Diseñe expresiones de ER para abrir métodos de clase de aplicación

Esta artículo describe cómo volver a usar la lógica de aplicación existente en las configuraciones de informes electrónicos (ER) llamando a los métodos necesarios de clases de aplicación en expresiones de ER. Los valores de los argumentos para las clases de llamada se pueden definir dinámicamente en tiempo de ejecución. Por ejemplo, los valores se pueden basar en la información del documento de análisis para garantizar su corrección.

Por el ejemplo de este artículo, diseñe un proceso que analice los extractos bancarios de entrada para una actualización de los datos de la aplicación. Recibirá los extractos bancarios entrantes como archivos de texto (.txt) que contienen códigos de número de cuenta bancaria internacional (IBAN). Como parte del proceso de importación de extractos bancarios, debe validar la corrección del código de IBAN mediante la lógica que esté ya disponible.

Requisitos previos

Los procedimientos de este artículo se ha creado para los usuarios a los que se ha asignado el rol de Administrador del sistema o Desarrollador de informes electrónicos.

El procedimiento se puede completar mediante cualquier conjunto de datos.

Para completarlos, debe descargar y guardar el archivo siguiente: SampleIncomingMessage.txt.

En este artículo, creará las configuraciones de ER necesarias para la empresa de ejemplo, Litware, Inc. Por tanto, antes de que pueda completar los procedimientos en este artículo, debe completar los siguientes pasos:

1. Vaya a Administración de la organización>Espacios de trabajo>Informes electrónicos.
2. En la página Configuraciones de localización, compruebe que está disponible el proveedor de la configuración para la empresa de ejemplo Litware, Inc. y que se ha marcado como activo. Si no ve a este proveedor de configuración, primero debe completar los pasos del procedimiento Creación de proveedores de configuración y marcarlos como activos.

Importe una nueva configuración para el modelo ER

1. En la página Configuraciones de localización, en la sección Proveedores de configuración, seleccione la ventana del proveedor de configuración Microsoft.

2. Seleccione Repositorios.

3. En la página Repositorios de localización, seleccione Mostrar filtros.

4. Para seleccionar el registro del repositorio global, agregue un campo de filtro Nombre.

5. En el campo Nombre, especifique Global. Luego seleccione operador de filtro contiene.

6. Seleccionar Aplicar.

7. Seleccione Abrir para revisar la lista de configuraciones de ER del repositorio seleccionado.

8. En la página Repositorio de configuraciones, en el árbol de configuraciones, seleccione Modelo de pago.

9. En la pestaña desplegable Versiones, si está disponible el botón Importar, seleccione Sí.

   Si el botón Importar no está habilitado, ya ha importado la versión seleccionada de la configuración de ER del Modelo de pago.

10. Cierre la página Repositorio de configuraciones y luego cierre la página Repositorios de localización.

Añada una nueva configuración para el formato de ER

Agregar un nuevo formato de ER para analizar los extractos bancarios de entrada en el formato de TXT.

1. En la página Configuraciones de localización, seleccione la ventana Configuraciones de informes.

2. En la página Configuraciones, en el árbol de configuraciones del panel izquierdo, seleccione Modelo de pago.

3. Seleccionar Crear configuración.

4. En el cuadro de diálogo desplegable, siga estos pasos:

   1. En el campo Nuevo, especifique Formato basado en modelo de datos PaymentModel.
   2. En el campo Nombre, escriba Formato de importación de extracto bancario (muestra).
   3. Seleccione Sí en el campo Admite la importación de datos.
   4. Seleccione Crear configuración para terminar de crear la configuración.

Diseñar la configuración del formato de ER - Formato

Diseñe el formato de ER que representa la estructura esperada del archivo externo en formato TXT.

1. Para la configuración de formato Formato de importación de extracto bancario (muestra) que agregó, seleccione Diseñador.

2. En la página Diseñador de formatos, en el árbol de estructura de formato del panel izquierdo, seleccione Agregar raíz.

3. En el cuadro de diálogo que aparece, siga estos pasos:

   1. En el árbol, seleccione Texto\Secuencia para agregar un componente de formato Secuencia.
   2. En el campo Nombre, especifique Raíz.
   3. En el campo Caracteres especiales, seleccione Línea nueva - Windows (CR LF). Basándose en esta configuración, cada línea en el archivo de análisis se considerará un registro individual.
   4. Seleccione Aceptar.

4. Seleccione Agregar.

5. En el cuadro de diálogo que aparece, siga estos pasos:

   1. En el árbol, seleccione Texto\Secuencia.
   2. En el campo Nombre, escriba Filas.
   3. En el campo de Multiplicidad, seleccione Uno o varios. En base a este valor, se espera que el menos una línea esté presente en el archivo del análisis.
   4. Seleccione Aceptar.

6. En el árbol, seleccione Raíz\Filas y luego seleccione Agregar secuencia.

7. En el cuadro de diálogo que aparece, siga estos pasos:

   1. En el campo Nombre, especifique Campos.
   2. En el campo Multiplicidad, seleccione Exactamente uno.
   3. Seleccione Aceptar.

8. En el árbol, seleccione Raíz\Filas\Campos y luego seleccione Agregar.

9. En el cuadro de diálogo que aparece, siga estos pasos:

   1. En el árbol, seleccione Texto\Cadena.
   2. En el campo Nombre, escriba IBAN. 3.. Seleccione Aceptar.

