Skip to Content

Wiki source code of Parámetros del Sistema

Version 1.9 by Nico Perez on 2026/06/17 09:47
Show last authors
1 = Parámetros del sistema =
2
3 == Introducción ==
4
5 La opción **Parámetros del sistema** permite consultar y administrar parámetros de configuración utilizados por el módulo de **Liquidación de Haberes**.
6
7 Estos parámetros definen referencias y valores que el sistema utiliza en distintos procesos de liquidación, generación de informes, exportaciones, Libro de Sueldos Digital, aportes, fondos, conceptos especiales y otros comportamientos asociados al módulo.
8
9 Desde esta pantalla se pueden visualizar, crear, editar o eliminar parámetros asociados al módulo de Liquidación. Cada parámetro posee una **clave**, un **valor** y un **módulo**. La clave identifica al parámetro dentro del sistema, mientras que el valor puede ser una referencia a una entidad existente o un dato ingresado directamente.
10
11 Es importante diferenciar esta opción de la administración de **Conceptos de Liquidación**. Los conceptos se configuran desde su propia pantalla y representan conceptos liquidables, como sueldo, vacaciones, SAC, presentismo, premios o descuentos. En cambio, los parámetros del sistema indican qué concepto, tipo, valor o lista debe utilizar el sistema para una finalidad determinada.
12
13 Por ejemplo, un parámetro puede indicar que la clave liqHaberes.concepto.vacaciones utiliza el concepto 100 - VACACIONES. En ese caso, el concepto continúa siendo administrado desde **Conceptos de Liquidación**, mientras que el parámetro define qué concepto debe tomar el sistema cuando necesita identificar el concepto configurado como vacaciones.
14
15
16 ----
17
18
19 == Ubicación en el sistema ==
20
21 **Módulo:** Liquidación de Haberes
22
23 **~ Listado:** Archivos
24
25 **~ Opción:** Parámetros del sistema
26
27 (FOTO)
28
29 Pantalla de acceso a la opción **Parámetros del sistema** dentro del listado de Archivos del módulo Liquidación de Haberes.
30
31
32 ----
33
34 == Funcionamiento general ==
35
36 La opción **Parámetros del sistema** permite administrar parámetros asociados al módulo de Liquidación de Haberes.
37
38 La pantalla muestra un listado de parámetros filtrados por el módulo LiqHaberes. Esto significa que no se visualizan necesariamente todos los parámetros generales del sistema, sino aquellos vinculados con el funcionamiento de Liquidación de Haberes.
39
40 Cada parámetro se identifica mediante una clave. Esa clave puede ser utilizada por procesos internos del sistema, exportaciones, informes o fórmulas configuradas para recuperar un valor determinado.
41
42 El valor del parámetro puede tener dos comportamientos principales:
43
44 * Puede referenciar una entidad existente del sistema, como un Concepto de Liquidación, un Tipo de Concepto, un Tipo de Liquidación u otra entidad configurable.
45 * Puede guardar un valor directo, como un número, texto, lista de códigos o indicador utilizado por el sistema.
46
47 Por este motivo, modificar un parámetro puede afectar el comportamiento de procesos de Liquidación de Haberes sin modificar directamente la definición del concepto o entidad referenciada.
48
49
50 ----
51
52 == Diferencia con Conceptos de Liquidación ==
53
54 La opción **Conceptos de Liquidación** permite crear y configurar los conceptos que intervienen en una liquidación. Allí se define el comportamiento propio del concepto, su fórmula, tipo, base imponible, factor multiplicador, orden de liquidación y demás datos funcionales.
55
56 La opción **Parámetros del sistema**, en cambio, no define cómo se liquida un concepto. Su función es indicar qué concepto, tipo, valor o lista debe utilizar el sistema en determinados procesos.
57
58 Por ejemplo:
59
60 * En **Conceptos de Liquidación** puede existir el concepto 8 - ADICIONAL UOCRA LP.
61 * En **Parámetros del sistema** puede existir la clave liqHaberes.concepto.plusProd cuyo valor sea 8 - ADICIONAL UOCRA LP.
62
63 En ese caso, el parámetro no reemplaza al concepto. El parámetro indica que, para la clave liqHaberes.concepto.plusProd, el sistema debe tomar como referencia el concepto 8 - ADICIONAL UOCRA LP.
64
65 Si se modifica el concepto, cambia la configuración del concepto liquidable. Si se modifica el parámetro, cambia qué concepto toma el sistema para esa clave.
66
67 == ==
68
69 ----
70
71 == Diferencia con Parámetros del sistema generales ==
72
73 La opción de **Parámetros del sistema** también existe en otros sectores del sistema, como Configuración.
74
75 La diferencia de esta opción dentro de Liquidación de Haberes es que se accede al mismo mantenimiento de parámetros, pero filtrado para visualizar los parámetros asociados al módulo LiqHaberes.
76
77 Por lo tanto, esta pantalla está orientada a parámetros que intervienen en procesos propios de Liquidación de Haberes, mientras que la opción general puede incluir parámetros de otros módulos o contextos del sistema.
78
79 == ==
80
81 ----
82
83 == Pantalla principal ==
84
85 Al ingresar a la opción, el sistema muestra un listado de parámetros asociados al módulo de Liquidación de Haberes.
86
87 La grilla principal permite consultar los parámetros registrados y visualizar sus datos principales:
88
89 |=Columna|=Descripción
90 |**Clave**|Identificador del parámetro dentro del sistema. Es el dato que permite reconocer qué configuración se está administrando.
91 |**Valor**|Valor actualmente asignado al parámetro. Puede corresponder a una entidad del sistema, como un Concepto de Liquidación, o a un valor directo, como un número, texto o lista de códigos.
92 |**Módulo**|Módulo al que pertenece el parámetro. En esta opción, los parámetros se encuentran asociados a Liquidación de Haberes.
93
94 (FOTO)
95
96 Pantalla principal con el listado de parámetros del sistema asociados al módulo **LiqHaberes**.
97
98 Desde esta pantalla se puede acceder a la consulta, alta, edición, eliminación, impresión y exportación de parámetros, de acuerdo con los permisos disponibles para el usuario.
99
100
101 ----
102
103 == Búsqueda ==
104
105 La pantalla dispone de un sector de búsqueda que permite filtrar los parámetros visibles en la grilla.
106
107 El sistema permite utilizar distintos criterios de coincidencia:
108
109 |=Criterio|=Descripción
110 |**Todas**|Busca coincidencias considerando todas las condiciones indicadas.
111 |**Alguna**|Busca registros que cumplan al menos una de las condiciones indicadas.
112 |**Exacta**|Busca coincidencias exactas según el texto ingresado.
113 |**Buscar**|Campo donde se ingresa el texto a consultar.
114
115 También se dispone del botón **Búsqueda Avanzada**, utilizado para acceder a opciones adicionales de búsqueda del listado cuando corresponda.
116
117 La búsqueda permite localizar parámetros por datos como la clave o el módulo, facilitando la administración cuando existen múltiples parámetros registrados.
118
119 (FOTO)
120
121 Sector de búsqueda de la pantalla principal, con las opciones de coincidencia y el botón **Búsqueda Avanzada**.
122
123 == ==
124
125 ----
126
127 == Paginación ==
128
129 Cuando la cantidad de parámetros supera la cantidad de registros visibles por pantalla, el sistema organiza el listado en páginas.
130
131 La grilla permite:
132
133 * avanzar o retroceder entre páginas;
134 * visualizar la página actual y el total de páginas;
135 * definir la cantidad de registros por página;
136 * consultar el rango de registros mostrado.
137
138 Esta funcionalidad facilita la navegación del listado cuando existen numerosos parámetros configurados para el módulo.
139
140 == ==
141
142 ----
143
144 == Acciones disponibles ==
145
146 Desde la pantalla principal, el sistema permite realizar las siguientes acciones:
147
148 |=Acción|=Descripción
149 |**Nuevo (F7)**|Permite registrar un nuevo parámetro del sistema.
150 |**Imprimir**|Permite imprimir el listado de parámetros.
151 |**Actualizar**|Recarga la información del listado.
152 |**Exportar (F8)**|Permite exportar el listado de parámetros.
153 |**Cerrar (F12)**|Cierra la pantalla de parámetros.
154 |**Editar**|Permite acceder al formulario de edición del parámetro seleccionado.
155 |**Eliminar**|Permite eliminar parámetros seleccionados, cuando el usuario cuenta con permisos para realizar la acción.
156
157 La edición se realiza desde el icono disponible en cada fila de la grilla. La selección mediante casillas permite operar sobre uno o más registros, según las acciones habilitadas para el usuario.
158
159 La eliminación de parámetros debe realizarse con precaución, ya que otros procesos del sistema pueden depender de la existencia de una clave determinada.
160
161
162 ----
163
164 == Alta de parámetro ==
165
166 Desde el botón **Nuevo (F7)**, el sistema permite registrar un nuevo parámetro.
167
168 Al ingresar al alta, la pantalla permite seleccionar el tipo de parámetro que se desea crear:
169
170 * **Persistent Param**
171 * **Value Param**
172
173 La elección del tipo de parámetro determina qué datos se deben completar y cómo será interpretado el valor guardado.
174
175 (FOTO)
176
177 Formulario de alta de parámetro, con la selección entre **Persistent Param** y **Value Param**.
178
179 == ==
180
181 ----
182
183 == Persistent Param ==
184
185 La opción **Persistent Param** se utiliza cuando el parámetro debe guardar una referencia a una entidad existente del sistema.
186
187 Este tipo de parámetro no almacena simplemente un texto o número, sino que permite seleccionar una instancia de una clase determinada. Por ejemplo, puede utilizarse para indicar que una clave de Liquidación de Haberes debe apuntar a un Concepto de Liquidación específico.
188
189 Un caso típico es un parámetro cuya clave identifica un concepto especial utilizado por el sistema:
190
191 {{{liqHaberes.concepto.plusProd
192 }}}
193
194 y cuyo valor referencia al concepto:
195
196 {{{8 - ADICIONAL UOCRA LP
197 }}}
198
199 En este caso, el parámetro indica que para la clave liqHaberes.concepto.plusProd el sistema debe utilizar el concepto 8 - ADICIONAL UOCRA LP.
200
201 (FOTO)
202
203 Formulario de alta o edición de un **Persistent Param**, donde se selecciona la clase, la instancia, el código y el módulo.
204
205 === ===
206
207 ----
208
209 === Campos principales ===
210
211 |=Campo|=Descripción
212 |**Clase**|Entidad del sistema que se utilizará como origen de la referencia. Por ejemplo, Concepto de Liquidación, Tipo de Concepto u otra clase disponible.
213 |**Instancia**|Registro concreto seleccionado dentro de la clase indicada. Al estar en el modulo de liquidacion es el comportamiento esperado es haber elegido la clase de Conceptos de Liquidacion
214 |**Código**|Clave del parámetro. Identifica al parámetro dentro del sistema.
215 |**Módulo**|Módulo al que pertenece el parámetro. Para esta opción corresponde a Liquidación de Haberes. Se coloca el nombre de LiqHaberes o liqHaberes para posterior aparicion dentro de esta página.
216 |**Descripción**|Texto descriptivo opcional para identificar el uso del parámetro.
217 |**Editable por Usuario**|Indica si el parámetro puede ser visualizado o administrado por usuarios con permisos limitados, según la configuración de acceso.
218
219 === Selección de clase e instancia ===
220
221 Al crear un **Persistent Param**, el sistema permite seleccionar una clase y luego una instancia correspondiente a esa clase.
222
223 Por ejemplo, si se selecciona la clase **Concepto Liquidación**, la instancia deberá ser un concepto existente, como sueldo, vacaciones, SAC, presentismo, premio u otro concepto configurado.
224
225 (FOTO)
226
227 Listado de clases disponibles para la configuración de un parámetro persistente.
228
229 La instancia seleccionada será el valor funcional que el sistema utilizará cuando consulte la clave del parámetro.
230
231 == ==
232
233 ----
234
235 == Value Param ==
236
237 La opción **Value Param** se utiliza cuando el parámetro debe guardar un valor directo.
238
239 A diferencia de un **Persistent Param**, este tipo no referencia una entidad del sistema, sino que almacena un dato ingresado manualmente.
240
241 Puede utilizarse para registrar:
242
243 * un número;
244 * un texto;
245 * una lista de códigos;
246 * un indicador;
247 * un valor utilizado por exportaciones, informes o procesos de Liquidación.
248
249 Ejemplos de valores posibles:
250
251 {{{500
252 }}}
253
254 {{{1,2,4,6,11,14
255 }}}
256
257 {{{240
258 }}}
259
260 (FOTO)
261
262 Formulario de alta de un **Value Param**, utilizado para registrar un parámetro con valor directo.
263
264 === Campos principales ===
265
266 |=Campo|=Descripción
267 |**Código**|Clave del parámetro. Identifica al parámetro dentro del sistema.
268 |**Módulo**|Módulo al que pertenece el parámetro. Para esta opción corresponde a Liquidación de Haberes.
269 |**Valor**|Dato directo que se guarda para la clave indicada.
270 |**Descripción**|Texto descriptivo opcional para identificar el uso del parámetro.
271 |**Editable por Usuario**|Indica si el parámetro puede ser visualizado o administrado por usuarios con permisos limitados, según la configuración de acceso.
272
273 == ==
274
275 ----
276
277 == Guardado del parámetro ==
278
279 Una vez completos los datos requeridos, se debe presionar **Guardar** para registrar el parámetro.
280
281 El sistema valida que los campos obligatorios estén informados antes de guardar. Si falta algún dato requerido, el parámetro no puede registrarse correctamente.
282
283 La creación de parámetros debe realizarse con precaución, ya que las claves pueden ser utilizadas por procesos internos del sistema o por fórmulas configuradas.
284
285
286 ----
287
288 == Edición de parámetro ==
289
290 La edición permite modificar la configuración de un parámetro existente.
291
292 Para acceder a la edición, se debe seleccionar el icono correspondiente en la fila del parámetro dentro de la grilla principal. El sistema abre el formulario con los datos actuales del parámetro.
293
294 (FOTO)
295
296 Formulario de edición de un parámetro existente asociado al módulo **LiqHaberes**.
297
298 En la edición se mantienen los mismos criterios que en el alta:
299
300 * Si el parámetro es de tipo **Persistent Param**, el valor corresponde a una entidad existente del sistema.
301 * Si el parámetro es de tipo **Value Param**, el valor corresponde a un dato directo ingresado manualmente.
302
303 Modificar un parámetro puede cambiar el comportamiento de procesos que consultan esa clave. Por ejemplo, si un parámetro referencia un Concepto de Liquidación, cambiar la instancia seleccionada puede hacer que el sistema utilice otro concepto en informes, exportaciones o cálculos asociados.
304
305 Por este motivo, antes de editar un parámetro se recomienda verificar:
306
307 * qué clave se está modificando;
308 * qué valor tiene actualmente;
309 * si el parámetro apunta a una entidad o guarda un valor directo;
310 * si la clave es utilizada por procesos de Liquidación de Haberes;
311 * si existen fórmulas, reportes o exportaciones que dependan de ese parámetro.
312
313 == Eliminación de parámetro ==
314
315 La pantalla permite eliminar parámetros, siempre que el usuario cuente con los permisos correspondientes.
316
317 La eliminación debe realizarse con precaución, ya que otros procesos del sistema pueden depender de la existencia de la clave eliminada.
318
319 Si una fórmula, reporte, exportación o proceso interno consulta un parámetro inexistente, el comportamiento puede verse afectado. Por este motivo, antes de eliminar un parámetro se recomienda validar si la clave está siendo utilizada.
320
321 No se recomienda eliminar parámetros estándar del módulo sin una revisión previa del impacto funcional.
322
323 == Validaciones y controles ==
324
325 Al guardar un parámetro, el sistema valida que los campos obligatorios se encuentren informados.
326
327 En los parámetros de tipo **Persistent Param**, los campos principales requeridos son:
328
329 * **Clase**
330 * **Instancia**
331 * **Código**
332 * **Módulo**
333
334 En los parámetros de tipo **Value Param**, los campos principales requeridos son:
335
336 * **Código**
337 * **Módulo**
338 * **Valor**
339
340 El campo **Descripción** permite agregar información adicional sobre el uso del parámetro, pero no reemplaza la necesidad de utilizar una clave clara y consistente.
341
342 El campo **Editable por Usuario** determina si el parámetro puede quedar disponible para usuarios con permisos limitados, según la configuración de acceso. Este control es importante para evitar que parámetros sensibles sean modificados por usuarios que no deberían administrar configuraciones críticas.
343
344 == Seguimiento ==
345
346 En la edición de un parámetro puede estar disponible la acción **Seguimiento**.
347
348 Esta opción permite consultar información asociada al historial o seguimiento del registro, de acuerdo con la configuración del sistema.
349
350 (FOTO)
351
352 Botón **Seguimiento** disponible en la edición de un parámetro.
353
354 El seguimiento resulta útil para revisar información vinculada al registro cuando se requiere controlar cambios o consultar datos asociados a su mantenimiento.