| Contents: | Main | Chapter | See Also: | Getting Started Manual | Advanced User Manual | |||
| Reference Type | Category | ICR # |
|---|---|---|
| Supported | ScreenMan | 2610 |
You can use the $$GET^DDSVALF extrinsic function only within a ScreenMan form, in all places where M code can be placed on the form.
The $$GET^DDSVALF 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. REF: For a detailed description of IENS, see the "IENS: Identify Entries and Subentries" section in the "Database Server (DBS) API" section. |
|
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: May 2026