10. Seleccione Guardar.

La configuración está ahora establecida para que cada línea del archivo de análisis contenga solo el código de IBAN.

Diseñar la configuración del formato de ER – asignación a un modelo de datos

Diseñe una asignación de formato de ER que use información del archivo de análisis para completar un modelo de datos.

1. En la página Diseñador de formato en el Panel acciones, seleccione Asignar formato a modelo.

2. En la página Asignación de modelo a origen de datos en el Panel acciones, seleccione Nuevo.

3. En el campo Definición, seleccione BankToCustomerDebitCreditNotificationInitiation.

4. En el campo Nombre, escriba Asignación a modelo de datos.

5. Seleccione Guardar.

6. Seleccione Diseñador.

7. En la página Diseñador de asignación de modelo, en el árbol Tipos de origen de datos, seleccione Dynamics 365 for Operations\Clase.

8. En la sección Orígenes de datos, seleccione Agregar raíz para agregar un origen de datos que llame a la lógica de la aplicación existente para la validación de códigos IBAN.

9. En el cuadro de diálogo que aparece, siga estos pasos:

   1. En el campo Nombre, especifique Check_codes.
   2. En el campo Clase, especifique o seleccione ISO7064.
   3. Seleccione Aceptar.

10. En el árbol Tipos de orígenes de datos, siga estos pasos:

    1. Amplíe el origen de datos format.
    2. Expanda format\Root: Sequence(Root).
    3. Expanda format\Root: Sequence(Root)\Rows: Sequence 1..* (Rows).
    4. Expanda format\Root: Sequence(Root)\Rows: Sequence 1..* (Rows)\Fields: Sequence 1..1 (Fields).

11. En el árbol Modelo de datos, siga estos pasos:

    1. Amplíe el campo Pagos del modelo de datos.
    2. Expanda Payments\Creditor Account(CreditorAccount).
    3. Expanda Payments\Creditor Account(CreditorAccount)\Identification.
    4. Expanda Payments\Creditor Account(CreditorAccount)\Identification\IBAN.

12. Siga estos pasos para vincular componentes del formato configurado a los campos del modelo de datos:

    1. Seleccione format\Root: Sequence(Root)\Rows: Sequence 1..* (Rows).
    2. Seleccione Pagos.
    3. Seleccione Enlazar. Basándose en esta configuración, cada línea en el archivo de análisis se considerará un pago único.
    4. Seleccione format\Root: Sequence(Root)\Rows: Sequence 1..* (Rows)\Fields: Sequence 1..1 (Fields)\IBAN: String(IBAN).
    5. Seleccione Payments\Creditor Account(CreditorAccount)\Identification\IBAN.
    6. Seleccione Enlazar. Basado en este ajuste, el campo IBAN del modelo de datos se completará con el valor del archivo de análisis.

    

13. En la pestaña Validaciones, siga estos pasos para agregar una regla de validación que muestra un mensaje de error para cualquier línea del archivo de análisis que contenga un código IBAN no válido:

    1. Seleccione Nuevo y luego seleccione Editar condición.
    2. En la página Diseñador de fórmula, en el árbol Origen de datos, expanda el origen de datos Check_codes que representa la clase de aplicación ISO7064 para ver los métodos disponibles de esta clase.
    3. Seleccione Check_codes\verifyMOD1271_36.
    4. Seleccione Agregar origen de datos.
    5. En el campo Fórmula, introduzca la siguiente expresión: Check_codes.verifyMOD1271_36(format.Root.Rows.Fields.IBAN).
    6. Haga clic en Guardar y, a continuación, cierre la página.
    7. Seleccione Editar mensaje.
    8. En la página Diseñador de fórmulas, en el campo Fórmula, introduzca CONCATENATE("Invalid IBAN code has been found: ", format.Root.Rows.Fields.IBAN).
    9. Haga clic en Guardar y, a continuación, cierre la página.

    En base a esta configuración, la condición de validación devolverá FALSE para todo código IBAN no válido llamando al método existente verifyMOD1271_36 de la clase de aplicación ISO7064. Tenga en cuenta que el valor del código IBAN se define de forma dinámica en el tiempo de ejecución como argumento del método de llamada basándose en el contenido del archivo de texto de análisis.

    

14. Seleccione Guardar.

15. Cierre la página Diseñador de asignación de modelo y luego cierre la página Asignación de modelo a origen de datos.

Ejecute la asignación de formato

Para comprobar, ejecute la asignación de formato mediante el archivo SampleIncomingMessage.txt que descargó anteriormente. La salida generada incluirá datos que se importan desde el archivo de texto seleccionado y se trasladan al modelo de datos personalizado durante la importación real.

1. En la página Asignación de modelo a origen de datos, seleccione Ejecutar.

2. En la página Parámetros de informes electrónicos, seleccione Navegar, busque el archivo SampleIncomingMessage.txt que descargó y selecciónelo.

3. Seleccione Aceptar.

4. Observe que la página Asignación de modelo a origen de datos muestra un mensaje de error sobre un código IBAN no válido.

   

5. Revise la salida en formato XML que representa los datos que se han importado del archivo seleccionado y se han trasladado al modelo de datos. Observe que solo se procesaron sin errores tres líneas del archivo de texto importado. El código IBAN en línea 4 no es válido y se omitió.