Sitecore Connect™ for Sitecore CMP 2.0.0
Sitecore Connect™ for Sitecore CMP version 2.0.0 udkom i denne uge. Modulet synkroniserer indhold, der er oprettet i Sitecore Content Hub, med Sitecore XP.
Modulet har fremragende dokumentation. Her vil jeg forklare, hvordan det fungerer internt.
I Sitecore XP kaldes byggeklodserne items. I Content Hub kaldes de entities. Entities har felter og relationer.
Lad os sige, at vi opretter et blogindlæg på engelsk (en-US) i Content Hub. Vi har nu en entity med egenskaber som Title og Body. En relation med navnet ContentTypeToContent fra en Blog-entity til vores entity angiver, at det er et blogindlæg.
En relation med navnet LocalizationToContent fra en-US-entityen til vores entity markerer blogindlægget som amerikansk engelsk.
Hvis vi lokaliserer blogindlægget til nl-BE, opretter Content Hub endnu en blogindlægs-entity og forbinder den med nl-BE-sprogentityen via relationen LocalizationToContent. En relation med navnet ContentToContentLocalization forbinder også det engelske blogindlæg med dets belgisk-nederlandske lokalisering.
Lad os se, hvordan Sitecore Connect™ for Sitecore CMP 2.0.0 omdanner disse entities til items i Sitecore XP.
Når en entity publiceres, kører en Content Hub-trigger en action, som sender en besked til et Azure Service Bus-topic med navnet hub_out. Beskeden indeholder entity_id, og andre systemer kan abonnere på topic'et for at få besked om ændringer.
PĂĄ Sitecore XP-siden (CM) lytter en subscription client efter nye beskeder i hub_out.
NĂĄr der kommer en ny besked, starter cmp.importEntity-pipelinen.
cmp.importEntity-pipelinen kører følgende tre processorer:
FetchEntity-processoren:
- Henter
entity_idfra Service Bus-beskeden. - Henter entityen fra Content Hub.
- Finder indholdets sprog ud fra relationen
LocalizationToContent. - Finder en eventuel localization parent ud fra relationen
ContentToContentLocalization.
EnsureItem-processoren:
- Forsøger at finde et item, der svarer til entityen.
- Søger i den konfigurerede Item Bucket efter et item, hvor feltet
Entity Identifiermatcher id'et på enten den aktuelle entity eller dens eventuelle localization parent. - Sætter feltet
Entity IdentifierpĂĄ det nye item. - Opretter et item, hvis der ikke findes et match. Processoren bruger sproget fra relationen
LocalizationToContent, hvis det findes, og ellers standardsproget.
SaveFieldValues-processoren:
- Gemmer de item-felter, der er konfigureret til synkronisering.
- Sender en besked til et andet topic med navnet
hub_in, nårcmp.importEntityer færdig. Beskeden indeholder den indgående beskeds id, item-id, entity-id og en eventuel exception.
Content Hub behandler beskeden og fĂĄr dermed status for synkroniseringen af entityen.
