In the search field, change the query string from *:*  to table:country and click the Go button to view all documents which have this table  field value assigned.

At the top right of the screen, click the Details > On button to display full details for the documents.

Look at the title, teaser, and text field values shown for the documents and observe that some terms in these field values are wrapped in span  HTML tags with class  attribute values starting with "scope", as in this example:

[…] former <span class="scope jobtitle">President</span> […]

These tags indicate that the term in question has been tagged with a scope by Attivio's entity-extraction functionality. In this example, the type of the scope for the term "President" is jobtitle ; other scopes tagged in the indexed documents include person , location, company, date, nationality, and number .

Some scopes are added by other modules: keyphrase  scopes are tagged by the Key-Phrase Extraction module, while entsentpos  and entsentneg  scopes are tagged by the Entity Sentiment module.

In Search UI, enter text:SCOPE(person)  as a new query.

Click the blue down-arrow symbol to the right of the search field and change the query language from Simple to Advanced. (The SCOPE operator is not supported in the Simple Query Language.)

Click the Go button to view all documents which include terms tagged with person  scopes.

These terms should appear wrapped in span class="scope person"  HTML tags when Search UI's Details function is set to "On"; even when it's set to "Off", Search UI highlights many scopes in query results.

Repeat this exercise for other scopes, such as title:SCOPE(keyphrase)  or text:SCOPE(location) .

If you see no results for a scope query, double-check that the query language is still set to Advanced.

In Search UI, enter  text:sentence:AND(scope(date),scope(person),president) as a new query.

Click the blue down-arrow symbol to the right of the search field and ensure that the query language is set to Advanced.

Click the Go button to view all documents which have  text field values that include a  date scope, a  person  scope, and the term "president" all within a single sentence scope tag.

Navigate to http://localhost:17000/dictionaryadmin/ (or click the Administrator UI's Business Center > Dictionary Administration menu link) in your web browser to open the Dictionary Administration web application.

Log in with username aieadmin and password attivio if prompted.

Create a new entity dictionary:

1. Click the Create a New Dictionary button to access the New Dictionary screen.
2. Enter a Dictionary Name value (e.g., CustomScopes).
3. Click the Type drop-down control and select Entity as the type.
4. Enter a Group name (e.g., Test).
5. Click the Save button to save the new dictionary, then click OK to dismiss the save notification.

Add terms to the new dictionary:

1. Click the Edit Terms button to access the Terms screen.
2. Click the Add New Term button at the top right of the screen to open the New Term dialog box.
3. Enter World War II as a Term value and click the Save button.
4. Click the OK button to dismiss the notification message for the new term.
5. Repeat the above steps to add two further terms: Great Depression and Cold War.

Approve and publish the new dictionary:

1. Click the Approve button to approve the new dictionary (making it eligible for publication), then click OK to dismiss the approval notification.
2. Click the Publish button to publish the approved dictionary (making it active), then click OK to dismiss the publication notification.

Navigate to http://localhost:17000/admin/workflow_ingest (or click the Administrator UI's System Management > Workflows > Ingest menu link) to access the Ingest workflow editor screen.

Click the extractBaseEntities workflow to open its editor dialog box.

This dialog box shows the list of stages (components) included in this workflow: these are document transformers which operate on documents routed through this workflow.

These stages run in order, so each document is first processed by sentenceFinder, then by companyFinder, and so on.

Create a new workflow component (stage) that instantiates the ExtractDictionaryEntities class:

1. Click the Add New Component button to open the Platform Component selection dialog box.
2. Type "Dictionary" into the filter field and click the Filter button to view only component classes whose names contain this term.
3. Select the ExtractDictionaryEntities class and click the OK button to open the New ExtractDictionaryEntities dialog box.

Configure the new component:

1. Enter historyFinder in the Name property field. This is the name of our new document transformer component.
2. Enter history in the Entity Type property field. This specifies the name of the custom scope tag this component will assign to matched terms.
3. Enter CustomScopes (the name of the new entity dictionary) in the Dictionary Name property field.
4. Enter en (English) in the Default Locale property field.
5. Click the Save button to save the new document transformer component.

The new historyFinder component should appear at the end of the list of workflow stages. (We could use the Move Up and Move Down buttons to re-order the workflow stages, but we don't need to for this exercise.

Click the Save button to save the modified extractBaseEntities workflow.

Repeat Step 6 from the Attivio Quick Start Tutorial to run the four sample Factbook connectors.

In the Search UI, enter text:SCOPE(history) into the search field, set the query language to Advanced, and click the Go button.

You should see only documents which include the terms "World War II", "Great Depression", or "Cold War", and those terms should be highlighted in the results.