Adds an error message to Axional Studio Console. If user doesn't have console activated, message won't appear.

Settings Parameters:

• nfname: string

  Name of the function origin of the log.

• errmsg: string

  Message to be showed on the console.

Adds an alert message to Axional Studio Console. If user doesn't have console, message won't be showed.

Parameters:

• nfname: string

  Function name of log origin.

• errmsg: string

  Message to be showed on the console.

Obtains the URL in order to open a form.

Parameters:

• rep_code: string

  Object code to be opened.

• cond: string

  Filter condition.

Since:

• 27/11/2015

Determines if a form accepts data entrance.

Return:

• boolean

  -true if user has input fields and necessary permisions in order to get inside data.

  -false on the opposite way.

Since:

• 30/12/2016

Adds a line on a basket shopping dynamically. New line will have all values as a parameters. In addition, it will be as mode edition and cursor will be on the first field editable.

Parameters:

• p_boxid: string/number

  It can be either nmemotèchnic code of (boxcode) box, as intern identifier of (boxid) data base.

• values: Object[]

  Array of values to be assigned to new line. It must contain many registers as columns of shopping basket.

Deletes all data of a shopping basket.

Parameters:

• p_boxid: string/number

  It can be either nmemotèchnic code of (boxcode) box, as intern identifier of (boxid) data base.

Executes generation script for a shopping basket.

Parameters:

• p_boxid: string/number

  It can be either nmemotèchnic code of (boxcode) box, as intern identifier of (boxid) data base.

Close modal formauto opened previosly with openModalFormauto function

Since:

• 05/07/2018

It is a structure generated by a programmer in order to interpose the inspection of a column in front of an event. It is available by introducing a style code.

Deprecated

Converts a date to an user form to MDY format, ready to be used on SQL sentence.

Parameters:

• date: string

  Date on user format.

Returns:

• string

  Date on MDY format.

Since:

• 14/12/2016

This function has same functionality as executeQueryMap, with the difference that server connection is done by asynchronous way. In consequence, function finalizes before receive server answer; for this reason, function don't return obtained result. It is needed to collect it through success function passed as a parameter.

Parameters:

• query_code: string

  Identifier of SQL sentence to be executed. Each sentence must be previously defined on a table wic_jrep_form_query for actual object.

• params: Object[] (Optional)

  Execution parameters of the query, that will be replaced with query characters '?'. This parameters have to be defined before on wic_jrep_form_query_field table for actual object and query defined for query_code.

• success: function (Optional)

  The Function is executed when SQL Sentence is executed successfully. The function receives following parameters:

  * data: Map with objects returned by sentence on JSON format, where each key corresponds with resultSet alias of resultSet created by the execution of SQL sentence.

  It is also possible to obtain data from the object by data.get("index") function.

• error: function(optional)

  Function to be executed in case that SQL Sentence couldn't be executed. Function receives following parameters:

  * errmsg: Error message.

Since:

• 14/04/2016

This function has same functionality as executeQueryValue, with the difference that connection with server is done by asynchronous way. In consequence, function finalizes before receiving server answer; for this reason, function doesn't return the obtained result, it is needed to collect it through function success reflected as a parameter.

• query_code: string

  Identifier SQL sentence to be executed. Each sentence has to be defined on table wic_jrep_form_query to actual object.

• params: Object[] (Optional)

  Execution parameters of the query that will be replaced by characters '?' of the query. These parameters have to be defined on wic_jrep_form_query_field table to actual object and the query has to be defined by with a query_code.

• success: function (Optional)

  Function executed when SQL sentence has been executed successfully. Function receives following parameters:

  * data: Map with objects returned by sentence on JSON format, where each key corresponds with resultSet alias of resultSet created by the execution of SQL sentence.

  It is also possible to obtain data of the object through function data.get("index").

• error: function (Optional)

  Function to be executed in case that SQL Sentence couldn't be executed. Function receives following parameters:

  * errmsg: Mensaje de error.

Since:

• 14/04/2016

This function has same functionality as executeQueryValue, with the difference that connection with server is done by asynchronous way. In consequence, function finalizes before receiving server answer; for this reason, function doesn't return the obtained result, it is needed to collect it through function success reflected as a parameter.

Parameters:

• query_code: string

  Identifier of SQL sentence to be executed. Each sentence has to be defined on table wic_jrep_form_query to actual object.

• params: Object[] (Optional)

  Execution query parameters, that will be replaced by '?' characters of the query. These parameters have to be defined before on wic_jrep_form_query_field table for actual object and query defined by query_code..

• success: function (Optional)

  Function executed when SQL sentence has been executed successfully. Function receives following parameters:

  * data: objects map returned by sentence on JSON format, where the key of each attribute is related with resultSet alias generated by SQL sentence execution.

  It is also possible to obtain object data through data.get("index") function.

• error: function (Optional)

  Function executed in case that SQL sentence couldn't be executed. Function receives following parameters:

  * errmsg: Error message

Since:

• 14/04/2016

Executes defined action for a form associated with a defined box when it isn't hide out or disabled by hiding/activation expressions on button definition.

Deprecated:

• 20/05/2019

  Instead of that, use function executeFormAction.

Parameters:

• p_boxid: string/number

  It can be either nmeotechnic (boxcode) box, or intern identifier of database (boxid).

• btnpos: integer

  Button position, with identifier box, determines button to be executed.

Executes defined action for a form button related with a determinated box when it doesn't be hide out or disabled by expressions of hiding/activation of button definition.

Deprecated:

• 20/05/2019

  Instead of that, use function executeFormAction.

Parameters:

• btnpos: integer

  Button position with box identifier determines the button to be executed.

Fires click event on an observable box. (Observable box has to support it event)

Settings Parameters:

• p_boxid: string or number

  Observable box Id or memotecnic

• p_record

  JSON with the record used to refresh the observer box.

Example:

executeClickObservableEvent ("BOX_SQLTABLE", { id:1 })

Allows to force the elimination of an actual register when user has necessary permissions.

Since:

• 11/01/2017

Executes action defined by its mnemonic code.

Parameters:

• action_code: string

  Mnemotechnic code.

Allows to force the insertion of an actual register when user has necessary permissions.

Since:

• 11/01/2017

Executes an SQL Sentence defined before on actual object. All parameters have always been received as an objects as Javascript (string, number, Date, ...) Sentence result can return a single register.

Parameters:

• query_code: string

  Identifier of SQl sentence to be executed. Each sentence has to be defined before on the table wic_jrep_form_query for actual object.

• params: Object[] (Optional)

  Execution parameters of the query, that will be replaced by '?' characters of the query. This parameters have to be defined before on wic_jrep_form_query_field table for actual object and the query defined by query_code.

• success: function (Optional)

  Function to be executed when SQL has been executed successfully. Function receives following parameters:

  * data: It is a map with returned objects by sentence on JSON format, where the key of each attribute is related with resultSet alias created by the execution of SQL sentence.

  It is also possible to obtain data of the object through data.get("index") function.

• error: function (Optional)

  Function executed when SQL Sentence can't be executed. Function receives following parameters:

  * errmsg: Mensaje de error.

Returns:

• Object[]

  Returned objects by sentence on JSON format, where the key of each attribute is related with resultSet alias created by the execution of SQL sentence. If sentence doesn't return any register, function will return null.

Since:

• 14/04/2016

Executes an SQL Sentence defined on the actual object. All parameters are received as Javascript objects (string, number, Date, ...) Result of the Sentence can be returned with a single register.

Parameters:

• query_code: string

  Identifier of SQL sentence to be executed. Each sentence has to be defined before on wic_jrep_form_query table for the actual object.

• params: Object[] (Optional)

  Execution parameters of the query that will be replaced by '?' characters of the query. These parameters have to be defined before on wic_jrep_form_query_field table to actual object and query defined by query_code.

• success: function (Optional)

  Function executed in case that SQL sentence couldn't be executed. Function receives following parameters:

  * data: Returned objects by sentence on JSON format, where the key of each attribute is related with resultSet alias created by the execution of SQL sentence.

  It is also possible to obtain object data through data.get("index") function.

• error: function (Optional)

  Function executed in case that SQL sentence couldn't be executed. Function receives following parameters:

  * errmsg: Error message.

Returns:

• string/number

  Returned value by SQL sentence.

Since:

• 14/04/2016

Executes an SQL sentence defined before on the actual object. Parameters have always been received as Javascript objects (string, number, Date, ...) Sentence result can return a single register.

Parameters:

• query_code: string

  SQL identifier to be executed. Each sentence has to be defined before on wic_jrep_form_query for the actual object.

• params: Object[] (Optional)

  Execution parameters of the query, that will be replaced by '?' characters. These parameters have to be defined before on wic_jrep_form_query_field table for actual object and the query defined by query_code.

• success: function (Optional)

  Function executed in case that SQL sentence couldn't be executed. Function receives following parameters:

  * data: It is a map with returned objects by sentence on JSON format, where the key of each attribute is related with resultSet alias created by the execution of SQL sentence.

  It is also possible to obtain data of the object through data.get("index") function.

• error: function (Optional)

  Function executed in case that SQL sentence couldn't be executed. Function receives following parameters:

  * errmsg: Error message.

Returns:

• Object[]

  Array with returned objects by sentence on JSON format, where the key of each attribute is related with resultSet alias created by the execution of SQL sentence.

Since:

• 14/04/2016

Allows to force cursor loading. Function forces execution of SQL sentence of the object.

Parameters:

• mandatory: boolean (Optional)

  Allows to indicate if confirmation reload message can be omitted.

  -true, doesn't need reload confirmation.

  -false, needs confirmation.

  Default value: true.

Since:

• 11/02/2015

Allows to force form reset if user has all needed permissions.

Since:

• 11/01/2015

Fires select event on an observable box. (Observable box has to support it event)

Settings Parameters:

• p_boxid: string or number

  Observable box Id or memotecnic

• p_records

  Array JSON with the records used to refresh the observer box.

Example:

executeSelectObservableEvent ("BOX_SQLTABLE", [{ id:1 },{ id:2 },{ id:3 },{ id:4 }])

Allows to force form modification when user has all needed permissions.

Since:

• 11/02/2017

Obtains a single database identifier for a form box (boxid) through nmemotechnical code of the box.

Parameters:

• nmemo: string

  Nmemotechnical code of the box.

Returns:

• number

  A single identifier of the box related with nemotechnical received.

Obtains the selection of a box with all selectable data. It is only applicable to boxes of SQL-IMGLIST, SQL-TABLE, SQL-TREE, SQL-BLOB types.

Parameters:

• p_boxid: string/number

  It can be either nemotechnical of (boxcode) box or intern identifier of (boxid) database.

Returns:

• Object[]

  Array with selected data.

Obtains data and current time, depending on the defined timetable of the system for connection user.

Returns:

• string

  Date and actual time.

Obtains the row which is being edited.

