Versión: 20 R5 BETA

Interfaz 4D Write Pro

4D WritePro Interface ofrece un conjunto de paletas, que permiten a los usuarios finales personalizar fácilmente un documento 4D Write Pro.

Un desarrollador 4D puede implementar fácilmente estas paletas en su aplicación. Así, los usuarios finales pueden gestionar todas las propiedades de 4D Write Pro, como las fuentes, la alineación del texto, los marcadores, la disposición de las tablas y los marcos.

The main 4D Write Pro Interface documentation can be found in the 4D Design Reference manual.

A continuación encontrará la documentación de configuración del Asistente para tablas.

Asistente de tablas

El asistente de tablas está aquí para simplificar aún más la creación de tablas basadas en datos de bases d utilizando contextos, fuentes de datos y fórmulas.

El asistente de tablas, accesible a los usuarios finales, carga plantillas suministradas y configuradas por los desarrolladores de 4D. Esto permite a los desarrolladores personalizar la plantilla según los casos de uso específicos y los requisitos empresariales de los usuarios.

El Asistente de tablas viene con plantillas y temas predeterminados, que los desarrolladores pueden configurar para adaptar su contenido a los requisitos específicos de la aplicación.

Para implementar el Asistente de tablas en su aplicación, los desarrolladores pueden crear y configurar archivos de plantilla.

Interfaz del Asistente de tablas WP

El usuario abre el diálogo Asistente para tablas desde el elemento de menú "Insertar tabla" de la barra de herramientas y la barra lateral de la interfaz de 4D Write Pro.

Desde esta interfaz, el usuario puede seleccionar una plantilla o una tabla en la primera lista desplegable y un tema en la segunda.

En Columnas:

Dependiendo de si el usuario selecciona un modelo o una tabla, puede ver la lista de campos almacenados en el modelo (los tipos Blob y objeto se excluyen automáticamente). A continuación, pueden seleccionar las columnas que se mostrarán en la tabla marcando la casilla situada delante del nombre del campo y ordenarlas moviendo y arrastrando la lista de campos.

En líneas:

In the Table Wizard, the user can also define the number of header rows and extra rows (0 to 5 each), set break rows (summary rows) above or below the data row, and choose to show/hide carry-over rows.

En pantalla:

El usuario ajusta el nivel de zoom según sus preferencias seleccionando la opción deseada de una lista desplegable, utiliza botones de opción para mostrar fórmulas o datos para una presentación clara y elige mostrar una regla horizontal utilizando una casilla de verificación.

After finalizing the table creation and customization, the user can click on the Insert button to add the table to their WP document.

Una vez integrada la tabla en el documento, el usuario puede personalizar su estilo. Las herramientas de formato de la barra de herramientas y la barra lateral siguen estando disponibles.

Configuración de la plantilla WP Table Wizard

La configuración de las plantillas incluye:

Defining tables and fields as well as preparing formulas adapted to the application from the template file.
Translating table, field, and formula names from the translation file.
Designing graphic styles and customized themes from the theme file.

Estos tres tipos de archivos contribuyen a la configuración del Asistente para tablas y, aunque cada uno de ellos tiene una finalidad distinta, ninguno de ellos se considera un componente esencial.

Archivos de plantillas

El archivo de plantilla permite definir lo siguiente:

la fórmula que devuelve una selección de entidades utilizada como fuente de datos de la tabla,
las fórmulas de ruptura (si se puede insertar una línea de ruptura)
los atributos de la clase de datos que pueden utilizarse como columnas de la tabla,
las fórmulas disponibles como menús contextuales dentro de líneas de ruptura, líneas de arrastre o líneas adicionales.

Limitación

En la implementación actual (4D v20 R2), las fórmulas en saltos, fuentes de datos y menús contextuales no soportan llamadas a los métodos de la base local. Esta limitación se eliminará en la próxima versión.

The template file must be stored in a "Resources/4DWP_Wizard/Templates" folder within your project.

El archivo de plantilla en formato JSON contiene los siguientes atributos:

