Pantallas

• Cód. pantalla (campo CODMSK)

El código de la pantalla puede contener de 1 a 10 caracteres alfanuméricos. El primer carácter siempre es una letra. No puede ser una palabra reservada de Adonix.

• campo ABRMSK

La abreviatura de la pantalla contiene de 1 a 4 caracteres alfanuméricos de los cuales el primero siempre es una letra. No puede ser una palabra reservada de Adonix.

Por norma general, debe haber una abreviatura única por pantalla, salvo en casos excepcionales. De hecho, este es el identificador que se utilizará para abrir la pantalla si la abreviatura no se ha indicado en el proceso. Esta abreviatura proporciona la clase de las variables de esta pantalla.

• Descripción (campo ZINTMSK)

• Pantalla modelo (campo MDL)

Esta casilla permite identificar que una pantalla nunca se utiliza como tal (ni en interactivo ni en importación), sino que solo sirve de modelo para crear otras pantallas. También puede servir para crear una clase de trabajo para los procesos. Estas pantallas nunca se validan. Pueden contener 500 campos, mientras que las pantallas que se pueden validar solo pueden contener 250 campos.

• Código actividad (campo CODACT)

Este campo permite indicar si la pantalla debe crearse en la base de datos del dossier.
Si el campo no se completa, la pantalla siempre se genera. Si el campo corresponde a un código de actividad inactivo, la pantalla no se genera.

Un código de actividad que comienza por X, Y, o Z identifica la pantalla como específica, es decir, no se actualiza en caso de revalidación del dossier.

• Módulo (campo MODULE)

Selecciona un módulo para la parametrización.

Este campo permite indicar si la pantalla se debe crear en la base de datos del dossier. Se crea si el módulo al que está asociada la pantalla está activo en el dossier.

• Tamaño (campo TYPMSK)

En primer lugar, la pantalla se define por su tipo, que puede ser:

• Cabecera y Pestaña se utilizan particularmente en la gestión de objetos, las consultas y el modelo "captura de ventana".
• Cuadro de diálogo se utiliza en el modelo captura de ventana.
• Pantalla completa se utiliza en un objeto cuadro y en el modelo "captura de ventana".
• Pantalla completa con lista se utiliza en un objeto simple con una sola pantalla y en el modelo "captura de ventana".

Los tres primeros tipos (cabecera, pestaña, cuadro de diálogo) requieren la entrada adicional del número de líneas y columnas, teniendo en cuenta que el título de las pestañas ocupa 1 línea, el contorno de los bloques ocupa 1 o 2 líneas por línea y el máximo es 28 líneas, 112 columnas (88 columnas si hay una lista izquierda).

Estos dos campos (líneas, columnas) se consideran parte de la parametrización. Los valores de estos campos no se reducen con la integración de un parche, excepto el número de líneas si no se encuentra ningún código de actividad específico (en los bloques o en los campos).

• campo NBRLIG

• campo NBRCOL

• Apilamiento (campo STACKED)

• Script estándar (campo TRTSTD)

Proceso en el que se buscan las acciones "estándar" (código STD) asociadas al campo de la pantalla. Para un objeto XXX, el nombre del proceso estándar es SUBXXX. Se recomienda encarecidamente utilizar esta norma, pero no es obligatorio. En la validación de la pantalla, este proceso se actualiza (o se crea si aún no existe) cuando se añade una acción "estándar" a un campo. De hecho, la etiqueta del subprograma se genera al parametrizar el valor del campo. Solo falta que el programador escriba dicho subprograma.

• Script vertical (campo TRTSPV)

Proceso en el que se buscan las acciones "verticales" (código SPV) asociadas al campo de la pantalla. Para un objeto XXX, el nombre del proceso específico es SPVXXX. Se recomienda encarecidamente utilizar esta norma, pero no es obligatorio. En la validación de la pantalla, este proceso se actualiza (o se crea si aún no existe) cuando se añade una acción "vertical" a un campo. De hecho, la etiqueta del subprograma se genera al parametrizar el valor del campo. Solo falta que el programador escriba dicho subprograma. La actualización de este campo no requiere la protección de un código de actividad.

• Script específico (campo TRTSPE)

Proceso en el que se buscan las acciones "específicas" (código SPE) asociadas al campo de la pantalla. Para un objeto XXX, el nombre del proceso específico es SPEXXX. Se recomienda encarecidamente utilizar esta norma, pero no es obligatorio. En la validación de la pantalla, este proceso se actualiza (o se crea si aún no existe) cuando se añade una acción "específica" a un campo. De hecho, la etiqueta del subprograma se genera al parametrizar el valor del campo. Solo falta que el programador escriba dicho subprograma. La actualización de este campo no requiere la protección de un código de actividad.

