Content Service Connections
3Sixty's Content Service Connections offer public REST endpoints that allow for integration with external applications. Actions in the Content Services API or the Discovery web application perform actions against specific repositories through these connectors.
Click here for a list of Repositories that Support Content Services.
See the 3Sixty Technical Guide for advanced mapping and configuration settings.
Creating A Content Service Connection
To create a content service connector select Content Service under Connections in the navigation menu.
Click Create New Content Service Connection and fill in the following fields.
Tip: Connector ID
Connector ids are how 3Sixty identifies the individual connector when receiving calls from other sources, such as Federation Service. This value must be usable as part of url. Use the description field if you need more than a few letters/numbers to describe the connection. The description shows up with its connector ID across the product.
Basic Configuration
Field |
Description |
---|---|
Connector ID |
A unique identifier for this connection i.e. 3sixty_demo (Alphanumeric, dashes and underscore characters only) |
Description |
The text that will be displayed on drop-downs etc. to identify this connection. |
Type |
The software type of Service Connection . |
Keep Connection Alive |
3Sixty will cache the connection for a given amount of time before discarding it. |
Keep Alive in Milliseconds |
How long to keep the connection alive before discarding it (300000 is 5 minutes) |
Security Mode |
This is how to authenticate with the back-end search.
|
Mapping Type |
Select the mapping type you want to use for this connection. Either Single or Group.
|
Connection Configuration
Different connectors might require additional configuration. These values will populate after selecting a Type. See your 3Sixty Connector guide for more detail on specific connectors.
Content Service Mapping
You can also add mappings or mapping groups to your Content Service Connections which will allow you to map custom parameters to properties in the destination system.
Add Mappings to a Content Service Connector
-
Create a mapping.
-
(Optional) Add your mappings (and other mappings) to a Mapping Group.
-
-
Click the edit icon for your Content Service connector.
-
In the drop-down under Mapping Type select Single Mapping or Group Mapping
-
In the drop-down under the mapping type you chose, select the Mapping or Mapping Group you want to add to this connection.
-
Save the Content Service connector.
Creating Mappings for Content Services
Content Service mappings will use the source as the parameter name for the content service call. The target field should match a field name in the destination repository. For easier use, you can leverage the schema discovery for your connectors to populate the output field names when mapping.
In the above example, the parameter name can be populated to map data to the Title field in the connected repository.
Here is an example call using the mapping above:
http://localhost:8080/3sixty-admin/repo/spo2/update?fileId=s5dba1525-44a6-45ed-a42e-4a155a3f0539&name=second_level_22
The above call will update the SharePoint document by setting the Title to 'second_level_22'.
Commonly Supported Operations
Note: Capabilities
The capabilities of each Content Service Connector is limited to operations allowed by the repository. Additionally, not all methods are available for all connectors. View individual connector pages for a list of capabilities.
-
Creating content
-
Retrieving file content
-
Showing content properties
-
Listing folder items
-
Listing file versions
-
Updating file content and properties
-
Deleting files and folder
-
Showing repository capabilities
-
Retrieving the Root Folder ID
-
Managing Permissions
List of Repositories supported by Content Services
Related Articles: