SPE DOC GU Diccionario de Datos

Diccionario de datos
Alcance funcional
Versión 1.3
Alcance funcional Versión: 1.3

Sector: Análisis y Documentación - Tecnología Vigencia: 10/11/2017
Documento: GSA_DOC_GU_Diccionario_de_Datos Autor: Ezequiel Pedrosa
El contenido de este documento ha sido elaborado y se ofrece solamente con carácter informativo y para uso exclusivo de los usuarios de los productos de
Softland Inversiones S.L. (en adelante Softland) en Latinoamérica, España y/u otros países.
El presente documento podrá ser revisado, modificado, editado o incluso remplazado o eliminado por Softland en cualquier momento, a su exclusivo criterio
y sin necesidad de previo aviso. Es responsabilidad del usuario revisar periódicamente si ha habido alguna actualización o modificación.
Softland no asume ninguna responsabilidad por cualquier error o imprecisión que pueden aparecer en dicho documento.
Dado que las condiciones bajo las cuales pueda ser usado el producto al que se refiere este documento están más allá del control de Softland, la información
provista no implica ninguna garantía de performance del producto final, así como Softland tampoco asume ninguna responsabilidad respecto al uso del
producto.
Ninguna información contenida en el documento constituye una oferta, solicitud o recomendación para comprar, o vender, o efectuar transacciones, o
servicios de ningún tipo, y/o a llevar a cabo ningún acto de ninguna índole o naturaleza. El contenido tampoco es parte de un contrato o de una relación
comercial. Los usuarios asumen a su costa y responsabilidad todos los riesgos asociados al uso del producto a que se refiere este documento.
En ningún caso, Softland, sus directores, funcionarios, empleados o agentes serán responsables frente al usuario por pérdidas directas o indirectas,
responsabilidades, reclamaciones, gastos o daños de cualquier tipo, ni contractual ni extracontractualmente, incluidos los casos de negligencia, que sean
consecuencia o deriven de alguna otra manera del uso de todas o de parte de la información contenida en este documento, o en relación con ellas, aun cuando
se no haya advertido de ello.
© Softland Inversiones S.L. Todos los derechos reservados. No se permite la reproducción total o parcial de este documento, ni su traducción, ni su
incorporación a un sistema informático, ni su locación, ni su transmisión, en cualquier forma o por cualquier medio, incluido, pero no limitado a medios
electrónicos, mecánicos, grabaciones y sistemas de recuperación, sin el permiso previo y escrito de Softland.
Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016
Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 2 / 35


Historial de Versiones
Revisión Aprobación / Vigencia

Fecha Versión Descripción Autor
Fecha Revisó Fecha Aprobó
17/11/2015 1.0 Creación s/parte EP 174 EP 16/11/2015 GR/JS 17/11/2015 EP
09/06/2016 1.1 Actualización s/Parte EP 220 EP 24/06/2016 GL 24/06/2016 EP
01/09/2016 1.2 Actualización S/Parte EP 227 EP 04/10/2016 GR 12/10/2016 EP
22/09/2017 1.3 Actualización S/Parte GR 1593 EP 09/11/2017 GR 10/11/2017 EP


Tabla de contenidos
1. INTRODUCCIÓN ................................................................................................................................................... 5
2. ALCANCE FUNCIONAL .......................................................................................................................................... 6
2.1 INGRESO AL DICCIONARIO DE DATOS ........................................................................................................................... 6
2.2 PANTALLA PRINCIPAL ............................................................................................................................................... 7
2.2.1 Barra de menu............................................................................................................................................ 7
2.2.2 Barra de herramientas ............................................................................................................................... 8
2.3 ADMINISTRACIÓN DE TABLAS Y WIZARD ...................................................................................................................... 8
2.3.1 Barra de menu............................................................................................................................................ 8
2.3.2 Barra de herramientas ............................................................................................................................... 9
2.3.3 Creación de tabla de usuario ...................................................................................................................... 9
2.3.4 Creación de campo de usuario ................................................................................................................. 12
2.3.5 Creación de un Proceso o Wizard ............................................................................................................. 14
2.3.5.1 Creación de wizard ................................................................................................................................................ 14
2.3.5.2 Creación de tabla wizard ....................................................................................................................................... 16
2.4 OPERACIONES SECUNDARIAS ................................................................................................................................... 17
2.4.1 Creación de tipos de dato ......................................................................................................................... 17
2.4.2 Posicionamiento de campos en pantalla.................................................................................................. 18
2.4.3 Traducción de mensaje de error en pantalla (Uso interno de Softland)................................................... 19
2.4.4 Relaciones de campos a reportes ............................................................................................................. 20
2.4.5 Relaciones de objetos a reportes (o Consultas integradas)...................................................................... 23
2.4.6 Índices ...................................................................................................................................................... 29
2.4.7 Estadísticas............................................................................................................................................... 30
2.4.8 Regeneración de Stored Procedures ........................................................................................................ 31
2.4.9 Reparar objetos jerarquía de objetos ....................................................................................................... 32
3. ANEXO - ESTRUCTURA DE TABLAS .................................................................................................................... 32
3.1 NOMENCLATURA DE TABLAS.................................................................................................................................... 32
3.2 NOMENCLATURA DE CAMPOS .................................................................................................................................. 35