• N.º (campo NOBLOC)

• Título del bloque (campo ZTITBLOC)

• Tipo bloque (campo TYPBLOC)

El tipo de bloque define la presentación de los campos en el bloque.

• Cuadro: los campos se organizan en un cuadro desplegable de líneas (horizontal y verticalmente, si es necesario).
• Lista: lista de campos independientes.
• Texto: los textos se muestran en un fondo fijo y no se pueden modificar.
• Invisible: declaración de un bloque con lista invisible. Permite incluir en una pantalla campos técnicos ocultos que se pueden utilizar en los procesos vinculados a la pantalla.
• Flash: para utilizar vistas portal (dato externo a la función).
• Ofimática: para un documento Excel, Word o Powerpoint.
• Browser: para una página web.
• Editor html: principalmente reservado para la entrada de documentación.
• Técnico: para componentes XSL.
• Business Intelligence: para ejecutar un informe BO (principalmente reservado para el supervisor).

Los bloques de tipo Flash, Ofimática, Browser y Editor html requieren una variable parámetro.

• Pos (campo POSBLOC)

Posición, Línea y Columna sirven para situar los bloques con respecto a los demás. Hay que simular un cuadro en el diseño de los bloques y, a continuación, indicar en cada uno de ellos el posicionamiento, mediante las coordenadas (línea.columna) de su ángulo superior izquierdo, y la ocupación, mediante el número de líneas y columnas del cuadro ficticio.

• Lín. (campo LINBLOC)

• Col (campo COLBLOC)

• Alto (campo HTBLOC)

Si es necesario, estos campos permiten indicar un número mínimo de columnas y líneas para un bloque cuadro.

• Largo (campo LGBLOC)

• Orden (campo RANG)

Indique el rango de entrada. Los bloques se introducen por orden ascendente del rango cuando se pasa de un campo a otro por tabulación. Se puede utilizar en programación para identificar un bloque. Por ejemplo, mostrar todos los campos del bloque 10 sería: Affzo 10.       
Por lo tanto, se recomienda no modificar el rango del bloque en la definición de la pantalla.

• Long. (campo LNGLIB)

En un bloque de tipo Lista, este campo indica el número de caracteres asignado a la descripción de cada campo. En función del espacio disponible, pueden ser 20, 15 o 12 caracteres.

• Act (campo ACTBLOC)

Este campo permite que un bloque de datos sea opcional.

• Si no se ha introducido el código de actividad, el bloque siempre se genera.
• Si este campo corresponde a un código de actividad inactivo, los campos del bloque no se generan.
  

• Línea (campo NBLIGT)

En un bloque de tipo Cuadro, este campo indica el número máximo de líneas en el cuadro.

• Opciones (campo OPTION)

En un bloque de tipo Cuadro, este campo contiene una lista de caracteres en la que cada uno de ellos representa una función de base autorizada (si se muestra) en el cuadro. Estos caracteres se pueden seleccionar mediante una ventana de selección. Están disponibles las siguientes funciones:

• K: Línea anterior & siguiente en modo entrada
• A: Cancelar una línea
• D: Cancelar un intervalo de líneas
• R: Insertar líneas al final del cuadro
• I: Insertar líneas
• S: Cortar
• B: Copiar
• C: Pegar
• T: Cargar todas las líneas del cuadro
• ?: Buscar
• +: Justificar columna
• =: Modo ficha automática
• 1-9: Número de columnas fijas (a partir de la 1^ª columna)

• Apilamiento (campo BLOCSTACKE)

• N.º columna (campo BLOCCOLNUM)

• Parámetro (campo BASPAG)

En un bloque de tipo Cuadro, este campo define el nombre de la variable a pie de tabla. Es una variable técnica que almacena el número de líneas realmente introducidas. Debe estar definida como accesible en la pestaña Campos con el tipo de datos ABS. Si queremos que el bloque sea invisible, definiremos esta variable en modo invisible.

• En un bloque de tipo Ofimática, este campo debe ser de tipo Blob.
• En un bloque de tipo Flash, Browser o Editor html, este campo debe ser de tipo Clob (AC0, AC1 o ACB en estándar).

• Representación (campo BLOCTYPT)

Representación del bloque "Cuadro" en la pantalla:

• Carácter: sin gráfica asociada al cuadro.
• Carácter o Gráfica: la gráfica y el cuadro se muestran alternativamente a petición del usuario.
• Carácter y Gráfica: se muestran la gráfica y el cuadro.
• Gráfica:solo se muestra la gráfica, no se puede acceder al cuadro.

