ARGetEntry
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 the form entry with the indicated ID from the specified server. You can retrieve data for specific fields, all (accessible) fields, or no fields (which is useful to verify whether a form has any entries). This function returns only the name, size, and compressed size of attachment fields. Use ARGetEntryBLOB
to retrieve the contents of the attachment.
Privileges
The system returns data based on the access privileges of the user that you specify for the control
parameter. User permissions are verified for each specified field. The system returns values for accessible fields and warning messages for fields the user cannot access.
Synopsis
#include "ar.h"
#include "arerrno.h"
#include "arextern.h"
#include "arstruct.h"
int ARGetEntry(
ARControlStruct *control,
ARNameType schema,
AREntryIdList *entryId,
ARInternalIdList *idList,
ARFieldValueList *fieldList,
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.
schema
The name of the form containing the entry to retrieve.
entryId
The ID of the entry to retrieve.
Note
The system identifies entries in join forms by concatenating the entry IDs from the member forms. As a result, an entry ID can consist of one or more values of type AREntryIdType
and, therefore, is represented by the AREntryIdList
structure.
idList
A list of zero or more internal IDs that specify the fields to retrieve. Specify NULL
for this parameter (or zero fields) to retrieve all (accessible) fields. Specify NULL
for both this parameter and the fieldList
parameter if you do not want to retrieve any fields. To minimize network traffic, specify only the fields that you need if you do not require the data for all fields. If an attachment field is specified in the list, only its name, size, and compressed size are returned. Use ARGetEntryBLOB
to retrieve the contents of the attachment.
Return values
fieldList
A list of zero or more field/value pairs that identifies the data for the specified entry. The fields are returned in the order specified by idList
. If the user does not have permission for a specified field or the field does not exist, the system does not return a value for the field/value pair. Specify NULL
for this parameter if you do not want to retrieve any field data.
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
ARCreateEntry, ARDecodeDiary, ARDecodeStatusHistory, ARDeleteEntry, ARGetEntryBLOB, ARGetListEntry, ARSetEntry. See FreeAR for: FreeAREntryIdList
, FreeARInternalIdList
, FreeARFieldValueList
, FreeARStatusList
.
Comments