1. INTRODUCCIÓN
El presente documento describe la configuración y utilidad de la aplicación Diccionario de datos (DE32.exe),
que se instala junto al sistema ERP Softland Logic.
Dicha aplicación es donde se permite y debe administrar los diferentes objetos de la base de datos de cada una
de las empresas de gestión (por ej. tablas, campos, índices, trigger, etc.), como así también de la empresa
Administración.
Puede ocurrir que los cambios que se realizan en las distintas bases de datos del sistema por fuera de
esta herramienta, los cambios de versión (conversión de la base de datos) se puedan eliminar por el
proceso por no reconocerlos como propios.
En el anexo del documento se incluye la explicación de la estructura de tablas establecido por Softland,
y del cual se basa el diccionario de datos.
A continuación, se enumeran algunas de las funcionalidades que presenta el Diccionario de datos:
1. Administración de tablas:
1.1. Creación y modificación de tablas de usuario. Dichas tablas pueden ser:
✓ Independientes: representan objetos tablas de tipo usuario. No tienen relación de dependencia
con las tablas del sistema, sean de usuario o estándares del sistema.
✓ Dependientes (o Hijas de): son tablas hijas de otras tablas (solapas grilla en los objetos tablas),
sean de usuario o estándares del sistema. Por ejemplo, en el objeto Clientes o Registración de
facturación.
1.2. Creación y modificación de campos de usuario a una tabla estándar o de usuario.
2. Administración de procesos (o Wizard)

✓ Creación y modificación de procesos o wizard de tipo usuario. Esto implica definir cada uno de
los pasos del proceso, como así también los campos que incluye cada uno de ellos. No tiene
aplicación para cliente final, se utiliza para desarrollo estándar y/o de usuario.


3. Operaciones Secundarias
✓ Creación de tipos de dato.
✓ Posicionamiento de los campos en la pantalla.
✓ Traducción de mensaje de error en pantalla (uso interno de Softland).
✓ Relaciones a reportes (vinculación de un reporte a un campo)
✓ Consultas integradas (vinculación de un reporte a un objeto)
✓ Vista de índices y Estadísticas.
✓ Regeneración de Procedimientos almacenados (Stored Procedures).
✓ Reparar jerarquía de objetos en el árbol de menú.
2. ALCANCE FUNCIONAL
2.1 Ingreso al Diccionario de datos

Para acceder a la aplicación se debe ejecutar el archivo Diccionario de datos (DE32.exe), con elevación de
derechos cuando corresponda, ubicado en el menú Inicio de Windows\Todos los programas\Softland o en
C:\ArchivosdePrograma(X86)\Softland\Cliente, en caso que se haya instalado en el directorio que viene por
defecto en la instalación de Softland y dependiendo del sistema operativo.
El sistema solicita ingresar el usuario y contraseña, de utilizar seguridad estándar. En el caso de utilizar seguridad
integrada, hacer clic directamente en el botón Aceptar.
Fig. 1. Ingreso al diccionario de datos.
Luego de ello, el sistema solicita seleccionar la empresa.
Fig. 2. Selección de empresa.


2.2 Pantalla principal
Fig. 3. Pantalla principal.
2.2.1 Barra de menu

Se encuentran las siguientes opciones:
✓ Archivo: se permite ingresar a una empresa, cerrar la sesión del usuario, crear o abrir una tabla o salir de
la aplicación, etc.
✓ Herramientas: se permite crear, editar o borrar un tipo de dato; definir el posicionamiento de los campos
en la pantalla (incluye la posibilidad de realizarlo en forma masiva o en proceso Batch); realizar la
grabación de las tablas en forma masiva o en proceso Batch; crear y editar la relación de un objeto a un
reporte; convertir las relaciones de reportes; crear y editar la relación de un campo a un reporte (consulta
integrada), regenerar stored procedures; reparar la jerarquía de objetos en el árbol de menu.
A partir de la versión 3.5, el proceso de conversión del base de datos de cada empresa incluye la
conversión de las relaciones de reportes existentes. Este proceso reemplaza la tabla de relación
cwOMRelationships, por las tablas slOMRelationships donde se graban los datos de la relación y
slOMRelationFields relativa a los campos de la relación. En caso de surgir algún inconveniente durante
esa conversión, habría que ejecutar por única vez la opción de menu Convertir relaciones, a los efectos
de completar dicha conversión.


✓ Ventana: se permite indicar el tipo de visualización de las ventanas, como por ejemplo en cascada o en
mosaico horizontal.
2.2.2 Barra de herramientas

Se encuentran las siguientes opciones:
✓ Nueva Tabla: se permite crear una tabla de usuario.
✓ Nuevo wizard: se permite crear un wizard de usuario, esto es definir cada uno de los pasos que incluye
el proceso.
✓ Nueva tabla wizard: se permite crear una tabla wizard de usuario, es decir, la tabla con los campos
asociados a un paso de un Wizard.
✓ Abrir Tabla: se permite abrir una tabla estándar o de usuario.
✓ Abrir wizard: se permite abrir un wizard de usuario.
✓ Abrir tabla wizard: se permite abrir una tabla wizard.
2.3 Administración de Tablas y Wizard

Se explican las distintas opciones para llevar a cabo la administración de las tablas y los campos de tipo usuario,
que son utilizadas por el sistema Softland.
2.3.1 Barra de menu

A las opciones que se encuentran en la pantalla principal se le agregan:
En la opción Archivo:
✓ Guardar: se permite grabar los cambios realizados en una tabla.
✓ Guardar como: se permite realizar una copia de una tabla. La nueva tabla es de usuario y el sistema
propone por defecto el sufijo USR_ y la posibilidad de actualizar los prefijos de los campos.
✓ Eliminar: se permite eliminar una tabla de usuario.
✓ Cerrar: se permite cerrar la tabla actual abierta.
En la opción Edición:
✓ Agregar campo: se permite ingresar un nuevo campo de usuario a una tabla estándar o de usuario.
✓ Eliminar campo: se permite eliminar un campo de usuario de una tabla estándar o de usuario.
✓ Renombrar campo: se permite modificar el nombre de un campo de usuario de una tabla estándar o de
usuario.
✓ Tipo de campo: se permite ver el tipo de campo. Las opciones son: Normal (se graba y se muestra), Se
muestra, pero no se graba, No se graba ni se muestra y Se graba, pero no se muestra.


