Funciones para trabajar con fields
Funciones para trabajar con fields
getCurrentField() | Devuelve un vínculo al objeto Field que usa el script personalizado actual. |
getFieldByName(namesPath) (*) | Devuelve un enlace al campo para el que se abrió el script personalizado. Ejemplo:
|
getFieldValue(namesPath) (*) | Devuelve:
namesPath | fieldObject:
|
setCurrentFieldValue(value, forced, onSaved) | Modifica el valor del campo para el que está abierto el script personalizado. Parámetros:
|
setFieldValue(namesPath | field, value, forced, onSaved) (*) | Modifica el valor del campo. Parámetros:
|
save() | Cierra la ventana en la que se ejecuta el script personalizado y guarda los cambios. |
cancel() | Cierra la ventana en la que se ejecuta el script personalizado sin guardar los cambios. |
(*) Para algunas de las funciones enumeradas arriba, la ruta al campo se especifica como un parámetro de entrada. Incluye el nombre del campo y los nombres de los elementos padre (grupo de campos, sección). Para tablas, tablas repetidas y grupos repetidos, debe especificar el número de instancia comenzando por 0 (cero). Ejemplo: donde [10] es el número de instancia del grupo repetido. | |
Funciones para trabajar con conjuntos de datos
Funciones para trabajar con conjuntos de datos
addEntity(entityInfo: {cacheName, columns, values}, onResult(newId)) | Añade una entrada al conjunto de datos. Parámetros:
|
editEntity(entityInfo: {cacheName, columns, values}, onResult()) | Edita una entrada en la base de datos. Parámetros:
|
getDict({cacheName, filters: [{FieldName, FieldValue}], cursorPos, allowMultipleColumnResults}, onResult (param: { FieldName, FieldValue, BoldMask}[][]) ) | Realiza una búsqueda en un conjunto de datos de un valor especificado o de una parte de este. Devuelve las cadenas coincidentes en el siguiente formato: [{FieldName Parámetros:
Si, por ejemplo, en un conjunto de datos está presente lo siguiente: CompanyName: ABBYY Supongamos que se realiza una búsqueda de los símbolos “ABB”. Entonces, se devolverá lo siguiente: [ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] Nota: El array devuelto puede contener varios valores, incluidos aquellos que inicialmente no cumplían las condiciones de búsqueda. Los resultados de búsqueda del array se ordenarán por el valor del parámetro BoldMask en orden descendente (es decir, empezando por las cadenas que mejor coincidan con las condiciones de búsqueda). |
getDictAll({cacheName, filters: {FieldName, FieldValue}}, }, onResult (param: { FieldName, FieldValue, BoldMask}[][])) | Realiza una búsqueda en la base de datos del valor completo especificado. Devuelve los valores de todos los campos encontrados. Parámetros:
[ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] Nota: El array devuelto puede contener varios valores, incluidos algunos que inicialmente no cumplían las condiciones de búsqueda. Los resultados de búsqueda del array se ordenarán por el valor del parámetro BoldMask en orden descendente (es decir, comenzando por las cadenas que mejor coincidan con las condiciones de búsqueda). |
Funciones para trabajar con el formulario del documento
Funciones para trabajar con el formulario del documento
selectRow(tablePath, rowNumber) (*) | Marca como seleccionada una fila de la tabla.
|
deselectRow(tablePath, rowNumber?) (*) | Quita la selección de una fila de la tabla.
|
scrollFormToField(namesPath) (*) | Desplaza el editor de formularios hasta que el campo quede visible.
|
getDomElementPosition(domId, onResult: (result?: {width, height, top, left, right, bottom})) | Obtiene la posición de un elemento en la ventana del editor de formularios y devuelve el resultado de una función de callback.
|
setStyles(styles, callback) | Agrega estilos CSS a la ventana del marco de la acción personalizada.
|
(*) En algunas de las funciones indicadas arriba, la ruta al campo se especifica como un parámetro de entrada. Incluye el nombre del campo y los nombres de los elementos primarios (grupo de campos, sección). Para tablas, tablas repetidas y grupos repetidos, debe especificar el número de instancia comenzando en cero. Ejemplo: donde [10] es el número de la instancia del grupo repetido. | |
Propiedades del objeto commandArgs
Propiedades del objeto commandArgs
commandArgs.params.document | Document | Almacena una copia del objeto de un documento abierto. Puede usarse para acceder a cualquier error, campo o región del documento actual. |
commandArgs.params.currentField | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField) | Devuelve una referencia a un objeto de campo que refleja el estado del campo en el momento en que se llama al script. Forma parte del documento indicado anteriormente. Nota: Si el valor del campo se modificó después de que se inicializó el script, los cambios no se aplicarán. |
commandArgs.params.appPath | cadena | El nombre de dominio del servidor. |
commandArgs.params.coordinates | Object | Las coordenadas del elemento DOM que llamó al script personalizado. |
commandArgs.params.currentElementDomId | cadena | El ID del elemento DOM que llamó al script personalizado. |
| Función | Descripción |
|---|---|
| commandArgs.events.addEventHandler | Agrega un controlador de eventos en el contexto global del script personalizado. |
| commandArgs.events.triggerHandlers | Desencadena un evento en el contexto global del script personalizado. |
| commandArgs.events.removeEventHandler | Elimina un controlador de eventos en el contexto global del script personalizado. |
campo de grupo de campos
campo de grupo de campos
Fields | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField)[] | De solo lectura | Array de campos |
HasTableLayout | Boolean | De solo lectura | Especifica si la región del campo es una tabla. |
Caption | cadena | De solo lectura | Nombre o título del campo personalizado |
FieldType | Number | De solo lectura | Tipo de campo. Valor posible: 4 – grupo de campos |
Id | Number | De solo lectura | ID del campo |
IsReadOnly | Boolean | De solo lectura | Especifica si la edición de campos no está permitida. |
IsVisible | Boolean | De solo lectura | Especifica si el campo es visible en el formulario de datos. |
MaxRegions | Number | De solo lectura | Número máximo de regiones del campo. Si el valor es -1, se permite cualquier número de regiones. |
Name | cadena | De solo lectura | Nombre interno del campo. |
NamePath | cadena[] | De solo lectura | Array de nombres de campos y grupos que forman la ruta al campo. |
NeedRecognize | Boolean | Lectura/escritura | Especifica si se debe recuperar de la región el valor del campo cuando se vuelvan a comprobar las reglas. |
Regions | {
| De solo lectura | Array de regiones.
|
Campo de sección
Campo de sección
Fields | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField)[] | De solo lectura | Array de campos |
Pageids | Number[] | De solo lectura | Identificadores de las páginas en las que se encuentra la sección. |
IsFlexible | Boolean | De solo lectura | Especifica si la sección es flexible. |
Caption | cadena | De solo lectura | Nombre del campo personalizado, caption |
FieldType | Number | De solo lectura | Tipo de campo. Valor posible: 6 – sección |
Id | Number | De solo lectura | ID del campo |
IsReadOnly | Boolean | De solo lectura | Especifica si la edición del campo no está permitida |
IsVisible | Boolean | De solo lectura | Especifica si el campo es visible en el formulario de datos. |
MaxRegions | Number | De solo lectura | Número máximo de regiones de campo. Si el valor es -1, se permite cualquier cantidad de regiones. |
Name | cadena | De solo lectura | Nombre interno del campo |
NamePath | cadena[] | De solo lectura | Array de nombres de campos y grupos que forman la ruta hasta el campo. |
NeedRecognize | Boolean | Lectura/escritura | Especifica si se debe recuperar el valor del campo desde la región cuando las reglas se vuelvan a comprobar. |
Regions | {
| De solo lectura | Array de regiones.
|
Campo de tabla
Campo de tabla
Filas | {
| De solo lectura | Lista de filas de la tabla. Parámetros del objeto de fila de la tabla:
|
Título | Cadena | De solo lectura | Nombre o título del campo personalizado |
FieldType | Number | De solo lectura | Tipo de campo. Valor posible: 7 – tabla |
ID | Número | De solo lectura | ID del campo |
IsReadOnly | Boolean | De solo lectura | Indica si no se permite editar el campo. |
IsVisible | Boolean | De solo lectura | Indica si el campo es visible en el formulario de datos. |
MaxRegions | Number | De solo lectura | Especifica si el campo es visible en el formulario de datos; -1 permite cualquier número de regiones. |
Name | Cadena | De solo lectura | Nombre de servicio del campo. |
NamePath | String[] | De solo lectura | Array con los nombres de los campos y grupos que forman la ruta hasta el campo. |
NeedRecognize | Boolean | Lectura/escritura | Especifica si se recupera el valor del campo de la región cuando se vuelven a comprobar las reglas. |
Regiones | {
| De solo lectura | Array de regiones.
|
campo de entrada de texto
campo de entrada de texto
Flags | Number[] | Lectura/escritura | array de la misma longitud que el campo Value. Consta de 0 y 1. 0 – un carácter que está en Value en la misma posición que el 0 en Flags requiere verificación. |
Sugerencias | String[] | De solo lectura | Lista de valores de campo sugeridos |
Value | String | Lectura y escritura | Valor del campo |
TextType | Number | De solo lectura | Tipo de campo de texto. Posibles valores:
|
Título | Cadena | De solo lectura | Nombre y título del campo personalizado |
FieldType | Number | De solo lectura | Tipo de campo. Valor posible: 0 – campo de texto |
ID | Número | De solo lectura | ID del campo |
IsReadOnly | Boolean | De solo lectura | Especifica si no se permite editar el campo. |
IsVisible | Boolean | De solo lectura | Especifica si el campo es visible en el formulario de datos. |
MaxRegions | Number | De solo lectura | Número máximo de regiones de campo. Si el valor es -1, se permite cualquier cantidad de regiones. |
Name | Cadena | De solo lectura | Nombre de servicio del campo. |
NamePath | String[] | De solo lectura | Array con nombres de campos y grupos que forman la ruta del campo. |
NeedRecognize | Boolean | Lectura/escritura | Especifica si se debe recuperar el valor del campo de la región cuando se vuelvan a comprobar las reglas. |
Regiones | {
| De solo lectura | Array de regiones.
|
IsVerified | Boolean | De lectura y escritura | Especifica si el campo se ha verificado. |
NeedVerification | Boolean | De solo lectura | Indica si el campo requiere verificación. |
NeedDoubleVerification | Booleano | De solo lectura | Indica si el campo requiere una doble verificación |
IsSummary | Booleano | De solo lectura | Especifica si el campo se utiliza para formar el resumen de datos en el formulario de datos. |
campo de marca de verificación
campo de marca de verificación
Value | Booleano | Lectura/escritura | Valor del campo |
Etiqueta | Cadena | De solo lectura | Nombre del campo personalizado, etiqueta |
FieldType | Number | De solo lectura | Tipo de campo. Valor posible: 2 – marca de verificación |
ID | Número | De solo lectura | ID del campo |
IsReadOnly | Boolean | De solo lectura | Especifica si la edición del campo está deshabilitada. |
IsVisible | Boolean | De solo lectura | Indica si el campo es visible en el formulario de datos. |
MaxRegions | Number | De solo lectura | Número máximo de regiones de campo. Si el valor es -1, se permite cualquier cantidad de regiones. |
Name | Cadena | De solo lectura | Nombre de servicio del campo. |
NamePath | String[] | De solo lectura | Array de nombres de campos y grupos que componen la ruta del campo. |
NeedRecognize | Boolean | Lectura/escritura | Especifica si se debe obtener el valor del campo de la región cuando se vuelven a comprobar las reglas. |
Regiones | {
| De solo lectura | Array de regiones.
|
IsVerified | Boolean | Lectura y escritura | Especifica si el campo ha sido verificado. |
NeedVerification | Boolean | De solo lectura | Especifica si el campo requiere verificación. |
NeedDoubleVerification | Boolean | De solo lectura | Especifica si el campo requiere una doble verificación. |
IsSummary | Boolean | De solo lectura | Especifica si el campo se utiliza para generar el resumen de datos en el formulario de datos. |
Campo de grupo de marcas de verificación
Campo de grupo de marcas de verificación
MaxSelectedCount | Número | De solo lectura | Número máximo de valores de campo seleccionados. |
MinSelectedCount | Number | De solo lectura | Número mínimo de valores de campos seleccionados. |
Valores | Number[] | De lectura y escritura | Valor del campo. Un array de IDs de registros que conforman la lista de posibles valores del campo (Variantes). |
Variantes | {Id:number, Name:string}[] | De solo lectura | Lista de posibles valores del campo:
|
Etiqueta | Cadena | De solo lectura | Nombre del campo personalizado, etiqueta |
FieldType | Number | De solo lectura | Tipo de campo. Posible valor: 3 – grupo de marcas de verificación |
ID | Número | De solo lectura | ID del campo. |
IsReadOnly | Boolean | De solo lectura | Especifica si no se permite editar el campo. |
IsVisible | Booleano | De solo lectura | Indica si el campo es visible en el formulario de datos. |
MaxRegions | Number | De solo lectura | Número máximo de regiones de campo. Si el valor es -1, se permite cualquier cantidad de regiones. |
Name | Cadena | De solo lectura | Nombre de servicio del campo. |
NamePath | String[] | De solo lectura | Array de nombres de campos y grupos que forman la ruta del campo. |
NeedRecognize | Booleano | Lectura y escritura | Especifica si se debe obtener el valor del campo de la región cuando se vuelvan a comprobar las reglas. |
Regiones | {
| De solo lectura | Array de regiones.
|
IsVerified | Boolean | Lectura y escritura | Indica si el campo se ha verificado. |
NeedVerification | Booleano | De solo lectura | Indica si el campo requiere verificación. |
NeedDoubleVerification | Boolean | De solo lectura | Especifica si el campo requiere una doble verificación. |
IsSummary | Boolean | De solo lectura | Especifica si el campo se usa para generar el resumen de datos en el formulario de datos. |
Campo de imagen
Campo de imagen
Caption | cadena | De solo lectura | Nombre del campo personalizado o etiqueta |
FieldType | Number | De solo lectura | Tipo de campo. Valor posible: 1 – imagen |
Id | Number | De solo lectura | ID del campo. |
IsReadOnly | Boolean | De solo lectura | Especifica si no se permite editar el campo. |
IsVisible | Boolean | De solo lectura | Especifica si el campo es visible en el formulario de datos. |
MaxRegions | Number | De solo lectura | Número máximo de regiones del campo. Si el valor es -1, se permite cualquier número de regiones. |
Name | cadena | De solo lectura | Nombre interno del campo. |
NamePath | cadena[] | De solo lectura | Array de nombres de campos y grupos que forman la ruta al campo. |
Regions | {
| De solo lectura | Array de regiones.
|
Campo de grupo repetido de secciones
Campo de grupo repetido de secciones
Nombre | Tipo | Permisos | Descripción |
Id | Number | De solo lectura | ID del campo |
Name | cadena | De solo lectura | Nombre del campo |
Sections | Section[] | De solo lectura | array de campos de tipo Section |
FieldType | Number | De solo lectura | Tipo de campo. Valor posible: 8 – grupo repetido de secciones. |
Propiedades del objeto de documento
Propiedades del objeto de documento
AssemblingErrors | {
| De solo lectura | Errores de ensamblado en el documento, donde:
|
BatchId | Número | De solo lectura | El ID del paquete |
Errores | {
| De solo lectura | Errores en el documento, donde:
|
Fields | (Section | SectionsGroup)[] | De solo lectura | Lista de secciones/secciones duplicadas |
Id | Número | De solo lectura | Identificador del documento |
Index | Number | De solo lectura | Índice del documento dentro del paquete |
Pages | {
| De solo lectura | Lista de páginas de documento que contiene lo siguiente:
|
ProjectId | Número | De solo lectura | Identificador del proyecto |
TaskId | Número | De solo lectura | ID de tarea |
TemplateId | Número | De solo lectura | ID de la definición del documento |
TemplateName | Cadena | De solo lectura | Nombre del documento de definiciones |
TemplateVersion | Número | De solo lectura | Versión de la definición del documento |
Versión | Número | De solo lectura | Versión del documento |
