Pluginad
Pluginad laiendavad Entu võimalusi objektitüübi tasandil. Plugin on tüübi plugin objekt, mis on lisatud objektitüübile selle plugin parameetri kaudu.
Loo plugina objektid Seadistamise alas, seejärel viita neile objektitüübi plugin parameetrist.
Pluginate kategooriad
Kasutajaliidese pluginad avatakse muutmissahtlis iframi vahekaardina kõrvuti standardse muutmisvormiga. Kasuta neid kohandatud loomise või muutmise kogemuste jaoks — CSV-importija, vormiassistent või integratsioon, mis tõmbab andmeid välisest teenusest. Plugin saab konteksti URL-päringuparameetritena ja renderdatakse Entu enda kasutajaliideses.
Veebikonksu pluginad on serveripoolsed päästikud. Kui objekt luuakse või seda muudetakse, saadab Entu POST-päringu plugina URL-ile taustal ilma kasutajat blokeerimata. Kasuta neid andmete edastamiseks välistele süsteemidele, automatiseerimiste käivitamiseks, kolmanda osapoole teenustega sünkroonimiseks või mistahes tausta loogika käitamiseks, mis peaks reageerima andmemuutustele.
Plugina parameetrid
| Parameeter | Kirjeldus |
|---|---|
name | Kuvanimetus, mis kuvatakse muutmissahtlis vahekaardi sildina (kasutajaliidese pluginate puhul). |
type | Mis tüüpi plugin see on — vaata pluginate tüüpe allpool. |
url | Kasutajaliidese pluginate jaoks — iframi vahekaardil laaditud URL. Veebikonksu pluginate jaoks — URL, mis saab POST-päringu; see peab olema https ega tohi viidata localhost-ile ega privaatvõrgu aadressile, muidu veebikonks jäetakse vahele. |
Pluginate tüübid
| Tüüp | Käivitatakse | Mis juhtub |
|---|---|---|
entity-edit | Muutmissahtel avati olemasoleva objekti jaoks | Plugina URL laaditakse iframi vahekaardina. URL saab account, entity, locale, token. |
entity-add | Muutmissahtel avati uue objekti loomiseks | Plugina URL laaditakse iframi vahekaardina. URL saab account, type, parent (kui lisatakse alam-objektina), locale, token. |
entity-edit-webhook | Seda tüüpi olemasolev objekt on salvestatud või selle mõni parameetriväärtus kustutatud | Server saadab POST-i { db, plugin, entity: { _id }, token } plugina URL-ile. Token on lühiealine JWT (1 min). Tulista-ja-unusta. |
entity-add-webhook | Seda tüüpi uus objekt on loodud (mitte dubleerimisega) | Sama serveripoolne POST nagu eespool, käivitatakse loomisel. |
Kasutajaliidese plugina URL-parameetrid
Kui Entu laadib kasutajaliidese plugina iframes, lisab see plugina URL-ile need päringuparameetrid:
| Parameeter | Kirjeldus |
|---|---|
account | Andmebaasi identifikaator |
entity | Objekti ID (entity-edit jaoks) |
type | Objektitüübi ID (entity-add jaoks) |
parent | Ülemobjekti ID (entity-add puhul alam-objekti loomisel) |
locale | Praeguse kasutajaliidese keelekood |
token | Praeguse kasutaja juurdepääsutoken (JWT) API-kõnede tegemiseks tema nimel |
Veebikonksu päringu sisu
Veebikonksu pluginate jaoks (entity-edit-webhook, entity-add-webhook) saadab Entu POST-päringu järgmise JSON-sisuga:
{
"db": "mydatabase",
"plugin": "entity-edit-webhook",
"entity": {
"_id": "ENTITY_ID"
},
"token": "SHORT_LIVED_JWT"
}plugin on käivitunud plugina tüüp — entity-edit-webhook või entity-add-webhook. token kehtib 1 minut, kannab muudatuse teinud kasutaja õigusi ja seda saab kasutada objekti lugemiseks või muutmiseks API kaudu. Veebikonksu käivitamine on tulista-ja-unusta — Entu ei oota vastust ega proovi uuesti tõrke korral.
WARNING
Veebikonksu kohaletoimetamine pole garanteeritud. Kui sinu lõpp-punkt on maas või tagastab vea, läheb päring kaotsi. Rakenda oma korduskatsumise või järjekorra loogika, kui töökindlus on oluline.
Sisseehitatud pluginad
Entu pakub valmis pluginate komplekti, mida majutatakse aadressil github.com/entu/plugins. Seadista need, luues plugina objekti ja seades selle url-iks vastava plugina URL.
Süsteem
CSV import
Objektide hulgiimport tabelist. Lae üles CSV-fail, vaata read eelvaates üle, vali importima minevad read ja vastenda iga CSV-veerg objekti parameetriga. Toetab laias valikus tekstikodeeringuid, seega töötavad vanemad süsteemidest pärit ekspordid ilma käsitsi teisendamiseta — kodeering tuvastatakse automaatselt ja seda saab muuta. Päiserida vahele ei jäeta; jäta see valimata. Vastendada saab ainult parameetreid, millel pole valemit ega readonly seadet.
Skeemimallid
Kiire viis oma andmebaasi skeemi seadistamiseks nullist alustamata. Selle asemel, et käsitsi määratleda objektitüübid ja nende parameetrid, vali valmis tüüp jagatud malliteegist — näiteks Raamat, Dokument, Kaust või Audiovisuaalne salvestis — ja Entu kopeerib objektitüübi ning selle parameetrite definitsioonid (nimi, tüüp, nimetus, järjekord, valem, jagamine jne) sinu andmebaasi. Saad parameetrite nimekirja üle vaadata enne importimist ja need, mida ei vaja, märkimata jätta; juba olemasolevad tüübid ja parameetrid on märgitud imporditutena.
Raamatud
Esteri import
Otsi ESTER ühiskataloogi, mida kasutavad Eesti kõrgkooli- ja avalikud raamatukogud. Leia raamatuid ja publikatsioone pealkirja, autori, ISBN-i või ISSN-i järgi ja impordi need täieliku bibliograafilise metaandmetega objektidena. Telefonis saad raamatu ISBN-vöötkoodi ka kaameraga skannida — puuduta otsinguvälja kõrval olevat kaameranuppu või tee vöötkoodist pilt — ja plugin otsib seda automaatselt.
Open Library import
Otsi Open Library kataloogist — tasuta ülemaailmsest raamatute andmebaasist. Leia raamat pealkirja, autori või ISBN-i järgi ja vali seejärel täpne väljaanne — väljaannete loendit saab filtreerida keele järgi. Valitud väljaanne imporditakse objektina, mille pealkiri, alapealkiri, autor, kirjastus, ilmumiskoht ja -aasta, sari, lehekülgede arv, mõõtmed, kaal, keel, märksõnad, ISBN ja märkused täidetakse automaatselt koos raamatu kaanepildiga. Telefonis saad raamatu ISBN-vöötkoodi ka kaameraga skannida — puuduta otsinguvälja kõrval olevat kaameranuppu või tee vöötkoodist pilt — ja plugin otsib seda automaatselt.
Audio-video
Discogsi import
Otsi muusika andmebaasist Discogs ja lisa väljaandeid otse oma kogusse. Sisesta esitaja või albumi pealkiri ja vali seejärel albumi täpne väljaanne (leitakse ainult Discogsi master-kirjega albumid) — Entu loob objekti pealkirja (title), esitaja, plaadifirma, katalooginumbri, aasta, formaadi, riigi, žanri, stiili, vöötkoodi ja muu metaandmetega automaatselt täidetuna koos kaanepildiga. Telefonis saad väljaande vöötkoodi ka kaameraga skannida — puuduta otsinguvälja kõrval olevat kaameranuppu või tee vöötkoodist pilt — ja plugin otsib seda automaatselt.
MusicBrainzi import
Otsi avatud muusikaentsüklopeediast MusicBrainz. Leia album ja vali seejärel täpne väljaanne (tiraaž, riik, formaat) — objekt luuakse pealkirja, esitaja, sildi, aasta, formaadi, vöötkoodi ja žanritega ning kaanepildiga Cover Art Archive'ist. Telefonis saad väljaande vöötkoodi ka kaameraga skannida — puuduta otsinguvälja kõrval olevat kaameranuppu või tee vöötkoodist pilt — ja plugin leiab sobivad albumid automaatselt.
TMDB import
Otsi andmebaasist The Movie Database ja impordi filme oma kogusse. Otsingutulemused ja metaandmed on eesti keeles, kui kasutajaliidese keel on eesti, muidu inglise keeles. Loodud objekti pealkiri, originaalpealkiri, režissöör, peaosatäitjad, aasta, žanrid, kestus, keeled, riigid, tootjafirmad, IMDb ID ja kirjeldus täidetakse automaatselt koos filmi plakatiga.
Mängud
BoardGameGeeki import
Otsi andmebaasist BoardGameGeek ja impordi lauamänge, mille autor, kunstnik, kirjastaja, kategooriad, mehaanikad, mängijate minimaalne ja maksimaalne arv, mängu kestus, minimaalne vanus, aasta ja kirjeldus täidetakse automaatselt koos karbipildiga.
IGDB import
Otsi videomängude andmebaasist IGDB ja impordi mänge, mille arendaja, kirjastaja, platvormid, žanrid, aasta ja kirjeldus täidetakse automaatselt koos kaanepildiga.
Kogumisobjektid
Brickseti import
Otsi andmebaasist Brickset ja impordi LEGO komplekte nime või komplekti numbri järgi. Objekti number, nimi, teema, alamteema, aasta, klotside ja minifiguuride arv, vanusevahemik, karbi mõõtmed, kaal, kirjeldus, märksõnad ning vöötkoodid täidetakse automaatselt koos komplekti pildiga. Telefonis saad karbi vöötkoodi ka kaameraga skannida — puuduta otsinguvälja kõrval olevat kaameranuppu või tee vöötkoodist pilt — ja plugin leiab komplekti automaatselt.
Numista import
Otsi müntide ja rahatähtede kataloogist Numista ja impordi tüüpe, mille väljaandja (parameetrina country), nimiväärtus, esimene ja viimane vermimisaasta, materjal, kaal, läbimõõt (parameetrina dimensions), kuju, sari, kataloogiviited ja märkused täidetakse automaatselt koos esi- ja tagakülje piltidega. Tulemused on inglise keeles.
Asukohad
KML import
Impordi geograafilisi asukohti KML-failidest (formaat, mida kasutavad Google Earth ja enamik GIS-tööriistu). Pärast üleslaadimist kuvatakse kõigi failist leitud kohtade loend, vali, milliseid kaasata, ja need luuakse objektidena parameetritega name, lat ja long. Kirjeldus salvestatakse parameetrisse kirjeldus ja selles leitud pildilingid parameetrisse pildilingid — nende säilitamiseks peavad objektitüübil olema nende nimedega parameetrid. Imporditakse ainult punktid; jooned ja alad jäetakse vahele.
Juurdepääsukontroll
Plugina objektid kasutavad sama õiguste ja jagamise mudelit nagu kõik teised objektid. Muutmissahtel kuvab plugina vahekaarte ainult nende pluginate jaoks, millele praegusel kasutajal on juurdepääs.
Sea plugina objektil _sharing: domain, et see oleks saadaval kõigile andmebaasi kasutajatele — siis peavad ka plugin objektitüüp ja selle parameetrite definitsioonid jagama parameetreid name, type ja url, vaata Objektitüübid → Nähtavus. Jäta see private-ks ja määra konkreetsetele isikutele selgesõnalised _viewer (või kõrgemad) õigused, et piirata juurdepääsu.
See võimaldab teatud pluginaid avalikustada kõigile (nt CSV-importija kõigile toimetajatele), säilitades samal ajal teiste piiramise administraatoritele või konkreetsetele tiimidele.
TIP
Kasutaja vajab minimaalselt _viewer õigusi plugina objektil, et vahekaart ilmuks. Veebikonksu pluginad on serveripoolsed ega kuvata kasutajaliideses, kuid nende objekt järgib endiselt sama õigustemudelit haldamise eesmärkidel.