✓ Validación del campo: se indica si es un campo validable. Permite ingresar una descripción de su
validación. Ser un campo validable implica que el sistema estándar envía un evento a la controller (o
archivo dll) cada vez que el campo cambio su valor.
En la opción Ver:
✓ Árbol jerárquico: se visualiza de la tabla actual, las tablas dependientes y de las que depende ella. Por
ejemplo, la FCRMVH dependen entre otras las tablas FCRMVI y FCRMVI02. También se puede crear o
eliminar una tabla hija de usuario.
✓ Tabla: se visualiza la pantalla de configuración de la tabla.
✓ Campos: se visualiza la pantalla de configuración de los campos de la tabla.
✓ índices: se permite crear, renombrar y borrar índices de campos índices e incluidos.
✓ Estadísticas: se permite crear, renombrar y borrar estadísticas sobre campos en particular. Sirven a los
efectos de recopilar información sobre la distribución de los datos existentes en las columnas de las
tablas, y así optimizar las consultas SQL.
✓ Personalizar grilla: se permite indicar que columnas de la pantalla de los campos son visibles y cuales
fijos, el color predeterminado de las columnas y de las celdas inhabilitadas.
✓ Atributos de tabla: se permite ingresar o eliminar el tipo y valor de atributo de una tabla. Uso interno de
desarrollo de Softland. Se utiliza en los procesos de conversión de Monoempresa a Multiempresa.
2.3.2 Barra de herramientas

A las opciones que se encuentran en la pantalla principal se le agregan:
✓ Nuevo campo: se permite ingresar un nuevo campo de usuario a una tabla estándar o de usuario. Es la
misma opción que agregar campo de la barra de menu.
✓ Eliminar campo: se permite eliminar un campo de usuario de una tabla estándar o de usuario. Es la misma
opción que eliminar campo de la barra de menu.
✓ Vista de tabla: se visualiza la pantalla de configuración de la tabla. Es la misma opción que Tabla de la
barra de menu.
✓ Vista de campo: se visualiza la pantalla de configuración de los campos de la tabla. Es la misma opción
que Campos de la barra de menu.
✓ Vista de índices: se permite crear, renombrar y borrar índices de campos índices e incluidos. Es la misma
opción que índices de la barra de menu. Solo se puede acceder cuando el tipo de tabla es Física.
✓ Vista de trigger de usuario: se permite ingresar el código de trigger de usuario (en las acciones Insert,
Update y Delete) a aplicar a la tabla. Solo se puede acceder cuando el tipo de tabla es Física.
2.3.3 Creación de tabla de usuario

Para la creación de una tabla de tipo usuario, se debe ir a la opción Nueva>Tabla de la barra de herramientas o
Nueva Tabla de la barra de herramientas. Esto abre una ventana con las siguientes opciones que se muestran en
la figura 4:


Fig. 4. Definición la tabla de usuario Cajeros (USR_GRTSEC).
1. Nombre: debe comenzar con el Prefijo USR_. Por defecto el sistema muestra UNKNOWN, valor que se debe
modificar por el deseado.
2. Tipo: se debe indicar alguna de las tres opciones disponibles:
✓ Tabla Física, se indica que la tabla que se está creando tiene persistencia en la base de datos.
✓ Tabla virtual, se indica que la tabla no tiene persistencia en la basa de datos. Ejemplo es la tabla de
wizard. Se utiliza para desarrollo propio del usuario.
✓ Tablas Alias, se indica que la nueva tabla, que es virtual, parte de una tabla física existente. Se utiliza
para desarrollo propio del usuario.
3. Tabla Base: se habilita sólo si la tabla es de tipo Tabla Alias, es decir se indica la tabla sobre la que depende
aquella.
4. Descripción: se ingresa una identificación.
5. Descripción compacta: se ingresa una identificación reducida.
6. Tabla hija, se indica que la tabla depende en jerarquía de otra tabla existente. Por ejemplo, la tabla FCRMVI
(ítems) que resulta ser tabla dependiente de la FCRMVH (Registración de facturación).
7. Hija falsa, se habilita si es Tabla hija, indica que no hereda la clave de su tabla padre o de la que depende.
8. Tabla, se habilita si es Tabla hija, indica la tabla padre o de la que depende.


9. Trigger / Constraint, se define el tipo de control de integridad referencial que se aplica en la tabla.
10. Árbol de la empresa, se indica si se muestra en el menú del sistema de gestión. En el caso de ser tabla hija,
no se encuentra habilitado ya que hereda esta propiedad de la tabla padre
11. Generador de reportes, se indica si se puede crear un reporte de esta tabla.
12. Módulo y Área, se indica la posición de partida de la nueva tabla. En el caso de ser tabla hija, no se encuentra
habilitado ya que hereda esta propiedad de la tabla padre.
13. Stored Procedure para insertar datos, se utiliza para desarrollo propio de usuario.
14. Tabla intermedia asociada, se utiliza para desarrollo propio de usuario.
15. Tabla de depuraciones asociada, se indica que la tabla es para depuraciones. Se utiliza para desarrollo propio
de usuario.
16. Tabla de log asociada se debe indicar alguna de las tres opciones disponibles:
✓ Usar el valor predeterminado (no se usará tabla de log).
✓ No usar tabla de log.
✓ Usar tabla de log.
En las tablas estándares del sistema, la opción Tabla de log asociada es la única opción que se puede
editar.
17. Clase controladora, se indica el nombre de la clase controladora de la tabla de usuario. Por ejemplo, en la
tabla Registración de facturación (FCRMVH), tiene la clase controladora
FC_RR_FCRMVH.ControllerFCRMVH, donde FC es el módulo y FCRMVH es la tabla física, y la versión es 3, es
decir que realiza el evento de grabación (o Save) para todas las tablas del objeto (tabla encabezado y de
ítem). En cambio, la tabla Registración de tesorería (CJRMVH), tiene la clase controladora
CJ_RR_CJRMVH.ControllerCJRMVH, donde CJ es el módulo y CJRMVH es la tabla física, y la versión es 4, es
decir que realiza el evento de grabación (o Save) por cada tabla del objeto en forma individual (tabla
encabezado y de ítem). Se utiliza para desarrollo propio de usuario.
En la creación de una tabla de usuario, se debe asignar la controler GRWUsrScr.ControllerGRUSCR,

