This documentation supports the 18.08 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

ARGetListSchema

Note

You can continue to use C APIs to customize your application, but C APIs are not enhanced to support new capabilities provided by Java APIs and REST APIs.

Description

Retrieves a list of forms from the specified server. You can retrieve all (accessible) forms or limit the list to forms of a particular type or forms modified after a specified time.

Privileges

The system returns information based on the access privileges of the user that you specify for the control parameter. All lists, therefore, are limited to forms the user can access.

Synopsis

#include "ar.h"
#include "arerrno.h"
#include "arextern.h"
#include "arstruct.h"

int ARGetListSchema(
   ARControlStruct *control,
   ARTimestamp changedSince,
   unsigned int schemaType,
   ARNameType name,
   ARInternalIdList *fieldIdList,
   ARPropList *objPropList,
   ARNameList *nameList,
   ARStatusList *status)

Input arguments

control

The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and server fields are required.

To specify whether to search for an object's real or resolved name, use the AR_SESS_CONTROL_PROP_API_OVERLAYGROUP variable of the ARSetSessionConfiguration function (see ARSetSessionConfiguration). For calls that use field or view IDs, the search is performed on the real or resolved name of the associated form.

If you do not use the AR_SESS_CONTROL_PROP_API_OVERLAYGROUP variable, the BMC Remedy AR System server uses the default overlay group at run time. For information about configuring the default overlay group, see the description for Overlay-mode in ar.cfg or ar.conf options N-R

changedSince

A time stamp that limits the forms retrieved to those modified after the specified time. Specify 0 for this parameter to retrieve forms with any modification time stamp.

schemaType

A value that indicates the form types to retrieve (some types are mutually exclusive).

0:

Retrieve all form types (AR_LIST_SCHEMA_ALL).

1:

Retrieve all base forms (AR_LIST_SCHEMA_REGULAR).

2:

Retrieve all join forms (AR_LIST_SCHEMA_JOIN).

3:

Retrieve all view forms (AR_LIST_SCHEMA_VIEW).

4:

Retrieve all join forms that depend on the form specified by the name parameter (AR_LIST_SCHEMA_UPLINK).

5:

Retrieve all base or join forms that the form specified by the name parameter depends on (AR_LIST_SCHEMA_DOWNLINK).

6:

Retrieve all display-only forms (AR_LIST_SCHEMA_DIALOG).

7:

Retrieve all forms with data fields (AR_LIST_SCHEMA_ALL_WITH_DATA).

8:

Retrieve all vendor schemas (AR_LIST_SCHEMA_VENDOR).

To retrieve both visible and hidden forms, add 1024 (AR_HIDDEN_INCREMENT) to the form type. For example, specify AR_LIST_SCHEMA_ALL | AR_HIDDEN_INCREMENT for this parameter.

name

If the schemaType is AR_LIST_SCHEMA_UPLINK, this parameter specifies the form on which the retrieved forms depend. If the schemaType is AR_LIST_SCHEMA_DOWNLINK, this parameter specifies the form that depends on the retrieved forms. This parameter is ignored if you do not specify AR_LIST_SCHEMA_UPLINK or AR_LIST_SCHEMA_DOWNLINK as the schemaType.

fieldIdList

List of form fields. The system returns only the forms that contain all the fields in this list. Specify NULL for this parameter (or zero fields) if you do not want to qualify the forms returned by the fields they contain. For example, specify the four reserved server event fields (800, 801, 802, 803) in this list to retrieve the server event schema.

Note

Archive forms are not returned if you specify a list of form fields. You must specify NULL to return archive forms.

objPropList

List of server-managed object properties to search for. Returns all schemas that match the object properties, for example, the application owner. See Server-managed object property tags.

Return values

nameList

A list of zero or more (accessible) forms that match the criteria in the schemaType, changedSince, fieldIdList, and objPropList parameters. The system returns a list with zero items if no forms match the specified criteria.

status

A list of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error checking.

See also

ARCreateSchema, ARDeleteSchema, ARGetListSchemaWithAlias, ARGetSchema, ARSetSchema. See FreeAR for: FreeARNameList, FreeARStatusList, FreeARInternalIDList.

Was this page helpful? Yes No Submitting... Thank you

Comments