Yleiset järjestelmän tietotyypit

  1. Koti
  2. Ohje
  3. Kehittäjille
  4. Yleiset järjestelmän tietotyypit

Yleiset järjestelmän tietotyypit

Collection Pro käyttää useita ennalta määriteltyjä järjestelmän tietotyyppejä. Nämä tyypit muodostavat järjestelmän ydintoiminnot ja ovat keskeisiä käyttäjähallinnassa, sisällön organisoinnissa ja käyttöoikeuksien hallinnassa.

Yleiset järjestelmän tietotyypit

  • Käyttäjä (User) – Yksittäinen käyttäjätili, jolla on pääsy järjestelmään. Sisältää kirjautumistiedot, näyttönimen ja muuta käyttäjäkohtaista metadataa.
  • Ryhmä (Group) – Käyttäjien joukko, jota käytetään tyypillisesti käyttöoikeuksien ja roolien hallintaan.
  • Pooli (Pool) – Säiliö digitaalisten aineistojen tai metadatan organisointiin ja hallintaan.
  • Tiedosto (File) – Tallentaa kaikki järjestelmässä käytettävät tiedostot, kuten objektit, liitännäiset, logot, käyttäjäkuvat ja paljon muuta. Tiedostoja voidaan ladata, linkittää ja rikastaa metatiedolla. Katso lisätietoja kohdasta Tiedosto-järjestelmäntietotyyppi.

user (Käyttäjä)

user-tietotyyppi tallentaa tiedot käyttäjistä, joilla on pääsy Collection Pro -järjestelmään. Jokaisella käyttäjällä on yksilöllinen tunniste ja siihen liittyvää metadataa, jota käytetään esimerkiksi kirjautumiseen, näyttönimen muodostamiseen ja käyttöoikeuksien hallintaan.

Käyttäjän kentät

KenttäTyyppiKuvaus
_generated_displaynamestringAutomaattisesti muodostettu näyttönimi, joka perustuu käyttäjätunnukseen ja sähköpostiin.
_idint64Käyttäjän yksilöllinen tunniste, joka luodaan automaattisesti.

file (Tiedosto)

file-tietotyyppi tallentaa kaikki Collection Pro -järjestelmässä käytettävät tiedostot. Näitä voivat olla esimerkiksi:

  • Objektit
  • Liitännäiset (Plugins)
  • Logot, taustakuvat ja XSLT-tiedostot (peruskonfiguraatiossa)
  • Käyttäjäkuvat ja mukautettu data
  • Poolin vesileimat ja mukautettu data
  • Objektiluokan mukautettu data

Tiedostojen lataaminen järjestelmään

Tiedostoja voidaan ladata useilla tavoilla:

  • Suora lataus/api/eas/put
  • Etälataus URL-osoitteesta/api/eas/rput
  • WebDAV
  • Liitännäisten kautta/api/plugin/manage (liitännäistyypillä url)

Tiedostot tallennetaan määritettyihin sijainteihin, kuten S3-pilvipalveluun tai paikalliselle levylle. Collection Pro tukee myös puhtaasti etänä tallennettuja tiedostoja, jolloin vain URL tallennetaan.

Metadatan tunnistus

Collection Pro suorittaa automaattisesti ohjelmia metadatan tunnistamiseksi jokaisesta tiedostosta. Tätä prosessia voidaan laajentaa liitännäisten avulla.

Tiedoston kentät

