Versions Compared

Key

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



This section describes the Configuration for ServiceNow Amazon S3 Seeds and how to run a crawl for them.

Easy Heading Free
navigationTitleOn this Page
navigationExpandOptionexpand-all-by-default

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 Seed option from the left-hand menu.

The "Seed" option, identified by a "seed" image , is located on the left side of the application, just above the "Workflows" option. Click on it to navigate to the "Seed" page.



Step 3. Specify Connection Description and Type

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

  • Description: specify a description for the Seed. It is advised for it to be concise and meaningful.
  • Type: select "ServiceNowS3" as the type for the Seed.



Step 4. Specify

the Articles and Attachments configuration (Optional)

Seed Information

Once the type has been selected, you will be presented with the "Articles and AttachmentsSeed" section of the "Seed" page. Here you need to set the following options for this section of the Seed. If no options are modified, default values are used:

  • Include Articles and Attachments : if enabled, knowledge articles will be crawled and, optionally, attachments for those articles can be crawled too.
    • Articles Display Base URL: the base display URL for articles.
    • Use Knowledge Base Security: if enabled, ACLs for articles and attachment are retrieved (requires server configuration).
    • Choose Pattern Field: the field to be used when including/excluding articles.
    • Include Patterns: the patterns to be used to include articles for the crawl.
    • Exclude Patterns: the patterns to be used to exclude articles from the crawl. 
    • Include Knowledge Article Attachments: if enabled, knowledge articles' attachments will be crawled.
      • Include or Exclude Attachments Using Patterns: enable to allow filtering by using include/exclude patterns for articles' attachments.
        • Use Mime Type for Patterns: if enabled, the connector will match the patterns using the mime type  of the attachment instead of the file name.
        • Include Patterns: the patterns to be used to include attachments for the crawl.
        • Exclude Patterns: the patterns to be used to exclude attachments from the crawl. 

A single parameter is required in this section:

  • Crawl path: the path to be crawled. It can be a bucket, folder or file.


Image Added


Step 5. Specify Split Files Configuration

Image Removed

Step 5. Specify the Catalog Items and Attachments configuration

(Optional)

The "Catalog Items and AttachmentsSplit Files" section is located between the "Articles and AttachmentSeed" and "Connector" sections of the "Seed" page. Here you need to set the following options for this section of the Seed. If no options are modified, default values are used:

  • Include Catalog Items Process Split Documents: if enabled, catalog items will be crawled.
    • Include Catalog Model Fields: if enabled, includes the key fields of the model associated to the catalog item.
    • Choose Pattern Field: the field to be used when including/excluding catalog items.
    • Include Patterns: the patterns to be used to include catalog items for the crawl.
    • Exclude Patterns: the patterns to be used to exclude catalog items from the crawl. 
    • Include Catalog Item Attachments: if enabled, catalog items' attachments will be crawled.
      • Include or Exclude Attachments Using Patterns: enable to allow filtering by using include/exclude patterns for catalog items' attachments.
        • Use Mime Type for Patterns: if enabled, the connector will match the patterns using the mime type  of the attachment instead of the file name.
        • Include Patterns: the patterns to be used to include attachments for the crawl.
        • Exclude Patterns: the patterns to be used to exclude attachments from the crawl. 

Image Removed

  • files that are split are treated as a single document instead of multiple documents.
  • Split Patterns: list of regular expressions to match folders that contain split files.

Image Added

Step 6. Specify a Connector

The "Connector" section is located between the "Catalog Items and AttachmentsSplit Files" section and the "Connection" section of the "Seeds" page. Here you must select a previously created ServiceNow Amazon S3 Connector for the Seed, from the Connector combo box.


Image RemovedImage Added


Step 7. Specify a Connection

The "Connection" section is located between the "Connector" section and the "Workflows" section of the "Seeds" page. Here you must select a previously created ServiceNow Amazon S3 Connection for the Seed, from the Connection combo box.


Image RemovedImage Added


Step 8. Specify Workflows (Optional)

The "Workflows" section is located between the "Connection" section and the "Tag" section of the "Seeds" page. Here, you can select previously created Workflows that apply to the seed. If no workflow is specified, a default workflow is assigned.


Image RemovedImage Added


Step 9. Specify a Tag (Optional)

The "Tag" section is located between the "Workflows" section and the "Policies" section of the "Seeds" page. Here you can, if desired, specify a tag for seeds filtering.


Image RemovedImage Added


Step 10. Specify Policies (Optional)

The "Policies" section is the last section, located right below the "Tag" section of the "Seeds" 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.


Image RemovedImage Added

Step 11. Save the Seed

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



Step 12. Running the crawl

To run an Identity Crawl for a ServiceNow a crawl for the Amazon S3 Seed, click on the button for the seed you want to run and select Full , or Incremental or Identity Crawl. This will start the chosen crawl for your seed.

Image RemovedImage Added