con valor 3, si en el objeto se le configuran las herramientas Script por link o Administrador de
validaciones (QV).


2.3.4 Creación de campo de usuario

Para la creación de un campo usuario en una tabla, tanto para una estándar como de usuario, se deben completar
las siguientes opciones que se muestran en la figura 5:
Fig. 5. Definición de la tabla de usuario Cajeros (USR_GRTSEC).
En el encabezado:
1. Nombre: debe comenzar con el Prefijo USR_. Por defecto el sistema muestra UNKNOWN, valor que se debe
modificar por uno deseado.
2. Encabezado: se debe indicar una descripción que lo identifica.
3. Tipo de campo: se define directamente en la creación del campo. El mismo consta de cuatro opciones:
✓ Normal, se indica que el campo tiene persistencia en la base de datos y se muestra en la pantalla del
sistema.
✓ Se graba, pero no se muestra, se indica que tiene persistencia y no muestra en la pantalla del
sistema.
✓ Se muestra, pero no se graba, se indica que no tiene persistencia, pero se muestra en la pantalla del
sistema.
✓ No se graba ni se muestra, se indica que no tiene persistencia ni se muestra en la pantalla del
sistema.


Las opciones dependen del tipo de tabla (estándar/usuario).
4. Tipo de dato: se indica el alias de tipo de dato del campo. En caso de crear uno nuevo, debe comenzar con
el prefijo USR_.
5. Clave: se indica si es parte de la clave primaria de la tabla, por lo que fuerza el campo como requerido. Es
decir, define los campos que componen los valores para identificar en forma univoca a cada registro, y así el
valor no pueda repetirse.
6. Requerido: se indica si es obligatorio completar este campo.
7. Sólo lectura: se indica que el campo no es editable por parte del usuario dentro de la pantalla del sistema
8. Validable: sólo se habilita si la tabla tiene una Clase controladora asociada. Se indica si la modificación de
este campo genera un evento de validación para la clase. Este campo debe estar activo cuando se utiliza la
herramienta QV (Administrador de Sentencias).
9. Encabezado compacto: se ingresa la descripción reducida. Por defecto, copia la que se ingresa en el
encabezado.
Propiedades del campo:

10. Clave Foránea: se indica a con qué tabla y campo, tiene relación. Por ejemplo, el campo FCRMVI_CODFOR
(Formulario), de la tabla FCRMVI (ítems), tiene como clave foránea el campo FCRMVH_CODFOR de la tabla
FCRMVH (registración de facturación), el campo GRCFOR_DESCRP dela tabla GRCFOR (Formularios).
11. Descripción: se recupera la descripción de la tabla y campo que se indica en la clave foránea.
12. Relación con tabla maestra: se indica si el campo tiene relación con la tabla a la que pertenece la clave
foránea.
13. Búsqueda automática: se utiliza en el buscador de las versiones anteriores a 3.1, A partir de la 3.1 se utiliza
la funcionalidad del Super find (o llamado botón lupa).
14. Normal: se indica el valor por omisión tiene el campo para el nuevo registro.
15. Conversión: se indica con qué valor se actualizará el campo cuando se convierte la empresa.
16. Búsqueda automática: se ingresa una consulta SQL (Query) personalizada que permite definir criterios
específicos de búsqueda en el campo de tipo lista dinámica (con clave foránea). Por ejemplo, la recuperación
de valores ordenados por nombre en forma ascendente o descendente.
17. Reglas de validación: la regla de validación está compuesta por un Operador y tanto un Valor cómo un
Campo para hacer la comparación en función del operador elegido.
18. Filtro para las relaciones: en caso de definir que el campo tiene una Clave foránea, se puede extender el
filtro para la relación acotando el resultado de la unión.
19. Máscara: se indica la tabla y el campo del que se recupera la máscara para el campo.


20. Se compara contra otros campos: se indica si el filtro para recuperar la máscara se hace igualando la clave
de la tabla de máscaras con campos del mismo registro.
21. Se compara contra valores constantes: se indica si el filtro para recuperar la máscara se hace igualando la
clave de la tabla de máscaras con valores fijos.
22. Filtro para hallar la máscara: en el caso de utilizar una máscara de una tabla, se ingresa el campo contra el
cual el sistema se comparará.
23. Atributos: se permite ingresar o eliminar el tipo y valor de atributo de una tabla.
No en todas las tablas se pueden crear campos de usuario. Por ejemplo, en algunas tablas que tengan la
opción Store Procedure. Es importante considerar, que al crear un campo de usuario se debe verificar el
correcto funcionamiento del sistema.
2.3.5 Creación de un Proceso o Wizard

Para la creación de un Proceso o Wizard de tipo usuario, se debe crear un Wizard y luego una o varias Tablas de
Wizard.
2.3.5.1 CREACIÓN DE WIZARD

Se debe ir a la opción Nuevo Wizard de la barra de herramientas. Esto abre una ventana con las siguientes
opciones que se muestran en la figura 6:


