Collection
Before you begin collecting, you must create a collection job and associate it with a specific matter, custodians, and one or more data sources. Add the custodians, data sources, and other information using the Collect wizard. Once completed, start the collection using the Collect console. Finally, download a results report that details the items collected and a summary report of the entire collection job. For more information, see Reports.
Creating a collection
Before you begin creating a collection, make sure to create a matter. For more information, see Matters.
Use the following procedure to create a collection:
- On the Collect tab, click the Collections sub-tab. Collect displays a list of the collections currently added to this application.
- Click New Collection.
- Complete the steps in the Collect wizard. See Using the Collect wizard
- On the Collection Details page, click Run Collection in the console. See Collect console.
For information on running concurrent Microsoft 365 collection jobs, see Accessing Microsoft 365 tenants.
Using the Collect wizard
The Collect wizard takes you through each step to create a collection. After completing the collection setup, run a collection from the Collection console.
Collection wizard security permissions
When a step is complete, click Next or the hyperlink under the next step shown. Click the Previous button to move to the previous step. Information is auto-saved when moving between steps. If any required information is wrong or missing, an error message displays and you cannot move to the next step.
Collection Details
Complete the Collection Details step by entering information in the following fields:
- Enable Auto-Processing—toggle on to enable auto-processing. If enabled, select the workspace, profile, and document prefix. Relativity processes all data in a completed collection, or completed with errors collection, after a collection finishes.
- Workspace—select a workspace within your instance to use when creating a processing job.
- Processing Profile—select a processing profile available in the drop-down menu. The available profiles are from the selected workspace.
- Document prefix —select the document prefix option of Use Entity Document Number Prefix or Use Processing Profile Document Number Prefix to apply to each file in the processing set once it's published to a workspace.
- Description—enter a description of the collection used for reporting purposes.
- Receive Progress Notifications—toggle on to send or receive collection job status emails. The statuses include:
- Completed—includes completed or completed with errors job status.
- Failed—includes job status and reason for failure.
- Notification Address—enter the email address of person that wants to receive collection job statuses.
- Data Source Type—select one or more data sources to use in the collection. For more information, see Data source types.
Data source
Configure the data source(s) chosen in the Collection Details step. Each data source has different criteria to enter. See the list of data source types under Data sources for information on each one.
You can select multiple data sources in the first step if you want to configure all or multiple sources in the step. Switch between each source to configure its criteria by using any of these methods:
- Click the name of the data source in the left navigation menu.
- Click Next and Previous to move you through the data sources.
- Select individual data sources by clicking on the checkbox and then using the right arrows to select them.
Data source criteria
Add criteria to collect specific data. To configure the data sources, complete the following fields:
After selecting field options, you must click Add Criteria. You can add multiple criteria to search data sources. Things to know about criteria:
- Each criteria is then separated by an AND operator.
- Leave the data source criteria empty to collect all data from the sources.
Custodians
Complete the Custodians step by assigning custodians to the project. Follow the steps below to assign a custodian.
- From the Unselected custodians table, use the column filters to locate custodians.
- Click a checkbox next to a custodian. Collect supports up to 30 custodians (entities) assigned in a collection job. If you need more than 30 custodians, you need to create another collection job. This limit only applies to the number of custodians. There is no limit to the number of targets to be collected. For example, you can select 30 custodians and three data sources for a total of 90 targets for the collection job.
Note: If you select multiple Slack custodians in the same collection, the channels they share will only collect once.
- Click the right arrow
icon to add select custodians. Click double right arrow
icon to add all custodians.
- Click Next.
Note: There is a limit of 10,000 listed custodians with targets in the custodian picker.
Non-custodial
Note: This section only applies when SharePoint is selected as the data source.
Select non-custodial data sources to complete this step. Non-custodial data means you will select the sites that you want to collect. Selecting custodians is not required.
With non-custodial data, you can collect from parent-level sites only. All sub-sites under a parent site are automatically collected.
To select non-custodial data:
- Click one or more data sources in the Select Sources column.
- With one of the data sources highlighted, click the check boxes next to the sites you want to collect.
- (Optional) Toggle on the Show selected only option in the SharePoint Sites table to only display the sites that have been selected for collection. The selected sites will display in a concise list at the top for easy review and confirmation before proceeding to the final Summary step.
- Click Next.
Collection Summary
Complete the creation of the collection by reviewing all steps, custodians, data sources, and targets, before finalizing. If Google Workspace, Microsoft 365, Slack, and X1 custodian targets were not created before you started the project, click Generate Targets. Clicking Generate Targets will check to see if targets exist for the custodians you have selected for collection. If the targets do not exist, Collect will automatically create them based on the email address contained in the Entity record for each custodian.
Targets
In the Targets section, you will see a number next a custodian's name. The number listed is the number of custodian targets found in the associated data source. A zero, 0, means Collect did not find any custodian targets with that email address in that data source. A one means Collect found a single custodian target associated with the email address within the data source. Any number greater than one means that Collect found multiple custodian targets with that email address within the data source.
If there is no color highlighting the number, it means Collect already found and generated the custodian target. If there is a green highlight, Collect autogenerated the custodian target. If there is a red highlight, Collect could not autogenerated this custodian target. If red, you can still manually generate the custodian target. For more information, see Creating a custodian target.
Complete the collection setup by clicking View Collection Details. Once you finish creating the collection, it redirects you to the Collection Details page. From the Collection Details page, you can preview and run the collection from the Collection Summary.
Non-custodian targets
Note: This section only applies when SharePoint is selected as the data source.
In the Non-Custodian Targets section, you will see the target, target identifier, and the status.
- Target—the name you gave when creating the data source.
- Target Identifier—the URL of the SharePoint site.
- Status—a message telling you if the target is valid or invalid. If invalid, navigate to the data source details page and click the Refresh Sites button.
Identifying Collection data in Staging Explorer
This section helps to identify the components of the folder information within the Staging pane of the Staging Explorer as it relates to the Collections setup fields.
Use the sample screen below as a general guide for each data source type.
Here is a breakdown of the folder components within the Staging pane of the Staging Explorer:
\\files\<T####>\ProcessingSource\Collections\<WorkspaceID>\<CollectionName>_<CollectionArtifactID>\<DataSourceArtifactID>
- The Processing Source Location from the Collections page becomes the file location for the data in Staging Explorer. It contains a sub-folder for Collections to house the Collection data. Using the above example, it would be:
\\files\T002F\ProcessingSource\Collections
- The Workspace ID folder in the Staging pane corresponds to the Workspace ID number listed after the “AppID=” in the URL. For example, 1187585 would be the Workspace ID from this URL: kcura.relativity.one/Relativity/RelativityInternal.aspx?AppID=1187585...
\\files\T002F\ProcessingSource\Collections\1187585
- The Name of the Collection from the Collections page and the Collection Artifact ID become the folder name within the Workspace ID folder. Using the above example, it would be:
\\files\T002F\ProcessingSource\Collections\1187585\GCE Logistics_3819941
- The Artifact ID of the data source used becomes the sub-folder. Using the above example, they would be:
\\files\T002F\ProcessingSource\Collections\1187585\GCE Logistics_3819941\3819948
\\files\T002F\ProcessingSource\Collections\1187585\GCE Logistics_3819941\3819949
In the case of grouped collections, such as Teams and Slack, there will be a folder within the collection folder corresponding to the data source type. Using Teams as an example, the file structure would be:
\\files\T002F\ProcessingSource\Collections\1187585\GCE Logistics_3819941\Teams