Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DATOS GENERALES


Producto

Solucoes_espanhol
SolucaoTOTVS RH

Línea de producto: 

Linhas_totvs_espanhol
LinhaLínea Protheus

Segmento:

Segmentos_totvs_espanhol
Segmento RH

Módulo:SIGAGPE - Gestión de Personal.
Función:

   

GPEXOPER
Rutina(s) Modificada(s)Nombre TécnicoFecha
GPEXFOR1Funciones Genéricas de Formulación.2927/1011/2024
GPEA291Definición Registro de OperadoresFórmulas.2927/1011/2024GPEA291

   

Rutina(s) Involucrada(s)Nombre TécnicoFecha
GPEXOPERDefinición de OperadoresRegistro de Fórmulas.29/10/2024

   

País:Argentina (ARG)
Ticket:N/A
Requisito/Story/Issue (informe el requisito vinculado):DNOMI-26242641

02. SITUACIÓN/REQUISITO

Se requiere de un operador estándar, para realizar la lectura de acumulados de ganancias que son almacenados en la tabla RT3 - Acumulados IAG en Argentinamodificar los operadores SUMA_MOVLI, FILTRO_MOVLI y FILTRO_ACUM para que acepten Variables o Mnemónicos en la 1ra Expresión y no solo valores fijos.

03. SOLUCIÓN

Se realizan las siguientes actualizaciones:

...

  • En la rutina Funciones Genéricas de Formulación (GPEXFOR1) se crea la función fGetAcuIAG() para obtener el valor de acumulados de la tabla RT3 - Acumulados IAG a partir del uso del operador SUM_GAN_ACU, el cual obtendrá a partir del mes indicado en el campo Fch. In. Ganan (RCH_FCHGAN) del periodo que se está procesando, ejemplo:
    • Si el mes del campo Fch. In. Ganan es enero, por ejemplo "01/01/2024", se obtendrá el valor acumulado del mes 01 (RT3_ACUM01).
    • Si el mes del campo Fch. In. Ganan es de un mes diferente a enero, por ejemplo "01/09/2024", se obtendrá el valor acumulado del mes 09 (RT3_ACUM09); si el valor acumulado en el mes es 0, se leerá el valor acumulado del mes anterior.

...

title¡ATENCIÓN!

...

  • modifican las funciones fBaseMov() y fFiltroMov(), correspondientes a los operadores FILTRO_MOVLI y SUMA_MOVLI; cambiando la validación en caso de que reciba un mnemónico/variable, para que tome el valor, y si es un valor fijo, que lo tome como se hacía anteriormente.
  • En la rutina Registro de Fórmulas (GPEA291) se corrige, para que no emita el mensaje de error al colocar un mnemónico o variable en la 1ra Expresión de los operadores FILTRO_MOVLI y SUMA_MOVLI.


945.
  • Se deben tener acumulados para poder probar el operador FILTRO_ACUM, el cual lee la tabla RG7 - Acumulados Históricos. Por ejemplo:

Totvs custom tabs box
tabsPre-condiciones, Procedimiento
idspaso1,paso2
Totvs custom tabs box items
defaultyes
referenciapaso1
  1. Realizar un respaldo del repositorio (RPO).
  2. Aplicar el parche correspondiente a la issue DNOMI-26242641.
    • Verificar que las rutinas se encuentren actualizadas en el repositorio y verificar que coincidan con las descritas en el encabezado del presente documento técnico, considerando que las fechas sean iguales o superiores.

    Regeneración de tablas:

