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 |