You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

The RDB via Tables Connector can be configured using the Rest API. It requires the following entities to be created:

  • Credential
  • Connection
  • Connector
  • Seed

Below are the examples of how to create the Credential, Connection and the Seed. For the Connector, please check this page.

Create Credential


FieldOptionalDefaultMultipleNotesExample
typeNo-NoThe value must be "group-expansion"."group-expansion"
descriptionNo-NoName of the connection object."MyGroupExpansionConnection"
throttlePolicyYes-NoId of the throttle policy that applies to this connection object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPoliciesYes[ ]YesThe ids of the routing policies that this connection will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]

Example

POST aspire/_api/connections
{
    "type": "group-expansion",
    "description": "MyGroupExpansionConnection",
}

Create Connection


FieldOptionalDefaultMultipleNotesExample
typeNo-NoThe value must be "group-expansion"."group-expansion"
descriptionNo-NoName of the connection object."MyGroupExpansionConnection"
throttlePolicyYes-NoId of the throttle policy that applies to this connection object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPoliciesYes[ ]YesThe ids of the routing policies that this connection will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]

Example

POST aspire/_api/connections
{
    "type": "group-expansion",
    "description": "MyGroupExpansionConnection",
}

Update Connection


FieldOptionalDefaultMultipleNotesExample
idNo-NoId of the connection to update"89d6632a-a296-426c-adb0-d442adcab4b0",
descriptionNo-NoName of the connection object."MyGroupExpansionConnection"
throttlePolicyYes-NoId of the throttle policy that applies to this connection object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPoliciesYes[ ]YesThe ids of the routing policies that this connection will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]

Example

PUT aspire/_api/connections/89d6632a-a296-426c-adb0-d442adcab4b0
{
    "id": "89d6632a-a296-426c-adb0-d442adcab4b0",
    "description": "MyGroupExpansionConnection",
}

Create Connector


For the creation of the Connector object using the Rest API check this page

Update Connector


For the update of the Connector object using the Rest API check this page

Create Seed


FieldOptionalDefaultMultipleNotesExample
seedNo-NoPut a placeholder here"seed_placeholder"
typeNo-NoThe value must be "group-expansion"."group-expansion"
descriptionNo-NoName of the seed object."MyGroupExpansionSeed"
connectorNo-NoThe id of the connector to be used with this seed. The connector type must match the seed type."82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31"
connectionNo-NoThe id of the connection to be used with this seed. The connection type must match the seed type."602d3700-28dd-4a6a-8b51-e4a663fe9ee6"
workflowsYes[ ]YesThe ids of the workflows that will be executed for the documents crawled.["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"]
throttlePolicyYes-NoId of the throttle policy that applies to this seed object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPoliciesYes[ ]YesThe ids of the routing policies that this seed will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]
tagsYes[ ]YesThe tags of the seed. These can be used to filter the seed["tag1", "tag2"]
propertiesYes-NoConfiguration object
seedsIncludedyes-yesThose seeds will be included in crawling identities["5b9f4074-01a3-4d86-8642-32a6f27179d4"]
seedsExcludedyes-yesThose seeds will be excluded from crawling identities["5b9f4074-01a3-4d86-8642-32a6f27179d4"]
seedsIdentities localyes-yesCustom mapping local
idno-noThe seed id for the mapping

"5b9f4074-01a3-4d86-8642-32a6f27179d4"

identityKeyTypeno-noThe value must be "local""local"
identityKeyAttrno-noThe name of the mapping attribute"someAttributeName"
seedsIdentities externalyes-yesCustom mapping external
idno-noThe seed id for the mapping

"5b9f4074-01a3-4d86-8642-32a6f27179d4"

identityKeyTypeno-noThe value must be "external""external"
identityKeyAttrno-noThe name of the mapping attribute in external seed"someAttributeName"
externalSeedno-noThe external seed id"5b9f4074-01a3-4d86-8642-32a6f27179d4"
externalLookupAttributeno-noThe external lookup attribute name"externalLookupAttrName"

Example


POST aspire/_api/seeds
{
    "type": "group-expansion",
    "seed": "seed_placeholder",
    "connector": "82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31",
    "description": "GroupExpansion_Test_Seed",
    "throttlePolicy": "6b8b5f23-fc77-47a1-9b58-106577162e7b",
    "routingPolicies": ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"],
    "connection": "602d3700-28dd-4a6a-8b51-e4a663fe9ee6",
    "workflows": ["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"],
    "tags": ["tag1", "tag2"],
    "properties": {
       "seedsIncluded": [
           "5b9f4074-01a3-4d86-8642-32a6f27179d4"
        ],
       "seedsExcluded": [],
       "seedsIdentities": [
           {
             "id": "5b9f4074-01a3-4d86-8642-32a6f27179d4",
             "identityKeyType": "local",
             "identityKeyAttr": "someAttrName"
            }
       ]
    }
}

Update Seed


FieldOptionalDefaultMultipleNotesExample
idNo-NoId of the seed to update"2f287669-d163-4e35-ad17-6bbfe9df3778"
(see the "Create seed" for other fields)




Example

PUT aspire/_api/seeds/2f287669-d163-4e35-ad17-6bbfe9df3778
{
    "id": "2f287669-d163-4e35-ad17-6bbfe9df3778",
    "connector": "82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31",
    "description": "FileSystem_Test_Seed",
    "throttlePolicy": "6b8b5f23-fc77-47a1-9b58-106577162e7b",
    "routingPolicies": ["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"],
    "connection": "602d3700-28dd-4a6a-8b51-e4a663fe9ee6",
    "workflows": ["b255e950-1dac-46dc-8f86-1238b2fbdf27", "f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"],
    "tags": ["tag", "tag2"],
    "properties": {
       "seedsIncluded": [
           "5b9f4074-01a3-4d86-8642-32a6f27179d4"
        ],
       "seedsExcluded": [],
       "seedsIdentities": [
           {
             "id": "5b9f4074-01a3-4d86-8642-32a6f27179d4",
             "identityKeyType": "local",
             "identityKeyAttr": "someAttrName"
            }
       ]
    }
}
  • No labels