Fig. 6. Definición del Wizard Proceso de promociones (USR_PPRPRWIZ).
1. Nombre: se debe ingresar un código que debe comenzar con el Prefijo USR_. En la figura 6, se ingresa el
código USR_PPRPRWIZ.
2. Descripción: se debe ingresar una descripción que lo identifica. Es la descripción del objeto wizard que se
muestra en el área de objetos del menu principal. En la figura 6, Proceso de promociones.
3. Clase controladora: se ingresa el nombre de la clase controladora de Wizard de usuario. Debe ser
GRWUsrScr.ControllerGRUWIZ.
4. Versión: se debe ingresar el valor cero (0).0
5. Módulo / Área, se indica la posición de partida de la nueva tabla. En la figura 6, se indica el módulo y área
Clientes (VT).
6. Mostrar mensajes, se indica si al terminar se muestran mensajes sobre el proceso que se está realizando o
mensajes de error.
7. Visible, se indica si es visible en el menú, se define que no es visible cuando el wizard termina volcando datos
en una tabla.
8. Pasos, si se realiza botón derecho sobre la lista de pasos, en el un menú contextual se encuentran las
opciones Add Stop (Agregar paso) y Delete Step (Borrar paso). La opción Add Step, se agrega un nuevo paso
al Wizard, donde se ingresar un nombre que debe comenzar con el Prefijo USR_). La opción Delete Step, se
elimina el campo seleccionado.
9. Descripción del Step, se ingresa o modifica la descripción del paso seleccionado en la lista de pasos.


2.3.5.2 CREACIÓN DE TABLA WIZARD

Para la creación de una tabla wizard de tipo usuario, se debe ir a la opción Nueva>Tabla de la barra de
herramientas o Nueva Tabla wizard de la barra de herramientas. Su configuración es igual a la de tablas normales
con las siguientes diferencias que se muestran en la figura 7:
Fig. 7. Definición la tabla wizard Paso 1 - Parámetros (USR_PPRPR01).
1. Nombre: se ingresa un código que debe comenzar con el Prefijo USR_. En la figura 7, se ingresa el código
USR_PPRPR01.
2. Tipo: es de tipo virtual. Si ingresa por la opción Nueva tabla de wizard desde la barra de herramientas, dicho
campo no es editable.
3. Wizard: se indica el wizard al cual pertenece la nueva tabla. En el ejemplo de la figura 7, se indica el
USR_PPRPRWIZ (Proceso de promociones), definido en la figura 6.
4. Paso: se indica el paso al cual corresponde en el wizard que se indica en el campo Wizard.
5. Modo grilla: se indica en el caso que los campos se quieran mostrar en pantalla en modo grilla.
A los efectos de una mejor administración de las tablas de wizard, se recomienda incluir la palabra
VIRT, una vez seguido del prefijo USR_, dentro de la estructura del nombre de los campos de la tabla
de wizard. Asimismo, los tipos de campos. Por ejemplo, el campo USR_VIRT_CMPRAD (Comprador).


Los campos de la tabla de wizard tienen la característica que no se graban en la base de datos. Por ello,
el tipo de campo puede ser:
✓ Se muestra, pero no se graba.
✓ No se graba ni se muestra.
2.4 Operaciones secundarias
2.4.1 Creación de tipos de dato

Para su creación se debe ir a la opción Herramienta de la barra de menu, y luego a la opción Tipos de dato.
En el mismo se puede administrar (crear, borrar y editar) los tipos de dato (los nuevos debes comenzar con el
prefijo USR_), donde se indica el tipo de dato base que representa el equivalente en la base de datos (integer,
double, date, boolean, etc.); ingresa la cantidad máxima de caracteres; ingresa la cantidad máxima de decimales
(en el caso de ser numérico); ingresar una máscara; ingresa reglas de validación (carga de valores fijos); ingresa
una lista de datos (implica definir una lista con valores predeterminados) y visualiza los campos donde está
incluido el tipo de dato (botón Usuarios).
En el ejemplo de la figura 8, se muestra la definición del tipo de dato USR_DIMENS, con un carácter, una lista de
datos (U=Unidades, S=Semanas y D=Días) y el tipo de dato base Variable Lenght String.
Fig. 8. Definición del tipo de dato de usuario USR_DIMENS.


2.4.2 Posicionamiento de campos en pantalla

El posicionamiento permite hacer el diseño original de una pantalla donde se indica el orden de ubicación de los
campos de tipo usuario, la posición en referencia a otro campo y la ubicación del campo dentro de un contenedor
(o frame). Asimismo, se puede crear y eliminar un contenedor (o frame).
Para su creación se debe ir a la opción Herramienta de la barra de menu, y luego a la opción Posicionamiento.
Luego de ello, se muestra la ventana ABM’s donde se elige la tabla cuyo diseño se desea modificar. En el ejemplo
de la figura 9, se muestra la grilla con los campos de la tabla usuario Productos en consignación (USR_STMCOH).
Fig. 9. Ventana de posicionamiento de la tabla Productos en consignación (USR_STMCOH).
Es posible realizar el posicionamiento de campos en forma masiva o proceso Batch.


2.4.3 Traducción de mensaje de error en pantalla (Uso interno de Softland)

Es la herramienta que permite personalizar los mensajes de error en pantalla. Para acceder se debe ir a la opción
Posicionamiento de la barra de menu, seleccionar cualquiera opción de la ventana ABM’s, y, por último, ir a la
opción Traducción de la barra de menu.
En esa ventana se listan todos los mensajes de error pasibles de traducción. En las siguientes figuras se muestra
el mensaje original, la traducción y luego el mensaje traducido en la registración de un comprobante de
facturación.
Fig. 10. Ventana Traducción. Mensaje de error original.
Fig. 11. Ventana Traducción. Mensaje de error modificado.
Fig. 12. Mensaje de error en la registración de facturación.


2.4.4 Relaciones de campos a reportes

