Versões comparadas

Chave

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

Diseño de Pantalla y diccionario con MVC de Cobros Diversos 


Línea de Producto:

Microsiga Protheus.

Segmento:

Servicios - Mercado Internacional.

Módulo:

SIGAFIS- Financiero.

Rutina:

Rutina

Nombre Técnico

FIN887EventDEF.PRW

Reglas de Negocio válidas para todos los países (estándar).

FIN887EventDEFFIS.PRWReglas de Negocios especificas del módulo Fiscal.
FIN887EventDEFCTB.PRWReglas de Negocio especificas del módulo Contable.
FIN887GridDEF.PRWReglas de Negocio válidas para todos los países (estándar), para el uso del Grid de Formas de Cobro.
FIN887BrwDEF.PRWReglas de Negocio válidas para todos los países (estándar), para el uso del Browse de Documentos a Cobrar.

Rutina(s) involucrada(s)

Nombre Técnico

Informe la(s) rutina(s) involucrada(s).

Informe el nombre técnico de la(s) rutina(s) involucrada(s).

Requisito/Story/Issue: DMINA-574

País(es):

México.

Base(s) de Datos:

Todas.

Tablas utilizadas:

SA1.- Clientes

SM2.- Monedas

SA6.- Bancos

SAQ.- Cobradores

SF2.- Facturas

SF1.- Notas de Crédito.

SEL.- Recibos

SE1.-Cuantas por Cobrar

SE5.- Movimientos bancarios

FJT .- Encabezado del Recibo

FK’s.- Reestructuración de tabla SE5.

Sistema(s) operativo(s):

Todas.

Descripción 

Usar los estándares de desarrollo MVC (Model-View-Controller) en el registro de Cobros Diversos II para separar la lógica de negocio de la lógica de presentación (interface), para permitir el desarrollo, pruebas y mantenimiento de forma aislada. Visualizando ganar productividad en el desarrollo de reglas de negocio estándares de producto y de las posibles personalizaciones de nuestros Clientes utilizando POO (Programación Orientada Objetos).

Importante

(Solo para Microsiga Protheus, versiones anteriores a la versión 12)

Antes de ejecutar el compatibilizador, informe el nombre del compatibilizador es imprescindible:

  • Realizar la copia de seguridad de la base de datos del producto que ejecutará el compatibilizador (directorio PROTHEUS_DATA\DATA, si es la versión 10, o \PROTHEUS11_DATA\DATA, si es la versión 11) y de los diccionarios de datos SX (directorio PROTHEUS_DATA_SYSTEM, si es la versión 10, o \PROTHEUS11_DATA\SYSTEM, si es la versión 11).
  • Los directorios mencionados anteriormente corresponden a la instalación estándar del Protheus, por lo tanto, deben modificarse de acuerdo con el producto instalado en la empresa.
  • Esta rutina debe ejecutarse de modo exclusivo, es decir, ningún usuario debe estar utilizando el sistema.
  • Si los diccionarios de datos tienen índices personalizables (creados por el usuario), antes de ejecutar el compatibilizador, asegúrese de que están identificados por el nickname. Si el compatibilizador necesita crear índices, los agregará a partir del orden original instalado por el Protheus, lo que podrá ocasionar la superposición de índices personalizados, si no están identificados por el nickname.
  • El compatibilizador debe ejecutarse con la Integridad referencial desactivada*.


Atención

¡El siguiente procedimiento debe realizarlo un profesional calificado como Administrador de base de datos (DBA) o su equivalente!

La activación indebida de la integridad referencial puede modificar drásticamente la relación entre tablas en la base de datos. Por lo tanto, antes de utilizarla, observe atentamente el siguiente procedimiento:

1.    En el Configurador (SIGACFG), verifique si la empresa utiliza Integridad referencial, seleccionando la opción Integridad/Verificación (APCFG60A).

