6.2 PutObject

Topic Version1Published10/16/2017
For StandardETPW20 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}{}