A continuación, describiremos los diseños más habituales que han sido utilizados para el diseño de las tablas predefinidas de la aplicación y que pueden servir para orientar sobre cómo realizar un diseño personalizado acorde con los utilizados en la aplicación.

Los tipos de columnas utilizados dependerán de los controles a incluir en el diseño:

• Auto: se suele utilizar para contener controles de etiquetas.
• Fijo: se suele utilizar para contener controles de edición de datos.
• Extendible: se suele utilizar para hacer que el control ocupe el resto de la pantalla.
• Separador: se suele utilizar para separar visualmente 2 columnas de controles.

Diseño general

Como norma general se utilizan columnas Auto para las etiquetas con un ancho mínimo de 85 si los texto son pequeños, columnas fijas de 125 para los códigos y columnas fijas de 450 para los nombres.

En la sección principal, es decir, en la parte de arriba de nuestra tabla, generalmente hay un código y un nombre, en el ejemplo que hay a continuación especificamos los tipos de columnas y los anchos que se utilizan habitualmente en las pantallas de la aplicación.

Hay un tipo de fila y de columna que se llama Extendible, se suele poner al final de la tabla para que ocupe todo el espacio que queda libre de pantalla, tanto en columna como en fila. Igualmente se puede utilizar una fila de tipo Separador para dejar un pequeño espacio por encima de los grupos de controles y tablas de datos, para así evitar que la información quede muy junta visualmente.

También se han establecido en algunas de las definiciones de columnas de tipo Auto la propiedad de Grupo de ancho compartido, con el fin de permitir que columnas de diferentes secciones tengan el mismo ancho a pesar de ser de tipo Auto.

Diseño de direcciones

En las tablas que se encuentran direcciones, el diseño puede ser algo más complejo, aunque se sigue el mismo criterio, definiendo las columnas que contienen controles de etiqueta como tipo Auto con anchos mínimos y si es un campo con controles de edición de datos como tipo Fijo.

Creación de tablas

En la base de datos se puede añadir tablas personalizadas, aunque deben cumplirse los siguientes requisitos mínimos:

• El nombre de la tabla deberá comenzar o contener un guion bajo antes del cuarto carácter (por ejemplo: _Tabla, E_Tabla, Emp_Tabla, …), no pudiendo comenzar por CFG_ o TPV_ (reservados para las tablas de configuraciones y TPV).
• Siempre se debe incluir un campo Id de tipo numérico y autoincremental, además debe crearse una clave principal única por dicho campo.
• Si registrar el usuario y fecha de creación y modificación, entonces se deberán incluir los campos de IdUsuarioCreacion (smallint, null), FechaCreacion (datetime, null), IdUsuarioModificacion (smallint, null) y FechaModificacion (datetime, null).
• Si se desea incluir archivos adjuntos a los registros de la tabla, entonces se deberá incluir el campo ExistenArchivos de tipo bit y que no admita nulos (not null).
• Si se desea incluir una imagen principal adjunta a los registros de la tabla, entonces se deberá incluir el campo ExisteImagenPrincipal de tipo bit y que no admita nulos (not null).
• Se recomienda incluir relaciones entre las tablas para evitar inconsistencias en los datos, para ello a la hora de crear realizaciones se deberá utilizar como nombre de la relación el formado por el nombre de la tabla y el campo o campos relacionados (por ejemplo, si la tabla es Emp_Tabla y el campo es IdUsuarioCreacion, el nombre de la relación debería ser FK_Emp_Tabla_IdUsuarioCreacion).
• En caso de que la tabla contenga gran cantidad de información, se recomienda la creación de índices para agilizar la búsqueda de los datos, para ello se deberá utilizar como nombre del índice el formado por el nombre de la tabla y el campo o campos indexados (por ejemplo, si la tabla es Emp_Tabla y el campo es IdUsuarioCreacion, el nombre del índice debería ser IX_Emp_Tabla_IdUsuarioCreacion).

Creación de campos

En la base de datos se pueden añadir campos a las tablas, aunque en el caso de incluirlo en tablas predefinidas de la aplicación, entonces el nombre deberá comenzar o contener un guion bajo antes del cuarto carácter (por ejemplo: _Campo, E_Campo, Emp_Campo, …).

Creación de funciones y vistas

En la base de datos se pueden añadir funciones y vistas, aunque el nombre deberá comenzar o contener un guion bajo antes del cuarto carácter (por ejemplo: _VistaTabla, E_VistaTabla, Emp_VistaTabla, …)

IMPORTANTE

Cualquier cambio en la estructura de la base de datos que no cumplan o no estén contemplados en los requerimientos anteriores, así como cualquier modificación directa de la información o configuraciones que se realice en la base de datos, supondrá la exclusión de los servicios de soporte técnico.