Es la herramienta que permite vincular un reporte a un campo de un objeto de tipo lupa (o browse). Para la
existencia de la relación se necesita en primer orden, crear el campo en una tabla (tipo de dato abrowsefield), y
luego vincular el campo a un reporte determinado.
A continuación, se explica cómo hacer la relación del campo lupa denominado Código Postal, ubicado
en la solapa grilla Contactos, del objeto Clientes:
• Creación del campo lupa (o browse)

Ir a la opción Archivo>Abrir tabla de la barra de menu o Abrir Tabla de la barra de herramientas. En la ventana
Abrir tabla, seleccionar VTMCLC (Contactos).
Fig. 13 – Abrir Tabla Contactos.
Ir a la opción Ver>Campo de la barra de menú o Vista de campos de la barra de herramientas. En dicha pantalla,
ir a la opción Edición>Agregar Campo, o ir a la barra de herramientas y seleccionar Nuevo campo.
En la figura 14, se muestra la ventana Nuevo campo, donde se debe como tipo de campo Se muestra pero no se
graba y donde en el campo Nombre del campo, el sistema propone como nombre USR_XXXXXX_ _UNKNOWN
(donde XXXXXX es el nombre de la tabla). En este caso, se renombra el UNKNOWN por CODPOS, siendo el
nombre definitivo USR_VTMCLC_CODPOS.
Fig. 14 – Nuevo campo USR_VTMCLC_ CODPOS.


Se debe indicar el tipo de dato ABrowserField. El campo USR_VTMCLC_ CODPOS, queda definido como se
muestra en la figura 15.
Fig. 15 – Definición del campo de usuario USR_VTMCLC_ CODPOS.
Por último, ir a la opción Archivo>Guardar de la barra de menu o Guardar de la barra de herramientas.
• Relación Campo - Reporte

Ir a la opción Herramientas, y luego Relaciones a reportes de la barra de menu. En la ventana ABM’s, seleccionar
la tabla VTMCLC (Contactos), como se muestra en la figura 16.
Fig. 16 – Tabla VTMCLC – Contactos.
En la figura 17, se visualiza la ventana Relaciones a Reportes, con la configuración de la relación del
campo de usuario Código Postal con la del reporte Gr – Códigos postales.


Fig. 17 – Relación del campo Código Postal con el reporte Gr- Código Postal.
A continuación, se detalla su configuración:

✓ En el campo Descripción de la relación, se ingresa Contacto – Código Postal.
✓ En el campo Objeto Destino, se indica el nombre del reporte, en este caso GRT_PAC_LST (GR –
Códigos Postales).
✓ Se indica que la relación parte del campo de usuario Código Postal (USR_VTMCLC_CODPOS).
Por defecto, el sistema propone la opción Buscar valores, en el campo Formato para abrir el reporte
destino, de la solapa Opciones. Esto permite realizar únicamente una búsqueda de valores por pantalla,
sin retorno de datos. En caso de necesitar la recuperación de datos en determinados campos del reporte,
seguir los pasos que se mencionan en el punto 2.4.5 Relaciones de objetos a reportes.
• Ejemplo de la relación Campo - Reporte

Ir al objeto tabla Clientes, solapa grilla Contactos, donde se muestra el campo browse Código Postal.


Fig. 18 – Campo lupa Código Postal.
Cuando se realiza la creación de un campo browse, se necesita reiniciar Softland, para su incorporación
a la interfaz de usuario.
Al hacer clic en el botón lupa , se muestra la ventana Código Postal, con los valores que se recuperan del
reporte GR – Códigos Postales.
Fig. 19 – Ventana Código Postal.
2.4.5 Relaciones de objetos a reportes (o Consultas integradas)

Es la herramienta que permite vincular un reporte a un objeto de menu. Para ello, se debe ir a la opción
Herramienta de la barra de menu, y luego a la opción Consultas.


La ventana Consultas tiene las siguientes opciones:

• Tipo de objeto: se indica el tipo de objeto al que se quiere asociar un reporte. Existen dos (2)
alternativas:
✓ Tabla: es un objeto estándar del sistema (Ej.: Registraciones de cobranzas VTRRCH).
✓ Alias de tabla: es un objeto creado por el usuario (Empiezan con el prefijo USR_).
• Objeto: Se indica en qué objeto del menu se visualiza la consulta asociada. Las opciones disponibles
son en función del Tipo de objeto seleccionado.
• Tabla: se indica en qué tabla del Objeto seleccionado previamente se visualiza la consulta y se permite
realizar el volcado de datos.
En la figura 20 se muestra la consulta en el objeto tabla Registración de cobranzas.
Fig. 20 Cuadro de dialogo Consultas.
Al ingresar al botón Editar, se muestra la ventana Relaciones a reportes, con las siguientes solapas:


Fig. 21 Relación a reportes – solapa General.
En la solapa General, se encuentran las siguientes opciones:

• Nuevo/Editar/Eliminar: se puede crear una nueva consulta, editar o eliminar una existente.
• Descripción de la relación: se ingresa un nombre que con la que identifica la relación. En el ejemplo de
figura 21, Búsqueda de Clientes.
• Objeto destino: se indica el reporte que se asocia a la registración. En el ejemplo de la Figura 21, VT –
Clientes (Reducido) (VTM_CLH_CLR).
• Campos de la relación: se indica el o los campos en los cuales al posicionarse se habilita la consulta. La
misma puede partir desde cualquier campo o de alguno de ellos. En el ejemplo de la Figura XXX, se
indica el campo VTRMVH_NROCTA, Descripción Código de Cliente.
En la solapa Parámetros, se puede indicar si los valores de los campos de la registración se asignan como
parámetros del reporte asociado. Los campos disponibles como parámetros son los que existen como
disponibles en función del objeto y la tabla seleccionada. Se encuentran las siguientes opciones:
• Campo/Parámetro origen: es el campo de la registración donde se asigna como valor de parámetro al
reporte.
• Parámetro destino: es el parámetro del reporte que hereda el valor del campo de la registración indicado.
•


