File Field Manager (REST)

The File Field Manager service includes endpoints for uploading and downloading files linked to file fields. As a sample use case, you might leverage this service to create a custom page with links for downloading files from Relativity.

It also supports the use of progress indicators and cancellation tokens through .NET. For more information, see File Field Manager (.NET).

This page contains the following information:

Guidelines for the File Field Manager service

Review the following guidelines for working with this service.

The URLs for REST endpoints contain path parameters that you need to set before making a call:

• Set {versionNumber} to the version of the API, using the format lowercase v and the version number, such as v1.
• Set other path parameters in the URLs to the Artifact ID of a given entity, such as {workspaceID} to the Artifact ID of a workspace.

Note: To indicate the admin-level context, set the {workspaceID} path parameter to -1.

Postman sample file

You can use the Postman sample file to become familiar with making calls to endpoints on the service. To download the sample file, click File Field Manager Postman file.

Client code sample

You can use the following .NET code as a sample client to download and save a file from a file field.

public static async Task DownloadAndSaveFileHttpExample()
{
    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 relativityObjectID = 104211;
        int fieldArtifactID = 1042124;
 
        string url = $"/Relativity.Rest/api/relativity-object-model/{versionNumber}/workspaces/{workspaceID}/files/download";
        string inputJSON = $@"{{""fileRequest"": {{""objectidentifier"": {{""ArtifactID"": {relativityObjectID}}},""field"": {{""ArtifactID"": {fieldArtifactID}}}}}}}";
        using (HttpResponseMessage response = await client.PostAsync(url, new StringContent(inputJSON, Encoding.UTF8, "application/json")))
        {
            response.EnsureSuccessStatusCode();
            using (Stream responseStream = await response.Content.ReadAsStreamAsync())
            using (Stream fileStream = File.Create($"C:\\Temp\\{(response.Content.Headers.ContentDisposition.FileName).Replace("\"", "")}"))
            {
                await responseStream.CopyToAsync(fileStream);
            }
        }
    }
}

Uploading files to file fields

To upload a file to a file field, use a URL with following general format:

<host>/Relativity.Rest/api/relativity-object-model/{versionNumber}/workspaces/{workspaceId}/files/upload

Note: Set the {workspaceId} to -1 to indicate the admin-level context.

The request must include the following:

• FileRequest - contains the data required to upload a file from a file field.
  • ObjectIdentifier- identifies the Relativity object, which will contain the uploaded file, by ArtifactID or GUID.
    • ArtifactID - the Artifact ID of the object.
  • Field - a reference to the field that you want associated with the uploaded file.
    • ArtifactID - the Artifact ID of the field.

The request content is a bit stream representing the file that you are uploading. See the following sample JSON:

{
    "FileRequest": {
        "ObjectIdentifier": {
            "ArtifactID": 1234567
        },
        "field": {
            "ArtifactID": 5678912
        },
        "FileName": "SampleFile"
    }
}

The response contains the following fields:

• FileID - the file identifier. This value will always be 0 for any newly uploaded file.
• UploadedFileGuid - the GUID used to identify the uploaded file in temporary storage.
• Filename - the name of the file that you uploaded.

{
    "FileID": 0,
    "Filename": "SampleFile",
    "UploadedFileGuid": "d5e48d89-c21f-44da-b2f5-717ae0e107b8"
}

Downloading files from file fields

To download a file from a file field, use a URL with following general format:

<host>/Relativity.Rest/api/relativity-object-model/{versionNumber}/workspaces/{workspaceId}/files/download

Note: Set the {workspaceId} to -1 to indicate the admin-level context.

The request must include the following:

• FileRequest - contains the data required to download a file from a file field.
  • ObjectIdentifier - identifies the Relativity object, which contains the file being requested for download, by ArtifactID or GUID.
    • ArtifactID - the Artifact ID of the object.
  • Field - a reference to the field containing the file that you want to download.
    • ArtifactID - the Artifact ID of the field.

{
    "FileRequest": {
        "ObjectIdentifier": {
            "ArtifactID": 1234567
        },
        "Field": {
            "ArtifactID": 5678912
        }
    }
}

The response is a bit stream representing the file that you are downloading.