RSMF Slicing

This feature allows you to select events in a conversation and "slice" them to create a new document that contains the selected events which can then be imaged and produced like any other document in Relativity. Slicing reduces the need to apply markups to short message conversations and lets you tailor the content of short message documents to your needs.

Once a document has been sliced, it is also easy to track and manage them. When viewing a sliced document in the Short Message Viewer, a banner appears above the document to identify that it is sliced. You can quickly navigate to the original document by clicking on the document's name in the banner.

This page contains the following:

See these related pages:

Slicing permissions

The following permissions are needed to use RSMF Slicing:

Object Security Tab Visibility Other Settings
  • Document - View, Add

  • Documents

  • Admin Operations: Allow Import

Slicing an RSMF document

To slice a document with Relativity Short Message Format data, do the following:

  1. Optionally, click on the Filter icon and filter the document as needed to quickly locate the events you wish to include in the sliced document. As you apply filters, any events that do meet your currently selected filter options will be grayed out. These events cannot be selected for the sliced document unless you remove the filter(s).

  2. Check the box to the left of any events you want to include in the sliced document. Alternatively, to select all events that are not currently filtered out, click Select all filtered events in the Filter card.

    Note: If you select a reply, the parent message will also be included in the new sliced document.

  3. Click Save as new document in the bottom-right.

  4. Enable or disable the following fields as desired:

    • Email confirmation - If enabled, a user will receive an email when the new document has been sliced.

    • Copy Layout data - If enabled, select the desired layout from the drop-down menu to make that the default layout in the new sliced document. Any coding decisions that have been saved using that layout will be carried over to the sliced document.

    • Preserve all participants - If enabled, each participant from the original conversation will be in the metadata of the sliced document, regardless if they were active or not. If disabled, only the participants whose events are selected will be included in the sliced document.

  5. Click Save as new document.

    A new, sliced document is created with Control Number of the original document appended with "_sliceXXX" added to the name to differentiate it from the original document. When you open a sliced document in the Viewer, a banner with a link to the original document displays.
    (Click to expand)

A sliced document will have the following fields populated when the sliced RSMF file is brought back into Relativity, along with the default document fields populated via the Import API. Note that attachments within the created slice will be populated with default document metadata via the Import API, along with available file size, file name, and extension.

If users would like to have more fields populated on the new RSMF file upon slicing, they should ensure those fields are on a coding layout, and when creating the slice, the Copy Layout data option is selected. For example, the ‘Custodian’ field is populated on the RSMF file. To bring that field and value over to the new slice, it must be on the coding layout, and that layout must be copied when creating the slice. Otherwise, that field and value will not appear on the new slice.

RSMF EML Header Mapped Fields (if available) Definition Explanation
  • RSMF/Begin Date

  • RSMF Begin Date

  • Sent Date

  • Sent Date/Time

Populated with the date of the earliest event in the slice. This is reflected in ‘X-RSMF-BeginDate’ in the EML header of the RSMF file.
  • RSMF/EndDate

  • RSMF End Date

  • Last Modified

  • Last Modified Date

  • Last Modified Date/Time

Populated with the date of the latest event in the slice. This is reflected in ‘X-RSMF-EndDate’ in the EML header of the RSMF file.
  • RSMF/MessageCount

  • RSMF Message Count

  • Populated with the EML header information within the RSMF file. Slicing updates the following fields within the EML header: 
    • X-RSMF-BeginDate
    • X-RSMF-EndDate
    • X-RSMF-EventCount
    • X-RSMF-Version
    • The following X-RSMF- fields in the EML header are brought over from the original RSMF file and are not updated:

      • X-RSMF-Application

      • X-RSMF-Custodian

      • X-RSMF-Event-Collection-ID

  • Email To

  • Email From

  • Message Header

Populated with a list of participants in the ‘To’ field of the EML header. If you select Preserve All Participants before slicing, this field may remain unchanged from the original slice, based on participants whose events were selected in the slice.
Document Field Definition Explanation
Group Identifier Populated with Control Number of the sliced document, much like it is for regular RSMF documents.
Control Number Populated with the original RSMF document's Control Number but with the appended “_sliceXXX”. If the original RSMF document has attachments in the slice, the attachments will be named similarly to the sliced document, except they will have an additional "_XXX" appended to their name.
Relativity SliceID Populated with the ArtifactID of the original RSMF document.
Relativity Slice Origin ID

Note: The Relativity Slice Origin ID relational field is released in the Review RAP You can access this new field by upgrading your Review RAP to version Otherwise, you will be able access this field when the Review RAP is automatically upgraded in March 2022.

This relational field is populated with the Artifact ID of the original RSMF file when a slice is created. Relativity Slice Origin ID helps users see all slices that were generated from a single RSMF file.

If a slice is created from an existing slice, the new slice has the Artifact ID of the original RSMF file processed into Relativity. Users can open a relational view in the Short Message Viewer that displays all slices created from an RSMF file.

RSMF slicing filters

The Short Message Viewer has the following filtering options available:

  • Filter - displays or hides a panel containing all filters. Short Message Filtering allows users to quickly locate and investigate messages leveraging the following data dimensions: conversations, participants, events, and dates. See the table below for more information on what data is pulled in from the RSMF file to populate these filters’ values. For more info on the RSMF file format, visit Relativity short message format.

    Filter Category Data from RSMF File

    In the ‘conversations’ dictionary, there is a field called “display”, that relates to “id”, and is used to populate the conversations filter.

    Participants In the ‘participants’ dictionary, there is a field called “display”, that relates to “id”, is used to populate the participants filter.

    In the ‘events’ dictionary, there is a field called “type”, which is used to populate the events filter.

    • For RSMF 2.0, event types include: message, join, leave, disclaimer, history.

    • For RSMF 1.0, event types include: message, join, leave, disclaimer.

    Dates In the ‘events’ dictionary, there is a field called “timestamp”, the date filter uses to focus on messages in a certain timeframe.

    If a filter is selected and the Show filtered out events option is disabled, the Viewer will only display messages that meet the criteria. If a filter is selected and the Show filtered out events option is enabled, each message that does not meet the criteria will display but is grayed out to distinguish it from the messages that do meet the current filter options.

    When filtering is applied to the conversation, all message activity bars that do not meet the filter criteria will be grayed out in the Timeline Navigator.

    If multiple filters are selected within a specific filter category, OR logic is applied to those criteria. When making selections across multiple filter categories, AND logic will be applied. In other words, all selections within a filter category are additive to your results due to the OR logic, and selections across filter categories are subtractive to your results due to the AND logic.

    Optionally, you can keep the Event Types and Time Range fields set as you navigate from document-to-document in the Short Message Viewer. After selecting an option in either section, click on the Lock term icon to keep that option set for the rest of this session or until you click on the Lock term icon again. If you lock options and no messages meet your filters, No events are visible under the current filter settings. displays.

    The Short Message Viewer displays with the Filters card expanded. The user toggles various options to show how filtering messages controls what displays in the Viewer.

RSMF slicing audits

On the original RSMF document, an ‘Update’ audit will be added that captures the following information below.

On the newly created sliced document, a ‘Create’ audit will be added that captures the following information below. By default, there will be a ‘Native – Created’ audit, and two ‘Create’ audits, each of which will show the user name ‘Service Account Relativity’ in the Document History section. Expanding the most recent ‘Create’ audit will show the actual user who created the slice, along with the below information:

  • SourceLayoutID

  • ParentDocumentID

  • SliceDocumentID

  • UserEmail

  • UserID

  • CreatedDateTime

  • SelectedIndexes

  • CreateAttachments

  • PreserveAllParticipants

  • WorkspaceID