En la figura 22, se indica el parámetro Número de cuenta del cliente.
Fig. 22. Relación a reportes – solapa Parámetros.
En la solapa Opciones, se indica el tipo de consulta del reporte. Se encuentran las siguientes opciones:
• Formato para abrir el reporte destino:
✓ Formateado: se ejecuta el reporte para la visualización del reporte.
✓ Buscar Valores: Se ejecuta el reporte para la visualización del reporte y permite volcar los valores a
la registración.
• Permitir selección múltiple: Al seleccionar la opción Buscar Valores, se permite volcar varios ítems a la
registración, por lo cual, se debe utilizar cuando se asocia un reporte a una solapa de ítem de una
registración. Si no se selecciona esta opción solo se permitirá volcar un solo valor.
En la figura 23, se muestra la solapa opciones con el formato Buscar valores.


Fig. 23 Relación a Reportes – solapa Opciones.
En la solapa Retorno de datos, se indica cuales campos de la registración heredan los datos del reporte, por lo
cual, a cada campo de la registración que se desea volcar un dato, se debe tener asignado un campo del
reporte. Esta solapa se muestra en el caso de indicar como opción Buscar Valores, en la solapa Opciones. Se
encuentran las siguientes opciones:
• Campo destino: es el campo de la registración disponible para recibir valores en forma automática del
reporte.
• Toma valor de: es el campo del reporte que se toma el valor para asignarle el valor a la registración.
En la figura 24, se muestra la solapa Retorno de valores, con los valores Cuenta y Cobrador.


Fig. 24. Relación a Reportes – solapa Retorno de datos.
Para utilizar las Consultas implementadas se debe ingresar a la registración del sistema en la cual se implementa
la consulta, luego posicionar sobre el campo en el cual se debe activar la visualización, y, por último, seleccionar
en la barra de menú Consultas, alguna de las consultas configuradas.
En el ejemplo de la Figura 25, el objeto de menú Registración de Cobranzas (Tabla VTRRCH), al momento de
posicionar el cursor en el Código de Cliente (VTRMVH_NROCTA), se habilita la consulta Búsqueda de Clientes en
la opción Consultas de la barra de menú. Al hacer clic, se visualiza una ventana que corresponde al tipo de objeto
destino (VTM_CLH_CLR). En esta ventana se debe seleccionar el cliente y, por último, hacer clic en el icono
Guardar.
Cuando se realiza la creación de una consulta vinculada, se necesita reiniciar Softland, para su
incorporación a la interfaz de usuario.
Al hacer lo explicado en el párrafo anterior, el sistema recupera los valores del cliente y cobrador, en
función a lo indicado en la solapa Toma Valor, de la Relación de reportes. Ver figura 26.


Fig. 25. Registración de cobranzas – Consulta de clientes resumido.
Fig. 26. Registración de cobranzas – Recupero de valores en código de cliente y cobrador.
2.4.6 Índices
Es la herramienta que permite agregar índices a las tablas del sistema. El índice es una estructura de datos que
mejora la velocidad de las operaciones, por medio de un identificador único de cada fila de una tabla, permitiendo
un rápido acceso a los registros de una tabla en una base de datos. Se suelen usar en aquellos campos sobre los
cuales se hacen frecuentes búsquedas.
Para acceder a la definición de índices, se debe ir a la opción Vista de índices de la barra de herramientas o
Ver>Índices de la barra de menu.


En la figura 28, se muestra la ventana Índice, con la definición del índice GR_NYUMERATION, donde se utiliza el
campo Número de formulario (PVRMVH_NROFORM) para las búsquedas y posterior procesamiento de los datos,
en las registraciones de los comprobantes de proveedores y pagos. El campo Sin duplicados, sirve para que el
SQL verifique que en ese índice que no pueden existir dos (2) valores iguales. Es una manera de validar la
duplicidad en las cargas de las tablas de tipo usuario (USR).
Fig. 28. Registración de cobranzas – Recupero de valores en código de cliente y cobrador.
También se puede utilizar columnas incluidas (o agregadas), como complemento a los índices de las tablas
(estándar o de usuario), similares a las que funcionan en Microsoft SQL Server, y cuyo objetivo principal es la
optimización de las consultas SQL sobre las bases de datos.
2.4.7 Estadísticas
Es la herramienta que permite crear estadísticas vinculadas a tablas y sus campos, similares a las que funcionan
en Microsoft SQL Server, cuyo objetivo principal es la optimización de las consultas SQL sobre las bases de
datos.
Para acceder a la definición de las estadísticas, se debe ir a la opción Ver>Estadísticas de la barra de menu.
Como se muestra en la figura 29, en la tabla de Clientes (VTMCLH), se indican los campos Cuenta y Municipio,
para su uso en las estadísticas de SQL.


Fig. 29. Diccionario de datos. Estadísticas de la tabla Clientes (VTMCLH).
2.4.8 Regeneración de Stored Procedures

Es la herramienta que permite actualizar los stored procedures de la base de datos, en función a los stored
procedures enviados por Softland, adecuando de esta forma los stored procedures a los campos de usuario
creados por el cliente.
Para acceder al proceso de regeneración, se debe ir a la opción Ver>Regenerar stored procedures, funciones y
vistas de la barra de menu.
Fig. 30. Regenerar stored procedures.


2.4.9 Reparar objetos jerarquía de objetos

Es la herramienta que permite recuperar los objetos y carpetas de los favoritos asociadas al usuario que no se
visualizan en el árbol del usuario, como así también, el árbol original cuando presenta algún tipo de problema.
Para acceder al proceso de reparación, se debe ir a la opción Ver>Reparar jerarquía de objetos de la barra de
menu. Al hacerlo, el sistema muestra una ventana con el mensaje de confirmación del proceso.
Fig. 31. Reparar jerarquía de objetos. Mensaje de confirmación del proceso.
3. ANEXO - ESTRUCTURA DE TABLAS
3.1 Nomenclatura de tablas