Atributo	Tipo	Obligatorio	Descripción
tableDataSource	Text	x	Fórmula de la fuente de datos de la tabla
columns	Collection	x	Colección de columnas de tabla
columns.check	Text	x	True cuando la columna ya está marcada en el editor de plantillas. False cuando la columna está desmarcada en el editor de plantillas.
columns.header	Text	x	Etiqueta mostrada al usuario
columns.source	Text	x	Formula
breaks	Collection		Colección de objetos de ruptura. El orden de las interrupciones es importante. Corresponde al orden en el documento cuando las rupturas están sobre las líneas de datos.
breaks.label	Text	x	Etiqueta mostrada al usuario
breaks.source	Text	x	Formula
breakFormulas	Collection		Colección de objetos de fórmula aplicables a las líneas de ruptura
breakFormulas.label	Text	x	Etiqueta mostrada al usuario
breakFormulas.source	Text	x	Formula
bcorFormulas	Collection		Colección de objetos de fórmula aplicables a las filas de transferencia inferiores
bcorFormulas.label	Text	x	Etiqueta mostrada al usuario
bcorFormulas.source	Text	x	Formula
extraFormulas	Collection		Colección de objetos de fórmula aplicables a líneas adicionales
extraFormulas.label	Text	x	Etiqueta mostrada al usuario
extraFormulas.source	Text	x	Formula

Francés

If your application is likely to be run on a 4D with language set to French, make sure that you use tokens in your formulas so that they are correctly interpreted no matter the user's language configuration.

Ejemplo

He aquí un breve ejemplo del aspecto que podría tener su archivo JSON:

{
    "tableDataSource": "ds.People.all().orderBy(\"toCompany.name asc, continent asc, country asc, city asc\")",
    "columns": [{
            "check": true,
            "header": "Firstname",
            "source": "This.item.firstname"
        }, {
            "check": true,
            "header": "Lastname",
            "source": "This.item.lastname"
        }, {
            "check": true,
            "header": "Salary",
            "source": "String(This.item.salary;\"###,###.00\")"
        }
    ],
    "breaks": [{
            "label": "Company",
            "source": "This.item.toCompany.name"
        }
    ],
    "breakFormulas": [{
            "label": "Company",
            "source": "This.item.toCompany.name"
    }, {
            "label": "Sum of salaries",
            "source": "String(This.breakItems.sum(\"salary\"); \"###,###.00\")"
        }
    ],
    "bcorFormulas": [{
            "label": "Sum of salaries",
            "source": "String(This.tableData.sum(\"salary\"); \"###,###.00\")"
        }
    ],
    "extraFormulas": [{
            "label": "Sum of salaries",
            "source": "String(This.tableData.sum(\"salary\"); \"###,###.00\")"
        }
    ]
}

Archivos de traducción

Los archivos de traducción traducen los nombres de plantillas, temas, tablas, campos y fórmulas. These files are added to the "Resources/4DWP_Wizard/Translations" folder in your project.

Cada archivo de traducción debe nombrarse con el código de idioma correspondiente (por ejemplo, "en" para inglés o "fr" para francés).

El archivo de traducción en formato JSON contiene los siguientes atributos:

Atributo	Tipo	Descripción
tablas	Collection	Colección de objetos de tabla traducidos
fields	Collection	Colección de objetos de campo traducidos
formulas	Collection	Colección de objetos fórmula traducidos
fileNames	Collection	Colección de objetos fileName traducidos (aplicables al tema y al nombre de la plantilla)

En cada uno de estos atributos, el objeto de traducción incluye los atributos siguientes:

Atributo	Tipo	Obligatorio	Descripción
original	Text	x	Texto original destinado a traducción
translation	Text	x	Versión traducida del texto original

La definición de estos atributos dentro del objeto de traducción garantiza una organización y alineación adecuadas entre el contenido original y el traducido.

Si el nombre de la plantilla o la fórmula (ruptura, línea de arrastre o extra) existe en el archivo traducido, su traducción se aplica en el Asistente de tablas. Además, solo se visualiza y traduce la tabla definida en el archivo de traducción.

El archivo de traducción cumple una función adicional cuando un usuario selecciona una tabla en la interfaz. Puede filtrar las tablas y los campos propuestos al usuario. For example, to hide table IDs, this behavior is similar to the SET TABLE TITLES and SET FIELD TITLES commands.

Ejemplo

{
    "tables": [{
            "original": "People",
            "translation": "Personne"
        }
    ],
    "fields": [{
            "original": "lastname",
            "translation": "Nom"
        }, {
            "original": "firstname",
            "translation": "Prénom"
        }, {
            "original": "salary",
            "translation": "Salaire"
        }, {
            "original": "company",
            "translation": "Société"
        }
    ],
    "formulas": [{
            "original": "Sum of salary",
            "translation": "Somme des salaires"
        }
    ]
}
    

