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

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

ARDeleteField

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

Deletes the form field with the indicated ID from the specified server. Depending on the value that you specify for the deleteOption parameter, the field is deleted from the server immediately and is not returned to users who request information about fields.

When a parent field is deleted, its child fields might also be deleted. For example, deleting a panel holder field deletes all panels within it. All fields within those panels are removed from the current view but not deleted. Deleting a table field deletes all columns within it.

Privileges

BMC Remedy AR System administrator.

Synopsis

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

int ARDeleteField(
   ARControlStruct *control,
   ARNameType schema,
   ARInternalId fieldId,
   unsigned int deleteOption,
   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.

If a valid overlay group is specified in the control record, the ARDelete* function operates on the object that belongs to that group. If no group is specified, the function operates on the origin object. To specify whether to use an object's real or resolved name in an operation and whether to perform the operation only on objects in a specified overlay group, use the AR_SESS_CONTROL_PROP_DESIGN_OVERLAYGROUP variable of the ARSetSessionConfiguration function (see ARGetSessionConfiguration).

schema

The name of the form containing the field to delete.

fieldId

The internal ID of the field to delete.

deleteOption

A value that indicates the action to take if the specified field contains data (applicable only to base forms) or is associated with a join form.

0:

Do not delete the field (AR_FIELD_CLEAN_DELETE).

1:

Delete if the field contains data but not if it is associated with a join form (AR_FIELD_DATA_DELETE).

2:

Delete the field, all join form fields that map to it, and all join forms dependent on it for join qualification (AR_FIELD_FORCE_DELETE).

 

Return values

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

ARCreateField, ARDeleteMultipleFields, ARDeleteSchema, ARGetField, ARGetListField, ARGetMultipleFields, ARSetField. See FreeAR for: FreeARStatusList.

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

Comments