2.    Si no hay Integridad referencial activa, se listan en una nueva ventana todas las empresas y sucursales registradas en el sistema y ninguna de estas estará seleccionada. SOLAMENTE en este caso no es necesario ningún otro procedimiento de activación o desactivación de integridad, basta finalizar la verificación y aplicar normalmente el compatibilizador, de acuerdo con las  instrucciones.

3.     Si la Integridad referencial está activa en todas las empresas y sucursales, se muestra un mensaje en la ventana Verificación de vínculo entre tablas. Confirme el mensaje para que se concluya la verificación, o;

4.     Si existe Integridad referencial activa en una o más empresas, que no representan la totalidad, se listan en una nueva ventana todas las empresas y sucursales registradas en el sistema y solamente se seleccionarán las que tienen integridad. Anote las empresas y/o sucursales que tienen la integridad activada y reserve esta anotación para posterior consulta en la reactivación (o incluso, entre en contacto con nuestro Help Desk Framework para informarse sobre los archivos que contienen esta información).

5.    En los casos descritos en los ítems “iii” o “iv”, Y SOLO EN ESTOS CASOS, es necesario desactivar dicha integridad, seleccionando la opción Integridad/ Desactivar (APCFG60D).

6.     Al desactivar la Integridad referencial, ejecute el compatibilizador, de acuerdo con las instrucciones.

7.    Después de aplicar el compatibilizador, la Integridad referencial debe reactivarse, SOLAMENTE CUANDO se haya desactivado, por medio de la opción Integridad/Activar (APCFG60). Para ello, tenga a disposición la información de la(s) empresa(s) y/o sucursal(es) que tenía(n) activación de la integridad, selecciónela(s) nuevamente y confirme la activación.

 

¡EN CASO DE DUDAS, entre en contacto con el Help Desk Framework!


  1. En Microsiga Protheus TOTVS Smart Client(si la versión es 10) o ByYou Smart Client (si la versión es 11), digite el nombre del compatibilizador en el campo Programa Inicial. Describa si el compatibilizador debe tener una fecha específica o superior para que la actualización en los diccionários se efectúe correctamente. Importante: Para que se actualice correctamente el diccionario de datos, asegúrese de que la fecha del compatibilizador sea igual o superior al ___/___/____.
  2. Haga clic en OK para continuar.
  3. Después de confirmar, aparece una pantalla para seleccionar la empresa en la cual se modificará el diccionario de datos oaparece la ventana para seleccionar el compatibilizador. Seleccione el programa xxxx().
  4. Al confirmar, se muestra un mensaje de advertencia sobre la copia de seguridad y la necesidad de su ejecución de modo exclusivo.
    1. Haga clic en Procesar para iniciar el procesamiento. El primer paso de la ejecución es la preparación de los archivos. 
    1. Se muestra un mensaje explicativo en la pantalla.
    2. A continuación, se muestra la ventana Actualización concluida con el historial (log) de todas las actualizaciones procesadas. En este log de actualización se muestran únicamente los campos actualizados por el programa. El compatibilizador crea los campos que aún no existen en el diccionario de datos.
    3. Haga clic en Grabar para guardar el historial (log) mostrado.
    4. Haga clic en OK para finalizar el procesamiento.


Describa si hay algún procedimiento necesario después de aplicar el compatibilizador.

Procedimiento de Implantación 

El sistema se actualiza inmediatamente después de aplicar el paquete de actualizaciones (Patch) de este llamado.

  1. Aplique el patch del llamado y ejecute una vez la rutina Informe el nombre de la rutina.
  2. En el módulo, Informe el nombre del módulo acceda a Informe el camino y verifique si el parámetro informe el nombre del parámetro se creó de acuerdo con las especificaciones abajo: 

Nombre de la Variable:

Informe el Nombre de la Variable.

Tipo:

Informe el tipo.

Descripción:

Informe la descripción.

Valor Estándar:

Informe el valor estándar.

Modificaciones a Diccionario


  1. Creación del Grupo de Preguntas FIN887 en el archivo SX1 – Archivo de Preguntas:

