This command retrieves a list of allowed values for a given parent key. For example, if modules (MODULE_ID) in your installation are dependent upon products (PRODUCT_NAME), then you can use this function to find all the valid modules for a given product. The command can also be used to retrieve the values in a specified list only.
http://www.myserver.com/evj/ExtraView/ev_api.action?
user_id=username
&password=password
&statevar=allowed_list
&field=field_name
&parent=parent_field_name
&parent_val=product_name
[&access_token=token-value]
Both the field_name and the product_name must exist else the command will fail. The delimiter of a colon (:) in the example is the system delimiter stored in the behavior setting named DEFAULT_TEXT_REPORT_DELIMITER. If you only specify the field without the parent and parent_val, the command will return a list of all the values of the field.
The optional access_token
parameter allows you to use a valid OAuth2 token obtained with the get_token
command. If you provide the access_token
parameter, then the user_id
and password
parameters should not be provided. This prevents the password being sent in clear text over your network connection.
The following URL retrieves a list of modules for the product named WIDGET.
http://www.myserver.com/evj/ExtraView/ev_api.action? user_id=username &password=password &statevar=allowed_list &field=MODULE_ID &parent=PRODUCT_NAME &parent_val=WIDGET
This will produce output similar to the following:
1022:POWER_SUPPLY 1032:CASE 1203:MOTHERBOARD 1255:KEYBOARD 1334:MOUSE 1432:MONITOR