Índice
01. Operadores
A continuación se listan los Operadores utilizados en la formulación de los países correspondientes a Mercado Internacional (MI).
Generación de Mnemónicos
NOTA
En caso de contar con formulación estándar nativa; solo debe ingresar a la rutina Mnemónicos (GPEA300), de manera que el sistema realice la actualización automática de los Mnemónicos.
Si tiene personalizaciones en la formulación, como lo son Mnemónicos de usuario; realizar los siguientes pasos.
- Generar archivos Excel para validación:
Ejecutar la rutina “Consultas | Archivos | Genéricos” y Exportar a Excel la información (Opción Exp. CSV”), de las tablas RCA.
Guardar los archivos de Excel generados (antes del cambio).
- Respaldar las siguientes tablas:
- Abrir las tablas RCA.
- Respaldar Mnemónicos (RCA):
- Respaldar la tabla RCA.
- Borrar los registros de la tabla RCA.
- Carga de Formulación Estándar:
- Ingresar a la rutina de Mnemónicos, ubicada en "Actualizaciones | Definic. Cálculo | Mnemónicos" (GPEA300); para que se carguen los mnemónicos estándar.
- Regresar el respaldo de las tablas del punto 2.
- Abrir la tabla RCA.
- Generar archivos Excel para validación:
- Ejecutar la rutina "Consultas | Archivos | Genéricos" y Exportar a Excel la información (Opción Exp. CSV”), de la tabla RCA.
- Guardar los archivos de Excel generados (después del cambio).
- Comparar los archivos Excel generados en el Punto 1 contra los generados en el Punto 5, para determinar las diferencias de configuración de los datos.
- Mnemónicos (RCA)
- Comparar los archivos antes y después del cambio, para determinar las diferencias.
- Entrar en la rutina ubicada en "Actualizaciones | Definic. Cálculo | Mnemónicos"; para incluir los mnemónicos del cliente.
- Mnemónicos (RCA)
Lista de Operadores
OPERADORES | |||||||||
---|---|---|---|---|---|---|---|---|---|
Cod. Mnemon. | Descr. Mnem. | Tipo Mnemon. | Contenido | Tabla | Campo | Proceso | Descripción | Hotkey | Localización |
SUMA_GAN_ACU | Obtiene el valor acumulado del mes (lee concepto de RT3) | P - Operador | Obtiene el valor de acumulados del mes de ganancias de la tabla RT3 - Acumulados IAG, a partir del mes indicado en Fch. In. Ganan. (RCH_FCHGAN). | ARG | |||||
LEE_TRAY | Mediante este operador, se traen los registros existentes en trayectoria laboral del empleado desde un movimiento antes de la fecha inicial a la fecha final indicada. | P - Operador | Indica el inicio de un ciclo para obtiene los registros existentes en trayectoria laboral del empleado. | LT | MEX, COL y PER | ||||
SIG_TRAY | Este operador salta a la línea siguiente del operador LEE_TRAY si existe otro registro de trayectoria dentro de los seleccionados por ese operador. En caso de que no exista, salta a la línea abajo del operador SIG_TRAY. | P - Operador | Se utiliza para realizar el salto de registro en los registros obtenidos por el operador LEE_TRAY. | ST | MEX, COL y PER | ||||
PRIMER_REG_TRAY | Este operador se coloca en el primer registro de trayectoria laboral, dentro del rango de fechas de LEE_TRAY. | P - Operador | Se coloca en el primer registro de trayectoria laboral dentro del rango de información obtenida por el operador LEE_TRAY. | PRT | MEX, COL y PER | ||||
ULTIMO_REG_TRAY | Este operador se coloca en el último registro de trayectoria laboral, dentro del rango de fechas indicados en LEE_TRAY. | P - Operador | Se coloca en el ultimo registro de trayectoria laboral dentro del rango de información obtenida por el operador LEE_TRAY. | URT | MEX, COL y PER | ||||
SUMA_MOVLI | Permite por medio de la fórmula, el cálculo (adición/sustracción) de los valores de los conceptos ya calculados en los Movimientos Mensuales (tabla SRC). | P - Operador | El operador SUMA_MOVLI obtiene la “suma” de los valores de los conceptos que cumplan con la condición establecida en la 1ra expresión, para el campo señalado en la segunda expresión. | +M | TODOS | ||||
FILTRO_MOVLI | Este operador filtra los movimientos de los conceptos que cumplen con cierto criterio de selección, determinado por un campo de la tabla de Conceptos (SRV). | P - Operador | Funciona en conjunto con el mnemónico reservado TP_SUMA_MOVLI al cual se le asigna ”H” ó “D” para la lectura de las Unidades y “V” para Importe; si este no es definido se leen importes. | FM | TODOS | ||||
FILTRO_ACUM | El operador efectúa un filtro de Acumulados (RG7), a partir de un campo de la tabla de Conceptos (SRV). Este operador funciona en conjunto con los operadores siguientes:
| P - Operador | Si la condición del filtro usado en FILTRO_ACUM no existe, el retorno del operador es Cero, ya que se utiliza para limpiar cualquier valor anterior del mismo operador. En una misma fórmula puede usar varias veces el operador FILTRO_ACUM y se requiere que este sea inicializado (dejando en blanco las columnas de OPERANDO) o de lo contrario considerara una condición ‘AND’ entre ambos filtros. | FA | TODOS | ||||
SUMA_IMPORTES | SUMA_UNIDADES | Estos dos operadores, leen los acumulados del empleado del mes inicial al mes final del proceso en el maestro de empleados o el indicado en BUSCA_PROCESO. Los meses son tipo carácter de tamaño 2. Para indicar el año inicial y final es necesario asignarlos a los mnemónicos ANO_INI_ACU y ANO_FIN_ACU. | P - Operador | En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO). En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO). Si ANO_INI_ACU es diferente que ANO_FIN_ACU, Mes inicio puede ser mayor que Mes fin. | +I y +U | TODOS | ||||
UNIDADES_EMPRESA | IMPORTES_EMPRESA | Estos dos operadores, leen los acumulados del empleado del mes inicial al mes final de todos los procesos pertenecientes a la empresa a la cual está asignado el proceso que se está ejecutando. Los meses son tipo carácter de tamaño 2. Para indicar el año inicial y final es necesario asignarlos a los mnemónicos ANO_INI_ACU y ANO_FIN_ACU. | P - Operador | En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO). En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO). Si ANO_INI_ACU es diferente que ANO_FIN_ACU, Mes inicio puede ser mayor que Mes fin. | UE e IE | TODOS | ||||
UNIDADES_TOTAL | IMPORTES_TOTAL | Estos dos operadores, leen los acumulados del empleado del mes inicial al mes final de todos los procesos pertenecientes a la empresa a la cual está asignado el proceso que se está ejecutando y de todas las sucursales. Los meses son tipo carácter de tamaño 2. Para indicar el año inicial y final es necesario asignarlos a los mnemónicos ANO_INI_ACU y ANO_FIN_ACU. | P - Operador | En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO). En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO). Si ANO_INI_ACU es diferente que ANO_FIN_ACU, Mes inicio puede ser mayor que Mes fin. | UT e IT | TODOS | ||||
RESIDUO | Resto de una operación de división | P - Operador | El operador RESIDUO realiza la división entera entre el divisor que se encuentra en la 1ª EXPRESIÓN y el dividendo, que se encuentra en la 2ª EXPRESIÓN y reporta el residuo de esta división. | MOD | TODOS |
02. Uso de Operadores
SUMA_GAN_ACU
Ejemplo:
Secuencia | 1a Expresión | Operador | 2da Expresión | Resultado |
---|---|---|---|---|
000001 | # | TRACE_ON | ||
000002 | MUEVE | "2024" | ANO_INI_ACU | |
000003 | MUEVE | "2024" | ANO_FIN_ACU | |
000004 | SUMA_GAN_ACU | UNIDADES | ||
000005 | FINAL | ETIQUETA | ||
000006 | # | TRACE_OFF |
Observaciones
- Se debe definir antes el rango mediante los mnemónicos ANO_INI_ACU y ANO_FIN_ACU, los cuales son necesarios para posicionarse sobre la tabla RT3 - Acumulados IAG.
- El operador retornará en formato numérico el valor acumulado en la columna Resultado, en la cual se podrá utilizar variables auxiliares como por ejemplo NAUX_**, Mnemónicos transferibles, UNIDADES.
- El mes de búsqueda de acumulados, se tomará del campo Fch. In. Ganan (RCH_FCHGAN) del periodo seleccionado.
LEE_TRAY / SIG_TRAY
Ejemplo:
Secuencia | 1a Expresión | Operador | 2da Expresión | Resultado |
---|---|---|---|---|
000001 | # | TRACE_ON | ||
000002 | PERFECINI | LEE_TRAY | PERFECFIN | "01" |
000003 | MUEVE | DIAS_TRAY_SIG | NAUX_01 | |
000004 | SIG_TRAY | GEN_MOV | ||
000005 | MUEVE | NAUX_01 | UNIDADES | |
000006 | FINAL | ETIQUETA | ||
000007 | # | TRACE_OFF |
Observaciones
LEE_TRAY
- La 1a Expresión y 2da Expresión del operador LEE_TRAY indican la fecha inicial y final en las cuales se desea consultar la trayectoria laboral:
- Si se indica alguna de las expresiones, deberá ser en formato dd/mm/yyyy.
- Si no se indican la 1ra Expresión, se tomara la fecha de inicio del periodo que se esta procesando.
- Si no se indican la 2da Expresión, se tomara la fecha de fin del periodo que se esta procesando.
- En el uso del operador LEE_TRAY, en la columna Resultado se deberá indicar el tipo de movimiento a consultar:
- Si se requiere consultar más de un tipo de movimiento se deberán colocar separados por "," (coma), ejemplo: "01,09"
- Si no se indica un tipo de movimiento (Resultado vacío) se obtendrán todos los tipos de movimientos, también se puede indicar con '*'.
- Los códigos a informar, corresponden a los valores del campo RCP_TPMOV. En algunas localizaciones dichos códigos, se encuentran definidos en la opciones del campo o en una Tabla Alfanumérica.
- El orden de los registros obtenidos será en base a la fecha de movimiento en forma descendente.
- Podrá acceder a cualquier campo de la tabla de trayectoria por medio de mnemónicos de tipo archivo.
- En el caso de que no haya ningún registro en ese rango de fechas cargará el último movimiento “no importando su tipo de movimiento”.
- Si el empleado no tuviera ningún registro en trayectoria laboral, el flujo de la formula saltará hasta la siguiente instrucción SIG_TRAY.
- Se cuenta con el mnemónico reservado DIAS_TRAY_SIG que contiene los días de efectividad del movimiento que se esta procesando; en resultado se podrá utilizar en variables auxiliares como por ejemplo NAUX_**, Mnemónicos transferibles, UNIDADES.
SIG_TRAY
- Se cuenta con el mnemónico reservado GEN_MOV, si se informa en la 2da Expresión del operador SIG_TRAY antes de traer el siguiente registro inserta un registro en movimientos de nómina con lo que tenga en los mnemónicos reservados UNIDADES e IMPORTE y los inicializa en ceros. Si no se le indica que genere un movimiento no se inicializa en ceros UNIDADES e IMPORTE y solo generará un movimiento, si al terminar el ciclo trae algo UNIDADES e IMPORTE.
- Al encontrar este operador si existen más registros en trayectoria laboral, saltará al renglón inmediato inferior de LEE_TRAY y volverá a ejecutar la formula hasta que no haya más registros.
SUMA_MOVLI, FILTRO_MOVLI y FILTRO_ACUM
Ejemplo:
Secuencia | Operando 1 | Operador | Operando 2 | Resultado | Observación |
---|---|---|---|---|---|
000001 | # | TRACE_ON | |||
000002 | NOCALCULA | SI_IGUAL | 1 | FINAL | |
000003 | # PRUEBA SUMA_MOVLI | ||||
000004 | MUEVE | '1' | CAUX_00 | Mueve '1' a la variable carácter CAUX_00 | |
000005 | MUEVE | 'V' | TP_SUMA_MOVLI | Asigna en el operador TP_SUMA_MOVLI valores ('V') que serán tomados para el operador SUMA_MOVLI y FILTRO_MOVLI | |
000006 | CAUX_00 | FILTRO_MOVLI | CBSECOMPL | La variable carácter se utiliza de filtro para el campo CBSECOMPL, en este caso con el valor '1' anteriormente asignado | |
000007 | SUMA_MOVLI | NAUX_01 | Sumariza en el operador SUMA_MOVLI, de forma combinada con el operador anterior (FILTRO_MOVLI) y guarda el resultado en la variable numérica NAUX_01 | ||
000008 | MUEVE | 'H' | TP_SUMA_MOVLI | Asigna en el operador TP_SUMA_MOVLI unidades ('H') que serán tomados para el operador SUMA_MOVLI y FILTRO_MOVLI | |
000009 | '1' | FILTRO_MOVLI | CBSECOMPL | El valor fijo '1' se utiliza de filtro para el campo CBSECOMPL, para comprobar que continúa funcionando también de esa forma, en el operador FILTRO_MOVLI | |
000010 | SUMA_MOVLI | NAUX_02 | Sumariza en el operador SUMA_MOVLI, de forma combinada con el operador anterior (FILTRO_MOVLI) y guarda el resultado en la variable numérica NAUX_02 | ||
000011 | CAUX_00 | SUMA_MOVLI | CBSECOMPL | NAUX_03 | Se puede utilizar de esta forma directamente SUMA_MOVLI con el filtro en el mismo operador, tanto con valor fijo (el cual se guarda en la variable NAUX_04) como con un mnemónico o variable (el cual se guarda en la variable NAUX_03) |
000012 | '1' | SUMA_MOVLI | CBSECOMPL | NAUX_04 | |
000013 | # PRUEBA FILTRO_ACUM | ||||
000014 | ANO | PERFECINI | ANO_INI_ACU | Se inicializa el periodo de acumulación inicial y final para el operador FILTRO_ACUM, con las fechas inicial (mnemónico PERFECINI) y final del periodo de liquidación (mnemónico PERFECFIN) | |
000015 | ANO | PERFECFIN | ANO_FIN_ACU | ||
000016 | MUEVE | '1' | CAUX_01 | Mueve '1' a la variable carácter CAUX_01 | |
000017 | MUEVE | '12' | CAUX_02 | Mueve '12' a la variable carácter CAUX_02 | |
000018 | FILTRO_ACUM | Se coloca el operador FILTRO_ACUM sin parámetros para limpiar cualquier acumulado anterior, dentro de la misma fórmula | |||
000019 | '1' | FILTRO_ACUM | CBSECOMPL | El valor fijo '1' se utiliza de filtro para el campo CBSECOMPL, para comprobar que continúa funcionando también de esa forma, en el operador FILTRO_ACUM | |
000020 | CAUX_01 | SUMA_IMPORTES | CAUX_02 | NAUX_05 | Acumula los importes con el operador SUMA_IMPORTES, desde el mes 1 al 12, combinado con las condiciones anteriores indicadas desde la línea 14 |
000021 | FILTRO_ACUM | Se coloca el operador FILTRO_ACUM sin parámetros para limpiar cualquier acumulado anterior, dentro de la misma fórmula | |||
000022 | CAUX_01 | FILTRO_ACUM | CBSECOMPL | La variable carácter CAUX_01 que contiene el valor '1' se utiliza de filtro para el campo CBSECOMPL, en el operador FILTRO_ACUM | |
000023 | CAUX_01 | SUMA_UNIDADES | CAUX_02 | NAUX_06 | Acumula los unidades con el operador SUMA_UNIDADES, desde el mes 1 al 12, combinado con las condiciones anteriores indicadas desde la línea 14 |
000024 | NAUX_05 | SUMA | NAUX_06 | NAUX_06 | |
000025 | MUEVE | NAUX_03 | UNIDADES | ||
000026 | MUEVE | NAUX_06 | IMPORTE | ||
000027 | FINAL | ETIQUETA | |||
000028 | # | TRACE_OFF |
Observaciones
Operando1 | Operador | Operando2 | Resultado | ||||||||||||||||||||||||||||||||||||
Valor fijo tipo caracter (entre comillas) Mnemónico de tabla SRV (Conceptos) | SUMA_MOVLI | Mnemónico de tabla SRV (Conceptos) BASE_PENSIÓN Constante que contenga conceptos | N | ||||||||||||||||||||||||||||||||||||
Permite por medio de la fórmula, el cálculo (adición/sustracción) de los valores de los conceptos ya calculados en los Movimientos Mensuales (tabla SRC), de acuerdo con la lista de conceptos seleccionada. También permite el cálculo para beneficiarios de acuerdo con la definición del operando BASE_PENSION. 1. El posicionamiento para la tabla de beneficiarios debe realizarse en conjunto con el operador SUMA_MOVLI y el Mnemónico reservado BASE_PENSION, identificado en la segunda expresión de la fórmula utilizada. Utiliza el campo “RM_LEEBEN” en la tabla RCM, que identifica los Conceptos por Proceso.
2. También es posible utilizar el operador SUMA_MOVLI con un Mnemónico que identifique un campo de la tabla SRV (Conceptos), que tengan el valor en contenido en la variable alfanumérica CAUX_01, se sumarizan en la variable de resultado:
3. También es posible utilizar el operador SUMA_MOVLI con un Mnemónico que identifique un campo de la tabla SRV (Conceptos), que tengan el valor en '1 - Si', se sumarizan en la variable de resultado:
4. Otra posibilidad es utilizar directamente valores en la expresión de la fórmula, los cuales deben ser los códigos de los conceptos registrados en la tabla “SRV”, en el campo Código (“RV_COD”).
Suma los importes de los conceptos calculados hasta el momento de acuerdo a la lista de conceptos seleccionados. Respeta el tipo de concepto, es decir si es Percepción o Base Percepción se suma y si es Deducción o Base Deducción se resta. |
Operando1 | Operador | Operando2 | Resultado | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Valor fijo tipo caracter (entre comillas) Mnemónico de tabla SRV (Conceptos) | FILTRO_MOVLI | Mnemónico de tabla SRV (Conceptos) | N | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Operando1 | Operador | Operando2 | Resultado |
FILTRO_ACUM | |||
C (filtro de selección) | FILTRO_ACUM | Mnemónico de Conceptos (SRV) | |
PERMESPER | SUMA_IMPORTES | PERMESPER | |
FILTRO_ACUM | |||
‘S’ | FILTRO_ACUM | BSECSS | |
PERMESPER | SUMA_IMPORTES | PERMESPER | IMPORTE |
03. Actualizaciones
A continuación se listan los Documentos Técnicos, que describen las actualizaciones/modificaciones realizadas a los Operadores:
- DT Operador para la Lectura de Acumulados de Ganancias (IAG) en la Tabla RT3 ARG
- DT Mejora en Operadores SUMA_MOVLI, FILTRO_MOVLI y FILTRO_ACUM ARG
04. Asuntos Relacionados
Documento de Referencia de la Localización de Argentina:
DT Localización Argentina (SIGAGPE) - Protheus 12
Documento de Referencia de la Localización de Colombia:
DT Localización Colombia (SIGAGPE) - Protheus 12