Planfix API analitic.getOptions: Difference between revisions
From Planfix
(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.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>