Ga naar inhoud
Blackbird API

Sitecore XP

View on Github

Sitecore is een van de toonaangevende contentmanagementsystemen op enterpriseniveau, waarmee webredacteuren en marketeers volledige controle hebben over alle aspecten van hun website, van sociale integratie en blogberichten tot geavanceerde personalisatie, e-commerce en meer. Deze app richt zich op de integratie tussen Sitecore-items, talen en de rest van het Blackbird-ecosysteem. In tegenstelling tot andere Blackbird-apps moet u een op maat gemaakte plugin installeren op uw Sitecore-instantie om aan de slag te kunnen.

Deze app is gebouwd voor Sitecore XP. Voor Sitecore XM Cloud, zie deze handleiding in plaats daarvan.

Vóór het instellen

Voordat u verbinding kunt maken, moet u ervoor zorgen dat:

  • U toegang heeft tot een Sitecore XP-instantie.
  • U voldoende beheerdersrechten in Sitecore heeft om een plugin te installeren.
  • U het nieuwste Blackbird Sitecore plugin-pakket heeft gedownload van hier.

De plugin installeren

  1. Navigeer op de ‘Desktop’ naar de installatiewizard.

1706110503246

  1. Upload het pluginpakket dat u van Blackbird heeft ontvangen.

1706110550965

  1. Klik op Next.
  2. Klik op Install.
  3. Klik op Close.

Een API-sleutel aanmaken

  1. Ga naar Content Editor.
  2. Navigeer naar System -> Settings -> Services -> API Keys.
  3. Voeg een nieuw API Key-item toe.

1706110975432

  1. Vul de volgende velden in:
    • Allowed controllers: stel in op * of kies controllers.
    • Impersonation User: het verzoek wordt uitgevoerd als deze gebruiker. Sitecore-beheerders kunnen gebruikers aanmaken met bepaalde beperkingen indien nodig. Anonieme gebruikers worden als deze gebruiker geïmpersoneerd als het veld leeg is.
  2. Publiceer het item.

1706111272004

  1. Kopieer de Item ID (inclusief de haakjes) - dit is uw sleutel en kan in de volgende stappen worden gebruikt.

Verbinden

  1. Navigeer naar apps en zoek naar Sitecore XP.
  2. Klik op Add Connection.
  3. Geef uw verbinding een naam voor toekomstige referentie, bijvoorbeeld ‘Mijn Sitecore-verbinding’.
  4. Vul de URL naar uw Sitecore-instantie in.
  5. Vul de API-sleutel in uit de vorige sectie.
  6. Klik op Connect.

1706111666447

Actions

  • Search items vindt items op basis van uw zoekcriteria, inclusief laatst bijgewerkt, aangemaakt, taal, pad, enz.
  • Get all configured languages geeft alle talen terug die zijn geconfigureerd in deze Sitecore-instantie.
  • Get item content as HTML haalt de inhoud van een item op, weergegeven als een HTML-bestand, zodat het kan worden verwerkt door NMT of TMS. U kunt specificeren welke versie/taal moet worden opgehaald.
  • Update item content from HTML werkt de inhoud van een specifieke versie/taal bij. Daarnaast kunt u ervoor kiezen om altijd een nieuwe versie aan te maken.
  • Delete item content verwijdert een item.
  • Get Item ID from HTML haalt de item-ID op uit de HTML-inhoud. Wanneer u vertaalde HTML-inhoud ontvangt, voegen we de Item-ID toe aan de header van het HTML-bestand. Met deze actie kunt u de Item-ID uit het HTML-document ophalen.

Events

  • On items created wordt geactiveerd wanneer nieuwe items worden aangemaakt.
  • On items updated wordt geactiveerd wanneer een item wordt bijgewerkt.

Voorbeeld

Dit voorbeeld laat zien hoe u een subset van items kunt ophalen op basis van aangepaste criteria, deze items als HTML-bestanden kunt downloaden, vertalen met een NMT-provider en de vertalingen kunt bijwerken.

1706274178376

Feedback

Wilt u deze app gebruiken of heeft u feedback op onze implementatie? Neem contact met ons op via de bestaande kanalen of maak een issue aan.