Planfix API analitic.getOptions: Difference between revisions

From Planfix
Jump to: navigation, search
(Created page with "Get a description of data tag - full content of fields and their value types. Request format: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request method="analitic.getOptions"> <account></account> <sid></sid> <analitic> <id></id> </analitic> <signature></signature> </request> </source> {| class="wikitable" style="margin-top: 1em; width:100% " !width="150"|Name !!width="200"| Type !!width="50%"| Value !! Note |- |sid || string(32) ||session ke...")
 
No edit summary
 
(One intermediate revision by the same user not shown)
Line 83: Line 83:
|field.name || string || field description ||
|field.name || string || field description ||
|-
|-
|field.type || enum || data type in the field ||see the list of acceptable values in the  [[Planfix API:field data types of data tags|field data types of data tags]] section
|field.type || enum || data type in the field ||see the list of acceptable values in the  [[Planfix API:Field data types of data tags|field data types of data tags]] section
|-
|-
|field.list || || the list of acceptable values  for the field, if '''type'''=''LIST'' ||
|field.list || || the list of acceptable values  for the field, if '''type'''=''LIST'' ||
Line 104: Line 104:
== Go To ==
== Go To ==
*[[Planfix API:Data tags]]
*[[Planfix API:Data tags]]
*[[Error codes]]
*[[Error codes XML API v1|Error codes]]
*[[List of functions]]
*[[List of functions]]

Latest revision as of 15:11, 15 March 2024

Get a description of data tag - full content of fields and their value types. Request format:

<?xml version="1.0" encoding="UTF-8"?>
<request method="analitic.getOptions">
  <account></account>
  <sid></sid>
  <analitic>
    <id></id>
  </analitic>
  <signature></signature>
</request>
Name Type Value Note
sid string(32) session key issued as a result of authentication
analitic.id int data tag identifier

Response when the request is successfully executed:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <analitic>
    <id></id>
    <name></name>
    <group>
      <id></id>
    </group>
    <fields>
      <field>
        <id></id>
        <num></num>
        <name></name>
        <type></type>
        <list>
          <value></value>
          <value></value>
          <!-- ... -->
        </list>
        <handbook>
          <id></id>
        </handbook>
      </field>
      <field>
        <id></id>
        <num></num>
        <name></name>
        <type></type>
        <list>
          <value></value>
          <value></value>
          <!-- ... -->
        </list>
        <handbook>
          <id></id>
        </handbook>
      </field>
      <!-- ... -->
    </fields>
  </analitic>
</response>
Name Type Value Note
id int data tag identifier
name string data tag name
group.id int data tag group identifier
fields node containing the list of data tag fields
fields.field node describing the data tag field
field.id int field identifier required in requests when adding data tag to an action
field.num int serial number for the interface
field.name string field description
field.type enum data type in the field see the list of acceptable values in the field data types of data tags section
field.list the list of acceptable values for the field, if type=LIST
field.list.value string field value
field.handbook.id int directory identifier, if type=HANDBOOK

Otherwise, a response with an error will be returned:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Go To