6.2 PutObject
Topic Version | 1 | Published | 10/16/2017 | |
For Standard | ETPW20 v1 |
To add/update a single data object in a store, send a PutObject message.
The Resource object’s content type and UUID properties are critical in identifying the format and type of data object specified in the data property. Do not use the URI to determine any relationships or data object hierarchy. Any data object references must be contained within the data object itself.
For more information about properties and URIs, see:
- ETP Specification (Store Protocol (P4))
- Energistics Identifier Specification (Chapter 5 and Chapter 6)
The examples below use the following properties.
Property Name |
Example |
---|---|
uri |
eml://witsml20/Trajectory(0655e8cd-b590-4f89-9b30-2a897db562ec) |
uuid |
0655e8cd-b590-4f89-9b30-2a897db562ec |
name |
Plan #2 |
contentType |
application/x-witsml+xml;version=2.0;type=Trajectory |
Data object XML:
<Trajectory xmlns="http://www.energistics.org/energyml/data/witsmlv2" xmlns:eml="http://www.energistics.org/energyml/data/commonv2" uuid="0655e8cd-b590-4f89-9b30-2a897db562ec" schemaVersion="2.0">
<eml:Citation>
<eml:Title>Plan #2</eml:Title>
<eml:Originator>PDS</eml:Originator>
<eml:Format>PDS.WITSMLstudio.Desktop, Version=2017.1.0.0</eml:Format>
</eml:Citation>
<DTimTrajStart>2001-10-31T08:15:00.0000000+00:00</DTimTrajStart>
<DTimTrajEnd>2001-11-03T16:30:00.0000000+00:00</DTimTrajEnd>
<ServiceCompany>Anadrill</ServiceCompany>
<MagDeclUsed uom="dega">-4.038</MagDeclUsed>
<AziVertSect uom="dega">82.7</AziVertSect>
<DispNsVertSectOrig uom="ft">0</DispNsVertSectOrig>
<DispEwVertSectOrig uom="ft">0</DispEwVertSectOrig>
<Definitive>true</Definitive>
<Memory>true</Memory>
<FinalTraj>true</FinalTraj>
<AziRef>grid north</AziRef>
<Wellbore>
<eml:ContentType>application/x-witsml+xml;version=2.0;type=Wellbore</eml:ContentType>
<eml:Title>A-42</eml:Title>
<eml:Uuid>d7cb2b2b-b0c1-48d6-9d8b-5253f4507beb</eml:Uuid>
<eml:UuidAuthority>B-01</eml:UuidAuthority>
</Wellbore>
</Trajectory>
Example PutObject message followed by the Acknowledge message reply
// [5c7c2f28-4332-4c0f-acf5-a14aad678f3a] Message sent at 2017-04-18 20:32:21.5683{
"protocol":4,
"messageType":2,
"correlationId":0,
"messageId":3,
"messageFlags":0}{
"dataObject": {
"resource": {
"uri": "eml://witsml20/Trajectory(0655e8cd-b590-4f89-9b30-2a897db562ec)",
"contentType": "application/x-witsml+xml;version=2.0;type=Trajectory",
"name": "Plan #2",
"channelSubscribable": false,
"customData": {},
"resourceType": "DataObject",
"hasChildren": -1,
"uuid": "0655e8cd-b590-4f89-9b30-2a897db562ec",
"lastChanged": 0,
"objectNotifiable": false },
"contentEncoding": "gzip",
"data": [ binary data truncated for readability ] }}// [5c7c2f28-4332-4c0f-acf5-a14aad678f3a] Message received at 2017-04-18 20:32:22.4184{
"protocol":4,
"messageType":1001,
"correlationId":3,
"messageId":6,
"messageFlags":0}{}