Orden

01

Pregunta

 Muestra  Asientos?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaCombo
Def 1Si
Def 2No
VarMV_PAR01
Help

Considera la visualización de los Asientos contables

Orden

02

Pregunta

Agrupa Asientos?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaCombo
Def 1Si
Def 2No
VarMV_PAR02
Help

Considera la agrupación de los asientos contables

Orden

03

Pregunta

 Asientos Online?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaCombo
Def 1Si
Def 2No
VarMV_PAR03
Help

Considera los Asientos on-line.  

Orden

04

Pregunta

 Filtrar cliente?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaCombo
Def 1Código + Tienda
Def 2Código
Def 3Sin filtro
VarMV_PAR04
Help

Permite agrupar EN EL MISMO RECIBO los documentos que pertenecen al mismo Cliente + Sucursal o al mismo Cliente (independiente de la sucursal) o todos los Títulos seleccionados.

Orden

05

Pregunta

Para Generar Saldos?

Grupo

FIN887

Tipo

C

Tamaño

3

EntradaGet
VarMV_PAR05
Help

Informe el tipo de título que deberá ser generado en el caso de recibir más del saldo a cancelar. 

Orden

06

Pregunta

Considera sucursal?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaCombo
Def 1Si
Def 2No
VarMV_PAR06
Help

Si considera sucursal, el sistema muestra los títulos de la sucursal actual, en caso contrario muestra títulos de todas las sucursales para liquidación.


2. Modificación de los siguientes Campos en el archivo SX3 – Campos:


  • FJT - Encabezado de Recibo         

Campo

FJT_SERIE

Utilizado

Si

Campo

FJT_VERSAO

Utilizado

No

Campo

FJT_VERATU

Utilizado

No

Campo

FJT_DTDIGI

Utilizado

No

Campo

FJT_VALDOC

Utilizado

No

Campo

FJT_VALBX

Utilizado

No

Campo

FJT_VALRA

Utilizado

No

Campo

FJT_VALRRET

Utilizado

No

Campo

FJT_CANCEL

Utilizado

No


  • SEL - Recibos de Cobranza       

Campo

EL_TIPO

Utilizado

No

Campo

EL_DESCONT

Utilizado

Si

Campo

EL_SERIE

Utilizado

No

Campo

EL_VERSAO 

Utilizado

No

Campo

EL_COBRAD

Utilizado

No

Campo

EL_RECPROV

Utilizado

No

Campo

EL_CLIORIG

Obligatorio

No

UtilizadoNo

Campo

EL_LOJORIG

Obligatorio

No


UtilizadoNo

Campo

EL_UUID

Utilizado

No

Campo

EL_DIACTB

Utilizado

No

Campo

EL_FECTIMB

Utilizado

No

Campo

EL_RECIBO

Utilizado

No


EL_COBRAD


Procedimiento de

Configuración

(Estos procedimientos se deben realizar cuando es necesario configurar parámetros y/o  rutinas en el menú).

 

CONFIGURACIÓN DE PARÁMETROS

 

  1. En el Configurador (SIGACFG), acceda a Entornos/Archivos/Parámetros (CFGX017). Cree/configure (mantenga solo la instrucción correspondiente) el(los) parámetro(s) a continuación:

    (Es necesario crear una tabla para cada parámetro que se describe en el ítem Parámetro(s), de la tabla Características del Requisito).  

Ítems/Carpetas

Descripción

Nombre:

Tipo:

Informe el tipo del parámetro.

Cont. Por.:

Informe el contenido estándar.

Descripción:

 

CONFIGURACIÓN DE MENÚS

 

2.  En el Configurador (SIGACFG), acceda a Entornos/Archivo/Menú (CFGX013). Informe la nueva opción de menú del informe el nombre del módulo, conforme las instrucciones a continuación:

Menú

Informe el Menú en que se localizará la rutina.

Submenú

Informe el Submenú donde estará la rutina.

Nombre de la Rutina

