This article provides extra resources about field types and field mapping, which is performed in Step III of the Production Uploads popup. See Production Uploads for instructions on filling out the popup and navigating the UI.
Minimum load file requirements
Logikcull has minimum file field requirements in order to successfully validate a set of load files. The below fields are recommended for load file validation:
Field(s) | Reason |
|---|---|
Begin Doc/Begin Bates | Beginning bates or document identifier number for each record. |
Begin Family + End Family or Begin Attachment + End Attachment | Needed if linking families (i.e. emails and their associated attachments). The family fields cannot be overlaid, so we recommend requesting these in the original load file. |
File Name | File name that includes the file extension (i.e. document.msg). |
Native File Link | Needed if importing native records. |
Text File Link | Needed if importing OCR text/text files. |
Time fields | If you have a time field in your load file, a corresponding date field is required. For example, for "File Time Created" to be mapped, there must be a corresponding field available for "File Date Created". |
Custodian field | Lists who is associated with with the document. The custodian field cannot be overlaid so we recommend requesting this field in the original load file. |
Logikcull field mapping matrix and definitions
The below table lists all default fields in Logikcull, descriptions of each field, and the category the field belongs to.
Field | Description | Category |
|---|---|---|
Beg Bates | The beginning control number of a document, i.e., the Bates number of the first page. | Control Numbers |
End Bates | The ending control number of a document, i.e., the Bates number of the last page. | Control Numbers |
Family ID* | The control number that identifies members of a document family. This is the Begin Bates of the family's parent document. | Control Numbers |
Begin Family | The beginning control number of a document family, i.e., the Bates number of the first page of the first document in the family. | Control Numbers |
End Family | The ending control number of a document family, i.e., the Bates number of the last page of the last document in the family. | Control Numbers |
Begin Attach | The beginning control number of a document's attachments, i.e., the Bates number of the first page of the first attachment in the family. | Control Numbers |
End Attach | The ending control number of a document's attachments, i.e., the Bates number of the last page of the last attachment in the family. | Control Numbers |
Thread ID† | The thread id of an email or file. | Control Numbers |
Custodian | The document's custodian. You can map up to 50 custodians per upload. | Special Fields |
Native File Link | A link to a copy of the original file. | Special Fields |
Text File Link | A link to the extracted text file. | Special Fields |
Image File Link | A link to the rendered image file. | Special Fields |
Email From | The original author of the email. | Email Metadata |
Email To | The intended recipients of the email. | Email Metadata |
Email CC | The carbon copied recipients of the email. | Email Metadata |
Email BCC | The blind carbon copied recipients of the email. | Email Metadata |
Email Subject | The email subject line. | Email Metadata |
Email Date Sent | The date the email was sent. | Email Metadata |
Email Time Sent | The time the email was sent. | Email Metadata |
Email Date Received | The date the email was received. | Email Metadata |
Email Time Received | The time the email was received. | Email Metadata |
File Name | The document's original name in the file system. | File Metadata |
File Path | The document's original location in the file system; a breadcrumb. | File Metadata |
Full Text | The full extracted text or OCR of the document. | File Metadata |
Document Date | The date of the individual document. | File Metadata |
File Size | The original file size, in bytes, of the document. | File Metadata |
Custom Tags | Custom tags delimited by commas. | File Metadata |
File Author | An Office metadata tag, shows the name of the author for the document. | File Metadata |
File Last Saved By | An Office metadata tag, shows person name that last saved the document. | File Metadata |
File Company | An Office metadata tag, shows company name. | File Metadata |
File Keywords | An Office metadata tag, shows various keywords applied to document. Not from search. | File Metadata |
File Title | An Office metadata tag, shows the title name of the document. | File Metadata |
File Comments | An Office metadata tag, shows comments in the document. | File Metadata |
File Subject | An Office metadata tag, shows the subject of the document. | File Metadata |
File Revision Number | An Office metadata tag, shows number of revisions in document. | File Metadata |
File Date Created | An Office metadata tag, shows the date the document was created. | File Metadata |
File Time Created | An Office metadata tag, shows the time the document was created. | File Metadata |
File Date Last Modified | An Office metadata tag, shows the date the document was last modified. | File Metadata |
File Time Last Modified | An Office metadata tag, shows the time the document was last modified. | File Metadata |
*See the Note on Family ID and Parent ID fields section.
†See the Note on the Thread ID field section.
Note on Family ID and Parent ID fields
If Logikcull returns an error after you’ve mapped your fields and the message references Family ID or Parent ID, follow these steps to troubleshoot:
Check your Begin Family and End Family mappings.
Ensure these fields are correctly mapped to the appropriate values in your load file.
Review Family ID and Parent ID mappings. If Begin Family and End Family are mapped correctly, verify whether Family ID or Parent ID are also mapped.
In most standard production imports, these fields do not need to be mapped because Begin Family and End Family already define the family relationships.
Try unmapping Family ID and/or Parent ID and reattempt the upload.
Check for unsupported characters.
If the error persists, review your Family ID or Parent ID values for any non-supported characters (such as special symbols or inconsistent formats). Removing or cleaning these values before import can often resolve the issue.
Note on the Thread ID field
Thread ID mapping in an eDiscovery load file is the process of tagging related messages with the same identifier so entire conversations stay grouped during review.
This ensures email reply chains and mobile messages (like those from RSMF files) are displayed together in the correct order, giving reviewers full context instead of isolated messages. It also speeds up review, reduces confusion, and makes conversations easier to understand.
Be sure to map the correct Thread ID field. Some load files include multiple, similarly named fields and using the wrong one can break conversation grouping. If you’re unsure, contact support@revealdata.com.
Field mapping guide
The table below provides guidance for mapping some of the less intuitive field names so that metadata and file locations can be correctly communicated to Logikcull.
Common Load File Field Names | Logikcull Field |
|---|---|
BegBates | Begin Bates |
BEGDOC | Begin Bates |
BeginBates | Begin Bates |
BEGDOC# | Begin Bates |
FIRSTBATES | Begin Bates |
Begno | Begin Bates |
BATES START | Begin Bates |
BEGINDOC | Begin Bates |
EndBates | End Bates |
ENDDOC | End Bates |
ENDDOC# | End Bates |
LASTBATES | End Bates |
Endno | End Bates |
BATES END | End Bates |
BegAttach | Begin Family |
BEGATT | Begin Family |
BeginAttachmentBates | Begin Family |
ATTACH_START | Begin Family |
EndAttach | End Family |
ENDATT | End Family |
EndAttachmentBates | End Family |
ATTACH_END | End Family |
PAGES | Page Count |
PageCount | Page Count |
NUMPAGES | Page Count |
PGCOUNT | Page Count |
PAGECNT | Page Count |
FILEPATH | File Path |
OriginalFilepath | File Path |
PATH | File Path |
FPATHNAME | File Path |
NativeLink | Native File Link |
ORIGINALSPATH | Native File Link |
FILE_PATH | Native File Link |
NativePath | Native File Link |
LINK | Native File Link |
NativeFile | Native File Link |
NATIVE_DIR | Native File Link |
FILELINK | Native File Link |
XSPATHNAME | Native File Link |
TEXTPATH | Text File Link |
OCRPath | Text File Link |
TEXT_DIR | Text File Link |
TEXT PRECEDENCE | Text File Link |
Custodians | Custodian |
Group Identifier | Family ID |
GROUP_ID | Family ID |
Conversation ID | Thread ID |
ModeOne Conversation ID | Thread ID |
THREAD_ID | Thread ID |