Wiki source code of Versión S.I.C.O.S.S.

Version 3.2 by Nico Perez on 2026/05/15 11:54

Show last authors
1 == Introducción ==
2
3 La opción **Versión S.I.C.O.S.S.** permite administrar las versiones de formato utilizadas para la exportación de información al sistema S.I.C.O.S.S.
4
5 Cada versión define la estructura del archivo a generar, indicando qué campos debe incluir, en qué orden deben aparecer, qué longitud tendrá cada dato, qué tipo de valor se utilizará y cómo se completará el relleno cuando corresponda.
6
7 Esta configuración se utiliza luego en la opción [[**Exportar S.I.C.O.S.S.**,>>doc:Main.BS GESTION.CENTRO DE CONOCIMIENTO.Articulos y Contenido.Modulo del sistema .Liquidación de Haberes .Exportar SiCOSS.WebHome]] donde se selecciona la versión del formato que se aplicará para generar el archivo de exportación.
8
9 La funcionalidad permite crear nuevas versiones, modificar la estructura de campos de una versión existente, importar formatos compatibles y eliminar versiones registradas.
10
11 ----
12
13 == Ubicación en el sistema ==
14
15 **Módulo:** Liquidación de Haberes
16
17 **~ Listado:** Archivos
18
19 **~ Opción:** Versión S.I.C.O.S.S.
20
21 [[image:1778856799602-200.png]]
22
23 ----
24
25 == Funcionamiento ==
26
27 La opción **Versión S.I.C.O.S.S.** permite definir y mantener estructuras de formato para la generación de archivos de exportación S.I.C.O.S.S.
28
29 Cada versión contiene una grilla de campos que determina la composición del archivo generado. En esa grilla se define el orden de salida de los campos, su descripción, longitud, tipo de dato, fórmula de obtención o cálculo, relleno y ubicación del relleno.
30
31 Desde esta opción se puede:
32
33 * consultar las versiones S.I.C.O.S.S. registradas;
34 * crear nuevas versiones;
35 * modificar versiones existentes;
36 * definir o ajustar los campos que componen el formato;
37 * importar formatos compatibles con la grilla;
38 * eliminar versiones registradas;
39 * consultar el seguimiento de cambios realizados sobre cada versión.
40
41 == Listado de versiones S.I.C.O.S.S. ==
42
43 Al ingresar a la opción, el sistema muestra una grilla con las versiones S.I.C.O.S.S. registradas.
44
45 La grilla incluye el siguiente dato:
46
47 * **Versión S.I.C.O.S.S.:** nombre o identificación de la versión del formato.
48
49 Desde el listado es posible consultar, editar o eliminar los registros existentes, según los permisos del usuario.
50
51 [[image:1778856850994-318.png]]
52
53 ----
54
55 == Alta y edición de versión S.I.C.O.S.S. ==
56
57 La opción permite crear nuevas versiones S.I.C.O.S.S. o modificar versiones ya existentes.
58
59 Para crear una nueva versión, se debe presionar el botón **Nuevo**. El sistema abre una pantalla donde se debe informar el nombre o identificación de la versión.
60
61 Para modificar una versión existente, se puede acceder desde el registro de la grilla o utilizar la acción de edición disponible en el listado.
62
63 (FOTO)
64
65 Una vez creada o abierta una versión, el sistema muestra la sección **Formato**, donde se configura la grilla de campos que compondrá el archivo de exportación.
66
67 Los campos del formato pueden editarse directamente desde la grilla. Para que los cambios realizados sobre la versión o sobre su formato queden registrados, se debe presionar **Guardar**.
68
69 ----
70
71 == Formato de la versión ==
72
73 La sección **Formato** permite definir la estructura de campos que compondrá el archivo de exportación S.I.C.O.S.S.
74
75 Cada fila de la grilla representa un campo del archivo. El orden de las filas determina el orden en que los datos se incluirán en la salida generada.
76
77 Los campos pueden editarse directamente sobre la grilla. Una vez realizados los cambios, se debe presionar **Guardar** para que queden registrados.
78
79 (FOTO)
80
81 === Descripción ===
82
83 Permite indicar el nombre o referencia funcional del campo dentro del formato.
84
85 Este dato facilita la identificación del contenido que se incluirá en esa posición del archivo.
86
87 Ejemplos de campos:
88
89 * CUIL
90 * Apellido y Nombre
91 * Código de Situación
92 * Código de Condición
93 * Código de Actividad
94 * Código de Modalidad de Contratación
95 * Remuneración Total
96
97 === Longitud ===
98
99 Permite indicar la cantidad de caracteres o posiciones que tendrá el campo dentro del archivo exportado.
100
101 El valor informado en este campo determina el largo que deberá ocupar el dato en la salida generada.
102
103 === Tipo ===
104
105 Permite indicar el tipo de dato que tendrá el campo dentro del formato.
106
107 Las opciones utilizadas son:
108
109 * **T:** texto.
110 * **E:** entero.
111 * **D:** decimal / double.
112
113 Este dato permite definir cómo debe interpretarse el valor generado para ese campo dentro del archivo de exportación.
114
115 === Fórmula ===
116
117 Permite indicar de dónde toma el sistema el dato o cómo debe calcularse el valor del campo.
118
119 La fórmula puede hacer referencia a datos del empleado, datos de la liquidación, valores calculados o reglas internas definidas para la exportación.
120
121 Ejemplos:
122
123 * @CUIL: toma el CUIL del empleado.
124 * @EMPLEADO: toma el nombre del empleado.
125 * @CANTHIJOS: toma la cantidad de hijos.
126 * @CONYUGE: toma la información correspondiente al cónyuge.
127
128 Las fórmulas disponibles y su funcionamiento específico se administran en una configuración propia del sistema.
129
130 === Relleno ===
131
132 Permite indicar el valor utilizado para completar el campo cuando el dato obtenido no alcanza la longitud definida.
133
134 Por ejemplo, si el campo debe ocupar una cantidad fija de posiciones, el sistema utiliza el relleno configurado para completar el largo requerido.
135
136 === Al final ===
137
138 Indica si el relleno debe agregarse al final del valor del campo.
139
140 Cuando está configurado en **Sí**, el sistema agrega el relleno al final del dato.
141
142 Cuando está configurado en **No**, el sistema agrega el relleno al inicio del dato.
143
144 ----
145
146 == Importación de formato ==
147
148 La opción **Importar** permite cargar un formato de versión S.I.C.O.S.S. desde un archivo externo compatible con la estructura de la grilla.
149
150 Al presionar **Importar**, el sistema abre una ventana donde se debe seleccionar el archivo correspondiente para procesar la carga.
151
152 (FOTO)
153
154 El archivo importado debe respetar una estructura compatible con los campos del formato, de manera que el sistema pueda completar la grilla de la versión.
155
156 Una vez importada la información, se debe revisar el contenido cargado y presionar **Guardar** para registrar los cambios en la versión.
157
158 Esta opción permite facilitar la carga o actualización de estructuras de formato sin tener que completar manualmente cada campo de la grilla.
159
160 ----
161
162 == Acciones disponibles ==
163
164 Desde el listado de **Versión S.I.C.O.S.S.**, el sistema permite realizar las siguientes acciones:
165
166 * **Nuevo:** permite crear una nueva versión S.I.C.O.S.S.
167 * **Editar:** permite modificar una versión existente y ajustar su formato.
168 * **Eliminar:** permite eliminar una o más versiones registradas.
169 * **Buscar / Búsqueda avanzada:** permite localizar versiones específicas dentro del listado.
170 * **Actualizar:** refresca la información mostrada en pantalla.
171 * **Imprimir:** permite obtener una salida impresa del listado.
172 * **Exportar:** permite exportar la información del listado en los formatos disponibles del sistema.
173 * **Ayuda:** permite acceder a la ayuda asociada a la opción.
174 * **Cerrar:** permite salir de la pantalla.
175
176 Dentro de la pantalla de alta o edición también se encuentran disponibles las siguientes acciones:
177
178 * **Guardar:** registra los datos cargados o modificados en la versión y en su formato.
179 * **Importar:** permite cargar un formato desde un archivo externo compatible con la grilla.
180 * **Agregar campo:** permite incorporar una nueva fila al formato de la versión.
181 * **Eliminar campo:** permite quitar un campo de la grilla del formato.
182
183 ----
184
185 == Consideraciones ==
186
187 La opción **Versión S.I.C.O.S.S.** define la estructura del archivo que luego se genera desde la exportación S.I.C.O.S.S.
188
189 El orden de los campos en la grilla determina el orden en que los datos se incluirán en el archivo exportado.
190
191 Los cambios realizados sobre la grilla de formato no quedan registrados hasta presionar **Guardar**.
192
193 La columna **Fórmula** define el origen o cálculo del dato que se incluirá en cada campo. La configuración y detalle de las fórmulas disponibles se administra en una funcionalidad específica del sistema.
194
195 El valor informado en **Longitud** debe respetar la cantidad de posiciones esperadas para cada campo dentro del formato.
196
197 El campo **Relleno** se utiliza cuando el dato obtenido no alcanza la longitud definida.
198
199 La opción **Al final** determina la ubicación del relleno:
200
201 * si está configurada en **Sí**, el relleno se agrega al final del dato;
202 * si está configurada en **No**, el relleno se agrega al inicio del dato.
203
204 La importación de formato requiere un archivo compatible con la estructura de la grilla.
205
206 Las versiones pueden eliminarse aunque hayan sido utilizadas previamente en una exportación, ya que el archivo generado no queda vinculado operativamente al registro de la versión.
207
208 ----
209
210 == Relación con otras funcionalidades ==
211
212 Esta opción se relaciona principalmente con:
213
214 * [[**Exportar S.I.C.O.S.S.**>>doc:Main.BS GESTION.CENTRO DE CONOCIMIENTO.Articulos y Contenido.Modulo del sistema .Liquidación de Haberes .Exportar SiCOSS.WebHome]]
215 * [[**Parámetros del Sistema**>>doc:Main.BS GESTION.CENTRO DE CONOCIMIENTO.Articulos y Contenido.Modulo del sistema .Liquidación de Haberes .Parámetros del Sistema.WebHome]]
216 * [[**Liquidación de Haberes**>>doc:Main.BS GESTION.CENTRO DE CONOCIMIENTO.Articulos y Contenido.Modulo del sistema .Liquidación de Haberes .Liquidación de Haberes.WebHome]]