Sample ID Builder

<< Click to Display Table of Contents >>

Navigation:  EDGE > Configuration > Configuration Plugin Tool >

Sample ID Builder

In the EDGE-enum.xml file, there are five sections that control the automated Sample ID (SYS_SAMPLE_CODE) builder. By moving one of the enumeration values to the top of the list, you can control each of several functions of the Sample ID builder.

 

The sections in the default EDGE-enum.xml file will look like the following. Use the EDGE ConfigurationPlugin tool in the Plugins section to move values to the top of the list.

 

25113-ConfigTool

 

Below is a detailed description of each section.

 

<xs:simpleType name="sampleid_spm">

   <xs:restriction base="xs:string">

     <xs:maxLength value="10" />

     <xs:enumeration value="ADHOC_ONLY" />

     <xs:enumeration value="DISABLE" />

     <xs:enumeration value="REPLACE" />

   </xs:restriction>

 </xs:simpleType>

 <xs:simpleType name="sampleid_separator">

   <xs:restriction base="xs:string">

     <xs:maxLength value="10" />

     <xs:enumeration value="UNDERSCORE" />

     <xs:enumeration value="DASH" />

     <xs:enumeration value="PERIOD" />

     <xs:enumeration value="NOTHING" />

   </xs:restriction>

 </xs:simpleType>

 <xs:simpleType name="sampleid_date_format">

   <xs:restriction base="xs:string">

     <xs:maxLength value="15" />

     <xs:enumeration value="yyyyMMdd" />

     <xs:enumeration value="yyyyMMddHHmm" />

     <xs:enumeration value="MMddyy" />

     <xs:enumeration value="MMddyyHHmm" />

     <xs:enumeration value="ddMMyy" />

     <xs:enumeration value="ddMMyyHHmm" />

   </xs:restriction>

 </xs:simpleType>

 <xs:simpleType name="sampleid_date_to_end">

   <xs:restriction base="xs:string">

     <xs:maxLength value="10" />

     <xs:enumeration value="DATE_TO_END" />

     <xs:enumeration value="DONT_MOVE_DATE" />

   </xs:restriction>

 </xs:simpleType>

 <xs:simpleType name="sampleid_schema">

   <xs:restriction base="xs:string">

     <xs:maxLength value="100" />

     <xs:enumeration value="EDGE_LocDateMatrixDepth_Type2" />

     <xs:enumeration value="EDGE_LocDateMatrixDepth_Type" />

     <xs:enumeration value="EDGE_Loc" />

     <xs:enumeration value="EDGE_LocDate" />

     <xs:enumeration value="EDGE_LocDateDepth" />

     <xs:enumeration value="EDGE_LocDateMatrixDepth" />

     <xs:enumeration value="EDGE_LocMatrixDateType" />

     <xs:enumeration value="Edge_FacLocMatrixDateDepth" />

     <xs:enumeration value="EDGE_ifMatrixSO_LocCountSDepthEDepth" />

     <xs:enumeration value="EDGE_LocSDepthEDepthDate" />

     <xs:enumeration value="EDGE_FacLocDate" />

     <xs:enumeration value="EDGE_CustomSampleCode" />

     <xs:enumeration value="None" />

   </xs:restriction>

 </xs:simpleType>

 

Detailed Descriptions:

 

SAMPLEID_SPM – This section controls how the Sample ID builder interacts with SPM rows.

 

ADHOC_ONLY – The Sample ID builder will only run on non-SPM samples.

DISABLE – This value will turn off the Sample ID builder for all samples.

REPLACE – This value will activate the builder for all samples and replace existing SPM sample IDs.

 

SAMPLEID_SEPARATOR – This section controls which separator is inserted between the values in the Sample ID.

 

UNDERSCORE – Example: MW-01_WG_20120529

DASH – Example: MW-01-WG-20120529

PERIOD – Example: MW-01.WG.20120529

NONE – Example: MW-01WG20120529

 

SAMPLEID_DATE_FORMAT – This section controls the format of the date in the Sample ID.

 

yyyyMMdd – Example: MW-01_WG_20120529

yyyyMMddHHmm – Example: MW-01_WG_201205291459

MMddyy – Example: MW-01_WG_052912

and more...

 

SAMPLEID_DATE_TO_END – This section controls the placement of the date value in the Sample ID.

 

DATE_TO_END – Date is moved to the end of the Sample ID.

Examples for EDGE_LocDateMatrixDepth:  

MW-01_WG_20120529

SB-01_SO_1.5_20120529

DONT_MOVE_DATE – If this value is at the top, the date is not moved to the end.

Examples for EDGE_LocDateMatrixDepth:  

MW-01_20120529_WG

SB-01_20120529_SO_1.5

 

SAMPLEID_SCHEMA – This section controls the overall schema of the Sample ID.

 

Note: The currently available SAMPLEID_SCHEMA enumerations were intentionally designed to obscure parent sample visibility in the lab setting, as blind duplicates and replicates can be critical components for ensuring analysis integrity. For example, the "EDGE_LocDateMatrixDepth_Type" and "EDGE_FacLocMatrixDateDepth" options both have code which varies the Sample ID, depending on the value in the SAMPLE_TYPE field. An incremental number is appended to the Sample ID to accommodate multiple FD and FR sample types taken on the same day at any number of locations.

 

When the Parent Sample Code field in EDGE is used to reference the parent sample, the parent-child relationship is inherently stored in the EDD and the database.

 

EDGE_LocDateMatrixDepth_Type – Examples for EDGE_LocDateMatrixDepth_Type:  

Type = "N"

MW-01_WG_20120529

SB-01_SO_1.5_20120529

Type = "FB" or "TB"

FB_WG_20120529

TB_WG_20120529

Type = "FD" or "FR"

WG_20120529_FD_01

WG_20120529_FR_02

EDGE_FacLocMatrixDateDepth – Examples for EDGE_FacLocMatrixDateDepth (where enumeration sampleid_date_to_end = DATE_TO_END):  

Type = "N"

Springfield_MW-01_WG_20180529

Springfield_SB-01_SO_20180529_1.5-2.0

Type = "FB" or "TB"

Springfield_FB_WG_20180529

Springfield_TB_WG_20180529

Type = "FD" or "FR"

Springfield_WG_20180529_1

Springfield_WG_20180529_2

EDGE_LocDate – Examples for EDGE_LocDate:  

MW-01_20120529

SB-01_20120529

EDGE_LocDateDepth – Examples for EDGE_LocDateDepth:  

MW-01_20120529

SB-01_1.5_20120529

EDGE_LocDateMatrixDepth – Examples for EDGE_LocDateMatrixDepth:  

MW-01_WG_20120529

SB-01_SO_1.5_20120529

EDGE_FacLocDateType – Expected sys_sample_code = "Facility-Location-Date-Type-Number". The number is an integer used to avoid duplicate SYS_SAMPLE_CODES.

Springfield-B-31-20190513-N-2 (the second sample)

Springfield-20190513-FD-1 (the first QC sample)

EDGE_CustomSampleCode – Used to enable custom sample IDs to be implemented.