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ä | Tyyppi | Kuvaus |
---|---|---|
_generated_displayname | string | Automaattisesti muodostettu näyttönimi, joka perustuu käyttäjätunnukseen ja sähköpostiin. |
_id | int64 | Kä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ä | Tyyppi | Kuvaus |
---|---|---|
_duplicates | array | Lista mahdollisista duplikaateista. |
_id | int64 | Tiedoston yksilöllinen tunniste. |
_linked_objects | array | Lista objekteista, jotka on luotu tämän tiedoston perusteella. |
_mapped_metadata | object | Tiedoston metadatasta luotu objektidata. |
best_date | timestamp | Paras saatavilla oleva päivämäärä metadatasta. |
children | array | Sivutiedot (esim. PDF-tiedostoissa). |
class | string | Tiedoston luokka (esim. kuva, ääni, video). |
class_extension | string | Luokan ja version yhdistelmä. |
class_version_status | string | Luokan, version ja tilan yhdistelmä. |
compiled | string | Yhteenveto tiedoston metadatasta (esim. JPG, 1920x1285 px, 569.5 kB ). |
compiled_props | object | Rakenteinen versio compiled -kentästä. |
dimensions | string | Tiedoston mitat, mahdollisesti yksiköillä. |
duration | string | Ääni- tai videotiedoston kesto. |
extension | string | Tiedostopääte isoin kirjaimin. |
pages | string | Sivujen määrä (esim. 12p ). |
date_uploaded | timestamp | Latauksen aikaleima (UTC). |
eas_parent_id | int64 | Emotiedoston ID, jos tämä on johdettu tiedosto. |
filesize | int64 | Tiedoston koko tavuina. |
frontend_prefs | object | Käyttöliittymän mukautetut asetukset. |
hash | string | Tiedoston tiiviste (SHA-256 tai MD5). |
is_original | boolean | Onko alkuperäinen tiedosto (true ) vai johdettu (false ). |
last_status_at | timestamp | Viimeisin tilapäivitys. |
metadata | object | Tiedoston metatiedot. |
name | string | Tiedoston mukautettu nimi. |
original_filename | string | Alkuperäinen tiedostonimi ilman polkua. |
original_filepath | string | Alkuperäinen tiedostopolku. |
pages_allowed | boolean | Onko tiedostolla sivuja. |
preferred | boolean | Onko tämä versio ensisijainen. |
reference | string | Yksilöllinen viite tiedostolle. |
status | string | Tiedoston tila: pending , processing , sync , done , failed . |
technical_metadata | object | Tekninen metadata (katso alla). |
upload_user | object | Käyttäjä, joka latasi tiedoston. |
user | object | Lyhyt esitys käyttäjästä. |
versions | object | Tiedoston eri versiot (renditions). |
Tekninen metadata
Kenttä | Tyyppi | Kuvaus |
---|---|---|
aspect_ratio | float64 | Kuvasuhde. |
audio_codec | array | Käytetyt äänikoodekit. |
blurhash | string | Blurhash-esitys. |
camera_scanner | string | Käytetty kamera tai skanneri. |
colordepth | int | Väriresoluutio. |
colorprofile | string | Väriavaruusprofiili. |
colorspace | string | Väriavaruus. |
create_date | string | Luontipäivämäärä. |
date_time_original | string | Alkuperäinen päivämäärä metadatasta. |
dimensions | object | Korkeus, leveys ja yksikkö. |
dpi | int | Resoluutio pisteinä tuumalla. |
duration | int | Kesto sekunteina. |
file_type_extension | string | Tiedostotyyppi. |
filesize | int64 | Tiedoston koko tavuina. |
format | string | Muoto: landscape , portrait , square . |
gps_location | object | Sijaintitiedot: leveys-, pituusaste ja korkeus. |
has_clipping_path | boolean | Onko leikkauspolku käytössä. |
mime_type | string | MIME-tyyppi. |
orientation | string | Suunta. |
pages | int | Sivujen määrä. |
sha256_hash | string | SHA-256-tiiviste. |
video_codec | array | Kä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ä | Tyyppi | Kuvaus |
---|---|---|
_download_allowed | string | Ilmaisee, onko version lataaminen sallittu. |
_id | string | Version yksilöllinen tunniste. |
aspect_ratio | string | Kuvasuhde (esim. 16:9 ). |
blurhash | string | Blurhash-esitys nopeaan esikatseluun. |
class | string | Tiedostoluokka (esim. kuva, video, ääni). |
class_extension | string | Luokan ja version yhdistelmä. |
date_created | string | Version luontipäivämäärä. |
deep_link_url | string | Suora linkki versioon. |
delete_url | string | URL version poistamiseen. |
dpi | string | Resoluutio pisteinä tuumalla. |
extension | string | Tiedostopääte (esim. JPG , MP4 ). |
filesize | string | Tiedoston koko tavuina. |
hash | string | Version tiiviste (esim. SHA-256). |
height | string | Korkeus pikseleinä. |
iiif_url | string | IIIF-yhteensopiva URL kuvan jakeluun. |
last_status_at | string | Viimeisin tilapäivitys. |
orientation | string | Suunta (esim. vaaka , pysty ). |
path | string | Sisäinen polku versioon. |
percent_done | string | Käsittelyn eteneminen prosentteina. |
status | string | Version tila (esim. processing , done ). |
technical_metadata | string | Teknisen metadatan yhteenveto. |
url | string | Julkinen URL version katseluun. |
watermark | string | Ilmaisee, onko vesileima käytössä. |
width | string | Leveys pikseleinä. |
zoom_url | string | Zoomattava katselu-URL (esim. korkearesoluutioiset kuvat). |