Invocation of standard services

Whenever Content Integration Framework receives content or asset search request from its client application against target system, it invokes the simple-search service implemented for respective system. Content Integration Framework provides necessary input to the simple-search service upon invocation. Search items received from simple-search service are then returned to the client application. Identification of the target system happens based on the systemId property used in the service declaration file and the corresponding System Identifier setting in Unica Platform that is populated during the target system onboarding. This service must be implemented by the plugin, else the content search request ends up in 404 response to the client application.

The search result produced by this service can be either paginated or unpaginated. Presence or absence of support for paginated result should be clearly indicated using paginatedSearch property under systems section in service declaration file as explained in the Service declaration file topic.

The resource-loader service is executed by the Content Integration Framework only when indirect (or authenticated) access needs to be made to the search item on the target system. Configuration can be made in Unica Platform to indicate whether contents can be accessed directly (anonymously) from the target system or not. For more information about system configurations, see Unica Content Integration Administration Guide. Content Integration Framework provides a default resource-loader service to each system. The default resource-loader service simply loads the web resources from the target system by supplying necessary authorization details, if applicable. Plugins may choose to override the default resource-loader service and include their own implementation by extending the out-of-the-box implementation. Content download and content rendition might fail if the required overridden resource-loader implementation is missing

If implemented, this service is invoked for fetching the list of supported content categories, eventually used for populating the content type's drop down on Content Picker UI. These categories are used to narrow down the content search within a particular category. There may be other use cases pertaining to these categories in future releases of Unica Content Integration.

This is an optional service and absence of its implementation does not impact content searchability in Content Picker. Other alternatives are used instead to generate the list of supported content categories in the absence of this service, that is supportedContentTypes standard parameter for simple-search service in service declaration file or getSupportedContentTypes() method in simple-search service implementation.

This service is used to facilitate content navigation along with the list-contents service. In addition to the content search, content can also be located by navigating through the hierarchy of folders (or any other similar concept in respective system). If this service is implemented, it is expected to provide top/root level folders as well as sub-folders of a particular parent folder as and when requested during content navigation. Only one level of folder list is expected in single execution. Entire folder hierarchy need not be provided. If this service is implemented, it is imperative to implement the list-contents service as well to turn the content navigation feature on.

This is an optional service and absence of its implementation does not impact content searchability in Content Picker. However, content navigation is disabled in Content Picker UI if this service is not implemented.

This service is used to facilitate content navigation along with the list-folders service. If implemented, this service is expected to provide the list of contents belonging to a particular folder. List can be either paginated or unpaginated. Presence or absence of support for paginated list should be clearly indicated using paginatedList property under systems section in service declaration file as explained in the Service declaration file topic.

If this service is implemented, it is imperative to implement the list-folders service as well to turn the content navigation feature on.

This is an optional service and absence of its implementation does not impact content searchability in Content Picker. However, content navigation is disabled in Content Picker UI if this service is not implemented.

Any content searched using simple-search service or listed using list-contents service can be selected and used for various use cases in Unica applications. Such use cases might demand the details of already chosen content at later point of time. One such example is Content Preview feature in Centralized Offer Management, wherein details of already linked content with offer attribute are shown. Whenever Unica applications need details of any individual content, the get-content-details service is invoked by supplying the unique identifier of the required content.

This is an optional service and absence of its implementation does not impact content searchability in Content Picker. However, subsequent user requests for fetching details of a content will not be served if this service is not implemented.

This service is invoked by Unica applications to fetch the details of various attributes present in the content. The entire master schema of all the contents is expected from this service, which should include the details about each content attribute, such as the type and format of the value it holds and a unique identifier to uniquely identify that attribute for the given system. As of current release of Unica Content Integration and Unica Centralized Offer Management, this information is used to map content attributes with offer attributes, and subsequently auto populate offer attribute values by selecting the content from Content Picker. For more information about this feature, please see Unica Centralized Offer Management User Guide.

This is an optional service and absence of its implementation does not impact content searchability in Content Picker. However, the Content Integration feature in Centralized Offer Management becomes unavailable for the respective system if this service is not implemented.

This service is invoked to attempt cognitive analysis of an image and fetch the cognitive details accordingly. It is invoked only if respective system is configured as the Preferred cognitive service provider in Platform Configuration. For more information, see Unica Content Integration Installation and Configuration Guide.

This is an optional service and absence of its implementation does not impact content searchability or any other feature in Content Picker. However, cognitive tagging feature is disabled in Centralized Offer Management if this service is not available.