En los tres últimos valores, se puede acceder a una pantalla de "Parámetros gráficos" desde el menú contextual. 

• Bloque tabla (campo DETBLC)

Este campo ahora se utiliza para los "web services". Hay que completarlo en las pestañas que contienen su propia lista izquierda. Ejemplo: pantalla BPABPR.

En el bloque lista, se indica el número de bloque cuadro asociado.

• Vista portal (campo BLOCVIEW)

Este campo permite seleccionar la Vista portal en los bloques Flash.

• N.º (campo NOFIC)

• Tablas referencias (campo FICREF)

Esta tabla sirve de ayuda para introducir los campos en la pestaña siguiente. El sistema recupera las características de los campos de las tablas listadas. 

• N.º (campo NUMLIG)

• Campo (campo CODZON)

Este campo indica el nombre del campo de la pantalla. Este código puede contener de 1 a 10 caracteres alfanuméricos de los cuales el primero siempre es una letra. No se pueden utilizar palabras reservadas de Sage. Para beneficiarse de la transferencia de datos, debe tener el mismo nombre, si es posible, que el campo de la tabla a la que hace referencia. La sintaxis para acceder a un campo con el nombre NOMBRECAMPO definido en una pantalla con la abreviatura ABV1 es [M:ABV1]NOMBRECAMPO.

El nombre del campo suele estar codificado con grupos de 3 caracteres. Estos grupos aparecen en mayúscula en la función Codificación campos. Se recomienda seguir esta norma.

En los campos creados en específico, el nombre debe comenzar por X_, Y_ o Z_.

• Bloque (campo NUMBLOC)

Este campo indica el número del bloque en el que debe aparecer el campo.

• Pos (campo NOZONE)

Este campo indica el número del campo.

• En un bloque de tipo Cuadro, los campos se sitúan de izquierda a derecha por orden ascendente de sus números.
• En un bloque de tipo Lista, el número indica el número de línea en el bloque (1= línea superior). Para situar varios campos en la misma línea, hay que indicar el orden en la parte decimal.

Ej.: 1,2 indica la segunda posición de la primera línea.

• Descripción (campo ZINTIT)

• Col (campo PDSZON)

No hay información de ayuda disponible para este campo.

• N.º columna (campo COLNUM)

• Tipo (campo CODTYP)

Indique el tipo de dato del campo. En función del tipo de dato elegido, se puede solicitar información adicional.

• Menú (campo NOLIB)

Define el número de menú local asociado al campo definido en la línea.

Cuando un campo es de tipo menú local, se almacena bajo un valor numérico (del 1 al 255) que corresponde al rango de un título en una tabla llamada menú local, almacenada en la tabla de mensajes APLSTD.

En captura o en visualización, se presentan, según las elecciones hechas en la interfaz del usuario:

• bien un título que puede ser elegido de una lista desplegable llamada combo box STOP
• bien una lista de botones de opción.

El interés de este tipo de captura es que la lista de elecciones se presenta en la lengua de conexión del usuario.

Cada número de menú local caracteriza la lista de los títulos posibles. Por ejemplo, el menú local 1 corresponde a la opción No / Sí en este orden. En este caso, la interfaz del usuario puede ser también la casilla a marcar.

• Long. (campo LONG)

Permite definir la longitud de un campo cuando este campo utiliza un tipo de datos genérico sin longitud fija. Es el caso de los tipos A y DCB.

Para los blob, al igual que para los clob, hay que introducir la longitud que será una longitud máxima de almacenamiento. La codificación es la siguiente:

• Captura (campo SAIAFF)

Esta información indica si la zona debe introducirse o no. 3 Valores posibles:

• Entrado: Normal
• Mostrados: La zona no se introducirá nunca pero siempre se visualiza.
• Invisibles: La zona está presente al igual que la variable de la pantalla, pero ni se introduce ni se muestra.

• Transmisión (campo TRANSM)

Indica si la descripción de los campos invisibles debe tenerse en cuenta en la descripción XML de la ventana. Los posibles valores son:

• Sin transmisión: no se tiene en cuenta (corresponde al campo técnico V140).
• Todos los clientes: la tienen en cuenta el cliente y los web services.
• Web services: solo la tienen en cuenta los web services (corresponde al campo invisible V140).

En los campos invisibles del bloque técnico, el valor de este campo siempre es "Todos los clientes", ya que esta tecnología se utiliza para mostrar las gráficas XSL. En los demás campos invisibles, se recomienda asignar el valor "Sin transmisión", excepto en casos particulares.

