Object Type Manager (REST)

This code illustrates how to perform the following tasks:

• Instantiate an HttpClient object for sending requests to the Object Type Manager service.
• Set the required headers for the request. For information on setting headers, see HTTP headers.
• Initialize variables with the values for the object type to create, and the workspace where it should be added.
• Set the url variable to the URL for the workspace where the object type is to be added. For more information, see Create an object type.
• Set the JSON input required for the operation.
• Use the PostAsync() method to send a POST request.
• Return the results of the request and deserialize it.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
public static async Task<ObjectTypeResponse> Create()
{
    ObjectTypeResponse result;
    using (HttpClient client = new HttpClient())
    {
        client.DefaultRequestHeaders.Add("X-CSRF-Header", "-");
        client.DefaultRequestHeaders.Add("Authorization", "Basic " + Convert.ToBase64String(Encoding.GetEncoding("ISO-8859-1").GetBytes("test@test.com:SomePassword")));
        client.DefaultRequestHeaders.Add("X-Kepler-Version", "2.0");
        client.BaseAddress = new Uri("https://localhost/");
 
        int workspaceId = 1017660;
        int parentObjectArtifactId = 1035231;
        int applicationId = 1042129;
 
        string inputJSON = $"{{\"ObjectTypeRequest\": {{\"ParentObjectType\": {{\"Value\": {{\"ArtifactID\": \"{parentObjectArtifactId}\"}}}},\"RelativityApplications\": [{{\"ArtifactID\": \"{applicationId}\"}}],\"Name\": \"Object Test 1\",\"CopyInstancesOnCaseCreation\": false,\"CopyInstancesOnParentCopy\": false,\"EnableSnapshotAuditingOnDelete\": true,\"PersistentListsEnabled\": false,\"PivotEnabled\": true,\"SamplingEnabled\": false,\"Keywords\": \"\",\"Notes\": \"\"}}}}";
        var url = $@"/Relativity.rest/api/relativity-object-model/{versionNumber}/workspaces/{workspaceId}/object-types/";
        var response = await client.PostAsync(url, new StringContent(inputJSON, Encoding.UTF8, "application/json"));
        response.EnsureSuccessStatusCode();
        var content = await response.Content.ReadAsStringAsync();
        result = JsonConvert.DeserializeObject<ObjectTypeResponse>(content);
    }
 
    return result;
}

The JSON request contains the following fields:

• ObjectTypeRequest - represents a request to create or update an object type. It contains the following fields:
  • ParentObjectType - indicates the parent object type of the object type. For example, an object type may be a child of the Document object. This field contains the following subfields:
    • Value - contains an ArtifactTypeID, which is an identifier used to specify an object type supported by Relativity. For example, the Artifact Type ID for a Document object is 10. The Value field also contains the Artifact ID of the object type.
  • RelativityApplications - an array of Relativity applications represented by ObjectIdentifier objects, which contain the Artifact ID and GUIDs for an application. The object type is linked to the applications in this array. If the array is empty, then the object type is not linked to any application.
  • Name - the user-friendly name of the object type.
  • CopyInstancesOnCaseCreation - a Boolean value indicating whether instances of this object type are copied when you create a new workspace. For more information, see Fields for an object type.
  • CopyInstancesOnParentCopy - a Boolean value indicating whether the child objects are copied when the parent object is copied. For more information, see Fields for an object type.
  • EnableSnapshotAuditingOnDelete - a Boolean value indicating whether to capture audit information about the current field values for an object. For more information, see Fields for an object type.
  • PersistentListsEnabled - a Boolean value indicating whether users can save lists of these object instances.
  • PivotEnabled - a Boolean value indicating whether pivot functionality is available on objects of this type. Pivot provides the functionality to analyze and report trends or patterns by querying specific sets of data and summarizing the results. For more information, see Pivot.
  • SamplingEnabled - a Boolean value indicating whether the sampling functionality is enabled on the object. You can use sampling to create a group of documents for quality control or other purposes. For more information, see Sampling.
  • Keywords - optional words or phrases used to describe the object type.
  • Notes - an optional description or other information about the object type.

The response contains the following fields:

• ArtifactTypeID - an integer value used as an identifier for an object type supported by Relativity. For example, the Artifact Type ID for a Document object is 10.
• ParentObjectType - contains information about the parent object type, as follows:
  • Secured - indicates whether the current user has permission to view the setting in the Value field.
  • Value - contains the following fields:
    • Name - the user-friendly name for the parent object type.
    • ArtifactTypeID - an identifier used to specify an object type supported by Relativity. For example, the Artifact Type ID for a Document object is 10.
    • ArtifactID - the Artifact ID of the parent object type.
    • Guids - an array of GUIDs used to identify the parent object type.
