add_field_list

This action provides a list of all the available fields to the user in a specific order that is used by the layout for adding new issues within ExtraView. Most typically, this script is used to provide a list of fields and their titles for inclusion in a Perl script that is used to insert a new record within the ExtraView database. This action is used as a basis of the CLI evadd command.

Note that all of the ExtraView security is in force and an individual user will only see the fields to which he has access. Also, note that there is no difference in the way that User Defined Fields (UDF’s) are shown from other fields. UDF’s are handled in a seamless way within the API.

SYNTAX

http://www.myserver.com/evj/ExtraView/ev_api.action?
user_id=username
&password=password
&statevar=add_field_list
&include_images=1

This will return a list of fields as shown in the following figure. Note that the fields will vary according to your permissions and the fields defined in your installation.

RESOLUTIONDisposition
CUSTOMERCustomer
+SHORT_DESCRTitle
ALT_IDAlt ID
+PRODUCT_NAMEProduct
PRIORITYPriority
+CATEGORYCategory
SEVERITY_LEVELSeverity
ASSIGNED_TOAssigned To
OWNEROwner
COMPONENTComponent
TEST_CASE_IDTest Case ID
TEST_CASE_LOCATIONTest Case Location
PLATFORMPlatforms
OSOS
PRIVACYView
*WORKAROUNDWorkaround
*RELEASE_NotesRelease Notes
+*DescriptionDescription

NOTES

  • The general form of each entry returned by the command is:

    <prefix><fieldName><delimiter><fieldTitle><delimiter><parentName>

    where the parentName is blank or the immediate parent in an allowed-value or database-type relationship and the delimiter is that specified in the behavior setting named DEFAULT_TEXT_REPORT_DELIMITER and the characters in the prefix have the following meaning:

    ~ means the field is part of a repeating row layout
    * means the field has a display type of textarea or logarea
    % means the field has a display type of user

  • The parameter include_images is optional. If provided, it always has a value of 1. When the parameter is provided, fields with a display type of image are included in the results returned.