Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The File System Group Expansion Connector can be configured using the Rest API. It requires the following entities to be created:

  • Connection
  • Connector
  • Seed

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

Easy Heading Free
navigationTitle

Paneltitle

On this

pagetoc

Page
navigationExpandOptionexpand-all-by-default

Create Connection


Field
Optional
RequiredDefaultMultipleNotesExample
type
No
Yes-NoThe value must be "group-expansion"."group-expansion"
description
No
Yes-NoName of the connection object."MyGroupExpansionConnection"
throttlePolicy
Yes
No-No
Id
ID of the throttle policy that applies to this connection object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPolicies
Yes
No[ ]YesThe
ids
IDs of the routing policies that this connection will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]

Example

Code Block
themeRDark
title
Saga_json
TitlePOST aspire/_api/connections
{
    "type": "group-expansion",
    "description": "MyGroupExpansionConnection",
}

Update Connection


Field
Optional
RequiredDefaultMultipleNotesExample
id
No
Yes-No
Id
ID of the connection to update"89d6632a-a296-426c-adb0-d442adcab4b0",
description
No
Yes-NoName of the connection object."MyGroupExpansionConnection"
throttlePolicy
Yes
No-No
Id
ID of the throttle policy that applies to this connection object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPolicies
Yes
No[ ]YesThe
ids
IDs of the routing policies that this connection will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]

Example

Code Block
themeRDark
title
Saga_json
TitlePUT 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


Field
Optional
RequiredDefaultMultipleNotesExample
seed
No
Yes-NoPut a placeholder here"seed_placeholder"
type
No
Yes-NoThe value must be "group-expansion"."group-expansion"
description
No
Yes-NoName of the seed object."MyGroupExpansionSeed"
connector
No
Yes-No
The id
ID of the connector to be used with this seed. The connector type must match the seed type."82f7f0a4-8d28-47ce-8c9d-e3ca414b0d31"
connection
No
Yes-No
The id
ID of the connection to be used with this seed. The connection type must match the seed type."602d3700-28dd-4a6a-8b51-e4a663fe9ee6"
workflows
Yes
No[ ]Yes
The ids
IDs of the workflows that will be executed for the documents crawled.["f8c414cb-1f5d-42ef-9cc9-5696c3f0bda4"]
throttlePolicy
Yes
No-No
Id
ID of the throttle policy that applies to this seed object."f5587cee-9116-4011-b3a9-6b235b333a1b"
routingPolicies
Yes
No[ ]Yes
The ids
IDs of the routing policies that this seed will use.["313de87c-3cb9-4fe0-a2cb-17f75ce7d0c7", "b4d2579f-1a0a-4a8b-9fd4-d42780003b36"]
tags
Yes
No[ ]YesThe tags of the seed. These can be used to filter the seed.["tag1", "tag2"]
properties
Yes
No-NoConfiguration object
seedsIncluded
yes
No-yesThose seeds will be included in crawling identities["5b9f4074-01a3-4d86-8642-32a6f27179d4"]
seedsExcluded
yes
No-yesThose seeds will be excluded from crawling identities["5b9f4074-01a3-4d86-8642-32a6f27179d4"]
seedsIdentities local
yes
No-yesCustom mapping local
id
no
Yes-no
The seed id
Seed ID for the mapping

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

identityKeyType
no
Yes-noThe value must be "local""local"
identityKeyAttr
no
Yes-noThe name of the mapping attribute"someAttributeName"
seedsIdentities external
yes
No-yesCustom mapping external
id
no
Yes-noThe seed
id
ID for the mapping.

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

identityKeyType
no
Yes-noThe value must be "external""external"
identityKeyAttr
no
Yes-noThe name of the mapping attribute in external seed."someAttributeName"
externalSeed
no
Yes-noThe external seed
id
ID."5b9f4074-01a3-4d86-8642-32a6f27179d4"
externalLookupAttribute
no
Yes-noThe external lookup attribute name."externalLookupAttrName"

Example

Code Block
themeRDark
title
Saga_json
TitlePOST 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


FieldRequiredDefaultMultipleNotesExample
idYes-NoID of the seed to update"2f287669-d163-4e35-ad17-6bbfe9df3778"
(see the "Create seed" for other fields)




Example

Code Block
themeRDark
titlePUT 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"
            }
       ]
    }
}