Per estructurar les dades de l’API s’utilitzen els següents conceptes:
- Entitat: tipus de contingut concret a partir d'un nombre arbitrari de camps i relacions. Per exemple, l’entitat oposicions conté tots els camps relatius a un procés de selecció (títol, identificador, titulació requerida, data de finalització, etc.) i les seves relacions (matèries, institució i documents).
- Dataset: conjunt de dades d'un tipus d’entitat concreta. Per exemple, el dataset oposicions-matèries conté les dades de les matèries d’una oposició.
- Relació: les relacions ens permeten connectar dades d’una entitat amb un dataset concret o amb una altra entitat. Per exemple, es poden relacionar les entitats beneficiaris i subvencions a partir d’un identificador únic (codi id del beneficiari).
- Camp: els camps defineixen els diferents valors que pot tenir un tipus de contingut. Els camps tenen diferents propietats:
- Nom: etiqueta per identificar el camp en l'interacció amb l’API.
- Descripció: descripció del contingut del camp.
- Tipus: indica com està definit el valor del camp. Pot ser long, string, boolean, date o decimal.
- Pes: valor que s'utilitza per ordenar els camps dins d'un registre.
- Obligatori: indica que en tot registre aquest camp ha de tenir un valor assignat.
- Únic: indica que el valor del camp no es pot repetir en la resta de registres d'un mateix dataset.
- Multivaluat: indica que el camp pot prendre més d'un valor.
- Primari: indica que aquest camp identifica el registre del que forma part, per tant, també té un valor únic dins el mateix dataset.
Afegeix un nou comentari