Anrufung von Standardservices
Sobald das Content Integration Framework in der Dienstdeklarationsdatei deklariert und entweder mit dem RESTful- oder dem funktionalen Ansatz implementiert wurde, ruft es die Standarddienste in folgenden Szenarien auf:
- Einfache Suche (
simple-search)Immer wenn Content Integration Framework von seiner Client-Anwendung gegen das Zielsystem Inhalte oder Asset-Suchanfragen erhält, ruft er den für das jeweilige System implementierten
simple-search-Service auf. Content Integration Frameworkliefert den notwendigen Input für densimple-search-Service nach dem Aufruf. Vonsimple-search-Service erhaltene Suchbegriffe werden dann an die Client-Anwendung zurückgegeben. Die Identifizierung des Zielsystems erfolgt auf Grundlage dersystemId-Eigenschaft, die in der Dienstdeklarations-Datei verwendet wird, und der entsprechenden Systembezeichner-Einstellung in Unica Platform, die während des Onboardings des Zielsystems eingegeben wird. Dieser Service muss durch das Plug-in implementiert werden, sonst landet die Inhaltssuchanfrage als 404-Antwort auf der Client-Anwendung.Das von diesem Service erzeugte Suchergebnis kann paginiert oder unpaginiert sein. Das Vorhandensein oder Nichtvorhandensein von Unterstützung für paginierte Ergebnisse sollte mithilfe der Eigenschaft paginnedSearch im Abschnitt Systeme in der Dienstdeklarationsdatei, wie im Thema Servicedeklarationsdatei erläutert, eindeutig angegeben werden.
- Ressourcenlader (
resource-loader)Der
resource-loader-Service wird von Content Integration Framework nur dann ausgeführt, wenn ein indirekter (oder authentifizierter) Zugriff auf das Suchobjekt auf dem Zielsystem erforderlich ist. Die Konfiguration kann in Unica Platform erfolgen, um anzugeben, ob auf Inhalte direkt (anonym) vom Zielsystem aus zugegriffen werden kann oder nicht. Weitere Informationen zu Systemkonfigurationen finden Sie im Unica Content Integration Administrationsleitfaden. Content Integration Framework stellt einenresource-loader-Standardservice für jedes System bereit. Derresource-loader-Standardservice lädt die Webressourcen einfach aus dem Zielsystem, indem er die erforderlichen Autorisierungdetails bereitstellt, sofern zutreffend. Plug-Ins können denresource-loader-Standardservice überschreiben und ihre eigene Implementierung einschließen, indem sie die gebrauchsfertige Implementierung erweitern. Das Herunterladen von Inhalten und die Wiedergabe von Inhalten können fehlschlagen, wenn die erforderliche überschriebeneresource-loader-Implementierung fehlt - Inhaltskategorien auflisten (
list-content-categories)Falls dieser Dienst implementiert ist, wird er zum Abrufen der Liste der unterstützten Inhaltskategorien aufgerufen, die schließlich zum Auffüllen der Dropdown-Liste des Inhaltstyps auf der Benutzeroberfläche der Inhaltsauswahl verwendet werden. Diese Kategorien werden verwendet, um die Inhaltssuche innerhalb einer bestimmten Kategorie einzugrenzen. In zukünftigen Versionen von Unica Content Integration kann es andere Anwendungsfälle geben, die sich auf diese Kategorien beziehen.
Dies ist ein optionaler Dienst, und das Fehlen seiner Implementierung hat keinen Einfluss auf die Suchbarkeit von Inhalten in Content Picker. Andere Alternativen werden stattdessen verwendet, um die Liste der unterstützten Inhaltskategorien zu generieren, wenn dieser Dienst nicht vorhanden ist. Dies ist der
supportedContentTypes-Standardparameter für densimple-search-Dienst in der Dienstdeklarationsdatei oder diegetSupportedContentTypes()-Methode in dersimple-search-Dienstimplementierung. - Ordner auflisten (
list-folders)Dieser Dienst wird verwendet, um die Inhaltsnavigation zusammen mit dem
list-contents-Dienst zu erleichtern. Zusätzlich zur Inhaltssuche können Inhalte auch durch die Hierarchie der Ordner (oder ein anderes ähnliches Konzept im jeweiligen System) gefunden werden. Wenn dieser Dienst implementiert ist, wird erwartet, dass er Ordner auf oberster/Stammebene sowie Unterordner eines bestimmten übergeordneten Ordners bereitstellt, wenn dies während der Inhaltsnavigation angefordert wird. Bei einer einzelnen Ausführung wird nur eine Ebene der Ordnerliste erwartet. Es muss keine gesamte Ordnerhierarchie angegeben werden. Wenn dieser Dienst implementiert ist, muss der Listeninhalts-Dienst unbedingt implementiert werden, um die Inhaltsnavigationsfunktion zu aktivieren.Dies ist ein optionaler Dienst, und das Fehlen seiner Implementierung hat keinen Einfluss auf die Suchbarkeit von Inhalten in Content Picker. Die Inhaltsnavigation ist jedoch in der Content Picker-Benutzerschnittstelle in deaktiviert, wenn dieser Service nicht implementiert ist.
- Listeninhalt (
list-contents)Dieser Dienst wird verwendet, um die Inhaltsnavigation zusammen mit dem
list-folders-Dienst zu erleichtern. Wenn dieser Dienst implementiert ist, wird erwartet, dass er die Liste der Inhalte zur Verfügung stellt, die zu einem bestimmten Ordner gehören. Die Liste kann paginiert oder unpaginiert sein. Das Vorhandensein oder Nichtvorhandensein einer Unterstützung für eine paginierte Liste sollte anhand derpaginatedList-Eigenschaft im Abschnitt Systeme in der Dienstdeklarationsdatei, wie im Servicedeklarationsdatei-Thema erläutert, eindeutig angegeben werden.Wenn dieser Dienst implementiert ist, muss der
list-folders-Dienst unbedingt implementiert werden, um die Inhaltsnavigationsfunktion zu aktivieren.Dies ist ein optionaler Dienst, und das Fehlen seiner Implementierung hat keinen Einfluss auf die Suchbarkeit von Inhalten in Content Picker. Die Inhaltsnavigation ist jedoch in der Content Picker-Benutzerschnittstelle in deaktiviert, wenn dieser Service nicht implementiert ist.
- Inhaltsdetails abrufen (
get-content-details)Alle mit dem
simple-search-Dienst durchsuchten oder mit demlist-contents-Dienst aufgelisteten Inhalte können ausgewählt und für verschiedene Anwendungsfälle in Unica-Anwendungen verwendet werden. In solchen Anwendungsfällen können zu einem späteren Zeitpunkt Details zu bereits ausgewähltem Inhalt verlangt werden. Ein Beispiel hierfür ist die Funktion Inhaltsvorschau in Centralized Offer Management, in der Details zu bereits verlinkten Inhalten mit Angebotsattribut angezeigt werden. Wenn Unica -Anwendungen Details zu einem einzelnen Inhalt benötigen, wird der Service get-content-details durch sie Bereitstellung der eindeutigen ID des erforderlichen Inhalts aufgerufen.Dies ist ein optionaler Dienst, und das Fehlen seiner Implementierung hat keinen Einfluss auf die Suchbarkeit von Inhalten in Content Picker. Nachfolgende Benutzeranforderungen zum Abrufen von Details eines Inhalts werden jedoch nicht bedient, wenn dieser Dienst nicht implementiert ist.
- Objektschema abrufen (
get-object-schema)Dieser Dienst wird von Unica-Anwendungen aufgerufen, um die Details verschiedener Attribute im Inhalt anzuzeigen. Von diesem Dienst wird das gesamte Master-Schema aller Inhalte erwartet, das die Details zu jedem Inhaltsattribut enthalten sollte, z. B. den Typ und das Format des darin enthaltenen Werts sowie eine eindeutige Kennung, um dieses Attribut für das angegebene System eindeutig zu identifizieren. Ab der aktuellen Version von Unica Content Integration und Unica Centralized Offer Management werden diese Informationen verwendet, um Inhaltsattribute Angebotsattributen zuzuordnen und anschließend Angebotsattributwerte automatisch auszufüllen, indem der Inhalt aus der Inhaltsauswahl ausgewählt wird. Weitere Informationen zu dieser Funktion finden Sie im Unica Centralized Offer Management-Benutzerhandbuch.
Dies ist ein optionaler Dienst, und das Fehlen seiner Implementierung hat keinen Einfluss auf die Suchbarkeit von Inhalten in Content Picker. Die Funktion Content Integration in der Centralized Offer Management ist jedoch für das jeweilige System nicht mehr verfügbar, wenn dieser Dienst nicht implementiert ist.
- kognitive Analyse abfrufen (
get-cognitive-analysis)Dieser Dienst wird aufgerufen, um eine kognitive Analyse eines Bildes zu versuchen und die kognitiven Details entsprechend abzurufen. Er wird nur aufgerufen, wenn das jeweilige System in der Plattformkonfiguration als bevorzugter kognitiver Dienstanbieter konfiguriert ist. Weitere Informationen finden Sie im Unica Content Integration-Installations- und Konfigurationshandbuch.
Dies ist ein optionaler Dienst, dessen Implementierung keine Auswirkung auf die Suche nach Inhalten oder auf andere Funktionen in Content Picker hat. Die Funktion zur kognitiven Kennzeichnung ist jedoch in der zentralen Angebotsverwaltung deaktiviert, wenn dieser Dienst nicht verfügbar ist.