KenttäTyyppiKuvaus
_duplicatesarrayLista mahdollisista duplikaateista.
_idint64Tiedoston yksilöllinen tunniste.
_linked_objectsarrayLista objekteista, jotka on luotu tämän tiedoston perusteella.
_mapped_metadataobjectTiedoston metadatasta luotu objektidata.
best_datetimestampParas saatavilla oleva päivämäärä metadatasta.
childrenarraySivutiedot (esim. PDF-tiedostoissa).
classstringTiedoston luokka (esim. kuva, ääni, video).
class_extensionstringLuokan ja version yhdistelmä.
class_version_statusstringLuokan, version ja tilan yhdistelmä.
compiledstringYhteenveto tiedoston metadatasta (esim. JPG, 1920x1285 px, 569.5 kB).
compiled_propsobjectRakenteinen versio compiled-kentästä.
dimensionsstringTiedoston mitat, mahdollisesti yksiköillä.
durationstringÄäni- tai videotiedoston kesto.
extensionstringTiedostopääte isoin kirjaimin.
pagesstringSivujen määrä (esim. 12p).
date_uploadedtimestampLatauksen aikaleima (UTC).
eas_parent_idint64Emotiedoston ID, jos tämä on johdettu tiedosto.
filesizeint64Tiedoston koko tavuina.
frontend_prefsobjectKäyttöliittymän mukautetut asetukset.
hashstringTiedoston tiiviste (SHA-256 tai MD5).
is_originalbooleanOnko alkuperäinen tiedosto (true) vai johdettu (false).
last_status_attimestampViimeisin tilapäivitys.
metadataobjectTiedoston metatiedot.
namestringTiedoston mukautettu nimi.
original_filenamestringAlkuperäinen tiedostonimi ilman polkua.
original_filepathstringAlkuperäinen tiedostopolku.
pages_allowedbooleanOnko tiedostolla sivuja.
preferredbooleanOnko tämä versio ensisijainen.
referencestringYksilöllinen viite tiedostolle.
statusstringTiedoston tila: pending, processing, sync, done, failed.
technical_metadataobjectTekninen metadata (katso alla).
upload_userobjectKäyttäjä, joka latasi tiedoston.
userobjectLyhyt esitys käyttäjästä.
versionsobjectTiedoston eri versiot (renditions).

Tekninen metadata

KenttäTyyppiKuvaus
aspect_ratiofloat64Kuvasuhde.
audio_codecarrayKäytetyt äänikoodekit.
blurhashstringBlurhash-esitys.
camera_scannerstringKäytetty kamera tai skanneri.
colordepthintVäriresoluutio.
colorprofilestringVäriavaruusprofiili.
colorspacestringVäriavaruus.
create_datestringLuontipäivämäärä.
date_time_originalstringAlkuperäinen päivämäärä metadatasta.
dimensionsobjectKorkeus, leveys ja yksikkö.
dpiintResoluutio pisteinä tuumalla.
durationintKesto sekunteina.
file_type_extensionstringTiedostotyyppi.
filesizeint64Tiedoston koko tavuina.
formatstringMuoto: landscape, portrait, square.
gps_locationobjectSijaintitiedot: leveys-, pituusaste ja korkeus.
has_clipping_pathbooleanOnko leikkauspolku käytössä.
mime_typestringMIME-tyyppi.
orientationstringSuunta.
pagesintSivujen määrä.
sha256_hashstringSHA-256-tiiviste.
video_codecarrayKäytetyt videokoodekit.

Tiedostoversiot

Jokaisella tiedostolla Collection Pro -järjestelmässä voi olla useita versioita (renditions), jotka voivat erota toisistaan esimerkiksi resoluution, formaatin tai käsittelytilan mukaan. Alla on kuvattu tiedostoversioihin liittyvät kentät:

KenttäTyyppiKuvaus
_download_allowedstringIlmaisee, onko version lataaminen sallittu.
_idstringVersion yksilöllinen tunniste.
aspect_ratiostringKuvasuhde (esim. 16:9).
blurhashstringBlurhash-esitys nopeaan esikatseluun.
classstringTiedostoluokka (esim. kuva, video, ääni).
class_extensionstringLuokan ja version yhdistelmä.
date_createdstringVersion luontipäivämäärä.
deep_link_urlstringSuora linkki versioon.
delete_urlstringURL version poistamiseen.
dpistringResoluutio pisteinä tuumalla.
extensionstringTiedostopääte (esim. JPG, MP4).
filesizestringTiedoston koko tavuina.
hashstringVersion tiiviste (esim. SHA-256).
heightstringKorkeus pikseleinä.
iiif_urlstringIIIF-yhteensopiva URL kuvan jakeluun.
last_status_atstringViimeisin tilapäivitys.
orientationstringSuunta (esim. vaaka, pysty).
pathstringSisäinen polku versioon.
percent_donestringKäsittelyn eteneminen prosentteina.
statusstringVersion tila (esim. processing, done).
technical_metadatastringTeknisen metadatan yhteenveto.
urlstringJulkinen URL version katseluun.
watermarkstringIlmaisee, onko vesileima käytössä.
widthstringLeveys pikseleinä.
zoom_urlstringZoomattava katselu-URL (esim. korkearesoluutioiset kuvat).
Oliko artikkelista apua?

Aiheeseen liittyvää