Archivos de temas

El componente 4D Write Pro Interface proporciona por defecto una lista de temas, como "Arial", "CourierNew" y "YuGothic", disponibles en múltiples variaciones como "Blue" y "Green". However, you can create your own theme by placing it in the "Resources/4DWP_Wizard/Themes" folder within your project.

El archivo del tema en formato JSON contiene los siguientes atributos:

Atributo	Tipo	Descripción
default	Object	Objeto que contiene el estilo por defecto aplicable a todas las líneas.
tabla	Object	Objeto que contiene la definición de estilo aplicable a la tabla.
rows	Object	Objeto que contiene la definición de estilo aplicable a todas las líneas.
cells	Object	Objeto que contiene la definición de estilo aplicable a todas las celdas.
header1	Object	Objeto que contiene la definición de estilo aplicable a la primera línea del encabezado.
header2	Object	Objeto que contiene la definición de estilo aplicable a la segunda línea del encabezado.
header3	Object	Objeto que contiene la definición de estilo aplicable a la tercera línea del encabezado.
header4	Object	Objeto que contiene la definición de estilo aplicable a la cuarta línea del encabezado.
header5	Object	Objeto que contiene la definición de estilo aplicable a la quinta línea del encabezado.
headers	Object	Object containing the style definition applicable to the header rows, if a specific header (like header1, header2...) no está definido.
data	Object	Objeto que contiene la definición de estilo aplicable a la línea de datos repetida.
break1	Object	Objeto que contiene la definición de estilo aplicable a la primera línea de ruptura.
break2	Object	Objeto que contiene la definición de estilo aplicable a la segunda línea de ruptura.
break3	Object	Objeto que contiene la definición de estilo aplicable a la tercera línea de ruptura.
break4	Object	Objeto que contiene la definición de estilo aplicable a la cuarta línea de ruptura.
break5	Object	Objeto que contiene la definición de estilo aplicable a la quinta línea de ruptura.
breaks	Object	Object containing the style definition applicable to the break rows, if a specific break (like break1, break2...) no está definido.
bcor	Object	Objeto que contiene la definición de estilo aplicable a la línea de arrastre inferior.

For every attribute used in your JSON file (header, data, carry-over, summary, and extra rows), you can define the following WP attributes, mentionned with their corresponding WP constant:

Atributos WP	Constante WP correspondiente
textAlign	wk text align
backgroundColor	wk background color
borderColor	wk border color
borderStyle	wk border style
borderWidth	wk border width
font	wk font
color	wk font color
fontFamily	wk font family
fontSize	wk font size
padding	wk padding

Ejemplo

{
    "default": {
           "backgroundColor": "#F0F0F0",
           "borderColor": "#101010",
           "borderStyle": 1,
           "borderWidth": "0.5pt",
           "font": "Times New Roman",
           "color": "#101010",
           "fontFamily": "Times New Roman",
           "fontSize": "7pt",
           "padding": "2pt"
    },
    "table": {
           "backgroundColor": "#E1EAF3"
    },
    "header1": {
           "textAlign": 2,
           "borderColor": "#41548F",
           "borderWidth": "1.5pt",
           "backgroundColor": "#979BA9",
           "color": "#F4F4FF",
           "font": "Times New Roman Bold"
    },
    "data": {
           "fontSize": "13pt",
           "textAlign": 0
    },
    "break1": {
           "textAlign": 2,
           "fontSize": "15pt"
    }
}
    

Ver también

4D Write Pro - Table Wizard (tutorial video)

Asistente de tablas​

Interfaz del Asistente de tablas WP​

En Columnas:​

En líneas:​

En pantalla:​

Configuración de la plantilla WP Table Wizard​

Archivos de plantillas​

Ejemplo​

Archivos de traducción​

Ejemplo​

Archivos de temas​

Ejemplo​

Ver también​

Asistente de tablas

Interfaz del Asistente de tablas WP

En Columnas:

En líneas:

En pantalla:

Configuración de la plantilla WP Table Wizard

Archivos de plantillas

Ejemplo

Archivos de traducción

Ejemplo

Archivos de temas

Ejemplo

Ver también