Informe el Título de la rutina.

Programa

Informe el Fuente de la rutina.

Módulo

Informe el Nombre del(los) producto(s) que se utilizará(n) o “Todos”.

Tipo

Informe la Función.

Procedimiento de Utilización 

    • Describa los procedimientos, paso a paso (en caso de uso), que loa usuarios realizarán para que la mejora se visualice, identificando la información:
    • Ubicación de la rutina en el menú;
    • Ubicación de los nuevos campos y/o preguntas y sus respectivas carpetas de archivo que el usuario visualizará;
    • En caso de que se necesite tener algún archivo previo, haga una observación.

 

Ejemplo:

       1.            En el Plan de Salud (SIGAPLS), acceda a Actualizaciones / Producto Salud / Producto Salud (PLSA800).

El sistema exhibe la ventana de productos registrados.

       2.            Posicione el cursor en un producto y haga clic en Modificar.

       3.            En la carpeta Cobertura/Carencias, seleccione la subcarpeta Tipo de Prestador.

       4.            Haga doble clic en el campo TP Prestador (BCW_TIPPRE).

El sistema exhibe la ventana Tipo de Prestador – Coparticipación – Modificación.

       5.            Informe los datos conforme la orientación del help de campo y observe el rellenado del nuevo campo:

                      Solo p/Compra (BCW_SOMCOM): seleccione Sí para indicar si la coparticipación registrada será válida solo para efecto de compra de procedimientos o No, en caso contrario.

       6.            Verifique los datos y confirme.

Modificaciones a Diccionario

Modificar de manera manual por medio de Configurador (SIGACFG) el grupo de preguntas MT467N y agregar la opcion 4 al grupo de preguntas.

Creación del Grupo de Preguntas FIN887 en el archivo SX1 – Archivo de Preguntas:

Orden

01

Pregunta

 Muestra  Asientos?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaComboDef 1SiDef 2NoVarMV_PAR01Help

Considera la visualización de los Asientos contables

Orden

02

Pregunta

Agrupa Asientos?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaComboDef 1SiDef 2NoVarMV_PAR02Help

Considera la agrupación de los asientos contables

Orden

03

Pregunta

 Asientos Online?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaComboDef 1SiDef 2NoVarMV_PAR03Help

Considera los Asientos on-line.  

Orden

04

Pregunta

 Filtrar cliente?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaComboDef 1Código + TiendaDef 2CódigoDef 3Sin filtroVarMV_PAR04Help

Permite agrupar EN EL MISMO RECIBO los documentos que pertenecen al mismo Cliente + Sucursal o al mismo Cliente (independiente de la sucursal) o todos los Títulos seleccionados.

Orden

05

Pregunta

Para Generar Saldos?

Grupo

FIN887

Tipo

C

Tamaño

3

EntradaGetVarMV_PAR05Help

Informe el tipo de título que deberá ser generado en el caso de recibir más del saldo a cancelar. 

Si considera sucursal, el sistema muestra los títulos de la sucursal actual, en caso contrario muestra títulos de todas las sucursales para liquidación.

Orden

06

Pregunta

Considera sucursal?

Grupo

FIN887

Tipo

N

Tamaño

1

EntradaComboDef 1SiDef 2NoVarMV_PAR06Help

2.    Creación o modificación de tabla en el archivo SX2– Tablas:

Clave

Nombre

Modo

PYME

B04

(X2_CLAVE)

Diente/Región

(X2_NOME)

C

(X2_MODO)

N

(X2_PYME)

3.  Creación o modificación de Tablas Genéricas en el archivo SX5 – Tablas Genéricas:

Clave

Ej.: AR

Descripción

Ej.: Tabla de IR de Inversiones Financieras

4.  Creación o modificación (mantenga solo la instrucción correspondiente) de Campos en el archivo SX3 – Campos:

  • Tabla BGD - Prod. vs. Cob. vc. Proc. vs. Copart.:

Campo

(X3_CAMPO)

Tipo

