This class provides methods for configuring lists. Use these methods to manage them, for example, in the scripts of the UI actions.
Global variable usage
Within any list, you can use the predefined global variable.
Variable | Description |
---|---|
currentUiAction |
Example:
window.currentUiAction
s_list.addErrorMessage(message)
Use this method to display an error toast message in the lower right corner.
Parameter(s):
Name | Type | Mandatory | Default value |
---|---|---|---|
message | String | Y | N |
Return:
Type | Description |
---|---|
Void | This method does not return a value. |
Example:
s_list.addErrorMessage('Please enter a valid email address using the following format: joe@example.com');
s_list.addInfoMessage(message, durationMilliseconds)
Use this method to display the info messages when working with lists. They appear in the lower right corner. The message disappears after a certain period of time. Specify this period in milliseconds in the durationMilliseconds parameter.
Parameters:
Name | Type | Mandatory | Default value |
---|---|---|---|
message | String | Y | N |
durationMilliseconds | Number | N | N |
Return:
Type | Description |
---|---|
Void | This method does not return a value. |
Example:
s_list.addInfoMessage('Link copied to clipboard', 2000);
s_list.addSuccessMessage(message, durationMilliseconds)
Use this method to display the success messages when working with lists. They appear in the lower right corner. The message disappears after a certain period of time. Specify this period in milliseconds in the durationMilliseconds parameter.
Parameters:
Name | Type | Mandatory | Default value |
---|---|---|---|
message | String | Y | N |
durationMilliseconds | Number | N | N |
Return:
Type | Description |
---|---|
Void | This method does not return a value. |
Example:
s_list.addSuccessMessage('Record was successfully updated!', 3000);
s_list.addWarningMessage(message, durationMilliseconds)
Use this method to display the warning messages when working with lists. They appear in the lower right corner. The messages disappear after a certain period of time. Specify this period in milliseconds in the durationMilliseconds parameter.
Parameter(s):
Name | Type | Mandatory | Default value |
---|---|---|---|
message | String | Y | N |
durationMilliseconds | Number | N | N |
Return:
Type | Description |
---|---|
Void | This method does not return a value. |
Example:
s_list.addWarningMessage('This record has been modified by another user', 3000);
deleteRows(tableName, sysIds)
Use this method to delete one or more selected records, their IDs are passed in the second parameter.
Parameters:
Name | Type | Mandatory | Default value |
---|---|---|---|
tableName | String | Y | N |
sysIds | Array of Strings | Y | N |
Return:
Type | Description |
---|---|
Object | This method returns a Promise object that contains some specific data. |
Example:
s_i18n.getMessage("Delete the selected record(s)?", async (translationResponse) => { if (confirm(translationResponse)) { s_list.deleteRows(table, selectedRows) .then(() => { __resolveServerResponse(); s_list.refresh(table); }) } else { __resolveServerResponse(); } });
getCheckedRow(tableName)
Use this method to get information about the strings that are checked on the list.
Parameter:
Name | Type | Mandatory | Default value |
---|---|---|---|
tableName | String | Y | N |
Return:
Type | Description |
---|---|
Array of Strings | This method returns an array that contains the IDs of the strings checked. If no strings were checked, the method returns an empty array. |
Example:
const table = s_list.getTablesName()[0]; const selectedRows = s_list.getCheckedRow(table); if (!selectedRows.length) { s_i18n.getMessage("No selected rows.", (translationResponse) => { __resolveServerResponse(); alert(translationResponse); }); }
getQuery()
Use this method to return the filter condition for the displayed records in the list.
Return:
Type | Description |
---|---|
String | This method returns the condition formatted as an encoded query. |
Example:
; (() => { const url = new URL(`${API_BASE_URL}/list/${s_list.getTablesName()[0]}`); url.searchParams.set('condition', s_list.getQuery()); window.open(url, '_blank'); })();
getTablesName()
Use this method to return an array with the names of the tables displayed in the window.
Return:
Type | Description |
---|---|
Array of Strings | This method returns an array with the names of the tables. |
Example:
; (() => { const url = new URL(`${API_BASE_URL}/list/${s_list.getTablesName()[0]}`); url.searchParams.set('condition', s_list.getQuery()); window.open(url, '_blank'); })();
refresh(tableName)
Use this method to refresh the data on the list specified in the tableName parameter.
Parameter:
Name | Type | Mandatory | Default value |
---|---|---|---|
tableName | String | Y | N |
Return:
Type | Description |
---|---|
Void | This method does not return a value. |
Example:
if (confirm(translationResponse)) { s_list.deleteRows(table, selectedRows) .then(() => { s_list.refresh(table); }) }
- No labels