• CopyInstancesOnCaseCreation - a Boolean value indicating whether instances of this object type are copied when you create a new workspace. For more information, see Fields for an object type.
• CopyInstancesOnParentCopy - a Boolean value indicating whether the child objects are copied when the parent object is copied. For more information, see Fields for an object type.
• EnableSnapshotAuditingOnDelete - a Boolean value indicating whether to capture audit information about the current field values for an object. For more information, see .
• IsDynamic - a Boolean value indicating whether this object type is a custom type that is user-created.
• IsSystem - a Boolean value indicating whether this object type is available as an out-of-the-box type provided with Relativity.
• IsExtensible - a Boolean value indicating whether the object type can have new event handlers, mass operations and object rules.
• IsViewEnabled - a Boolean value indicating whether the view for the object type is enabled.
• PersistentListsEnabled - a Boolean value indicating whether users can save lists of these object instances.
• PivotEnabled - a Boolean value indicating whether pivot functionality is available on objects of this type. Pivot provides the functionality to analyze and report trends or patterns by querying specific sets of data and summarizing the results. For more information, see Pivot.
• SamplingEnabled - a Boolean value indicating whether the sampling functionality is enabled on the object. You can use sampling to create a group of documents for quality control or other purposes. For more information, see Sampling.
• FieldByteUsage - an integer value indicating the number of bytes used by the fields on the object type.
• RelativityApplications - contains the following fields:
  • HasSecuredItems - a Boolean value indicating whether the application contains items that the current user does not have permission to access.
  • ViewableItems - an array of identifier objects for items that are accessible to the current user. For example, an object in this array would contain the name, Artifact IDs, and GUIDs for an application.
• CreatedOn - the date and time when the object type was added to Relativity.
• CreatedBy - contains the Artifact ID and name of the user who created the object type. It also contains an array of GUIDs used to identify the user.
• LastModifiedBy - contains the Artifact ID and name of the user who recently updated the object type. It also contains an array of GUIDs used to identify the user.
• LastModifiedOn - the date and time when the object type was most recently modified.
• Keywords - optional words or phrases used to describe the object type.
• Notes - an optional description or other information about the object type.
• Meta - provides additional information available as extended metadata. It includes the following fields:
  • Unsupported - an array of properties that indicate functionality not available on the current instance of this object type. For example, if a user could not persist objects of this type in a list, then array would include PersistentListsEnabled.
  • ReadOnly - an array of object type properties that cannot be modified, such its name or parent object type.
• Actions - an array of Action objects indicating operations that you have permissions to perform on this object type. For example, you may not have permissions to modify an object type that is part of a locked application. Each Action object contains the following fields that are available as extended metadata:
  • Name - name of an operation available through REST for the object type, such as delete, update, and others.
  • Href - the URL used to make an HTTP request for the operation.
  • Verb - the name of the HTTP method for the operation.
  • IsAvailable - a Boolean value indicating whether you have permissions to perform the operation on this object type.
  • Reason - provides an explanation for the unavailability of an action.
• Name - the user-friendly name for the object type.
• ArtifactID - the Artifact ID of the object type.
• Guids - an array of GUIDs used to identify the object type

The response contains the following fields:

• ArtifactTypeID - an integer value used as an identifier for an object type supported by Relativity. For example, the Artifact Type ID for a Document object is 10.
• ParentObjectType - contains information about the parent object type, as follows:
  • Secured - indicates whether the current user has permission to view the setting in the Value field.
  • Value - contains the following fields:
    • Name - the user-friendly name for the parent object type.
    • ArtifactTypeID - an identifier used to specify an object type supported by Relativity. For example, the Artifact Type ID for a Document object is 10.
    • ArtifactID - the Artifact ID of the parent object type.
    • Guids - an array of GUIDs used to identify the parent object type.
