WITSML - Common Data Component Schema An identifier to indicate the data originator. This identifies the server that originally created the object and thus most of the uids in the object (but not necessarily the uids of the parents). This is typically a url. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" When the data was created at the persistent data store. constraints:@type="witsml:q_timestamp",xsd:pattern=".+" Last change of any element of the data at the persistent data store. The change time is not updated for a growing object while it is growing. constraints:@type="witsml:q_timestamp",xsd:pattern=".+" The item state for the data object. constraints:@type="witsml:q_ItemState",xsd:enumeration="actual",xsd:enumeration="model",xsd:enumeration="plan",xsd:enumeration="unknown",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" Comments and remarks. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" WITSML - Custom or User Defined Element and Attributes Component Schema. Specify custom element, attributes, and types in the custom data area. Any element or attribute in any namespace. It is strongly recommended that all custom data definitions be added to a unique namespace. A schema to capture a set of data that is relevant for many exchange documents. It includes information about the file that was created, and high-level information about the data that is being exchanged within the file. An identifier for the document. This is intended to be unique within the context of the NamingSystem. constraints:@minOccurs="1" Zero or more alternate names for the document. These names do not need to be unique within the naming system. The date of the creation of the document. This is not the same as the date that the file was created. For this date, the document is considered to be the set of information associated with this document information. For example, the document may be a seismic binset. This represents the date that the binset was created. The FileCreation information would capture the date that the XML file was created to send or exchange the binset. constraints:@type="witsml:q_timestamp",xsd:pattern=".+" A document class. Examples of classes would be a metadata classification or a set of keywords. The information about the creation of the exchange file. This is not about the creation of the data within the file, but the creation of the file itself. Information about the security to be applied to this file. More than one classification can be given. A free-form string that allows a disclaimer to accompany the information. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" A collection of events that can document the history of the data. The owner of the data. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" WITSML query parameters. An optional comment about the document. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" A structure for WITSML query parameters. The intent is to allow a query for all objects within an index range (whether or not the object is growing). These would typically be something like a daily report. The minimum start time for an object. This only applies to objects with a root level date and/or dateTime element(s). The objects may or not be growing objects but the See the API specification for behavior related to this query parameter. The maximum start time for an object. This only applies to objects with a root level date and/or dateTime element(s). See the API specification for behavior related to this query parameter. A block of information about the creation of the XML file. This is different than the creation of the data that is included within the file. The date and time that the file was created. constraints:@minOccurs="1",@type="witsml:q_timestamp",xsd:pattern=".+" If appropriate, the software that created the file. This is a free form string, and may include whatever information is deemed relevant. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" The person or business associate that created the file. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" Any comment that would be useful to further explain the creation of this instance document. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" Information about the security classification of the document. This is intended as a documentation of the security so that the file will not inadvertently be sent to someone who is not allowed access to the data. This block also carries a date that the security classification expires. For example, a well log is confidential for a period of time, and then becomes open. All security classes are characterized by their classification systems. The security class in which this document is classified. Examples would be confidential, partner confidential, tight. The meaning of the class is determined by the System in which it is defined. constraints:@type="witsml:q_kindString",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" The security classification system. This gives context to the meaning of the Class value. constraints:@type="witsml:q_kindString",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" The date on which this security class is no longer applicable. constraints:@type="witsml:q_timestamp",xsd:pattern=".+" A general comment to further define the security class. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" The audit records what happened to the data, to produce the data that is in this file. It consists of one or more events. constraints:@minOccurs="1" An event type captures the basic information about an event that has affected the data. The date on which the event took place. constraints:@minOccurs="1",@type="witsml:q_timestamp",xsd:pattern=".+" The party responsible for the event. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" A free form comment that can further define the event that occurred. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" A simple structure that allows an error report to be exchanged. The strucutre will allow for an error name, error id (generally a numerical code), and a description. A name of the error. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" A code, or other id, for the error. constraints:@type="witsml:q_kindString",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" A description of the error. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" The unique identifier of a container element. This attribute is generally required within the context of a WITSML server. There should be no assumption as to the semantic content of this attribute. This should only be used with recurring container types (i.e., maxOccurs greater than one). The value is only required to be unique within the context of the nearest recurring parent element. constraints:@type="witsml:q_uidString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" Captures information about one processed wellLog. The kind of processing used to create the new log. constraints:@minOccurs="1",@type="witsml:q_kindString",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" The resultant wellLog. constraints:@minOccurs="1" The wellLog which was the primary source for creating the derived log. A textual comment about the processing. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" The unique identifier of a container element. This attribute is generally required within the context of a WITSML server. There should be no assumption as to the semantic content of this attribute. This should only be used with recurring container types (i.e., maxOccurs greater than one). The value is only required to be unique within the context of the nearest recurring parent element. constraints:@type="witsml:q_uidString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" A set of points recorded during the installation process. The information can include the length along the fiber, the measured depth, and a type of point. The measured depth of the installed point of the fiber. This is optional, because the sender may want to record points that are outside the well. constraints:@type="witsml:q_measuredDepthCoord" The length along the fiber, from the zero point, for this particular point. constraints:@minOccurs="1",@type="witsml:q_lengthMeasure" The type of point that is being recorded. constraints:@type="witsml:q_InstalledFiberPoint",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" The unique identifier of a container element. This attribute is generally required within the context of a WITSML server. There should be no assumption as to the semantic content of this attribute. This should only be used with recurring container types (i.e., maxOccurs greater than one). The value is only required to be unique within the context of the nearest recurring parent element. constraints:@type="witsml:q_uidString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" Data that represents a foreign key to a wellbore. The wellbore may be defined within the context of another well. A pointer the wellbore with which there is a relationship. constraints:@minOccurs="1" A pointer to the well that contains the wellboreReference. This is not needed unless the referenced wellbore is outside the context of a common parent well. A reference to a rig within a wellbore. The wellbore may be defined within the context of another well. This value represents a foreign key from one node to another. A pointer to the rig with which there is a relationship. constraints:@minOccurs="1" A pointer to the wellbore that contains the rigReference. This is not needed unless the referenced rig is outside the context of a common parent wellbore. A pointer to the well that contains the wellboreParent. This is not needed unless the referenced wellbore is outside the context of a common parent well. Within the context of a WITSML Server, this data should duplicate the equivalent information in the well object. Name of the field in which the well is located. An alias name associated with the well. If the wellName is associated with a naming system then it should be included in this list. A datum to which elevations and depths are referenced. Defines the datums associated with elevation, vertical depth and measured depth coordinates within the context of a well. The human understandable contextual name of the reference datum. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" The code value that represents the type of reference datum. This may represent a point on a device (e.g., kelly bushing) or it may represent a vertical reference datum (e.g., mean sea level). constraints:@type="witsml:q_ElevCodeEnum",xsd:enumeration="CF",xsd:enumeration="CV",xsd:enumeration="DF",xsd:enumeration="GL",xsd:enumeration="KB",xsd:enumeration="RB",xsd:enumeration="RT",xsd:enumeration="SF",xsd:enumeration="LAT",xsd:enumeration="SL",xsd:enumeration="MHHW",xsd:enumeration="MHW",xsd:enumeration="MLLW",xsd:enumeration="MLW",xsd:enumeration="MTL",xsd:enumeration="KO",xsd:enumeration="unknown",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" The name of the vertical reference datum in a particular naming system. This should only be specified if the above 'code' represents some variation of sea level. An optional short name (code) can also be specified. Specifying a well known datum is highly desired if the above code is a variant of sea level because sea level varies over time and space. An example would be to specify a name of 'Caspian Sea' with a code of '5106' in the 'EPSG' naming system. Since various activities may use different points as measurement datums, it is useful to characterize the point based on its usage. A well reference datum may have more than one such characterization. For example, it may be the datum used by the driller and logger for measuring their depths. Example usage values would be 'permanent','driller', 'logger' 'WRP' (well reference point) and 'SRP' (site reference point). constraints:@type="witsml:q_kindString",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" A pointer to the wellbore that contains the reference datum. This should be specified if a measured depth is given. A pointer to the rig that contains the device used as a reference datum. The rig may be associated with a wellbore in another well (e.g., pattern drilling using a rig on a track). The gravity based elevation coordinate of this reference datum as measured from another datum. Positive moving upward from the elevation datum. An elevation should be given unless this is a vertical reference datum (e.g., sea level). constraints:@type="witsml:q_wellElevationCoord" The measured depth coordinate of this reference datum as measured from another datum. The measured depth datum should either be the same as the elevation datum or it should be relatable to the elevation datum through other datums. Positive moving toward the bottomhole from the measured depth datum. This should be given when a local reference is "downhole", such as a kickoff point or ocean bottom template, and the borehole may not be vertical. If a Depth is given then an Elevation should also be given. constraints:@type="witsml:q_measuredDepthCoord" A contextual description of the well reference datum. constraints:@type="witsml:q_commentString",xsd:maxLength="4000",xsd:whiteSpace="collapse",xsd:minLength="1" True indicates that this is the default reference datum for measured depth coordinates. False or not given indicates that this is not the default reference datum. Measured depth coordinates that do not specify a datum reference should be assumed to be measured relative to this default reference datum. Only one reference datum may be designated as the default measured depth datum for each well. Values are "true" (or "1") and "false" ( or "0"). constraints:@type="witsml:q_logicalBoolean",xsd:pattern=".+" True indicates that this is the default reference datum for vertical depth coordinates. False or not given indicates that this is not the default reference datum. Vertical depth coordinates that do not specify a datum reference should be assumed to be measured relative to the default reference datum. Only one reference datum may be designated as the default vertical depth datum for each well. Values are "true" (or "1") and "false" ( or "0"). constraints:@type="witsml:q_logicalBoolean",xsd:pattern=".+" True indicates that this is the default reference datum for elevation coordinates. False or not given indicates that this is not the default reference datum. Elevation coordinates that do not specify a datum reference should be assumed to be measured relative to the default reference datum. Only one reference datum may be designated as the default elevation datum for each well. Values are "true" (or "1") and "false" ( or "0"). constraints:@type="witsml:q_logicalBoolean",xsd:pattern=".+" The unique identifier of a container element. This attribute is generally required within the context of a WITSML server. There should be no assumption as to the semantic content of this attribute. This should only be used with recurring container types (i.e., maxOccurs greater than one). The value is only required to be unique within the context of the nearest recurring parent element. constraints:@type="witsml:q_uidString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" The WITSML API mandated plural root element which allows multiple singular objects to be sent. The plural name is formed by adding an "s" to the singular name. Information about the XML message instance. Main wrapper for all the distributed temperature survey information about the measurement. Note that this object must be accompanied by a wellLog object in order to be complete. constraints:@minOccurs="1" Data object schema version. The fourth level must match the version of the schema constraints (enumerations and XML loader files) that are assumed by the document instance. constraints:@use="required",@type="witsml:q_schemaVersionString",xsd:maxLength="16",xsd:pattern="1\.0\.0\.[1-9]?[0-9]\(PRODML\)",xsd:whiteSpace="collapse",xsd:minLength="1" The measurements of a DTS run are carried primarily in the wellLog object. The elements in this object are additional, defined parameters that are needed to capture the context of the DTS measurement. Human recognizable context for the well that contains the wellbore. constraints:@minOccurs="1",@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" Human recognizable context for the wellbore that contains the dts. constraints:@minOccurs="1",@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" Human recognizable context for the dts. constraints:@minOccurs="1",@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" The minimum time index contained within the object. The minimum and maximum indexes are server query parameters and will be populated with valid values in a "get" result. That is, all measurements for a well in the specified period defined by the min/max. See the WITSML API Specification appendix on "Special Handling" of growing objects for a description of the behavior related to this parameter. The maximum time index contained within the object. The minimum and maximum indexes are server query parameters and will be populated with valid values in a "get" result. See the WITSML API Specification appendix on "Special Handling" of growing objects for a description of the behavior related to this parameter. The definition of the "current time" index for this object. The current time index is a server query parameter which requests the selection of a single node from a recurring set (e.g., the data related to one point in a time series). That is, the "most recent" (at or before the specified time) measurement for a well. See the WITSML API Specification appendix on "Special Handling" of growing objects for a description of the behavior related to this parameter. constraints:@type="witsml:q_timestamp",xsd:pattern=".+" Contextual data about the well that was tested. The date and time associated with the measurement. This will normally be the start of the run. constraints:@type="witsml:q_timestamp",xsd:pattern=".+" The length of time that the instrument box was operating while collecting DTS data. constraints:@type="witsml:q_timeMeasure" A reference to the installed system that was used to make the measurements. constraints:@minOccurs="1" A reference to the well log used to record the table of data. constraints:@minOccurs="1" A reference to the fiber used to record the table of data. This is necessary only in the cases in which a dtsInstalledSystem has a multi-fiber installation. If there is only a single installed fiber, this element is unnecessary. A pointer to the fiber connection node. If more than one node is available for a well/wellbore, this element is used to specify which node is connected to the instrument box. This name should correspond to the fiberEndPoint/name that is recorded in the installed system object. A known point of the fiber. This point should correspond to one that is given in the wellboreFiberSchematic, so that the relationship between the length of fiber values in the wellboreFiberSchematic can be related to the values in the measurement table. An error that occurred during the measurement. A reference to a processed wellLog that represents this measurement. A container element that contains elements that are common to all data objects. A container element that can contain custom or user defined data elements. Unique identifier for the well. This uniquely represents the well referenced by the (possibly non-unique) nameWell. constraints:@type="witsml:q_uidString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" Unique identifier for the wellbore. This uniquely represents the wellbore referenced by the (possibly non-unique) nameWellbore. constraints:@type="witsml:q_uidString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" The unique identifier of a container element. This attribute is generally required within the context of a WITSML server. There should be no assumption as to the semantic content of this attribute. This should only be used with recurring container types (i.e., maxOccurs greater than one). The value is only required to be unique within the context of the nearest recurring parent element. constraints:@type="witsml:q_uidString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" The intended abstract supertype of all singular data objects. A timestamp value used for min/max query parameters related to "growing objects". The meaning of the endpoint of an interval can be modified by the endpoint attribute. constraints:@base="witsml:abstractDateTime",xsd:pattern=".+" The element value for which a match is requested. The default is "inclusive". constraints:@type="witsml:q_EndpointQualifier",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" A reference to a name in another node of the xml hierachy. This value represents a foreign key from one element to another. constraints:@base="witsml:abstractNameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" The element value for which a match is requested. A reference to the unique identifier (uid attribute) in the node referenced by the name value. This attribute is required within the context of a WITSML server. constraints:@type="witsml:q_refString",xsd:maxLength="64",xsd:pattern="[^ ]*",xsd:whiteSpace="collapse",xsd:minLength="1" The name of something within a naming system. constraints:@base="witsml:abstractNameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" The element value for which a match is requested. The naming system within the name is (hopefully) unique. constraints:@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" The name of something within a mandatory naming system with an optional code. constraints:@base="witsml:abstractNameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" The element value for which a match is requested. The naming system within the name is unique. constraints:@use="required",@type="witsml:q_nameString",xsd:maxLength="64",xsd:whiteSpace="collapse",xsd:minLength="1" A unique (short) code associated with the name. constraints:@type="witsml:q_kindString",xsd:maxLength="40",xsd:whiteSpace="collapse",xsd:minLength="1" The element value for which a match is requested. The element value for which a match is requested. The unit of measure for the value. The element value for which a match is requested. The unit of measure for the value. The datum of the coordinate value. The element value for which a match is requested.