Difference: 0LASubrUtilFieldSet (1 vs. 2)

Revision 22012-02-29 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPXRuntimeSubroutineAPI"
Changed:
<
<

All

>
>

.UTIL FIELD SET

 
Changed:
<
<		- invalid field name returns F and RT 0
>
>		This subroutine is called to set a value into a specified field name.
 
Changed:
<
<		- invalid occ no returns T and RT 1
>
>

Usage: 

      PASS         <App_Id>                   FIELD            SHARE? N
      PASS         <Field_Name>               FIELD            SHARE? N
      PASS         <Occ_no>                   FIELD            SHARE? N
      PASS         <value>                    FIELD            SHARE? N
      GOSUB    --- .UTIL FIELD SET
      *        Check for errors
      IF       --- .UTIL FIELD SET            NE
 
Changed:
<
<		- invalid leaves field contents unchanged (duh)
>
>

Description:

 
Changed:
<
<		- success returns T and RT 1
>
>		This subroutine is called to set a value into a specified field name. All parameters are required. If any required parameters are missing, the subroutine will CANCEL.
 
Changed:
<
<

Alpha

>
>		<App_Id> is the Application Id of the field you want to set (Required). The version will be taken from the currently running version.
 
Changed:
<
<		- silently truncates

Integers

>
>		<Field_Name> is the field you want to set (Required). This must be a valid field in the specified application.
 
Changed:
<
<		- decimals do nothing, but return T and RT 1
>
>		<Occ_no> is the occurrence number (Required). If blank or zero, it will default to 1.
 
Changed:
<
<		- incorrect sign does nothing, but returns T and RT 1
>
>		<value> is the string of data you want to set into the specified field (Required).
 
Changed:
<
<		- too large does nothign, but returns T and RT 1
>
>		<value> must be appropriate for the type of field. For example, if the target field is an unsigned integer, then you cannot set real or negative numbers into it. If the value is too large, too small or has too many decimal places for the target field, it will not be set. If the target field is a token, you must pass a valid token value (case sensitive). Date/time fields must be a string in the format CCYYMMDDhhmmsstt. If any leading parts are not supplied, they must be replaced with a dash character, ie, '--120228' or '--------2241'. Trailing dashes are optional.
 
Changed:
<
<

Real

>
>		See also .UTIL FIELD GET.

Comments:

 
Changed:
<
<		- too large does nothing, but return T and RT 1
>
>		Read what other users have said about this page or add your own comments.
 
Changed:
<
<		- too many decimals does nothing, but return T and RT 1
>
>
<--/commentPlugin-->
 
Deleted:
<
<		- too small does nothing, but return T and RT 1

Token

- invalid token does nothign but returns T and RT 1

-- JeanNeron - 2012-02-28

 \ No newline at end of file
Added:
>
>		-- JeanNeron - 2012-02-22

Revision 12012-02-28 - JeanNeron

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="APPXRuntimeSubroutineAPI"

All

- invalid field name returns F and RT 0

- invalid occ no returns T and RT 1

- invalid leaves field contents unchanged (duh)

- success returns T and RT 1

Alpha

- silently truncates

Integers

- decimals do nothing, but return T and RT 1

- incorrect sign does nothing, but returns T and RT 1

- too large does nothign, but returns T and RT 1

Real

- too large does nothing, but return T and RT 1

- too many decimals does nothing, but return T and RT 1

- too small does nothing, but return T and RT 1

Token

- invalid token does nothign but returns T and RT 1

-- JeanNeron - 2012-02-28

View topic | History: r6 < r5 < r4 < r3 | More topic actions...
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback