Contents: | Main | Chapter | See Also: | Getting Started Manual | Advanced User Manual |
You can use this entry point only within a ScreenMan form, in all places where M code can be placed on the form.
This extrinsic function retrieves data from a form-only field or a computed field.
If, while a form is running, a call to GET^DDSVALF fails, ScreenMan prints an error message in the Command Area.
$$GET^DDSVALF(FIELD,BLOCK,PAGE,FLAGS,IENS)
FIELD |
(Required) The Field Order number, Caption, or Unique Name of the form-only field. |
|
BLOCK |
(Required at the page and form levels) The Block Order or Block Name. The default is the current block. |
|
PAGE |
(Required at the form level) The Page Number or Page Name. The default is the current page. |
|
FLAGS |
(Optional) Controls whether the internal or external form is returned, as shown below: |
|
I | Return the Internal form of the data. (Default) | |
E | Return the External form of the data. | |
IENS |
(Required at the page and form levels) The standard IENS that identifies the entry or subentry associated with the form-only field. The default is the current entry or subentry. For a detailed description of IENS, see "IENS - A New Way to Identify Entries and Subentries" in the "Database Server (DBS) API" chapter. |
Example 1
Retrieve the value of a computed field called TOTAL on the current block:
S nmspTOT=$$GET^DDSVALF("TOTAL")
Example 2
Retrieve the external form of a form-only date field with caption "DATE OF BIRTH" on a block named "ZZBLOCK 1":
S nmspDATE=$$GET^DDSVALF("DATE OF BIRTH","ZZBLOCK 1","","E")
Reviewed/Updated: March 4, 2007