Serialización

La serialización canónica de datos del BODS es como un documento JSON. En IETF RFC 8256 y en ECMA 404 se proporcionan especificaciones equivalentes de JSON. Se RECOMIENDA que los publicadores:

  • usen UTF-8 para una interoperabilidad máxima (sección 8.1 de RFC 8259);

  • eludan los caracteres que puedan causar problemas al procesar datos (por ejemplo: &, <).

Consulte la sección 9 de la especificación JSON ECMA-404 que trata sobre cadenas de caracteres, codificación y elusión.

Las líneas JSON también PUEDEN utilizarse al crear archivos grandes.

Orden del enunciado

Un archivo JSON del BODS DEBE consistir en una serie de objetos de enunciado ordenados dentro de un arreglo de datos de nivel superior.

Específicamente, los valores interestedParty y subject de un enunciado sobre relación, cuando son un valor recordId, DEBEN coincidir con el valor recordId de al menos otro enunciado anterior en el arreglo de datos.

Forma tabular alternativa

Los datos del BODS también PUEDEN serializarse en forma de tabla, donde cada fila representa un enunciado. Las columnas DEBERÍAN representar campos de enunciado y los títulos de las columnas DEBERÍAN utilizar el indicador JSON relativo relevante de la raíz del enunciado.

Por ejemplo, el fragmento:

[
 {
   "statementId": "e3c07f34-1810-4eed-b845-4d9f4d97f9d5",
   "recordId": "1810-4eed-b845-4d9f4d97f9d5",
   "recordType": "entity",
   "recordDetails": {
     "identifiers": [
       {
         "scheme": "GB-COH",
         "id": "07444723"
       }
     ]
   }
 },
 {
   "statementId":"a2b485be-e3b6-4fd7-8a6a-930e46cf9957",
   "recordId": "e3b6-4fd7-8a6a-930e46cf9957",
   "recordType":"person",
   "recordDetails": {
     "identifiers":[
       {
         "scheme":"MX-RFC",
         "id":"ABC680524P-76"
       }
     ]
   }
 },
 {
   "statementId":"34b479f2-1681-4064-ab51-1e703fbafa",
   "recordId": "1681-4064-ab51-1e703fbafa",
   "recordType":"relationship"
 }
]

puede serializarse en una tabla como:

statementId

recordId

recordType

recordDetails/identifiers/0/scheme

recordDetails/identifiers/0/id

e3c07f34-1810-4eed-b845-4d9f4d97f9d5

1810-4eed-b845-4d9f4d97f9d5

entity

GB-COH

07444723

a2b485be-e3b6-4fd7-8a6a-930e46cf9957

e3b6-4fd7-8a6a-930e46cf9957

person

MX-RFC

ABC680524P-76

34b479f2-1681-4064-ab51-1e703fbafa

1681-4064-ab51-1e703fbafa

relationship