Set Up the eSHARE Classification Search Properties

Prev Next

This document describes how eSHARE classification IDs reach SharePoint search, and how to create the one search property you set up yourself. Purview DLP policies match files through these search properties, so set them up before you create a DLP policy. You need to do this once per tenant, after the classification columns are deployed. The following steps will be reviewed:

PREREQUISITES:

The person performing these steps must be a SharePoint Administrator. The classification columns must already be deployed; see Deploy the eSHARE Classification Columns.

SharePoint search collects values from files and columns into managed properties when it crawls them, and Purview DLP reads those managed properties, not the library columns. eSHARE stores the classification ID in two places, depending on how the file was classified, so there are two managed properties:

Classified with

eSHARE writes the ID to

Managed property

Setup needed

Data Classification Menu (any file type)

The Data Classification column on the library

DataClassificationOWSTEXT

None. SharePoint creates it from the site column the first time search finds a value.

Data Classification Add-in (Word, Excel, PowerPoint)

The eSHARE_GUID property inside the file

eSHAREGUID

Create it once and map it to the eSHARE_GUID crawled property

Both are needed: DataClassificationOWSTEXT covers every file classified with the Data Classification Menu, including PDFs, and eSHAREGUID covers Office files classified with the Add-in.

Create the eSHAREGUID Search Property

This step is needed only for files classified with the Data Classification Add-in. Search lists the eSHARE_GUID crawled property only after it has crawled a file that has one, so start with a classified file.

  1. Open a Word document from a SharePoint library, classify it with the Data Classification Add-in and save it. Wait for search to crawl it; this takes from 15 minutes to a few hours.

  2. Sign in to the SharePoint admin center for your cloud: https://contoso-admin.sharepoint.com for Commercial and GCC, or https://contoso-admin.sharepoint.us for GCC High.

  3. Navigate to 'More features' > 'Search', select 'Open', then select 'Manage Search Schema'.

  4. Select 'Crawled Properties', set 'Category' to 'All' and search for eSHARE_GUID. It appears with 'Mapped to property' empty. If it isn't listed, search hasn't crawled a classified file yet; try again later.

  5. Select 'Managed Properties' > 'New Managed Property' and complete the form:

    1. In 'Property name', enter eSHAREGUID (letters and digits only). In 'Description', note that eSHARE Classify DLP policies use it.

    2. In 'Type', select 'Text'.

    3. Check 'Searchable', 'Queryable' and 'Retrievable'. DLP needs 'Queryable' and 'Retrievable'.

    4. Leave 'Allow multiple values' and 'Safe for anonymous' unchecked, and 'Refinable' and 'Sortable' set to 'No'.

    5. Check 'Language neutral tokenization', since the value is an ID rather than text.

    6. Under 'Mappings to crawled properties', select 'Add a Mapping', search for eSHARE_GUID, select it and select 'OK'.

    7. Select 'OK' to save the managed property.

Note:

Don't edit DataClassificationOWSTEXT in the search schema. SharePoint manages it, and editing it turns it into an ordinary managed property.

Check That Search Has the Values

A new mapping only applies to files crawled after it was saved. New and edited files are crawled automatically; files classified before the mapping existed need to be crawled again.

  1. Classify a new file with each tool, or reclassify an existing one. Classifying a file again is the most reliable way to have it crawled again.

  2. To have a whole library crawled again, open the library's 'Settings' > 'Library settings' > 'Advanced settings' and select 'Reindex Document Library'. This marks the files for the next crawl; it doesn't crawl them immediately.

  3. After 15 minutes or more, search for a classification ID in the site's search box (the value shown in a classified file's 'Data Classification' column), using the property for the tool the file was classified with:

DataClassificationOWSTEXT:SYV66QonHSQ8
eSHAREGUID:SYV66QonHSQ8
  1. Confirm that the classified files are returned.

Note:

DLP can match a file a few minutes before search returns it, especially on OneDrive. Use search as a check, not as a condition for creating a DLP policy.