Post Data operation for the Airwatch adapter

The Post Data operation sends data to a specified URL. 

The following table describes the input elements for the Post Data operation.

Adapter request elements for the Post Data operation

ElementDefinitionRequired
<adapter-name>

Specifies the name of the adapter to use for this process

Default value: AirWatchAdapter

No
<url>

Specifies the URL defining the location of the content to be obtained

Default value: none

Yes
<data>

Specifies the information to be posted

This information can be simple text or it can use an XML document to specify parent and child or key and value tags. 

For example, Simple Text: Sample data that will be posted. 

XML Format: Parent- Child Format:
<parent>
<child>child value</child>
</parent> 

Key-Value Format:
<entry>
<key>key</key>
<value>value</value>
</entry>

Yes
<data-format>

Specifies the format for the adapter response

Valid values: html, xml (default), xhtml

No
<certificate-name>Specifies the fully qualified path where the certificate file is placedNo
<certificate-password>Specifies the password that corresponds to the <certificate-file> elementNo
<tenant-code>Specifies the tenant code that needs to be added to the header of the HTTP requestNo
<data-signing-scheme>

Specifies whether data is used for generating the signed authorization header to be included in the request

Valid values: true (default), false

No
<install-certificate>

Specifies whether to install certificates automatically

Valid values: true, false (default)

No
<allow-unsigned-certificate>

Specify whether to allow unsigned certificates from trusted zones

Valid values: true, false (default)

No
<passphrase>

Specifies the Java Standard Trust Keystore passphrase 

Default value: changeit

No

The following figure illustrates a sample adapter request for the Post Data operation:

Sample adapter request for the Post Data operation

<air-watch-adapter-request>
    <http-method>POST</http-method>
    <url>https://qa7.airwatchqa.com/api/v1/system/groups/6152/update</url>
    <data>
      <LocationGroup xmlns="http://www.air-watch.com/servicemodel/resources">
        <GroupId>testlg123updated</GroupId>
      </LocationGroup>
    </data>
    <data-format>XML</data-format>
    <certificate-name>C:\Temp\CN=5257-mohan.p12</certificate-name>
    <certificate-password>password</certificate-password>
    <tenant-code>1FC5H4JAAAG5A4SQAMQA</tenant-code>
    <data-signing-scheme>true</data-signing-scheme>
    <install-certificate>false</install-certificate>
    <allow-unsigned-certificate>false</allow-unsigned-certificate>
    <passphrase>changeit</passphrase>
</air-watch-adapter-request>

The following figure illustrates the adapter response for the sample request:

Sample adapter response for the Post Data operation

<air-watch-adapter-response>
  <metadata>
    <status>success</status>
  </metadata>
  <status-line>
    <code>200</code>
    <reason>OK</reason>
  </status-line>
  <header-lines>
    <Cache-Control>private</Cache-Control>
    <Server>Microsoft-IIS/7.5</Server>
    <X-AspNet-Version>4.0.30319</X-AspNet-Version>
    <X-MDM-Powered-By>AirWatch @ www.air-watch.com</X-MDM-Powered-By>
    <Date>Mon, 22 Apr 2013 16:09:01 GMT</Date>
    <Content-Length>0</Content-Length>
  </header-lines>
  <message-body>
    <non-xml-data-response></non-xml-data-response>
  </message-body>
</air-watch-adapter-response>

Was this page helpful? Yes No Submitting... Thank you

Comments