Hay que tener en cuenta que en los campos de los bloques invisibles hay dos valores posibles: "Sin transmisión", "Web services".

• Modo (campo MODE)

Este campo permite gestionar la presencia del campo según el modo de introducción de una tabla.

- El modo registro (accesible con clic derecho en la variable al pie de pantalla) permite mostrar/introducir una línea de una tabla en una ventana. Todos los campos de la línea señalados en 'Modo ficha' o 'Modo ficha+tabla' están accesibles en una página o en varias pestañas, en función del número de campos.

- En modo Tabla, sólo están accesibles los campos señalados en 'Modo tabla' o 'Modo ficha+tabla'.

Las acciones definidas en los campos están activas en los dos modos.

• Act (campo CODACT)

Si esta zona no se indica, siempre estará presenta. Si esta zona corresponde a código actividad inactivo, la zona no se generará. Los códigos de actividad que empiezan por X, Y, o Z corresponden a campos específicos que no se verán afectados al validar del dossier.

• Dim. (campo DIME)

Indique la dimensión del campo.
En el caso de un cuadro desplegable, la dimensión se asignará automáticamente.
Esta dimensión también se puede asignar automáticamente si el código de actividad del campo contiene una dimensión.

• Oblig (campo OBLIG)

Esta información indica si el campo es obligatorio.
Para un campo alfanumérico, obligatorio significa que el campo no puede estar vacío.
Para un campo numérico o de tipo fecha, obligatorio significa que no se puede introducir un valor nulo.

• Salto línea (campo BREAKAFTER)

• Ocultable (campo ISMASKABLE)

• Túnel (campo TUNNEL)

Cuando el tipo de datos está asociado a un objeto, esta información permite crear de forma automática un túnel disponible en el menú contextual del campo, que permite acceder directamente a la gestión de dicho objeto. 
Hay una excepción: el túnel no se propone cuando la tabla gestionada por el objeto de este tipo de datos es la tabla indicada en primera posición en la pestaña General de la pantalla.

• Vínc. (campo LIEN)

Si el campo tiene asignado el valor "Sí", se añade un campo adicional a la derecha del campo para mostrar la descripción del campo seleccionado. Este campo debe estar parametrizado en el campo "Descripción" o "Descripción corta" en la pestaña General de la tabla asociada.

• Opciones (campo OPTSAI)

Las opciones dependen del tipo de datos (utilizar la ventana de búsqueda).
Esta columna define las opciones aplicables a la entrada del campo. Estas opciones se materializan en caracteres que pueden concatenarse cuando se requieren varias opciones. Estas opciones se pueden elegir mediante una ventana de selección. Las opciones disponibles dependen del tipo de campo. Se puede acceder a una descripción detallada de todas las opciones posibles. La combinación de estas opciones permite al supervisor aplicar un formato de entrada específico para el campo.
Con el menú contextual, también puede indicar un formato específico para el campo mediante la sintaxis de Sage X3. La existencia de estos datos se representa con “$” en este campo. Por lo tanto, este campo permite introducir opciones o un formato de entrada.

• Truncamiento (campo OPTLNG)

Este campo permite indicar una longitud de visualización, si quiere que sea distinta a la longitud de entrada.  La entrada de este campo será desplegable. Por defecto, el supervisor utiliza una longitud de visualización de 30 caracteres en los campos alfanuméricos con una longitud superior a 30. Si no se indica ningún formato en el campo y en el tipo de dato vinculado al campo, se tiene en cuenta este formato de entrada. 

• Valor por defecto (campo VALDEF)

Este campo indica una expresión que se propone para inicializar el campo. Si la expresión viene precedida por el carácter "*", siempre se asigna el valor por defecto (aunque el campo ya se haya inicializado).

En un campo de tipo icono, el valor introducido indica el icono que se va a mostrar.
Ejemplo: 0 para "nuevo", 1 "abrir", 2 "registrar", 3 "cortar", 4 "copiar", 5 "pegar", etc.
Para no mostrar el icono, el campo debe permanecer vacío.

• Código acceso (campo CODACC)

Si no se completa este campo, siempre estará accesible para el usuario. Si se completa este campo, el usuario solo podrá acceder si dispone del código de acceso correspondiente. La habilitación puede dar acceso a la consulta y/o a la modificación del campo.

Esta posibilidad de restringir el acceso a un campo está reservada para el específico y no requiere la protección de un código de actividad.

• Condición de captura (campo CONSAI)