Deprecated:

• 01/10/2016

Returns:

• integer

  Row Index which is being edited. First row is number 0. Returns -1 in case of not being any edition row.

Obtains current data base.

Returns:

• string

  Data base code.

Obtains dictionary whom object has been defined as a last resort; depending on dictionaries priority order defined by current data base.

Returns:

• string

  Dictionary code where object has been defined.

Obtains form field identified by indicated name.

Parameters:

• fieldName: string

  Field section.

Returns:

• domEl

  Form field identified by indicated name.

Determines if a field has been identified from last transaction or form load.

Parameters:

• fieldName: string

  Field name.

Returns:

• boolean

  -true if field value had any modification.

  -false on the opposite way.

Obtains error message of a field.

Parameters:

• fieldName: string

  Name of the field where error message will be obtained.

Returns:

• string

  Error message that affects the field. In case that field doesn't have any error, it will be null.

Determines if it exists more than one field on the form with same name.

Parameters:

• field: domEl/domEl[]

  Field or array of fields from the form.

Returns:

• boolean

  -true if it exists more than one field on the form with same name.

  -false on the opposite way.

Obtains value of a field from a form.

Parameters:

• fieldName: string

  Field name.

• withoutAlert: boolean (Optional)

  Indicates if it is needed to communicate an error in case of not finding any field on the form by an indicated name.

Returns:

• string/number

  Field value. In case of not find the field, it will be null.

Example:

getFieldValue("ts_cloud_preventive_lines.preventive_lines_cabid");

Obtains first element of an array. When user obtains multiples results of a query, hastable values are strings arrays. This method allows to obtain the first of elements.

Parameters:

• data: array

  Array of data whom user will obtain the first element.

Returns:

• string

  First element of the array. In case that parameter received is not an array, it will return same parameter.

Recovers a variable of a group of global variables.

Parameters:

• tabname: string

  Table names which identifies sensitive fields to be assigned with a value.

• colname: string

  Name of the defined column on exit columns of the father questionnaire.

Returns:

• number

  Variable of a global variables group.

Recovers a variable of a group of global variables. It will be a string or an array javascript:

Parameters:

• tabname: string

  Table names which identifies sensitive fields to be assigned with a value.

• colname: string

  Column name defined on output columns of the father form.

Returns:

• Object[]

  Variable of a global variables group.

Recovers a variable of a group of global variables.

Parameters:

• tabname: string

  Table names which identifies sensitive fields to be assigned with a value.

• colname: string

  Column name defined on output columns of the father form.

Returns:

• string

  Variable of a global variables group.

Obtains a defined tag on data base dictionary for user language. In case of not finding a tab, it returns the text by default. If any text has been defined by default, it returns código_de_idioma.código_etiqueta; for example EN.LBL_NAME

Content tag can have dinamically references, through {i} syntax. Where {0}, {1}, ..., {n} references will be replaced by corresponding parameters that recive function through third parameter.

For this reason, a message of type:

The value must be defined between {0} and {1}".

Considering a call as following case:

getLabelMessage("LBL_RANG", "Default message...", 1, 8);

It will return:

"The value must be defined between 1 and 8".

Parameters:

• code: string

  Tag code.

• defmsg: string (Optional)

  Message by default to be returned in case of not finding the tag for user language.

• param3,param4,...,paramN: string (Optional)

  Arguments to be replaced by message if references {0}, {1}, ..., {N} are used.

Returns:

• string

  Defined tag on actual database dictionary to language user or, default text.

Obtains an object code of the father form.

Returns:

• string

  Object code of the father form.

Since:

• 29/12/2016

Obtains the value of the father column form. That is to say, form is located above actual form. Returned value is always a string.

Parameters:

• colname: string

  Column name defined on output columns of the father form.

Returns:

• string

  Column value of the father form.

Since:

• 29/12/2016

Obtains value of a column form father. That is to say, the form which is located above actual form. Returned value is always a Javascript object.

Parameters:

• colname: string

  Column name defined on output columns of the father form.

Returns:

• Object[]

  Column value of the father form.

Since:

• 29/12/2016

Obtains sql condition used to make the cursor.

Parameters:

• excludevars: boolean

  Flag indicating the condition must no contain variables

Returns:

• string

  Condition

Since:

• 05/07/2018

Executes an SQL Sentence based on current data base. Sentence result has to return an only register. All data have always been located for the user, this means that all data are on legible format and numbers can include decimal markers.

Deprecated:

• 14/04/2016

  Instead of that, use functions executeAsyncQueryValue or executeQueryValue.

Parameters:

• sql: string

  SQL/XML Sentence to be executed against current database.

• doNotUseCache: boolean (Optional)

  Indicates if the Sentence is executed on cache.

  -true Sentence is not obtained as cache and it has always access to database.

  -false Conversely, when Sentence is executed, next calls will obtain the result from the cache.

  Value by default: false

• callback: function (Optional)

  Function executed in case of not being executed successfully the SQL Sentence. Function receives following parameters:

  * qryvalue: Value returned by SQL Sentence.

• errcallback: function (Optional)

  Function executed in case that SQL Sentence has been executed successfully. Function receives following parameters:

  * errmsg: Error message.

  * errtrace (Optional): Trace error.

  * errtype (Optional): Identification code of error type.

  * errstmt (Optional): Sentence which has caused the error.

• scope: function (Optional)

  Field with callback functions and errcallback.

Returns:

• map

  It returns map execution, where the key is the name of the column and the value is the date which is corresponds with the column.

Example:

getQueryValue(
                        "SELECT NVL(MAX(corrective_lines_orden),0) orden FROM ts_cloud_corrective_lines " +
                        "WHERE corrective_lines_cabid = " + m_cabid, true // not-cached
                        );

Executes an SQL Sentence based on current data base. Sentence result has to return an only register. All data have always been located for the user, this means that all data are on legible format and numbers can include decimal markers.

Deprecated:

• 14/04/2016

  Instead of that, use functions executeAsyncQueryValues or executeQueryValues.

Parameters:

• sql: string

  SQL/XML Sentence to be executed against current database.

• doNotUseCache: boolean (Optional)

  Indicates if Sentence is executed on cache.

  -true, Sentence is not obtained as cache and it has always access to database.

  -false Conversely, when Sentence is executed, next calls will obtain the result from the cache.

  Value by default: false

• allowMultipleRows: boolean (Optional)

  Indicates if execution result can return more than one register.

  Value by default: false

• callback: function (Optional)

  Function executed in case of not being executed successfully the SQL Sentence. Function receives following parameters:

  * qryvalue: Returned value for SQL Sentence.

• errcallback: function (Optional)

  Function executed in case that SQL Sentence has been executed successfully. Function receives following parameters:

  * errmsg: Error Message.

  * errtrace (Optional): Trace error.

  * errtype (Optional): Identification code of error type.

  * errstmt (Optional): Sentence which has caused the error.

• scope: function (Optional)

  Field of callback and errcallback functions.

Returns:

• map/map[]

  Returns all results of map execution, where the key is the name of the column and the value is the date which is corresponds with the column. In case of not indicate that function can return multiple registers, function result is an array.

Example:

getQueryValues("SELECT cop_producto.titesp, cop_producto.tipcen, cop_producto.codcen, 
                gcentros.nombre " + "  FROM cop_producto, gcentros " +
                                    " WHERE cop_producto.idprod = " + field.value +
                                    "   AND cop_producto.tipcen = gcentros.tipcen " +
                                    "   AND cop_producto.codcen = gcentros.codigo "
);

Obtains object code of the form.

Returns:

• string

  Object code

Obtains object code of the form. In case of being an alias, it returns the code of original object. All alias are tags that allow access to an object with a different name as the original; defined through wic_jrep_object_alias maintenance

Returns:

• string

  Object Code

Obtains value of a field form with necessary format in order to send to the server. This, returns a Javascript object instead of a text chain located for user. This function is useless for calls functions like executeQueryValue.

Parameters:

• fieldName: string

  Field name.

Returns:

• Object[]

  Field value. In case of not find the field, it returns null.

Obtains actual time, according to the schedule system for connection user.

Returns:

• Actual Time.

Obtains current date, depending on schedule system defined for connection user.

Returns:

• string

  Actual date.

Obtains transaction size, this means, number of editable rows on a multirow form.

Returns:

• integer

  Number of editable rows of the form.

Obtains Axional Studio user.

Returns:

• string

  Code Axional Studio user.

Obtains value of a form variable.

Parameters:

• varname: string

  Variable name.

Returns:

• Object[]

  Name value of a form variable, based on a parameter.

Since:

• 29/12/2016

Determines if a field allows to select multiples values through (SoftReferences) references window. On this case, when registers are being selected, values are being added divided by '|'.

Parameters:

• fieldName: string

  Field name whom it will know if multiple selection has been accepted.

Returns:

• boolean

  -true if the field accepts multiple selection.

  -false if not.

Determines if a form has available transactions (insertion, modification or erasing). If there aren't transactions, inputs are not emitted, and for this reason, can't be accessed functions as getFieldValue, setFieldValue, etc.

Returns:

• boolean

  -true if the form has any available insertion transactions, modification or erasing.

  -false if not.

Example:

if (!hasTransactions()){
    return false;
}

This structure was used from tags to global variables generation. This parameterization is done through wic_jrep_form_globals maintenance.

Deprecated:

• Function by compatibility of wic is maintained with two surroundings Jetty and Tomcat.

Forces user to execute form reset before insertion.

Determines if a field is a date type.

Parameters:

• fieldName: string

  Field name.

Returns:

• boolean

  -true if field is a date type.

  -false if not.

Determines if a field is a numeric type.

Parameters:

• fieldName: string

  Field name.

Returns:

• boolean

  -true if a field is a numeric type.

  -false if not.

Determines if Javascript console of user is available.

Returns:

• boolean

  -true if the console is available.

  -false if not.

It determines if the form accepts multiples registers.

Returns:

• boolean

  -true if it is a form with multiple registers.

  -false if the form shows one register.

This function is temporary and is used during system migration to Jetty, Java8, Jersey, etc.

Returns:

• boolean

  -true if the system is compatible with Jetty, Java8, Jersey, etc.

  -false if not.

Determines if a form is ready to realize the insertion. It only has sense the question and it has used the isOnUpdate negation.

Returns:

• boolean

  -true form reset is executed and ready for insertion.

  -false if not.

Determines if a form is ready to realize the modification. It only happens when the form has modification permits and a reset has not been made.

Returns:

• boolean

  -true form is ready in order to make a modification.

  -false if not.

Determines if a column belongs to a form.

Parameters:

• colname: string

  Column name.

Returns:

• boolean

  -true if a column is included on input fields of the form.

  -false if not.

Since:

• 27/12/2016

Determines if a form is a reading type. It means that insertion transaction and modification are not available. On a reading type form, inputs not emitted, can't be accessed by getFieldValue, setFieldValue functions.