Informações
titleRegeneración de tablas
Informações
titleNOTA

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, como se indica en el punto "Mnemónicos" de la sección 04. INFORMACIÓN ADICIONAL.

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.
      • Verificar que se haya creado el mnemónico SUM_GAN_ACU, como se indica en el punto "Mnemónicos" de la sección 04. INFORMACIÓN ADICIONAL.
  • Regresar el respaldo de las tablas del punto b
    • 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 a contra los generados en el Punto e, 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.
  • Contar con información en los catálogos utilizados en el el Cálculo de Nómina:
    • Tipos de Procedimiento.
    • Procesos:
      • Configurar un proceso Jornal o Mensual.
    • Mnemónicos.
    • Contar con el operadorSUM_GAN_ACU.Fórmulas.
      • Contar con fórmulas que utilicen el operador SUM_GAN_ACU. Como los operadores FILTRO_MOVLI, SUMA_MOVLI y FILTRO_ACUM; como la ejemplificada en el punto Fórmulas de la sección 04. INFORMACIÓN INFORMACIÓN ADICIONAL.
    • Conceptos.
      • Contar con conceptos relacionado relacionados a fórmulas que utilicen el operador SUM_GAN_ACU. Por ejemplo un concepto de usuario con código E01los operadores FILTRO_MOVLI, SUMA_MOVLI y FILTRO_ACUM.
    • Conceptos por proceso.
      • Configurar conceptos y fórmulas que utilicen el operador SUM_GAN_ACUutilicen los operadores FILTRO_MOVLI, SUMA_MOVLI y FILTRO_ACUM.
    • Criterios de Acumulación.
    • Periodos, para este ejemplo se utilizará la siguiente información:
        Nómina LIQ - Nómina de Liquidación
        • Nómina ANT - Anticipos, de ejemplo:
        • Periodo: 2024
        • Mes: 
      • 09
        • 07
        • Número de Pago: 01
        • Fecha Inicial: 01/
      • 09
      • Fch. In. Ganan: 30/09/2024, este campo debe ser informado e indicará el mes de consulta de acumulados para el mnemónico SUM_GAN_ACU.
      • Último periodo del mes: 2 - No

        • 07/2024
        • Fecha Final:
      • 30/09/2024
        • 31/07/2024
        • Empleado para el proceso configurado.

    Contar con información en la tabla RT3 - Acumulados IAG para el Proceso, Empleado y Concepto definidos anteriormente; por ejemplo:

  • RT3_PDRT3_ANOINIRT3_ANOFIMRT3_MES07RT3_ACUM07RT3_MES08RT3_ACUM08RT3_MES09RT3_ACUM09
    E0120242024107.00728.00108.00836.00109.00
    RG7_FILIALRG7_PROCESRG7_MATRG7_PDRG7_ANOINIRG7_ANOFIMRG7_CODCRIRG7_SEQACURG7_HRS01RG7_ACUM01RG7_HRS02RG7_ACUM02
    D MG 01 0000010000060012024202411            30,00      400.000,00            30,00      400.000,00
    D MG 01 0000020000070402024202411                   -        400.000,00                   -        400.000,00
    Totvs custom tabs box items
    defaultno
    referenciapaso2

    Por Procedimientos (GPEM020):

    1. Ingresar al módulo Gestión de Personal (SIGAGPE).
    2. Ingresar a la rutina Por Procedimientos, ubicada en el menú: Ir al menú "Miscelánea | Cálculos | Por procedimientoprocedimientos" (GPEM020).
    3. Indicar los parámetros requeridos para calcular el proceso y procedimiento de las precondiciones.Proceso, Procedimiento, Periodo y Empleado configurados en las Pre-condiciones.
    4. Dar clic en el botón "Confirmar", para iniciar Confirmar el cálculo.
    5. Validar que el cálculo finaliza de manera exitosa.
    6. Si fue activado el TRACE y se utilizó la fórmula de ejemplo indicada en el punto Fórmulas de la sección 04. INFORMACIÓN ADICIONAL, validar:
      • El uso del operadorSUM_GAN_ACU.
      • Que el valor acumulado del mes indicado en el campo Fch. In. Ganan (RCH_FCHGAN) sea asignado a la variable indicada en la sección Resultado (por ejemplo IMPORTE, NAUX_**, etc.) de la secuencia correspondiente.

    04. INFORMACIÓN ADICIONAL

    Mnemónicos

    ...

      • de los operadores FILTRO_MOVLI, SUMA_MOVLI y FILTRO_ACUM, considere de manera correcta cuando se envíe en la 1ra Expresión un mnemónico o variable.

    04. INFORMACIÓN ADICIONAL

    Fórmulas

    Ejemplo de una fórmula que utiliza los operadores FILTRO_MOVLI, SUMA_MOVLI y FILTRO_ACUM:

    Secuencia1ra ExpresiónOperador 12da ExpresiónResultadoObservación
    000001 #TRACE_ON


    000002NOCALCULASI_IGUAL1FINAL
    000003# PRUEBA SUMA_MOVLI



    000004
    MUEVE'1'CAUX_00Mueve '1' a la variable carácter CAUX_00
    000005
    MUEVE'V'TP_SUMA_MOVLIAsigna en el operador TP_SUMA_MOVLI valores ('V') que serán tomados para el operador SUMA_MOVLI y FILTRO_MOVLI
    000006CAUX_00FILTRO_MOVLICBSECOMPL
    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_01Sumariza en el operador SUMA_MOVLI, de forma combinada con el operador anterior (FILTRO_MOVLI) y guarda el resultado en la variable numéricoa NAUX_01
    000008
    MUEVE'H'TP_SUMA_MOVLIAsigna en el operador TP_SUMA_MOVLI unidades ('H') que seran tomados para el operador SUMA_MOVLI y FILTRO_MOVLI
    000009'1'FILTRO_MOVLICBSECOMPL
    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_02Sumariza en el operador SUMA_MOVLI, de forma combinada con el operador anterior (FILTRO_MOVLI) y guarda el resultado en la variable numéricoa NAUX_02
    000011CAUX_00SUMA_MOVLICBSECOMPLNAUX_03Se 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_MOVLICBSECOMPLNAUX_04
    000013# PRUEBA FILTRO_ACUM



    000014
    ANOPERFECINI

    ...

    Ejemplo de una fórmula que utiliza el operador SUM_GAN_ACU:

    SecuenciaOperando 1OperadorOperando 2ResultadoObservación000001#TRACE_ON000002MUEVE2024
    ANO_INI_ACU
    Define el año
    Se inicializa el periodo de acumulación inicial y final
    de acumulados; es decir, el año inicial y final que buscará de acumulados en la tabla RT3 - Acumulados IAG.
    para el operador FILTRO_ACUM, con las fechas inicial (mnemónico PERFECINI) y final del periodo de liquidación (mnemónico PERFECFIN)
    000015
    ANOPERFECFIN
    000003MUEVE2024
    ANO_FIN_ACU
    000006SUMA_GAN_ACUNAUX_01

    Se define el operador para consular los acumulados del concepto que se está procesando y periodo seleccionado.

    El resultado obtenido, puede ser almacenado en una variable auxiliar tipo numérica o unidades.

    000016
    MUEVE'1'CAUX_01Mueve '1' a la variable carácter CAUX_01
    000017
    MUEVE'12'CAUX_02Mueve '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_ACUMCBSECOMPL
    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
    000020CAUX_01SUMA_IMPORTESCAUX_02NAUX_05Acumula 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
    000022CAUX_01FILTRO_ACUMCBSECOMPL
    La variable carácter CAUX_01 que contiene el valor '1' se utiliza de filtro para el campo CBSECOMPL, en el operador FILTRO_ACUM
    000023CAUX_01SUMA_UNIDADESCAUX_02NAUX_06Acumula los unidades con el operador SUMA_UNIDADES, desde el mes 1 al 12, combinado con las condiciones anteriores indicadas desde la línea 14
    000024NAUX_05SUMANAUX_06NAUX_06
    000025
    MUEVENAUX_03UNIDADES
    000026
    MUEVENAUX_06IMPORTE
    000027FINALETIQUETA


    000028
    000007MUEVENAUX_01UNIDADES

    Se mueve el resultado de Acumulados a UNIDADES.

    Utilizando el ejemplo definido, se retornará el valor 945.00

    000010FINALETIQUETA000011
    #TRACE_OFF


       

    Card documentos
    InformacaoSolución disponible para versión 12.1.33 (con garantía extendida), 12.1.2210 (con garantía extendida) o superiores.
    Titulo¡IMPORTANTE!

    05. ASUNTOS RELACIONADOS

    ...

    ...

    Documento de Referencia de

    ...

    Operadores:

    ...

    Operadores (SIGAGPE - MI)

    ...

    Templatedocumentos