Este campo está definido como accesible, pero en algunos casos se puede elegir no completarlo. La condición de captura es una expresión lógica expresada en la sintaxis de X3. Si la expresión es correcta en la entrada, el campo se completa. De lo contrario, el campo se muestra y su valor se conserva. Por ejemplo, para introducir un campo si el campo anterior tiene asignado el valor Sí: [M]ZONEPREC=2

• Objeto gráfico (campo TYPGRAPH)

Este campo permite precisar el tipo de objeto gráfico que se utilizará:

• Casilla a marcar: en un campo de tipo Sí/No (menú local 1).
• Radio buttons: en un campo de tipo menú local con un número de opciones limitado.
• Barra de progreso: en un campo numérico.
• Icono: en un campo alfanumérico.
• Foto: en un campo de tipo blob.
• Texto multilíneas: en un campo alfanumérico, clob o blob.
• Rtf relativo (formato KR): en un campo alfanumérico. Contiene el nombre de un fichero sin extensión.
• Rtf absoluto (formato KH): en un campo alfanumérico. Contiene el directorio, el nombre de un fichero y su extensión. 

En un campo de bloque tabla, los objetos autorizados son la casilla a marcar y el icono.

• Estilo (campo STYZON)

Se puede añadir un estilo particular a un campo mediante parametrización. Está reservado para el específico.  La actualización de este campo no requiere la protección de un código de actividad.

• Tabla de control (campo CODCTL)

Este campo permite definir una tabla de control para verificar la entrada y, en ciertos casos, tener una selección de posibles valores. Está reservado para el específico.  La actualización de este campo no requiere la protección de un código de actividad.

• Parametrización (campo ACHPARG)

Conjunto de parámetros disponibles para alimentar la gráfica con los campos del cuadro. Los parámetros están definidos en la tabla varia 915.

• Representación (campo CHREPR)

Permite definir la representación gráfica de la columna del cuadro.

Esta información es necesaria para las gráficas:

• Por defecto: se utiliza la representación definida para todas las gráficas
• Barra
• Línea

• N.º (campo NOAC)

• Tipo (campo TYPACT)

Este cuadro permite definir las acciones específicas asociadas al campo. Los tipos de acciones posibles son:

• Antes_campo: acción antes de cualquier entrada o visualización del campo. Se puede utilizar, por ejemplo, para definir el formato del campo.
• Inic_botón: permite definir los títulos de los botones del menú contextual.
• Inic: permite inicializar un campo.
• Antes_entrada: acción realizada antes de cada entrada. Se puede utilizar, por ejemplo, para situar mkstat y no introducirla.
• Control: permite comprobar la validez del campo.
• Después_campo: realizada después del control, si este es válido. Permite, por ejemplo, asignar o mostrar otros campos.
• Después_modif.: exactamente igual, pero cuando se ha modificado el campo.
• Selección: mediante la tecla F12.
• Botón 1: mediante la tecla F9 (reservado para túneles).
• Botón 2 a 20: la tecla F4 proporciona la lista de menús contextuales.
• Antes_línea: solo para cuadros desplegables, permite realizar alguna acción cada vez que se accede a una línea en modificación.
• Después_línea: solo para cuadros desplegables, permite realizar alguna acción después de cada entrada de línea.
• Clic: solo para campos de tipo icono. Permite desencadenar una acción al hacer clic en el icono.

• Acción (campo ACTION)

Es el código de la acción, enviado a la tabla de acciones, que indica el subprograma al que se va a llamar. Hay 3 códigos específicos: "STD" , "SPE" y "SPV", que indican que la acción no está catalogada, sino que llama a una etiqueta que está definida, respectivamente, en los procesos "estándar" para STD, "específico" para SPE y "vertical" para SPV. 

• Descripción (campo ZINTITACT)

• Ejecución (campo EXEACT)

Este campo permite definir el contexto de ejecución de la acción:

• Interactivo - Entrada en línea.
• Import./web service - Carga del web service o del modelo de importación. Las acciones se ejecutan en los campos una vez que se han completado todos.
• Siempre - En todos los contextos.

• Desactivación (campo DISACT)

Este campo está disponible para el específico y la verticalización. Se puede indicar:

• En una acción SPV: la desactivación o no de la acción STD del mismo tipo.
• En una acción SPE: la desactivación o no de la acción SPV y/o STD del mismo tipo.

• N.º (campo NOPA)

Esta parte de la pantalla permite definir el valor de ciertos parámetros.
Estos parámetros corresponden a las acciones que se indican para un campo (por ejemplo, para la acción de control del código postal, hay que definir el campo Código de país y el campo Ciudad). Hay que respetar el tipo de parámetro indicado en la ayuda.

• Descripción (campo CODPAR)

• Valor (campo VALPAR)