Field States
Description
Makes/unmakes a certain field required.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| field |
The name of the field |
String |
| value |
To make the field required, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example makes the customer comments field (cl.obs) required.
sdk.setRequired(FIELDS.CL_OBS, true);
Example 2
The following example makes the field U8882_EXTCL.PIN required. This field belongs to entity U8882_EXTCL (customer extension entity)
sdk.setRequired(FIELDS.U8882_EXTCL_PIN, true,TABLES.U8882_EXTCL);
Description
Makes/unmakes a certain field disabled for the user.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| field |
The name of the field |
String |
| value |
To make the field required, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example sets the customer comments field (cl.obs) to disabled, meaning the user cannot change its value.
sdk.setDisabled(FIELDS.CL_OBS, true);
Example 2
The following example sets the field U8882_EXTCL.PIN disabled if the user does not have administrator permissions. This field belongs to entity U8882_EXTCL (customer extension entity).
if (!sdk.User.esa) {
sdk.setDisabled(FIELDS.U8882_EXTCL_PIN, true,TABLES.U8882_EXTCL);
}
Description
Makes/unmakes a certain field invisible for the user.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| field |
The name of the field. |
String |
| value |
To make the field required, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example sets the customer comments field (cl.obs) to invisible, which means the user will not be able to see the field.
sdk.setHidden(FIELDS.CL_OBS, true);
Example 2
The following example sets the field U8882_EXTCL.PIN invisible if the user does not have administrator permissions. This field belongs to entity U8882_EXTCL (customer extension entity)
if (!sdk.User.esa) {
sdk.setHidden(FIELDS.U8882_EXTCL_PIN, true,TABLES.U8882_EXTCL);
}
Description
Makes/unmakes a certain field readonly, which means the user can only see the value of the field, and cannot change it.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| field |
The name of the field. |
String |
| value |
To make the field required, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example sets the customer comments field (cl.obs) to readonly, which means the user will not be able to change its value.
sdk.setReadonly(FIELDS.CL_OBS, true);
Example 2
The following example sets the field U8882_EXTCL.PIN to readonly if the user does not have administrator permissions. This field belongs to entity U8882_EXTCL (customer extension entity).
if (!sdk.User.esa) {
sdk.setReadonly(FIELDS.U8882_EXTCL_PIN, true,TABLES.U8882_EXTCL);
}
Description
Makes/unmakes a certain grid field invisible for the user.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| gridEntity |
The name of the grid entity. |
String |
| field |
The name of the grid fieldt. |
String |
| value |
To make the field hidden, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example sets the invoice’s line reference field (fi.ref) to invisible, which means the user will not be able to see the field.
sdk.setColumnHidden(TABLES.FI, FIELDS.FI_REF, true);
Example 2
The following example sets the invoice’s line field U8882_OBRAFT_FI. COSTTYPE invisible if the user does not have administrator permissions. This field belongs to entity U8882_OBRAFT_FI (invoice fi extension entity).
sdk.setColumnHidden(TABLES.FI, FIELDS.U8882_OBRAFT_FI_COSTTYPE, !sdk.User.esa, TABLES.U8882_OBRAFT_FI);
Example 3
The following example sets the invoice’s new grid field U8882_OBRATECH.OBS invisible. This field belongs to entity U8882_OBRATEC (new invoice grid)
sdk.setColumnHidden(TABLES.U8882_OBRATECH, FIELDS.U8882_OBRATECH_OBS, true)
Description
Makes/unmakes a certain grid field readonly, which means the user can only see the value of the field, and cannot change it.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| gridEntity |
The name of the grid entity. |
String |
| field |
The name of the grid fieldt. |
String |
| value |
To make the field hidden, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example sets the invoice’s line reference field (fi.ref) to readonly, which means the user will not be able to change its value.
sdk.setColumnReadonly(TABLES.FI, FIELDS.FI_REF, true);
Example 2
The following example sets the invoice’s line field U8882_OBRAFT_FI.COSTTYPE to readonly if the user does not have administrator permissions. This field belongs to entity U8882_OBRAFT_FI (invoice fi extension entity).
sdk.setColumnReadonly(TABLES.FI, FIELDS.U8882_OBRAFT_FI_COSTTYPE, !sdk.User.esa, TABLES.U8882_OBRAFT_FI);
Example 3
The following example sets the invoice’s new grid field U8882_OBRATECH. OBS to readonly. This field belongs to entity U8882_OBRATEC (new invoice grid)
sdk.setColumnReadonly(TABLES.U8882_OBRATECH, FIELDS.U8882_OBRATECH_OBS, true)
Description
Makes/unmakes a certain field disabled for the user.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| field |
The name of the grid fieldt. |
String |
| value |
To make the field hidden, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example allows disabling the
physical signature area of an
agent, created in the screen
Extensions and Entities screen, for the
Interventions entity, when the field (intervention.interventionReport) is not filled in.
sdk.setSignatureDisabled("agente_sign", currentRecord.interventionReport ==´´,"u4902_myintervention")
Description
Makes/unmakes a certain field disabled for the user.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| field |
The name of the grid fieldt. |
String |
| value |
To make the field hidden, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Description
Makes/unmakes a certain field disabled for the user.
Return Function
n/a
Parameters
| Name |
Description |
Type |
| field |
The name of the grid fieldt. |
String |
| value |
To make the field hidden, set the parameter to true. Otherwise, false. |
Boolean |
| extensionEntity |
If the field is an extension entity field, this parameter must have the extension entity name.
This parameter is optional and the default value is empty. |
String |
Example
The following example allows disabling the
physical signature area of an
agent, created in the
Screen Extensions and Entities screen, for the
Interventions entity, when the field (intervention.interventionReport) is not filled in.
sdk.setSignatureDisabled("agente_sign", currentRecord.interventionReport =='',"u4902_myintervention")