<a href="aliquo:{'table':'Clientes','condition':'Clientes.Id IN (9,32,40)'}">Clientes</a>

Dependiendo de la finalidad del enlace se pueden configurar los siguientes atributos:

table

Especifica el nombre de la tabla sobre la que se aplicará el resto de atributos.

process

También se puede especificar un proceso para realizar acciones sobre el elemento indicado, revise los códigos de la tabla CFG_Procesos.

condition

Condiciona la información, se puede indicar condiciones concatenadas con AND u OR, siguiendo la misma lógica de las consultas SQL.

action

Indica la acción a realizar sobre el enlace, los posibles valores son:

0. Ninguna (no es necesario especificarlo)
1. Añadir
2. Modificar
3. Duplicar

view

Este atributo puede tener dos valores.

· table: el resultado se muestra en formato lista, es el valor predeterminado.
· row: mostrará la ficha, o pantalla, del registro indicado.

Estados de notas facturables:

• No facturable: La nota se identificará como no facturable cuando el campo NoFacturar sea 1
• Facturada: La nota se identificará como facturada cuando el campo IdFactura sea distinto de NULL

It is important that the ZIP file is uploaded to the folder PlugIns de empresa. Normally only the .dll file and the images or icons are necessary. It is not necessary to upload the .pdb file or the .xml of the project itself.

(*) There is a development version, Visual Studio Community, which can be downloaded for free.

We will start Visual Studio and choose the menu option FILE / New project…

In the screen of New project we will select Class Library and indicate the name and the framework that we are going to use, version 4.7 should be selected.

Once the project is created we must add the references to the libraries Aliquo.Core.dll and Aliquo.Windows.dll, which can be found in the installation directory of Aliquo 5, "C:\Program Files (x86)\Aliquo Software 5" and System.ComponentModel.Composition that can be found in Assemblies. It is important that you mark not to make a local copy of these references.

Once the references have been added, you must implement the Command class, which is inside the namespace Aliquo.Windows.Extensibility.

In addition to implementing the plugin interface to develop and give functionality to the plugin, we must also include the attributes and metadata that allow identifying the plugin type, so that Aliquo can recognize it.

To start the debugging, you will specify, in the properties of the project, where the application and the compilation folder are located.

In the section Build we will choose as configuration option Debug, indicating the Output path "C:\Program Files (x86)\Aliquo Software 5\PlugIn\"

In the section Debug we will select the Start external program of Start action and indicate the complete path where Aliquo is installed (C:\Program Files (x86)\Aliquo Software 5\ Aliquo.exe) and in Start options the command line argument /DEV will be indicated, if you want to load the rest of the company’s PlugIn or /DEVX if you only want the execution of PlugIns hosted in the development folder.

We will start Visual Studio we will select Create a new project in Get started or using the menu choose the option File / New / Project…

In the screen of Create a new project we will select Class Library (.NET Framework) and click on Next.

In the screen of Configure your new project we will indicate the Project name, Location and Framework that we are going to use, version .NET Framework 4 should be selected.

Once the project is created we must add the reference to the library AliquoTPV.Core and AliquoTPV.Extensibility, which can be found in the installation directory of Aliquo TPV, "C:\Program Files (x86)\Aliquo TPV" and System.ComponentModel.Composition that can be found in Assemblies. It is important that you mark not to make a local copy of these references.

Once the references have been added, you must implement the Command class, which is inside the namespace AliquoTPV.Extensibility.

In addition to implementing the plugin interface to develop and give functionality to the plugin, we must also include the attributes and metadata that allow identifying the plugin type, so that Aliquo TPV can recognize it.

To start the debugging, you will specify, in the properties of the project, where the application and the compilation folder are located.

In the section Build we will choose as configuration option Debug, indicating the Output path "C:\Program Files (x86)\Aliquo TPV\PlugIn\"

In the section Debug we will select the Start external program of Start action and indicate the complete path where Aliquo TPV is installed (C:\Program Files (x86)\Aliquo TPV\ AliquoTPV.exe).

We have put at your disposal the creation of a small example, step by step, using Visual Studio^* and you can download a demo PlugIn from Github, where you can consult some examples.

To distribute the PlugIn, you have to compress all the necessary files in a ZIP file and use the option of Gestión de archivos de servidor to upload or update it. Once imported, the file will be available to all terminals who connect.

It is important that the ZIP file is uploaded under the name Plugin.zip to the folder Actualizaciones de TPV. Normally only the .dll file and the images or icons are necessary. It is not necessary to upload the .pdb file or the .xml of the project itself.

(*) There is a development version, Visual Studio Community, which can be downloaded for free.