Altova MapForce 2023 Enterprise Edition

Agregar archivos binarios a la asignación

Inicio Anterior Inicio Siguiente

Para asignar datos de o a archivos binarios cifrados en formato Protocol Buffers, primero debe añadir el archivo .proto que les acompaña a la asignación de MapForce, como mostramos a continuación.

Para añadir un archivo .proto como componente de una asignación:

1.En el menú Insertar, haga clic en Archivo de Protocol Buffers. También puede hacer clic en el botón de la barra de herramientas Insertar archivo de Protocol Buffers mf_ic_binary .

2.Tiene varias opciones:

a.Para abrir un archivo .proto almacenado en el disco local, navegue hasta el archivo y haga clic en Abrir.

b.Para abrir un archivo .proto desde una URL, haga clic en Cambiar a URL e introduzca la URL del archivo en el cuadro de diálogo (véase Agregar componentes desde una URL).

c.Para abrir un archivo .proto definido previamente como un recurso global, haga clic en Cambiar a recursos globales. Para información sobre los recursos globales, consulte el apartado Recursos globales de Altova.

3.Un archivo .proto suele contener distintos tipos de mensajes. Cuando la aplicación lo solicite, seleccione el tipo de mensaje que sea el objeto superior en la jerarquía (el objeto llamado "raíz").

mf_proto_01

4.Haga clic en Aceptar. Aparecerá un cuadro de diálogo.

mf_proto_13

5.Si quiere leer datos de un archivo binario de Protocol Buffers, haga clic en Examinar y seleccione la instancia binaria de la que quiere leer datos. Si quiere escribir datos en un archivo de Protocol Buffers o seleccionar una instancia más adelante, haga clic en Omitir.

 

Si puede leer el archivo .proto, MapForce muestra su estructura en la asignación de forma similar a como lo hace con otros tipos de componente, por ejemplo:

mf_proto_02

Hasta ahora ha añadido un componente binario a la asignación; sin embargo, la asignación todavía no está completa porque no lee ni escribe datos. Para ver ejemplos de asignaciones completas, consulte:

 

Ejemplo: leer datos de Protocol Buffers

Ejemplo: escribir datos en Protocol Buffers

 

Botón "Archivo/Blob"

El botón Archivo/Blob del componente binario abre un menú contextual con varios comandos que pueden resultar útiles en las siguientes situaciones:

 

Usar nombres de archivo de la configuración del componente: esta es la opción predeterminada y la puede usar con asignaciones que lean o generen un único archivo binario. Si esta opción está habilitada, puede cambiar el nombre del archivo en el cuadro de diálogo "Configuración del componente" (véase Configuración del componente binario).

Usar nombres de archivo dinámicos dados por la asignación: este comando se puede usar con asignaciones que deban leer o generar varios archivos binarios. Si esta opción está habilitada ya no puede cambiar el nombre del archivo en el cuadro de diálogo "Configuración del componente", sino que los nombres de los archivos tienen su origen en información proveniente de la asignación. Para ver un ejemplo de uso, consulte Ejemplo: escribir datos en Protocol Buffers.

Redistribuir blobs en Protocol Buffers: este comando convierte al elemento en un componente de redistribución. Con él puede analizar un valor binario en formato Protocol Buffers para que se convierta en una estructura en árbol asignable. Este proceso funciona de manera similar a los de redistribuir y serializar cadenas de texto (véase Redistribuir y serializar cadenas de texto), solo que en este caso se trabaja con cadenas de bytes binarias. Por ejemplo, en el siguiente componente puede conectar un elemento de tipo binario a la entrada "blob" del lado izquierdo. En el momento de ejecución este valor binario es redistribuido y enviará datos a las salidas de la estructura asignable del lado derecho.

mf_proto_14

Serializar Protocol Buffers en blobs: este comando convierte al elemento en un componente de serialización. Con él puede serializar una estructura en árbol asignable en un valor binario en formato Protocol Buffers. por ejemplo, en el siguiente componente puede conectar elementos de los tipos correspondientes con la estructura asignable del lado derecho. En el momento de ejecución la estructura es serializada y llenará la única salida (o tipo binario) en el lado derecho para que pueda continuar la conexión a un componente de destino. Esto puede ser útil si su asignación debe escribir datos como un tipo BLOB (archivo binario grande, por sus siglas en inglés) en una BD de destino. Otro posible uso es el de escribir datos en campos binarios (de tipo "bytes") de un componente de destino Protocol Buffer.

mf_proto_15

© 2017-2023 Altova GmbH