Versions Compared

Old Version 2

changes.mady.by.user Ricardo Fonseca

Saved on

compared with

New Version Current

changes.mady.by.user Ricardo Fonseca

Saved on

Key

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

This section describes the Configuration for Connection used by the

ServiceNow

AEM Connector Seeds.

Easy Heading Free
navigationTitleOn this Page
wrapNavigationTexttrue

Step 1. Open the Aspire Admin UI

.



Browse to the Aspire Admin UI. It is typically located at http://localhost:50505.



Step 2. Select the Connection

option

Option from the

left

Left-hand

menu.

Menu

The “Connection” option, identified by a “connection” image

Image Removed

Image Added, is located on the left side of the application, between the “Credentials” and “Connector Instances” options. Click on it to navigate to the “Connection” page.



Step 3. Specify Connection Description and Type

.

Once on the “Connection” page, click on the “+New” option to create a new Connection or select an existing one to modify it.

  • Description: specify a description for the Connection. It is advised for it to be concise and meaningful.
  • Type: select

“Sharepoint-online”
  • “Adobe Experience” as the type for the Connection.


Step 4. Specify Connection General

information.

Information

Once the type has been selected, you will be presented with the “General” section of the “Connection” page. Here, you need to enter the following information for the Connection:

  • Server URL: Hostname where SharePoint is located
  • Index Containers: if enabled, index the SharePoint Containers.
  • Scan recursively: if enabled, scan discovered items recursively.
  • Use Aspire Snapshots for Incrementals: if enabled, process incremental crawls using Aspire Snapshots instead of SharePoint's Change log.
    • Repository URL: the URL and port of the AEM Server.
    • Fetch ACLs: check to fetch the documents acls.
    • Use / to execute requests: check to include a slash character at the end of each node path for the JSON requests.
    • Exclude Properties: specify filters about which documents to exclude.
      • Property Name: property of the node to check.
      • Expected Value: the expected value of the property.
      • Is regex: check if expected value is a regex.
    • Include Properties: specify filters about which documents to include.
      • Property Name: property of the node to check.
      • Expected Value: the expected value of the property.
      • Is regex: check if expected value is a regex.
    • Stop Crawl on Scan
    Stop Crawl on Scanner
    • Error: if enabled, stops the crawl if an error occurs during the scan phase.
    Image Removed





    Image Added

    Step 5. Specify Connection Scope (Optional)


    The “Scope” section is located between the “General” section and the

    “Security”

    “Connection Settings” section of the “Connection” page. Here, you can specify document inclusions and exclusions, based on the regular expression patterns:

  • Exclude using SharePoint “No Crawl” property: if enabled, crawl will exclude sites and lists using SharePoint's NoCrawl property
  • Crawl Attachments: if enabled, crawls list item attachments.
  • Log the REST Request And Responses (debug mode): Check to add debug log information about the rest requests and their responses.
    • Scan excluded items: if enabled, scans excluded container items so documents inside them can be processed
    .
  • Replace content field with CanvasContent1/WikiField content in .aspx items: If selected, the content field of the .aspx items will be filled with the contents of the CanvasContent1/WikiField fields. If CanvasContent1 and WikiField fields are empty, no content will be assigned to the content field.
    • Download large files: if enabled, download a file that exceeds the Data Size Threshold to disc instead of leaving the connection open
    • .
    • Include patterns: list of regular expressions to match documents to be included in the crawl.
    • Exclude patterns: list of regular expressions to match documents to be excluded from the crawl.
    Image Removed




    Image Added

    Step 6. Specify

    Security

    Connection Settings (Optional)


    The

    “Security”

    “Connection Settings” section is located between the “Scope” section and the

    “Network”

    “Credentials” section of the “Connection” page. Here, you can specify

    groups prefix separator and use azure group expander
    • Groups Prefix separator: Prefix used to separate users and groups on ACL's.
    • Lowercase Group Expansion Entries: if enabled, all entries extracted from the cache groups process will be in lower case.
    • User/Group request page size: Page size for fetching users and groups
    • Use Azure Group Expander: If enabled, Azure AD group will be used when caching groups for expansion

    Image Removed

    Step 7. Specify Network (Optional)

    The “Network” section is located between the “Security” section and the “Delegated Permissions” section of the “Connection” page. Here, you can specify proxy settings, custom HTTP Headers and network settings.

    • Use proxy: check if proxy is required for connecting to SharePoint.
    • Custom HTTP Headers: Extra HTTP Headers to be included with the request
    • Request Retry Count: Number of retries for failed documents.
    • Request Retry Sleep: Time to wait in between failed requests.
    • Socket Timeout: Time of inactivity to wait for packets to arrive.
    • Connection Timeout: Time to wait to establish a connection with the remote host.
    • Connection Request Timeout: Time to wait to fetch a connection from the connection pool.
    • Idle Connection Timeout: Time to wait to close an idle connection.
    • Maximum Connections: Maximum numbers of open connections,
    • Maximum Connections Per Route: Maximum numbers of open connections per route.

    Image Removed

    Step 8. Specify Delegated Permissions (Optional)

    The “Delegated Permissions” section is located between the “Network” section and the “Credentials” section of the “Connection” page. Here you can click Image Removed that allows you to get or update the refresh token in the “Credentials” Page when using Azure Delegated Permission as an authentication method.

    custom settings for the AEM Server connection.

    • Idle Connection Timeout: maximum time to keep an idle connection open (specified in milliseconds).
    • Max Connections: maximum number of connections to be opened.
    • Connections per Target: maximum number of connections to be opened for the same target.
    • Connection Timeout: maximum connection wait time (specified in milliseconds).
    • Socket Timeout: maximum socket response wait time (specified in milliseconds).
    • Connection Throttling: check to enable connection throttling.
      • Throttling Period: the period to throttle the connection (specified in milliseconds).
      • Max Connections per Period: maximum number of connections to use during the throttling period.
    • Maximum Retries: maximum number of retries for a failed document.
    • Retry Delay: time to wait before a retry (specified in milliseconds).
    • Use Proxy: check to configure a proxy.
      • Hostname: the proxy hostname.
      • Port: the proxy port.
      • Schema: the proxy schema.
      • Use Authentication: check to configure credentials for the proxy.
        • Username: the proxy username.
        • Password: the proxy username's password.







    Image Added

    Step 7. Specify Credentials

    Image Removed

    Step 9. Specify Credentials.


    The “Credentials” section is located between the

    “Delegated Permissions”

    “Connection Settings” section and the “Policies” section of the “Connection” page. Here, you have to select a set of previously created

    SharePoint Online

    AEM Connector Credentials to be used from the Credentials' combo box.

    Image Removed

    Image Added

    Step

    10

    8. Specify Policies (Optional)


    The “Policies” section is the last section, located right below the “Credentials” section of the “Connection” page:

    • Throttle Policy: here, you can select a previously created Throttling Policy from the Throttle Policy combo box.
    • Route Policy: here you can select a previously created Routing Policy from the Route Policy combo box.
    • Delete Policy: here, you can select a previously created Delete Policy from the Delete Policy combo box.
    Image Removed



    Image Added

    Step

    11

    9. Save the Connection


    Click on the "Complete" button to save the new Connection (when updating, the button option will read "Save" instead of "Complete").