(X3_TIPO)

Tamaño

(X3_TAMANHO)

Decimal

(X3_DECIMAL)

Formato

(X3_PICTURE)

Título

(X3_TITULO)

Descripción

(X3_DESCRIC)

Nivel

(X3_NIVEL)

Utilizado

(X3_USADO) Informe Sí o No

Obrigatório

(X3_OBRIGAT) Informe Sí o No

Browse

(X3_BROWSE) Informe Sí o No

Opciones

(X3_CBOX)

When

(X3_WHEN)

Relación

(X3_RELACAO)

Val. Sistema

(X3_VALID)

Help

Describa el contenido informado para Help de Campo en el ATUSX.

Importante:

El tamaño de los campos que disponen de grupo puede variar de acuerdo con el entorno en uso.

5.  Creación o modificación de Consulta Estándar en el archivo SXB – Consulta Estándar:

  • Búsqueda B05PLS:

Alias

(XB_ALIAS)

Tipo

(XB_TIPO)

Secuencia

(XB_SEQ)

Columna

(XB_COLUNA)

Descripción

(XB_DESCRI)

Contém

(XB_CONTEM)

6.  Creación o modificación de Índices en el archivo SIX – Índices:

Índice

AA1

Orden

6

Clave

AA1_FILIAL+AA1_CODVEN

Descripción

Cod. Vendedor

Propietario

S

7.  Creación o modificación de Parámetros en el archivo SX6 – Parámetros:

Nombre de la Variable

(X6_VAR)

Tipo

(X6_TIPO)

Descripción

(X6_DESCRIC + X6_DESC1 + X6_DESC2)

Valor Estándar

(X6_CONTEUD)

8.  Creación o modificación (mantenga solamente la instrucción correspondiente) de Disparadores en el archivo SX7 – Disparadores:

  • Tabla BD5 – Cuentas Médicas:

Campo

Informe el contenido del (X7_CAMPO).

Secuencia

Informe el contenido del (X7_SEQUENC).

Campo Dominio

Informe el contenido del (X7_CDOMIN).

Tipo

Informe el contenido del (X7_TIPO).

Regla

Informe el contenido del (X7_REGRA).

¿Posiciona?

Informe el contenido del (X7_SEEK).

Chave

Informe el contenido del (X7_CHAVE).

Condição

Informe el contenido del (X7_CONDIC).

Proprietário

Informe el contenido del (X7_PROPI).

Orden

04

Pregunta

Filtrar cliente?

Tipo

N

Tamaño

1

Entrada

Combo

Var

MV_PAR04

Def 1

Código + Tienda

Def 2

Código

Def 3

Sin filtro

Help

Permite agrupar EN EL MISMO RECIBO los documentos que pertenecen al mismo Cliente + Sucursal o al mismo Cliente (independiente de la sucursal) o todos los Títulos seleccionados.

 

Orden

01

Pregunta

Muestra  Asientos?

Tipo

N

Tamaño

1

Entrada

Combo

Def 1

Si

Def 2

No

Var

MV_PAR01

Help

Considera la visualización de los Asientos contables

 

Procedimiento de Configuración

(Estos procedimientos se deben realizar cuando es necesario configurar parámetros y/o  rutinas en el menú).

 

CONFIGURACIÓN DE PARÁMETROS

 

  1. En el Configurador (SIGACFG), acceda a Entornos/Archivos/Parámetros (CFGX017). Cree/configure (mantenga solo la instrucción correspondiente) el(los) parámetro(s) a continuación:

    (Es necesario crear una tabla para cada parámetro que se describe en el ítem Parámetro(s), de la tabla Características del Requisito).  

Ítems/Carpetas

Descripción

Nombre:

Tipo:

Informe el tipo del parámetro.

Cont. Por.:

Informe el contenido estándar.

Descripción:

 

CONFIGURACIÓN DE MENÚS

 