Returns:

• boolean

  -true if the form has some insertion/modification transactions available or if it has unconditional input sign.

  -falseif not.

Determines if there is any selected register on the form.

Returns:

• boolean

  -true if there is a selected register on the form.

  -false if not.

Since:

• 29/12/2016

Disables Javascript check of a data base restriction (CHECK CONSTRAINT) of the main table form. Deactivation is only done by form level, if transaction is finished and the restriction is not done, database will show the error. This function allows to delegate, the modification of some value register in order to achieve the restriction to triggers of database.

Parameters:

• name: string

  Restriction name to be deactivated.

Disables erased transactions of the form.

Parameters:

• reason: string

  Reason to deactivate the functionality. This data is informative and provides information when user consults object transactions situation.

Disables insert transactions of the form.

Parameters:

• reason: string

  Reason to deactivate the functionality. This data is informative and provides information when user consults object transactions situation.

Disables reset transactions of the form.

Parameters:

• reason: string

  Reason to deactivate the functionality. This data is informative and provides information when user consults the object transactions situation.

Allows to deactivate dynamically, after the insertion of a register, new register will be fixed as unique element of the cursor. This is useful for headboard but not for lines.

Disables modification transactions of the form.

Parameters:

• reason: string

  Reason to deactivate this function. This data is informative and provides information when user consults object transactions situation.

Deactivate hard existense verification.

Deprecated:

• 03/02/2014

  Use function setFieldExistDisableVerify instead.

Parameters:

• fieldName: string

  Field name.

Example:

JSQL_disableVerifyExist("gcompedl.udmpre");

Allows the existence of editable fields on a form without insertion transactions nor modification. For example, line selectorstoFile.

Deprecated:

• 28/12/2016

  This function is not supported by the system.

Activates hard existence verification.

Deprecated:

• 03/02/2014

  Instead use function setFieldExistDisableVerify.

Parameters:

• fieldName: string

  Field name.

Example:

JSQL_enableVerifyExist("gcompedl.udmpre");

Executes an SQL/XML Sentence and recharges form after its execution. Moreover, it forces main Sentence object to be executed again. For this reason, it is possible to update form data in case that sent result Sentence can modify them.

Deprecated:

• 14/04/2016

  Because of security reasons, this function cannot be executed.

Parameters:

• cmd: string

  SQL or XML Sentence to be executed against actual database.

• cmd_crc: string

  CRC Code of actual register to verify data integrity. This is a code composed by MD5 of register content, which allows to verify that register content hasn't been changed from last load of the form.

• args: string[] (Optional)

  Arguments list which is sent in case that sentence has references to entry parameters through '?' character.

Obtains tag defined on dictionaries of actual database for user language.

Deprecated:

• 01/10/2016

  This function can't be used again. It is needed to use getLabelMessage function.

Parameters:

• code: string

  Tag code.

Obtains necessary syntax in order to make a call to XSQL-Script through some function as getQueryValue or getQueryValues.

Deprecated:

• 14/04/2016

  Instead of that, use functions as executeAsyncQueryValue, executeAsyncQueryValues, executeQueryValue o executeQueryValues.

Parameters:

• scriptname: string

  Process name XSQL-Script to be executed.

• arg1,arg2,...,argN: Object(optional)

  Received parameters after the name, are sent as arguments to XSQL-Script process.

Example:

JSQL_MakeXSQLScriptCall("gcompedl_js_getinfo", m_gcompedh_cabid, m_linid);

It rounds a decimal value with indicated precision.

Parameters:

• num: number

  Value to be rounded.

• dec: number

  Precision.

Returns:

• number

  Rounded value.

Since:

• 14/12/2016

The openModalFields is a pre-defined function used by a user program that allows to show a modal window with messages and/or form fields and execute a callback function on click accept button.

This function expects 5 params openModalFields (title, message, fields, buttons, callback).

Parameters:

• title: string

  Title name of modal window.

• message: string (Optional)

  Simple paragraph on body modal window.

