createMdbcsSubmission( )

Creates a PODSSubmission object, allowing specification of a character set for the title that is displayed in the M-Business Client Forms Manager.

Interface

PODSSubmissionMgr

IDL definition

PODSSubmission createSubmission(
  PODSString subStatus,
  PODSDate subDate,
  PODSBoolean isHidden,
  PODSString resultURL,
  PODSString sourceURL,
  PODSInt32 formIndex,
  PODSString actionURL,
  PODSString actionMethod,
  PODSString title,
  PODSUInt16 titleCharset
);

JavaScript synopsis

avantgo.submgr.createSubmission(
  subStatus,
  subDate,
  isHidden,
  resultURL,
  sourceURL,
  formIndex,
  actionURL,
  actionMethod,
  title,
  titleCharset
)

C synopsis

PODSSubmission* PODScreateSubmission(
  PODSSubmissionMgr* submgr,
  PODSString subStatus,
  PODSDate subDate,
  PODSBoolean isHidden,
  PODSString resultURL,
  PODSString sourceURL,
  PODSInt32 formIndex,
  PODSString actionURL,
  PODSString actionMethod,
  PODSString title,
  PODSUInt16 titleCharset
);

Parameters

submgr The PODSSubmissionMgr object.
subStatus [in] The submission status for the form (PODSSubmission object). For possible values, see the Submission status constants table in Constants for PODS submissions.
subDate [in] The submission date for the form (PODSSubmission object), represented as the number of seconds from the absolute reference date used by the mobile device.
isHidden [in] The isHidden setting for the form (PODSSubmission object), which determines whether the form appears in the M-Business Client Forms Manager dialog:
- PODS_TRUE hides the form

- PODS_FALSE displays the form
resultURL [in] The result URL for the form (PODSSubmission object). This is the absolute URL of the document returned when the form is submitted. This is the page that displays the result of the form’s action. If the form has never been submitted, specify NULL for this parameter.
sourceURL [in] The source URL for the form (PODSSubmission object). This is the absolute URL of the document containing the form. This cannot be NULL.
formIndex [in] The index of the form (PODSSubmission object) on the source document page. A page may contain several forms and this is the index of the form in the list of forms on the page (with numbering starting at 0).
actionURL [in] The URL specified in the form's (PODSSubmission object’s) ACTION attribute. This is the URL of the script to perform. This parameter cannot be NULL. If it is NULL, the form can never be submitted.
actionMethod [in] The value of the form's (PODSSubmission object’s) method attribute. Possible values are: SUB_METHOD_POST or SUB_METHOD_GET.
title [in] The form's (PODSSubmission object’s) title. This title appears in the Forms Manager dialog in M-Business Client. You may specify NULL for this parameter.
titleCharset [in] The character set to be used in displaying the form's title in the Forms Manager. For valid values, see Constants to specify a title's character set.

Returns

PODSSubmission object created.

Remarks

The createMdbcsSubmission( ) method does not save the submission. You must call appendSubmission( ) to save it so that it is sent to the server. The source URL and result URL may be accessed when users access the Forms Manager list. If a user selects a submission in the list and clicks Edit, M-Business Client displays the source URL to allow the user to edit the submission data. If a user selects an already submitted form from the Forms Manager list and clicks View, M-Business Client loads the result page so that the user sees the result of the action.