2.  En el Configurador (SIGACFG), acceda a Entornos/Archivo/Menú (CFGX013). Informe la nueva opción de menú del informe el nombre del módulo, conforme las instrucciones a continuación:

Menú

Informe el Menú en que se localizará la rutina.

Submenú

Informe el Submenú donde estará la rutina.

Nombre de la Rutina

Informe el Título de la rutina.

Programa

Informe el Fuente de la rutina.

Módulo

Informe el Nombre del(los) producto(s) que se utilizará(n) o “Todos”.

Tipo

Informe la Función.

Procedimiento de Utilización 

    • Describa los procedimientos, paso a paso (en caso de uso), que loa usuarios realizarán para que la mejora se visualice, identificando la información:
    • Ubicación de la rutina en el menú;
    • Ubicación de los nuevos campos y/o preguntas y sus respectivas carpetas de archivo que el usuario visualizará;
    • En caso de que se necesite tener algún archivo previo, haga una observación.

 

Ejemplo:

       1.            En el Plan de Salud (SIGAPLS), acceda a Actualizaciones / Producto Salud / Producto Salud (PLSA800).

El sistema exhibe la ventana de productos registrados.

       2.            Posicione el cursor en un producto y haga clic en Modificar.

       3.            En la carpeta Cobertura/Carencias, seleccione la subcarpeta Tipo de Prestador.

       4.            Haga doble clic en el campo TP Prestador (BCW_TIPPRE).

El sistema exhibe la ventana Tipo de Prestador – Coparticipación – Modificación.

       5.            Informe los datos conforme la orientación del help de campo y observe el rellenado del nuevo campo:

                      Solo p/Compra (BCW_SOMCOM): seleccione Sí para indicar si la coparticipación registrada será válida solo para efecto de compra de procedimientos o No, en caso contrario.

       6.            Verifique los datos y confirme.

Vídeo

  • Vídeo hospedado en Youtube e insertado en el template por medio de la macro Widget Connector.

** Canal del youtube y software de vídeo en definición.

 

Título del Vídeo:

Puesto a disposición por el Marketing.

Introducción:

Puesto a disposición por el Marketing.

Paso a Paso:

Capturar directamente del sistema.

Finalización:

Puesto a disposición por el Marketing

Utilización 

    • Describa los procedimientos, paso a paso (en caso de uso), que loa usuarios realizarán para que la mejora se visualice, identificando la información:
    • Ubicación de la rutina en el menú;
    • Ubicación de los nuevos campos y/o preguntas y sus respectivas carpetas de archivo que el usuario visualizará;
    • En caso de que se necesite tener algún archivo previo, haga una observación.

 

Ejemplo:

       1.            En el Plan de Salud (SIGAPLS), acceda a Actualizaciones / Producto Salud / Producto Salud (PLSA800).

El sistema exhibe la ventana de productos registrados.

       2.            Posicione el cursor en un producto y haga clic en Modificar.

       3.            En la carpeta Cobertura/Carencias, seleccione la subcarpeta Tipo de Prestador.

       4.            Haga doble clic en el campo TP Prestador (BCW_TIPPRE).

El sistema exhibe la ventana Tipo de Prestador – Coparticipación – Modificación.

       5.            Informe los datos conforme la orientación del help de campo y observe el rellenado del nuevo campo:

                      Solo p/Compra (BCW_SOMCOM): seleccione Sí para indicar si la coparticipación registrada será válida solo para efecto de compra de procedimientos o No, en caso contrario.

       6.            Verifique los datos y confirme.

Punto de Entrada

Descripción:

Informe el Menú en que se ubicará la rutina.

Ubicación:

Informe el Submenú donde estará la rutina.

Eventos:

Informe el Título de la rutina.

Programa Fuente:

Informe el Fuente de la rutina.

Función:

Informe el Nombre del(los) producto(s) que se utilizará(n) o “Todos”.

Respuesta:

Nombre

Tipo

Descripción

Obligatorio

 

 

 

 

Ejemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'Fact' //Validaciones del usuario

EndIf

Return aCab