Estructura de les dades

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