Configurar definiciones de intercambio de datos
Puede configurar Business Central para intercambiar datos en tablas específicas con datos en archivos externos. Por ejemplo para enviar y recibir documentos electrónicos, importar y exportar datos bancarios u otros datos, como nóminas y catálogos de artículos. Más información en Intercambio de datos electrónicamente.
Para crear una definición de intercambio de datos de un archivo de datos o una secuencia, puede utilizar los esquemas XML relacionados para definir los datos a incluir en ficha desplegable Definiciones de columna. Consulte el paso 6 de la sección Para describir el formato de las líneas y las columnas en el archivo. Más información en Usar esquemas XML para preparar definiciones de intercambio de datos.
Normalmente, configura las definiciones de intercambio de datos en la página Definición de intercambio de datos. Sin embargo, para actualizar los tipos de cambio de moneda, es más rápido utilizar un servicio de tipo de cambio de moneda. Obtenga más información en Actualizar tipos de cambio de divisas.
Nota
Si el archivo que se va a convertir está en formato XML, el término "columna" en este artículo se debe interpretar como un "elemento XML que contiene datos".
Este artículo incluye los siguientes procedimientos:
- Crear una definición de intercambio de datos.
- Exportar una definición de intercambio de datos como un archivo XML para que lo utilicen otros usuarios.
- Importar un archivo XML para una definición de intercambio de datos existente.
Crear una definición de intercambio de datos
La creación de una definición de intercambio de datos implica dos tareas:
- En la página Definición de intercambio de datos, describe el formato de líneas y columnas del archivo. Más información en la sección Para describir el formato de las líneas y las columnas en el archivo.
- En la página Asignación de intercambio de datos, asigne las columnas en el archivo de datos a los campos de Business Central. Más inforamción en la sección Para asignar columnas en el archivo de datos a los campos de Business Central.
Para describir el formato de las líneas y las columnas en el archivo
Seleccione el ícono
, ingrese Definiciones de intercambio de datos y luego elija vincular relacionado.Seleccione la acción Nuevo.
En la ficha desplegable General, describa la definición de intercambio de datos y el tipo de archivo de datos; para ello, rellene los campos tal como se describe en la tabla siguiente.
Campo Definición Código Introduzca un código para identificar la definición de intercambio de datos. Nombre Escriba un nombre para la definición de intercambio de datos. Tipo de archivo Especifique el tipo de archivo para el que se usa la definición de intercambio de datos. Puede seleccionar cuatro tipos de archivo:
- XML: Cadenas de contenido y marcado en capas rodeadas de etiquetas que indican la función.
- Texto variable: Los registros tienen una longitud variable y están separados por un carácter, como una coma o un punto y coma, también conocido como archivo delimitado.
- Texto fijo: Los registros tienen la misma longitud, se utilizan caracteres de relleno y cada registro está en una línea separada, también conocido como archivo de ancho fijo.
- Json: Cadenas de contenido en capas en JavaScript.Escriba Especifique para qué tipo de actividad económica se utiliza la definición de intercambio de datos, por ejemplo Exportación de pagos. Unidad de código de manejo de datos Especifique la codeunit que transfiere los datos a las tablas de Business Central y desde ellas. Código de validación Especifique la codeunit que se usa para validar los datos según las reglas de negocio predefinidas. Unidad de código de lectura/escritura Especifique la codeunit que procesa los datos importados antes de la asignación y los datos exportados después de la asignación. Lectura/Escritura XMLport Especifique el elemento XMLport a través del cual entra el archivo o el servicio de datos importados antes de que se asigne y desde el que salen los datos exportados cuando un archivo o un servicio de datos se escribe después de su asignación. Unidad de código de manejo de datos externos Especifique el codeunit que transfiere los datos externos al marco de intercambio de datos y desde él. Codeunit de comentarios de usuarios Especifique la codeunit que efectúa la limpieza después de la asignación, como marcar las líneas como exportadas y eliminar los registros temporales exportado. Codificación de archivos Especifique la codificación del archivo. Nota: Este campo solo es relevante para la importación. Separador de columnas Especifique cómo se separan las columnas del archivo de datos, si es de tipo Texto variable. Líneas de encabezado Especifique cuántas líneas de encabezado hay en el archivo.
Esta configuración garantiza que no se importan los datos de encabezado. Nota: Este campo solo es relevante para la importación.Etiqueta de encabezado Si hay una línea de cabecera en varias posiciones en el archivo, introduzca el texto de la primera columna en la línea de cabecera.
Esta opción garantiza que no se importan los datos de encabezado. Nota: Este campo solo es relevante para la importación.Etiqueta de pie de página Si hay una línea de pie de página en varias posiciones en el archivo, introduzca el texto de la primera columna en la línea de pie de página.
Esta opción garantiza que no se importan los datos del pie de página. Nota: Este campo solo es relevante para la importación.Propina
Para ver qué codeunits utiliza Microsoft en las definiciones existentes en el producto estándar, revise los tres campos Codeunit en la cabecera de la página Asignación de campos en la ficha desplegable General, para cada definición.
En la ficha desplegable Definiciones de línea, describa el formato de las líneas del archivo de datos; para ello, rellene los campos tal como se describe en la tabla siguiente.
Nota
Para importar estados de cuenta bancaria, solo se crea una línea para el único formato de archivo de estado de cuenta bancaria que se desee importar.
Para exportar pagos, puede crear una línea para cada tipo de pago que desee exportar. En ese caso, la ficha desplegable Definiciones de columna muestra columnas diferentes para cada tipo de pago.
Campo Descripción Tipo de línea Especifica el tipo de línea del archivo. Código Introduzca un código para identificar la línea en el archivo. Nombre Introduzca un nombre que describa la línea en el archivo. Recuento de columnas Especifique cuántas columnas tiene la línea en el archivo de datos. Nota: Este campo solo es relevante para la importación. Etiqueta de línea de datos Especifique la posición en el esquema XML relacionado del elemento que representa la entrada principal del archivo de datos. Nota: Este campo solo es relevante para la importación. Espacio de nombres Especifique el espacio de nombres que se espera en el archivo para habilitar la validación de espacio de nombres. Puede dejar este campo en blanco si no desea habilitar la validación de espacio de nombres. Código elemento primario Especifique el elemento principal de la línea en el campo Código si la configuración de intercambio de datos se realiza en archivos con movimientos principales y secundarios, por ejemplo, la cabecera y las líneas del documento. Repita el paso 4 para crear una línea por cada tipo de datos de archivo que desee exportar.
Proceda a describir el formato de las columnas en el archivo de datos llenando los campos en la ficha rápida Definiciones de columnas como se describe en la tabla en paso 8. Puede utilizar un archivo de estructura, como un archivo .xsd, para que archivo de datos llene previamente la ficha desplegable con los elementos correspondientes. Más información en Usar esquemas XML para preparar definiciones de intercambio de datos.
En la ficha desplegable Definiciones de columna, elija la acción Obtener estructura de archivo.
En la página Obtener estructura de archivos, seleccione el archivo de estructura relacionado y, luego, elija Aceptar. Las líneas de la ficha desplegable Definiciones de columna se rellenan según la estructura del archivo de datos.
En la ficha desplegable Definiciones de columna, edite o rellene los campos tal como se describe en la tabla siguiente.
Campo Descripción Columna No. Especifique el número que refleja la posición de la columna en relación con la línea en el archivo.
En el caso de archivos XML, especifique el número que refleja el tipo de elemento en el archivo que contiene los datos.Nombre Especifique el nombre de la columna.
En el caso de archivos XML, especifique el marcado de los datos que se intercambiarán.Tipo de datos Indique si los datos que se van a intercambiar son de tipo Texto, Fecha o Decimal. Formato de datos Especifique el formato de los datos, si lo hay. Por ejemplo, dd-mm-aaaa si el tipo de datos es Fecha. Nota: Para exportar, especifique el formato de datos según Business Central. Para importar, especifique el formato de datos según .Net Framework. Más información en Cadenas de tiempo y fecha estándar. Cultura del formato de datos Especifique el formato de datos regionales, si lo hay. Por ejemplo, en-US si el tipo de datos es Decimal para asegurarse de que se utilice la coma como separador de 0,000, de acuerdo con el formato de EE. UU. Más información en Cadenas de tiempo y fecha estándar. Nota: Este campo solo es relevante para la importación. Longitud Especifique la longitud de la línea de ancho fijo que contiene la columna si el archivo de datos es de tipo Fixed Text. Descripción Especifica una descripción de la columna, para fines informativos. Camino Especifique la posición del elemento en el esquema XML relacionado. Identificador de signo negativo Especifique el valor que se usa en el archivo de datos para identificar importes negativos en los archivos de datos que no pueden contener signos negativos. A continuación, este identificador se usa para revertir los importes identificados al signo negativo durante la importación. Nota: Este campo solo es relevante para la importación. Constante Especifique los datos que desea exportar de esta columna, como, por ejemplo, la información adicional sobre el tipo de pago. Nota: Este campo solo es relevante para la exportación. Relleno de texto requerido Especifica que los datos deben incluir espaciado de texto. Personaje del pad Especifique el carácter de relleno de texto. Justificación Especifica si la justificación de la columna está a la izquierda o a la derecha. Repita el paso 8 por cada columna o elemento XML del archivo que contiene los datos que desea intercambiar con Business Central.
El paso siguiente en la creación de una definición de intercambio de datos es decidir las columnas o los elementos XML del archivo de datos que se asignarán a los campos de Business Central.
Nota
La asignación específica depende del objetivo empresarial del archivo de datos que se intercambiará y de las variaciones locales. Incluso el estándar bancario de SEPA presenta variaciones locales. Business Central admite importar archivos de estado de cuenta de banco CAMT de SEPA originales. Se representa mediante el código de registro de definición de intercambio de datos de CAMT de SEPA en la página Definiciones intercambio de datos. Para obtener información acerca de la asignación de campos específicos de esta ayuda de CAMT de SEPA, consulte Asignación de campos al importar archivos CAMT de SEPA.
Para asignar columnas en el archivo de datos a campos en Business Central
Propina
A veces, los valores en los campos que desea asignar son diferentes. Por ejemplo, en una aplicación de negocio, el código de idioma de Estados Unidos es "EE. UU.", pero en otra es "EE. UU.". Eso significa que debe transformar el valor cuando se intercamian datos. Esto sucede por de las reglas de transformación que define para los campos. Obtenga más información en Reglas de transformación.
También puede agrupar por cualquier campo, utilizar el índice de clave para ordenar los resultados y los nuevos tipos de transformación redondeo y Búsqueda de campo.
En la ficha desplegable Definiciones de línea, seleccione la línea para la que desea asignar columnas a los campos y luego elija Asignación de campos. Se abre la página Asignación de intercambio de datos.
En la ficha desplegable General, especifique la configuración de asignación rellenando los campos tal y como se describe en la tabla siguiente.
Campo Descripción Identificación de la tabla Especifique la tabla que contiene los campos a los que se intercambian los datos, o desde los que se intercambian, según la asignación. Utilizar como tabla intermedia Especifique si la tabla que Seleccionar en el campo ID de tabla es una tabla intermedia donde se almacenan los datos importados antes de asignarlos a la tabla de destino.
Normalmente se utiliza una tabla intermedia cuando la definición de intercambio de datos importa y convierte documentos electrónicos en Business Central. Por ejemplo, documentos como facturas de proveedores en facturas de compra. Más información en Intercambio de datos electrónicamente.Nombre Escriba un nombre para la configuración de asignación. Índice clave Especifique el índice de clave para ordenar los registros de origen antes de la exportación. Unidad de código de premapeo Especifique la codeunit que prepara la asignación entre los campos de Business Central y los datos externos. asignación Unidad de código Especifique la codeunit que se usa para asignar las columnas especificadas o los elementos de datos XML a los campos de Business Central. Unidad de código posterior al mapeo Especifique la codeunit que completa la asignación entre los campos de Business Central y los datos externos. Nota: Cuando utiliza la función de extensión, la unidad de código convierte los datos exportados desde Business Central a un formato genérico que está listo para exportar. AMC Banking 365 Fundamentals Para importar, la codeunit convierte los datos externos a un formato listo para importar a Business Central. En la ficha desplegable Mapeo de campos, especifique qué columnas se asignan a qué campos en Business Central rellenando los campos como se describe en las siguientes tablas, dependiendo de si el campo Usar como tabla intermedia estaba habilitado o no.
Con el control de alternancia Usar como tabla intermedia desactivado:
Campo Descripción Columna No. Especifique para qué columna del archivo de datos desea definir una asignación.
Solo puede seleccionar las columnas que se representan con líneas en la ficha desplegable Definiciones de columna en la página Definición de intercambio de datos.Título de la columna Especifique el título de la columna en el archivo externo que está asignado al campo en el campo ID de tabla de destino cuando utilice una tabla intermedia para la importación de datos. Identificación del campo Especificar a qué campo se asigna la columna del campo Nº Columna.
Solo puede seleccionar en los campos que existan en la tabla especificada en el campo Id. de tabla en la ficha desplegable General.Título del campo Especifique el título del campo en el archivo externo que está asignado al campo en el campo ID de tabla de destino , cuando esté usando una tabla intermedia para la importación de datos. Opcional Especifique si se debe omitir la asignación si el campo está vacío. Si no selecciona esta opción, se producirá un error de exportación si el campo está vacío. Regla de transformación Especifica la regla que transforma el texto importado en un valor admitido para que se pueda asignar a un campo especificado. Cuando elige un valor en este campo, el mismo valor se introduce en el campo Regla de transformación en la tabla Búfer asignación campo intercambio datos y viceversa. Para obtener más información sobre cómo aplicar reglas de transformación, vaya a Reglas de transformación. Sobrescribir valor Especifique que el nuevo valor puede sobrescribir el valor actual. Prioridad Especifique el orden en que se deben procesar las asignaciones de campos. La asignación de campo con el número de mayor prioridad se procesa primero. Multiplicador Especifique un multiplicador que se aplicará a los datos numéricos, incluidos los valores negativos. Con el control de alternancia Usar como tabla intermedia activado:
Campo Descripción Columna No. Especifique para qué columna del archivo de datos desea definir una asignación.
Solo puede seleccionar las columnas que se representan con líneas en la ficha desplegable Definiciones de columna en la página Definición de intercambio de datos.Título de la columna Especifique el título de la columna en el archivo externo que está asignado al campo en el campo ID de tabla de destino cuando utilice una tabla intermedia para la importación de datos. Identificación de la tabla de destino Especifique la tabla a la que se asigna el valor del campo Título de columna , cuando utilice una tabla intermedia para la importación de datos. Título de la tabla Especifique el nombre de la tabla en el campo ID de tabla de destino , que es la tabla a la que se asigna el valor en el campo Título de columna , cuando utilice una tabla intermedia para la importación de datos. Identificación del campo de destino Especifique el campo en la tabla de destino al que se asigna el valor del campo Título de columna , cuando utilice una tabla intermedia para la importación de datos. Título del campo Especifique el nombre del campo en la tabla de destino al que se asigna el valor del campo Título de columna , cuando utilice una tabla intermedia para la importación de datos. Validar únicamente Especifique que el mapa de elemento a campo no se usa para convertir datos, sino solo para validarlos. Regla de transformación Especifica la regla que transforma el texto importado en un valor admitido para que se pueda asignar a un campo especificado. Cuando elige un valor en este campo, el mismo valor se introduce en el campo Regla de transformación en la tabla Búfer asignación campo intercambio datos y viceversa. Para obtener más información sobre las reglas de transformación, vaya a Reglas de transformación. Prioridad Especifique el orden en que se deben procesar las asignaciones de campos. La asignación de campo con el número de mayor prioridad se procesa primero.
En la ficha desplegable Agrupación de campos, especifique las reglas que desea usar para agrupar sus campos cuando cree el archivo completando los campos como se describe en la siguiente tabla.
Campo Descripción Identificación del campo Especifique el número del campo en el archivo externo que se usa para agrupar y este campo debe configurarlo el usuario. Título del campo Especifique el título del campo en el archivo externo que se usa para agrupación.
Reglas de transformación
Si los valores en los campos que está asignando difieren, debe usar reglas de transformación para las definiciones de intercambio de datos para que sean iguales. Defina reglas de transformación para las definiciones de intercambio de datos abriendo una definición existente, o creando una nueva definición, y luego en las Definiciones de línea FastTab, eligiendo Gestionar, y entonces Mapeo de campo. Se proporcionan reglas predefinidas, pero también puede crear las suyas propias. La siguiente tabla describe los tipos de transformaciones que puede realizar.
| Opción | Description |
|---|---|
| Mayúsculas | Ponga en mayúscula todas las letras. |
| Minúsculas | Ponga todas las letras en minúscula. |
| Título en mayúsculas y minúsculas | Ponga en mayúscula la primera letra de cada palabra. |
| Recortar | Eliminar espacios vacíos antes y después del valor. |
| Subcadena | Transforma una parte específica de un valor. Para especificar dónde comenzar la transformación, elija una Posición de salida o Texto de inicio. La posición inicial es un número que representa el primer carácter a transformar. El texto inicial es la letra inmediatamente anterior a la letra a reemplazar. Si desea comenzar con la primera letra del valor, utilice una posición inicial. Para especificar dónde detener la transformación, elija Longitud, que es el número de caracteres a reemplazar, o el Texto final, que es el carácter que está inmediatamente después del último carácter a transformar. |
| Reemplazar | Encuentre un valor y reemplácelo con otro. Esta transformación es útil para reemplazar valores simples, como una palabra en particular. |
| Expresión regular - Reemplazar | Use una expresión regular como parte de una operación de buscar y reemplazar. Esta transformación es útil para reemplazar valores múltiples o quizás más complejos. |
| Eliminar caracteres no alfanuméricos | Elimine caracteres que no sean letras o números, como símbolos o caracteres especiales. |
| Formato de fecha | Especifique cómo mostrar las fechas. Por ejemplo, puede transformar DD-MM-AAAA a AAAA-MM-DD. |
| Formato decimal | Defina reglas para la colocación de decimales y la precisión de redondeo. |
| Expresión regular - Coincidencia | Use una expresión regular para encontrar uno o más valores. Esta regla es similar a las opciones de Subcadena y Expresión regular - Reemplazar. |
| Costumbre | Esta regla de transformación es una opción avanzada que requiere asistencia de un desarrollador. Permite un evento de integración al que puede suscribirse si desea usar su propio código de transformación. Si eres desarrollador y quieres utilizar esta opción, ve a Consejo para desarrolladores: Ejemplo de opción personalizada. |
| Formato de fecha y hora | Defina cómo mostrar la fecha actual y la hora del día. |
| Búsqueda de campo | Utilice campos de diferentes tablas. Para usarlos, necesita seguir algunas reglas. Primero, use el Id. de tabla para especificar el id. de la tabla que contiene el registro para la búsqueda de campos. Después, en el campo Id. campo origen, especifique el id. del campo que contiene el registro para la búsqueda de campo. Por último, en el campo Id. campo destino, especifique el id. del campo en el que se encuentra el registro para la búsqueda de campo. Opcionalmente, utilice el campo Regla de búsqueda de campo para especificar el tipo de búsqueda de campo. Para el campo Objetivo, se usa el valor de Id. campo destino, incluso si está en blanco. Para el campo Original si el destino está en blanco, se utiliza el valor original si el destino está en blanco. |
| Redondo | Redondee el valor en este campo usando algunas reglas adicionales. Primero, en el campo Precisión, especifique una precisión de redondeo. Después, en el campo Dirección, especifique la dirección de redondeo. |
Nota
Obtenga más información sobre el formato de fecha y hora en Cadenas de formato de fecha y hora estándar.
Consejo para desarrolladores: ejemplo de la opción personalizada
El siguiente ejemplo muestra cómo implementar su propio código de transformación.
codeunit 60100 "Hello World"
{
[EventSubscriber(ObjectType::Table, Database::"Transformation Rule", 'OnTransformation', '', false, false)]
procedure OnTransformation(TransformationCode: Code[20]; InputText: Text; var OutputText: Text)
begin
if TransformationCode = 'CUST' then
OutputText := InputText + ' testing';
end;
}
Después de definir sus reglas, puede probarlas. En la sección fich desplegable Prueba, introduzca un ejemplo de un valor que desea transformar y luego verifique los resultados mediante Actualizar.
Exportar una definición de intercambio de datos como un archivo XML para que lo utilicen otros usuarios
Cuando haya creado la definición de intercambio de datos para un archivo de datos específico, podrá exportar la definición de intercambio de datos como un archivo XML que podrá importar. Esta tarea se describe en el procedimiento siguiente:
Elige el
icono, entrar Definiciones de intercambio de datos, luego elija el vincular relacionado.Seleccione la definición de intercambio de datos que desea exportar.
Seleccione la acción Exportar definición de intercambio de datos .
Guarde el archivo XML que representa la definición del intercambio de datos en una ubicación adecuada.
Si ya se ha creado una definición de intercambio de datos, solo tiene que importar el archivo XML al marco de intercambio de datos. Esta tarea se describe en el procedimiento siguiente:
Importar una definición de intercambio de datos existente
- Guarde el archivo XML que representa la definición del intercambio de datos en una ubicación adecuada.
- Elige el icono, entrar Definiciones de intercambio de datos, luego elija el vincular relacionado.
- Seleccione la acción Importar definición de intercambio de datos.
- Seleccione el archivo que ha guardado en el paso 1.
Consulte también .
Configurar el intercambio de datos
Configurar el envío y recepción de documentos electrónicos
Reciba pagos con Débito Directo SEPA
Realizar pagos con AMC Banking 365 Fundamentals extensión o transferencia de crédito SEPA
Documentos entrantes
Funcionalidad empresarial general
Encuentre módulos de aprendizaje electrónico gratuitos para Business Central aquí