get_valid_meta_data

This action retrieves a complete list of the metadata stored in ExtraView.

SYNTAX

http://www.myserver.com/evj/ExtraView/ev_api.action?
user_id=username
&password=password
&statevar=get_valid_meta_data
&fields=field_x
&user_info=x
&disabled_values=Y
&all=Y

NOTES

This function can return a significant amount of data, depending on your installation.

By default, the data returned is for the user’s current area and project only.

By default, the data returned is also filtered by any allowed values. For example, if there is an allowed value with the field named STATUS as the parent, then only the child records in the current area will be returned.

The previous two default conditions can be overridden, by using the optional parameter all=Y as part of the call.

The optional parameter fields can be used to refine the metadata returned to a single, or to a list of fields. For example, fields=CUST_LIST will return the metadata associated with the CUST_LIST field. You can repeat this parameter as many times as you need in the parameter list, to return the metadata on a number of fields with a single command.

The optional parameter disabled_values wlil return all the users, including those that are disabled, within the output to the command.

The optional parameter user_info has three possible functions:

  1. When no parameter is specified, the command works as documented in the other sections of this page
  2. When the parameter has a value of N then no user information is generated in the return of the call
  3. When the parameter has a value of Y then one set of generic information is returned, with SECURITY_USER_ID being used as the field ID.

The security permissions for each field are checked for the user performing the API command, and only fields to which the user has read permission are returned.

The result of the function is in the form:

field_name:meta_data_name:meta_data_title

where the delimiter : is the system delimiter stored in the behavior setting named DEFAULT_TEXT_REPORT_DELIMITER.

A small sample of data returned is shown below - note the delimiter in this case is the | character:

CATEGORY|ENHANCEMENT|Enhancement
CATEGORY|HARDWARE|Hardware
CATEGORY|SOFTWARE|Software
OS|5755|FREEBSD
OS|5721|LINUX
OS|5913|NetBSD
OS|5711|SOLARIS
OS|5752|WINDOWS 95
OS|5787|WINDOWS 98
OS|5704|WINDOWS NT
PRIORITY|0|0
PRIORITY|1|1
PRIORITY|2|2
PRIORITY|3|3
PRIORITY|4|4
PRIORITY|5|5
PRIVACY|PRIVATE|Private
PRIVACY|PUBLIC|Public
PRODUCT_NAME|GLOBALINTERACTION|Global Interaction
PRODUCT_NAME|NETTRANSACTIONS|Net Transactions
RELEASE_STATUS|CLOSED|Closed
RELEASE_STATUS|FIXED|Fixed
RELEASE_STATUS|OPEN|Open
RELEASE_STATUS|PENDING|Pending
RELEASE_STATUS|UNASSIGNED|Unassigned
RESOLUTION|CANNOT DUPLICATE|Cannot Duplicate
RESOLUTION|DEFERRED|Deferred
RESOLUTION|DUPLICATE|Duplicate
RESOLUTION|FIXED|Fixed
RESOLUTION|NEED MORE INFO|Need more info
SEVERITY_LEVEL|CRITICAL|Critical
SEVERITY_LEVEL|HIGH|High
SEVERITY_LEVEL|LOW|Low
SEVERITY_LEVEL|MEDIUM|Medium