To use the Short Message Viewer, you will need to create an RSMF file and Relativity 10.3 or above. RSMF is an agnostic chat platform data format which means that as long as a platform's functionality contains messaging capabilities, it will likely be supported in RSMF. At the beginning of 2021, over 40 different chat platforms’ data have been transformed and reviewed in RSMF. Examples of chat data that have been supported in RSMF include, but are not limited to: Slack, Microsoft Teams, Text messages (MMS, SMS, iMessage, Whatsapp), Google Chat, Bloomberg Chat, Instagram, and more.
There are two methods you can use to create an RSMF file. Each method and some resources that provide additional information are provided below.
- To build an RSMF file, use the following developer resources.
Don’t have a development resource, or a source that exports RSMF? Find partners that offer tailored conversion to RSMF.
In addition to being RFC 5322 compliant, an RSMF file must meet the following conditions before you can bring it into Relativity using Processing:
- It must have a .rsmf extension.
- It must have an <X-RSMF-Version> header field that defines the version of the RSMF spec that the file conforms to.
- It must have exactly one attachment with a Content-Transfer-Encoding header type of base64 (RFC 2045) and a Content-Disposition header of type attachment with a parameter filename equal to "rsmf.zip" (RFC 6266). See the rsmf.zip section for more details.
Relativity Short Message Format also supports a number of optional headers that provide roll-up of short message data contained within the file. Here are all the supported headers:
|X-RSMF-Version||Yes||The version of the RSMF specification that the file adheres to.|
|X-RSMF-Generator||No||Identifies the author of the RSMF file.|
|X-RSMF-BeginDate||No||The timestamp (ISO8601) of the earliest short message event within the file.|
|X-RSMF-EndDate||No||The timestamp (ISO8601) of the latest short message event within the file.|
|X-RSMF-EventCount||No||The number of short message events captured within the file.|
To learn more about which fields are processed and mapped into Relativity, visit Processing an RSMF file.
Before you begin the file creation process, the following resources may be useful to reference:
- Relativity has developed an RSMF library which allows you to optionally validate RSMF files and ensure they will work in Relativity before ingestion. This library is available via nuget. Documentation for the library is part of the nuget package.
- Relativity has also provided sample code demonstrating how to use the library. This code can be found by visiting the Relativity Validator Library GitHub page. The schema for rsmf_manifest.json file is also located in this repository. A tool such as Newtonsoft JSON can be used to generate the rsmf_manifest.json file.
To create an RSMF file, perform the following steps:
- Retrieve short message data from its source. For instance, you can use a mobile collection solution to extract data from a mobile device or an API to retrieve data from a messaging platform.
Group by participants and timeframes in the data.
Note: We recommend that an RSMF file should have no more than 10,000 events to ensure high performance in Relativity.
- The most common way we recommend you generate RSMF files is to first group messages by like participants, then group those messages by time period. You will then be able to review one conversation in standard time periods.
- For example, if you have a conversation between two participants over two years and the volume of messages is somewhat low, we recommend grouping all of those messages together, then creating RSMF files each grouped by day. While also respecting the 10,000 message recommended cap per RSMF file.
Add text to the Body of the RSMF file. Relativity Processing will extract the Body and automatically map it to the Extracted Text field when you publish.
Add one participant to the FROM header of the RSMF file. Relativity Processing will extract the data and make it available to map when you publish. This is a requirement if you want to run name normalization against the RSMF file.
Optionally, if you include information in the Body section of the RSMF file, this will display in the Extracted Text mode of the Short Message Viewer.
Once the RSMF file has been created, you can then import it into Relativity and ingest it into your workspace through Relativity Processing. To learn more, visit Processing an RSMF file.
Relativity provides a validation tool that you can use to validate the RSMF file before importing it into Relativity. To learn more about the validation tool, visit Validation library and rsmf_manifest.json schema availability.