• fields: JSONObject[] (Optional)

  List of form fields.

  • name: Internal value to identify the type.

  • label: Text to show as label.

  • type: field type

    • 0: Text

    • 1: TextArea

    • 2: Integer

    • 3: Decimal

    • 4: Date

    • 5: Datetime

    • 6: Checkbox

    • 7: Select

  • decimalPrecision: decimal precision of number (In case of decimal)

  • value: Initial value

  • trueVal: true value (In case of checkBox)

  • falseVal: false value (In case of checkBox)

  • values: list of a select. JSONObject[] [{code:.... , label:....] (In case of Select)

  • sref_tabname: Soft References table name (In case of Select with autocomplete)

  • sref_method: Soft References method (In case of Select with autocomplete)

• buttons: JSONObject[] (Optional) (Since: 02/05/2019)

  Add customized buttons. List of buttons fields:

  • text: Text of button.

  • click: Function to execute when click the button. (Is possible use this.close() to close the Window)

  • colortype:

    List of values:

    • W: Warning.

    • A: Alert.

    • C: Confirm.

    • I: Info.

• callback: function

  Function to execute when click on Accept button.

Since:

• 19/06/2018

Example:

openModalFields(
 	"Title", 
 	"", 
 	[
 		{
 			"name": "Zero",
 			"label": "LABEL_TEXT",
 			"type": 0,
 			"value": "Hello World!"
 		},
 		{
 			"name": "One",
 			"label": "LABEL_TEXTAREA",
 			"type": 1,
 			"value": "Lorem ipsum dolor sit amet, ...."
 		}, 
 		{
 			"name": "Two",
 			"label": "LABEL_INTEGER",
 			"type": 2,
 			"value": 25
 		},
 		{
 			"name": "Three",
 			"label": "LABEL_DECIMAL",
 			"type": 3,
 			"decimalPrecision": 3,
 			"value": 25.12
 		},
 		{
 			"name": "Four",
 			"label": "LABEL_DATE",
 			"type": 4,
 			"value": "2018-06-15"
 		},
 		{
 			"name": "Five",
 			"label": "LABEL_DATETIME",
 			"type": 5,
 			"value": "2018-06-15"
 		},
 		{
 			"name": "Six",
 			"label": "LABEL_CHECKBOX",
 			"type": 6,
 			"value": 1,
 			"trueVal": 1, 
 			"falseVal" : 0,
 		},
 		{
 			"name": "Seven",
 			"label": "LABEL_SELECT",
 			"type": 7,
 			"value": "it",
 			"values" : [
 				{value : "de", label : "Germany"},
 				{value : "fr", label : "France"},
 				{value : "uk", label : "United Kingdom"},
 				{value : "it", label : "Italy"},
 				{value : "es", label : "Spain"}
 			]
 		}
 	], 
 	null,
 	function(form) { alert("HELLO CALLBACK FUNCTION " + form.Three); }
 );

The openModalFormauto function allows to show a modal window with title and the iframe of object.

This function expects 6 params openModalFormauto (title, rep_code, cond, vars, closecallback, allowDetach).

• title: string

  Title name of modal window.

• rep_code: string

  Object code.

• cond: string

  Filter condition.

• vars: JSONObject (Optional)

  JSON object with variable names as the object keys and variable values as the object values.

• closecallback: function

  Function to execute on close modal.

• allowDetach: boolean

  Allow detach button.

Since:

• 19/06/2018

Example:

openModalFormauto(
                         	"Hello World!", 
                         	"studio_link_form_withvars",  
                         	"1=1",
                            { 
                                "INTVAR1": 25,
                                "DECVAR1": 1.2,
                                "DATEVAR1": "25-05-2018",
                                "DATETIMEVAR1": new Date()
                            },
                            function() { console.log("OK") },
                            false
                         );

Emits an error sound.

Shows/Hides out a box of the form.

Parameters:

• p_boxid: string/number

  It can be nmeotecnic box code (boxcode) or the internal identifier of (boxid) database.

• visible: boolean (Optional)

  -true where box is shown.

  -false where box is hide out.

  Value by default: true.

Shows/hides out a group of boxes. These have not belong to same datablock or grupo.

Parameters:

• boxes: JSONObject

  Structure which contains boxes and the visibility of each. This structure is { boxid: visible, ... }, where:

  boxid: It can be nmeotecnic box code (boxcode) or the internal identifier of (boxid) database.

  visible: -true where box is showed. -false box is hide out.

Allows to disable/enable a button of a box from the form when it is not hided out or disabled by hide out/activation expressions on button definition.

Parameters:

• p_boxid: string/number

  It can be nmeotecnic box code (boxcode) or the internal identifier of (boxid) database.

• btnpos: integer

  Button position, with box identifier, determines the button which is going to be disabled/enabled.

• btnpos: integer (Optional)

  -true where button is disabled.

  -false where button is enabled.

  Value by default: true.

Allows to disable/enable a button of a box from the form when it is not hided out or disabled by hide out/activation expressions on button definition.

Parameters:

• btnpos: integer

  Button position, with box identifier, determines the button which is going to be disabled/enabled.

• btnpos: integer (Optional)

  -true where button is disabled.

  -false where button is enabled.

  Value by default: true.

Activates the file indicated for edition. This function can be only used with multirow forms.

Deprecated:

• 01/10/2016

  This function can't be used again. There is not an alternative function as it is impossible to add field events on multirow forms.

Parameters:

• rowindex: integer

  Row index which is going to be editable. First row is number 0.

Shows/Hides out a full datablock. This is a box a group of boxes of the form located on same cell.

Parameters:

• blockID: number

  Block identifier. This is related with block position on the form.

• visible: boolean (Optional)

  -true it is showed on boxes block.

  -false it is hided out on boxes block.

  Value by default: true.

Allows to force modified state on a field. When a field is modified, by manuall o programm mode, this is marcked as modified. For this reason, before doing a transaction, a group of series is executed (is needed to prove the integrity, execution onChange event, etc.). Through this function, is possible to change modified indicator in order to emit or force execution of these actions.

Parameters:

• fieldName: string

  Field name.

• changed: boolean

  -trueit is marked as modified and specific actions will be executed.

  -false it is marked as no modified.

• execute: boolean (Optional)

  -true field change event is executed.

  -false field change event is not executed.

Example:

setFieldChanged("inf_pedidos.tercer", true);

It marks a field with indicated error. When a field with an error is marked, its style changes and it doesn't allow to move forward subsequent fields of the form. It also disables the possibility of inserting or modifying the register.

Parameters:

• field: domEl

  Field form which is marked with a mistake.

• error: string

  Error message of the field.

• isFormatingError: boolean (Optional)

  -true if an error becomes from a format problem.

  -false on the other hand.

  Value by default: false.

Example:

setFieldError(field," It can't be inserted dates before as" + (anoest -1) + ".", true);

For a field related with integration, determine that on the object and for SQL Condition defined, can exist more than one register with indicated value on the field. Conversely, in case of being this situation, field will be marked with the mistake.

Parameters:

• fieldName: string

  Field name.

• allowmr: boolean (Optional)

  -true integration allows multiples registers with same identifier.

  -false it can be only a register for indicated code.

Example:

setFieldExistAllowMultipleRows(field.name);

For a field related with integration, is needed to define if it is necessary integration with destination object. Otherwise, integrity relation is used to choose a possible value, but no defined values can be used on the destination object.

Parameters:

• fieldName: string

  Field name.

• disable: boolean

  -true integration relation becomes no restrictiva and allows to use non exist value on destination.

  -false relation is restrictiva.

Modifies integrity references of a field. Usually, integrity references are defined by a foreign key existence (Hard Reference), or they are defined through integrity relation wic_jdic_collist (Soft References) maintenance. This function allows to define (Dynamic References) dinamic relations, managed by programm way. Query, defines possible values that can adopt current field. The object indicaded has to be defined in some of the dictionaries of actual database.

Parameters:

• fieldName: string

  Field name.

• objdest: string

  Target object of the referendum. Indicates the SQL object that, together with the query condition, defines the possible values that the current field can adopt. The object indicated here must be defined in one of the dictionaries of the current database.

• coldest: string

  Name of the column that contains the possible values that the field may adopt.

• qrycond: string

  SQL condition that, together with the SQL clause of the destination object, delimits the number of valid records.

• noCache: boolean (Optional)

  -true each query is executed in the database.

  -false the SQL query runs in cache.

  Default value: false.

Example:

cond = "cop_partidas.codcon =" + getFieldValue("cop_amorestl.concep");
setFieldExistValues("cop_amorestl.codpar", "cop_partidas", "codpar", cond);

Locate the cursor in the indicated field.

Parameters:

• fieldName: string

  Field Name.

It allows to indicate if a field is editable or not. An editable field allows you to change its value manually using the corresponding form field. Otherwise, the field can not be modified manually, although it is possible to change its value via program.

Parameters:

• fieldName: string

  Field Name.

• noEntry: boolean (Optional)

  -true the field becomes read-only and, therefore, can not be modified manually.

  -false the field is editable.

  Default value: true.

Example:

setFieldNoentry(wic_ldap_authenticators.connection_name, true);

It allows to indicate if a field is required or not. A required field for which no value has been assigned, prevents both placing the focus in subsequent fields of the form assigning any value to it, as well as performing insertion and modification transactions.

Parameters:

• fieldName: string

  Field name.

• isNullable: boolean

  -true the field becomes not required and, therefore, it is not necessary to assign any value to it.

  -false the field is required and the system does not allow to leave it blank.

  Default value: true.

Example:

setFieldNullable('agc_terceros.nombre',true);

Indicates that the field should not be affected by the reset.

Parameters:

• fieldName: string

  Field name.

Sets the value of a form field.

Parameters:

• fieldName: string

  Field name

• fieldValue: string/number

  In general, it always receives a String, but for the numeric, either a String formatted in the user's format is sent, or a Number is sent (it is formatted for the user). It is an error to send a String formatted as a javascript number.

• noVerifyExistNeed: boolean (Optional)

  In the case of a field with integrity reference (SoftReference), it indicates whether the integrity of the defined value is checked.

  -true integrity is not checked.

  -false it is checked

  Default value: true.

Example:

m_orden = (1 * m_orden + 2);
setFieldValue("ts_cloud_corrective_lines.corrective_lines_orden", m_orden, true);

Make a massive assignment of values to fields of the form from a table and a data structure.

Parameters:

• tabname: string

  Name of the table that identifies the fields that are likely to be assigned a value.

• map: map

  Data structure that contains as key the name of the column and as the value the data to assign.

It allows hiding / displaying a field dynamically. In case the field has a label (label) it is also affected by the visibility of the field.

Parameters:

• fieldName: string

  Field name.

• visible: boolean(optional)

  -true both field and label is displayed.

  -false field and label is hidden.

Sets the value of a field. A field can have a fixed value because it comes from a selection or from a href.

Parameters:

• fieldName: string

  Field name.

Install a set of global variables.

Parameters:

• tabname: string

  Name of the table that identifies the fields that are likely to be assigned a value.

Forces the user to execute the form reset before inserting.

Deprecated:

• 03/02/2014

  Use the insertRequiresReset function instead.

Indicates the row size of the insert transaction.

Parameters:

• size: number

  Size or number of rows, of the insert transaction.

Displays a dialog screen with the detail of an error.

Parameters:

• errOpts: JSONObject

  Structure that contains the detail of the error to be displayed. The following shows the parameters that the structure must contain:

  * errmsg: Error message.

  * errstat (Optional): Error status.

  * errtrace (Optional): Trace of the error.

  * errtype (Optional): Identification code of the types of error.

  * errstmt (Optional): Sentience that caused the error.

Indicates the row size of the insert transaction.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• data: string

  Text string in DOT format with which the graphic will be updated.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• callback: function (Optional)

  Function to execute when the event is triggered.

• scope: function (Optional)

  Scope of the callback and errcallback functions.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• numpage: number

• callback: function

  Function that is executed in case the SQL Sentience has been executed successfully. The function receives the following parameters:

  * qryvalue: Value returned by the SQL Sentience.

• scope: function (Optional)

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Mark a text portion of a text column of the Blob object.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• regex:

• group:

• offsetRows:

• offsetCols:

• nRows: number

  Number of rows.

• nCols: number

  Number of columns.

Add an event to the table. It allows to indicate the execution of a function when a certain event is triggered. The events contemplated are:

# onload: It runs every time the table is loaded.

# before_insert (rowid): It is executed before inserting a new row. If the function of the event returns false, the insertion of the row is foreseen.

# after_insert (rowid): Run after the row has been inserted successfully.

# before_update (rowid): It is executed before modifying a row. If the function of the event returns false the modification of the row is foreseen.

# after_update (rowid): Run after the row has been modified successfully.

# after_delete (rowid): Run after the row has been deleted successfully.

# row_deselect (rowid): It runs the moment a row is unchecked as selected.

# row_select (rowid): It is executed at the moment a row is marked as selected.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• evtname: string

  Name of the event for which you want to add the function.

• callback: function

  Function to execute when the event is triggered.

Add a column event. It allows to indicate the execution of a function when a certain event is triggered. The events contemplated are:

# before (field): It is executed when the field receives the focus.

# after (field): It is executed when the field is exited, if the value has been modified.

# input (field):It is executed every time the value is modified.

# blur (field): It is executed when leaving the field.

# validate (field): It is executed when modifying the field. It allows to call the function sqltableSetFieldError to perform validations of customized data.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• colname: string

  Name of the column on which the event applies.

• evtname: string

  Name of the event for which you want to add the function.

• callback: function

  Function to execute when the event is triggered.

Add a line to the SQL table dynamically. The new line will be blank, only with the default values defined. The line will remain in edit mode and the cursor will be placed in the first editable field. In case of being a transactional table, the insertion in the database is not performed. It will save changes to the line via the save button or the ENTER key.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Delete all the contents of a SQL table. Deletion is only done locally, it does not affect the content of the database.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Get a SQL table of the form.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Return:

• domEl

  HTML element that represents the SQL table.

Gets the value of a cell in the SQL table.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• colname: string

  Name of the column from which you want to retrieve the value.

• rowid: number (Optional)

  Number of the row from which you want to retrieve the value. If a row number is not indicated, it obtains the value of the row that is in edition mode.

Return:

• string

  Value of the row and column indicated.

Gets the data of the selected rows in a SQL table.

Deprecated:

• 23/07/2018

  Instead of that, use function getBoxSelection.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Return:

• JSONObject[]

  Array with the selected rows; Each record in the array is a JSON structure in which the key is the column name and the value is the corresponding data in the SQL table.

Reloads the contents of the SQL table. To do this, rerun the SQL set against the server asynchronously.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Reloads the contents of the SQL table. To do this, rerun the SQL set against the server asynchronously.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• colexpr: Object

  Object of column expression as { 'colname1' : 'expr', 'colname2' : 'expr', ..., 'colnameN' : 'expr' }

• callback: Function (Optional)

  Function to execute after performing the search.

Return:

• boolean

  This function could be executed from the onclick event of an HTML link. You must return false to avoid opening an empty tab when you click on the link.

Example:

sqltableSearchBy("CLIPOT", {
                'cliente': getFieldValue('virtualtable.cliente'), 
                'articulo': getFieldValue('virtualtable.articulo')
});

Select a row from the SQL table.

Deprecated:

• 08/10/2014

  Use the sqltableToggleRowSelection function instead.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• rowid: number

  Number of the row to select.

It allows to define the error of a field of a row of the SQL table. Antención, this function can only be called from the event validate of the field, which can be defined by the function sqltableAddFieldEvent.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• colname: string

  Name of the column on which you want to change the value.

• errmsg: string

  Error message.

• rowid: number (Optional)

  Number of the row to which the field will be marked. If a row number is not indicated, assign the value to the row that is in edit mode.

Modifies the value of a cell in the SQL table.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• colname: string

  Name of the column on which you want to change the value.

• data: Object

  Value to assign.

• rowid: number (Optional)

  Number of the row to which the field will be marked. If a row number is not indicated, assign the value to the row that is in edit mode.

Modifies the selection of all rows in the SQL table.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Modifies the selection of a row in the SQL table.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• p_boxid: number

  Number of the row of the row to select.

Gets the data of the selected rows in a SQL tree.

Deprecated:

• 23/07/2018

  Instead of that, use functions getBoxSelection.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

Return:

• JSONObject[]

  JSON with the nodes selected. If the node has parents, it will be returned all parent levels.

Since:

• 05/07/2018

Refresh content of tree node. This function is asynchronous.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• p_parentnode: JSON

  Parent of node to be refreshed.

• p_nodeid: string

  JSON estructure with the ID fields of node to refresh. ID fiedls are defined on FORM SQL TREE NODES.

• onlyChildNodes: boolean (optional)

  Allows to indicate if only need refresh node childen.

• loadlcallback: function (optional)

  Function executed when node is loaded.

Since:

• 05/07/2018

Refresh content of tree node. This function is asynchronous.

Parameters:

• p_boxid: string/number

  It can be both the mnemonic code of the box (boxcode), and the internal identifier of the database (boxid).

• p_path: string

  Path of node to refresh. (Path use slash, and label to identify the node. Example: "/files/movies/Rocky IV")

• loadlcallback: function (optional)

  Function executed when node is loaded.

Since:

• 09/09/2019

Parameters:

• colname: string

  Name of the column on which you want to change the value.

Select all visible rows of a multi-selection form.

Deselects all visible rows of a multi-selection form.

Changes the selection of all visible rows of a multi-selection form.

Check if there is a selected row in a multi-selection form.

Return:

• boolean

  -true if there is a selected row in a multi-selection form.

  -false otherwise.