• CopyInstancesOnCaseCreation - a Boolean value indicating whether instances of this object type are copied when you create a new workspace. For more information, see Fields for an object type.
• CopyInstancesOnParentCopy - a Boolean value indicating whether the child objects are copied when the parent object is copied. For more information, see Fields for an object type.
• EnableSnapshotAuditingOnDelete - a Boolean value indicating whether to capture audit information about the current field values for an object. For more information, see .
• IsDynamic - a Boolean value indicating whether this object type is a custom type that is user-created.
• IsSystem - a Boolean value indicating whether this object type is available as an out-of-the-box type provided with Relativity.
• IsExtensible - a Boolean value indicating whether the object type can have new event handlers, mass operations and object rules.
• IsViewEnabled - a Boolean value indicating whether the view for the object type is enabled.
• PersistentListsEnabled - a Boolean value indicating whether users can save lists of these object instances.
• PivotEnabled - a Boolean value indicating whether pivot functionality is available on objects of this type. Pivot provides the functionality to analyze and report trends or patterns by querying specific sets of data and summarizing the results. For more information, see Pivot.
• SamplingEnabled - a Boolean value indicating whether the sampling functionality is enabled on the object. You can use sampling to create a group of documents for quality control or other purposes. For more information, see Sampling.
• FieldByteUsage - an integer value indicating the number of bytes used by the fields on the object type.
• RelativityApplications - contains the following fields:
  • HasSecuredItems - a Boolean value indicating whether the application contains items that the current user does not have permission to access.
  • ViewableItems - an array of identifier objects for items that are accessible to the current user. For example, an object in this array would contain the name, Artifact IDs, and GUIDs for an application.
• CreatedOn - the date and time when the object type was added to Relativity.
• CreatedBy - contains the Artifact ID and name of the user who created the object type. It also contains an array of GUIDs used to identify the user.
• LastModifiedBy - contains the Artifact ID and name of the user who recently updated the object type. It also contains an array of GUIDs used to identify the user.
• LastModifiedOn - the date and time when the object type was most recently modified.
• Keywords - optional words or phrases used to describe the object type.
• Notes - an optional description or other information about the object type.
• Actions - an array of Action objects indicating operations that you have permissions to perform on this object type. For example, you may not have permissions to modify an object type that is part of a locked application. Each Action object contains the following fields that are available as extended metadata:
  • Name - name of an operation available through REST for the object type, such as delete, update, and others.
  • Href - the URL used to make an HTTP request for the operation.
  • Verb - the name of the HTTP method for the operation.
  • IsAvailable - a Boolean value indicating whether you have permissions to perform the operation on this object type.
  • Reason - provides an explanation for the unavailability of an action.
• Meta - provides additional information available as extended metadata. It includes the following fields:
  • Unsupported - an array of properties that indicate functionality not available on the current instance of this object type. For example, if a user could not persist objects of this type in a list, then array would include PersistentListsEnabled.
  • ReadOnly - an array of object type properties that cannot be modified, such its name or parent object type.

The body of the request must contain the following fields unless specifically identified as optional:

• ObjectTypeRequest - represents a request to create or update an object type. It contains the following fields:
  • ParentObjectType - indicates the parent object type of the object type. For example, an object type may be a child of the Document object. This field contains the following subfields:
    • Value - contains an ArtifactTypeID, which is an identifier used to specify an object type supported by Relativity. For example, the Artifact Type ID for a Document object is 10. The Value field also contains the Artifact ID of the object type.
  • RelativityApplications - an array of Relativity applications represented by ObjectIdentifier objects, which contain the Artifact ID and GUIDs for an application. The object type is linked to the applications in this array. If the array is empty, then the object type is not linked to any application.
  • Name - the user-friendly name of the object type.
  • CopyInstancesOnCaseCreation - a Boolean value indicating whether instances of this object type are copied when you create a new workspace. For more information, see Fields for an object type.
  • CopyInstancesOnParentCopy - a Boolean value indicating whether the child objects are copied when the parent object is copied. For more information, see Fields for an object type.
  • EnableSnapshotAuditingOnDelete - a Boolean value indicating whether to capture audit information about the current field values for an object. For more information, see Fields for an object type.
  • PersistentListsEnabled - a Boolean value indicating whether users can save lists of these object instances.
  • PivotEnabled - a Boolean value indicating whether pivot functionality is available on objects of this type. Pivot provides the functionality to analyze and report trends or patterns by querying specific sets of data and summarizing the results. For more information, see Pivot.
  • SamplingEnabled - a Boolean value indicating whether the sampling functionality is enabled on the object. You can use sampling to create a group of documents for quality control or other purposes. For more information, see Sampling.
  • Keywords - optional words or phrases used to describe the object type.
  • Notes - an optional description or other information about the object type.

• LastModifiedOn - the date and time when the object type was most recently modified. This field is only required if you want to restrict the update of an object type to the date that it was last modified. The value must match the LastModifiedOn date for the object type stored in Relativity. Otherwise, you receive a 409 error, indicating that the object has been modified.

The response contains the following fields for each parent object type:

• Name - the user-friendly name of the object type.
• ArtifactTypeID - an integer value used as an identifier for an object type supported by Relativity. For example, the Artifact Type ID for a Document object is 10.
• ArtifactID - the Artifact ID of the object type.
• Guids - an array of GUIDs used to identify the object type.