Archivo de Manifiesto
Los procesos de lote que crean archivos, por ejemplo, los procesos de lote relacionados con la exportación de datos, pueden crear uno o más archivos en cada subproceso. Las aplicaciones externas que consumen estos archivos deben procesarlos solo cuando se completa exitosamente todo el proceso por lotes. Para automatizar el consumo de dichos archivos, la aplicación externa puede aprovechar una función que se activará tras la creación de un archivo de manifiesto para procesar todos los archivos a los que hace referencia el manifiesto. El archivo de manifiesto incluye detalles como el valor hash de contenido, la información de tamaño del archivo, etc, que ayudan a confirmar que el contenido del archivo está completo y no fue alterado antes de procesar los archivos.
En las siguientes secciones, se proporciona información adicional sobre los archivos de manifiesto.
El Parámetro de Lote Opción de Manifiesto
La creación de archivos de manifiesto solo se soporta en determinados controles de lotes relacionados con la extracción del producto base. Estos controles de lotes incluyen el parámetro de lote Opción de manifiesto, que controla si se debe crear o no un archivo de manifiesto una vez completado exitosamente el proceso de lote. Puede utilizar el portal de Consulta de Control de Lote para buscar todos los controles de lotes que soportan esta opción.
Información de Archivo de Manifiesto
-
La versión de la estructura de detalles del manifiesto.
-
El código de control de lote, el número de ejecución y el número de reejecución que identifican la ejecución de lote que genera los archivos.
-
El número total de archivos creados por la ejecución de lote.
-
Número total de registros procesados por la ejecución de lote.
-
El registro de hora de creación del manifiesto en formato ISO.
-
El número de la ejecución de lote completada anteriormente, si existe.
-
El archivo de manifiesto generado por la ejecución de lote completada anteriormente, si existe. Esto se puede utilizar para garantizar que los archivos se procesen en el orden adecuado y ayuda a detectar posibles situaciones en las que falten archivos.
-
Una lista de los archivos creados por la ejecución de lote, que incluye los siguientes detalles para cada archivo: el nombre del archivo, su tamaño en bytes y el valor hash SHA-256 de contenido del archivo.
[batch control]_[batch run number]_[batch rerun number]_manifest.jsonEl siguiente es un ejemplo de la estructura del archivo de manifiesto.
{
"version": 1,
"batchCode": "HD-PDE",
"batchRunNumber": 106,
"batchRerunNumber": 0,
"totalFiles": 3,
"recordsProcessed": 10,
"timeStamp": "2020-05-02T16:55:43.000353Z",
"previousBatchRunNumber":"105"
"previousManifestFileName":"HD-PDE_105_0_manifest.json",
"fileDetails": [
{
"fileName": "SOME_FILE_NAME_001.json.gz",
"fileSize": 1543,
"hashAlgorithm": "SHA-256",
"hashValue": "ff7d4e466f93cadc4a18ab009080916baff631e03b728e2f2684c4a4f92ccbe1"
},
{
"fileName": "SOME_FILE_NAME_002.json.gz",
"fileSize": 1182,
"hashAlgorithm": "SHA-256",
"hashValue": "78869e7ce971f28a70f5b35693a05726ba66109fecf492edb60291a62ae1ba9f"
},
{
"fileName": "SOME_FILE_NAME_003.json.gz",
"fileSize": 1182,
"hashAlgorithm": "SHA-256",
"hashValue": "78869e7ce971f28a70f5b35693a05726ba66109fecf492edb60291a62ae1ba9f"
}
]
}{
Verificación del Archivo de Manifiesto
El servicio web Verificar Archivo de Manifiesto puede ser utilizado por un sistema externo para validar que el archivo de manifiesto que recibió para una ejecución de lote específica no esté dañado ni alterado. El servicio devuelve el nombre del archivo de manifiesto y el valor hash de su contenido correspondiente a la ejecución de lote solicitada, lo que permite que la persona que llama compare los detalles de su archivo con los valores devueltos.