A continuación, se detalla el criterio utilizado para nombrar tablas en el sistema de gestión;
1. Las tablas físicas deben siempre respetar los 6 caracteres.

2. Las tablas lógicas no tienen restricción de longitud.
3. Detalle de tablas físicas.
Detalle
FC Módulo
R Tipo
MV Detalle o descripción
H Pertenencia
Ejemplo: Tabla física FCRMVH, correspondiente a las registraciones de facturación. En donde,

FC, corresponde al módulo de Facturación.


R, de tipo registración.
MV, movimiento.
H, encabezado (header).
Detalle de módulos
AG Gestión Agropecuaria
CB Conciliación Bancaria
CF Cash Flow
CG Contabilidad
CJ Tesorería
CO Compras
CP Control Presupuestario
CT Costos
CV Facturación de Contratos
DD Diccionario de Datos
DG Impuestos
DP Depuraciones
DY Tabla de Migración con el Sistema América
EC E-Commerce
ED Gestión Educativa
EO Análisis de Gestión Financiera (EOAF)
FC Facturación
GC Gestión de Cobranzas
GP Gestión de Proyectos
GR General
IG Informes Gerenciales
IM Importaciones
IN Interfaces
ME Mantenimiento de equipos
PD Producción
PV Proveedores


RH Recursos Humanos
RP Repartos
RV Activo Fijo
SJ Sueldos y Jornales
SP Seguimiento de Proyectos
ST Stock
TR Transferencias
VT Clientes
WA Autorización
WG Wizard Generator
Detalle de los distintos Tipos
T Tablas (Jurisdicción, Situación de IVA)

A Datos auxiliares (Tablas temporarias de Reportes)
Saldos
S Estáticos (Saldo estático de cuentas contables)
R Registraciones (Toda tabla involucrada con la registración)
M Maestros (Clientes, Proveedores, Productos, etc.)
C Comprobantes, Conceptos, Formularios
Detalle de Pertenencia
H Header
I Í ítem
D Dimensiones
G Subcuentas
En el detalle de pertenencia, pueden existir otras variantes, pero obligatoriamente para este tipo de
tablas es necesario clasificarla de esta manera.


3.2 Nomenclatura de campos

A continuación, se detalla el criterio utilizado para nombrar tablas en el sistema de gestión;
1. Los campos físicos siempre llevan prefijo de 6 caracteres con el nombre de la tabla y un [ _ ] (Under Score)
Por ejemplo: FCRMVH_NROCTA
2. Los campos virtuales siempre llevan como prefijo la palabra VIRT más [ _ ] (Under Score)
Por ejemplo: VIRT_INDICA
En la mayoría de los casos, la segunda parte del campo (por ejemplo, NROCTA) debe respetar también
los 6 caracteres.

SPE DOC GU Diccionario de Datos

Cargado por

Copyright:

Formatos disponibles

SPE DOC GU Diccionario de Datos

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

SPE DOC GU Diccionario de Datos

Cargado por

Copyright:

Formatos disponibles

Diccionario de datos

Alcance funcional Versión: 1.3

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 2 / 35

Alcance funcional Versión: 1.3

Revisión Aprobación / Vigencia

17/11/2015 1.0 Creación s/parte EP 174 EP 16/11/2015 GR/JS 17/11/2015 EP

09/06/2016 1.1 Actualización s/Parte EP 220 EP 24/06/2016 GL 24/06/2016 EP

01/09/2016 1.2 Actualización S/Parte EP 227 EP 04/10/2016 GR 12/10/2016 EP

22/09/2017 1.3 Actualización S/Parte GR 1593 EP 09/11/2017 GR 10/11/2017 EP

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 3 / 35

Alcance funcional Versión: 1.3

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 4 / 35

Alcance funcional Versión: 1.3

A continuación, se enumeran algunas de las funcionalidades que presenta el Diccionario de datos:

2. Administración de procesos (o Wizard)

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 5 / 35

Alcance funcional Versión: 1.3

2.1 Ingreso al Diccionario de datos

Fig. 1. Ingreso al diccionario de datos.

Luego de ello, el sistema solicita seleccionar la empresa.

Fig. 2. Selección de empresa.

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 6 / 35

Alcance funcional Versión: 1.3

2.2 Pantalla principal

Fig. 3. Pantalla principal.

2.2.1 Barra de menu

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 7 / 35

Alcance funcional Versión: 1.3

2.2.2 Barra de herramientas

2.3 Administración de Tablas y Wizard

2.3.1 Barra de menu

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 8 / 35

Alcance funcional Versión: 1.3

2.3.2 Barra de herramientas

2.3.3 Creación de tabla de usuario

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 9 / 35

Alcance funcional Versión: 1.3

Fig. 4. Definición la tabla de usuario Cajeros (USR_GRTSEC).

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 10 / 35

Alcance funcional Versión: 1.3

En la creación de una tabla de usuario, se debe asignar la controler GRWUsrScr.ControllerGRUSCR,

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 11 / 35

Alcance funcional Versión: 1.3

2.3.4 Creación de campo de usuario

Fig. 5. Definición de la tabla de usuario Cajeros (USR_GRTSEC).

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 12 / 35

Alcance funcional Versión: 1.3

Las opciones dependen del tipo de tabla (estándar/usuario).

Propiedades del campo:

Template: TP_GU_[Tema].dotx Versión: 1.4 Vigencia: 25/08/2016

Fecha Impresión: 17/11/17 Softland Inversiones S.L., 2017 Pág.: 13 / 35

Alcance funcional Versión: 1.3