Adminisztratív beállítások

Adminisztratív hozzáférések

Felhasználói csoportok hozzárendelése adminisztratív funkciókhoz. Például űrlap készítési vagy fajnév tábla kezelési jogkör kiadása.

Adatbázis táblák és oszlopok

Itt hozhat létre és kezelhet SQL táblákat és nézeteket. Az itt létrehozott táblák és táblaoszlopok regisztrálódnak az OBM metaadatokban és így válnak elérhetővé az OBM felületeken keresztül. Sztandard SQL klienseken keresztül létrehozott táblák és tábla mezők nem válnak automatikusan elérhetővé az OBM számára! A létrehozott táblák neve nem tartalmazhat ékezetes karaktereket, szóközöket vagy egyéb speciális karaktereket! Kerülje a nagybetűk használatát is! A _ karakter használata megengedett. Erősen ajánlott, hogy egy tábla létrehozásakor adjon meg egy leírást hozzá. Ugyanezek a szabályok vonatkoznak a mező nevekre is.

Itt lehet beállítani, hogy az egyes táblákból melyik oszlopok legyenek elérhetőek az űrlapok készítéséhez és lekérdezéshez a webes felületen.

Szintén itt lehet megadni a különlegesen kezelet oszlopokat. Ez azt jelenti, hogy olyan oszlopok amiket egyes modulok használnak anélkül, hogy tudnák mi az oszlop pontos neve illetve ugyanilyen alapon metakeresésekben is elérhetőek. Ilyen kitüntetett oszlopok a fajnév, dátum, adatgyüjtő, példányszám és hely oszlopok. A hely oszlopnál külön megadható az X,Y koordináta oszlop és a postgres geometria oszlop is. Dátumnál megadható több dátum oszlop is, adatgyűjtőnél szintén több oszlop is megadható. Fajnévél külön megadható a tudományos és nemzeti nevet tartalmazó oszlop ha van ilyen. Minden egyéb oszlop “adat” típusúra kell beállítani.

• adat: általános célú oszlopokra

• térbeli geometria: ez az oszlop térképek készítéséhez használható.

• tudományos fajnév: ez az oszlop a taxonok kezelésében használható.

• alternatív nevek: ez az oszlop a taxonok kezelésében használható.

• dátum ez az oszlop a dátumszűrőkben használható

• egyedek száma: összefoglaló funkciókban használható

• földrajzi szélesség: a földrajzi hosszúsággal együtt használható a térgeometria létrehozásához

• földrajzi hosszúság: a földrajzi szélességgel együtt használható térbeli geometria létrehozásához

• idézés: összefoglaló funkciókban használható

• melléklet: fájl mellékletek oszlop

• UTM zóna: a térgeometria létrehozásakor használható.

Két speciális mező van ebben a táblázatban: megjegyzés, parancs

A “megjegyzés” mezőnek tartalmaznia kell az oszlopok tartalmának leírását (metaadatok). Erősen ajánlott minden oszlophoz valamilyen meta leírást adni!

A ‘parancs’ mezőben definiálhat néhány beállítást, vagy végezhet bizonyos műveleteket (jelenleg átnevezés vagy törlés) az oszlopokon.

• Az obm_geometry oszlop esetében beállíthatja az oszlop SRID-jét (Spatial Reference System ID). A megadott értéknek a SET srid:4326 formátumúnak kell lennie, és a biomaps/header_names/f_srid fájlban kerül tárolásra, az alkalmazás pedig az SRID_C globális változóban használja.

• Az obm_id oszlophoz a következőképpen adhatja meg, hogy a szabálytáblát használja-e: SET use_rules:1

• Egy oszlop átnevezése a RENAME:új-név parancs szintaxisával lehetséges. Vigyázzon, ha átnevez egy oszlopot, a feltöltési űrlapok sérülhetnek!

• Egy oszlop törlése a DROP paranccsal lehetséges. Vigyázzon, ha töröl egy oszlopot, a feltöltési űrlapok sérülhetnek! Tehát frissítenie kell a kapcsolódó feltöltési űrlapokat, de a már letöltött űrlapokkal rendelkező offline ügyfelek nem biztos, hogy szinkronizálni tudják az adatokat.

A lap tetején elérhető egy SQL konzol, ami csak üzemeltetői státusszal és külön authentikáció után használható.

Szintén elérhető itt egy kinyitható lista az összes olyan tábla felsorolásával, ami a projektünk nevével kezdődik az SQL adatbázisban. Ezek közül ami pirossal van jelölve, amit nem kezel az OBM felület, mert nincs beregisztrálva az OBM számára hozzáférhető táblák közé.

A Nézetek kezelésével egy speciális funkciót is meg lehet valósítani, mégpedig azt, hogy egy adattáblánkat egy Nézettel helyettesítsük. Ilyen esetben a rendszer létrehoz az alaptábla nevével azonos Schémát a projektünk számára és oda helyezi át az eredeti táblánkat, amelyek kezeléséhez a megfelelő INSERT/UPDATE/DELETE Rule-okat is létrehozza. Ez a funkció akkor lehet hasznos, ha nagy adattáblánk van és vannak olyan folyatok, vagy triggerek, amelyek használata már túl lassú, vagy egyes specifikus felhasználó igények kielégítésére egyedi változatokat akarunk létrehozni az adattáblánkból.

A tábláinkhoz további oszlopokat is tudunk itt hozzáadni. Az oszlopk nevében ne legyenek üres karakterek, nagy betűk és kötőjelek sem!

Adat hozzáférések

A beállított hozzáférési szabályok és azok munkaállapotának áttekintése.

[web] -> [profile] -> [Projektadminisztráció] -> [adat hozzáférés]

[system] -> [/web-app-path/] -> [/projects/YOURPROJECT/local_vars.php.inc]

A projekt általános hozzáférési beállításának megtekintése adat táblánként. Itt ez nem konfogurálható!

Csoportok

Felhasználói csoportok létrehozása és felhasználók csoportokhoz hozzáadása itt történik. A felhasználói csoportok űrlapok, modulok és adminisztratív funkciókhoz való hozzáférés beállításban van jelentősége.

Faj nevek

Taxontáblák kezelőfelülete.

A fajnevek hozzárendelése a következő kategóriákhoz: [elfogadott név], [szinonimnév], [köznév], [helytelenül írt név].

A taxontáblában (fajnév-adatbázisban) szereplő fajneveket a “taxonnév-javítás-háttérmunkák” és a keresőfelületek használják.

Ezen az adminisztratív lapon történik a taxon tábla lekérdezése és karbantartása.

Felfüggesztett adatfeltöltések

A felhasználók elmentett és be nem fejezett fájl vagy űrlapos adat feltöltései találhatóak meg itt. A feltöltéseket betöltve azok folytathatóak vagy el is lehe vetni őket. Többnyire kitörlhetőek ezek a megszakított feltöltések!

Feltöltő űrlapok

Itt lehet feltöltő űrlapokat létrehozni és módosítani.

Az űrlapok kezelésének részletes leírása itt található: Adatfeltöltő űrlapok kezelése.

Fájl kezelő

Csatolt fájlként feltöltött képek és egyéb állományok listája és kezelése. Ki lehet exportálni egyben az egy táblához tartozó csatományokat, de ez némi időt vehet igénybe, mivel az exportálás egy háttérfolyamatként zajlik. Amikor készen van az export, akkor egy link jelenik meg az export gomb mellett.

Függvények

Néhány előre elkészített trigger itt be- és kikapcsolható, és a hozzájuk tartozó funkciók szerkeszthetők.

A kiválasztott táblához kapcsolódó összes trigger és SQL-szabály állapotát is megtekintheti.

Beépített triggerek:

• A taxonlista automatikus frissítése: A taxonszűrő által használt taxon-táblához hozzáadjuk a “tudományos nevet” és az “alternatív neveket”,

• Taxonnév automatikus frissítése: frissíti az adattáblát a taxontábla frissítésekor,

• Előzmények: előzménysorok létrehozása az “előzménytáblában” a sorok frissítése és törlése után,

• Hozzáférési szabályok: új sor beszúrása után szabálysor létrehozása a “szabályok táblában”. Az alkalmazott szabályok az űrlap beállításaiból származnak.

Térkép beállítások

[web] -> [profile] -> [Projektadminisztráció] -> [térkép beállítások]

A térképi megjelenítés beállításának három része van:

• mapszerver konfiguráció

• sql lekérdezés a mapszerver számára

• openlayers beállítások a mapszerver számára

Mapserver

Egy új projektnél be kell állítani a térkép kiterjedését. Ezt a legkönnyebb úgy megtenni, ha töltünk fel pár sor teszt adatot a várható kiterjedés sarkairól és a kalkulált kiterjedést beírjuk a private.map fájlba, amit ezen az adminisztratív oldalon tudunk szerkeszteni.

A publikus mapfájl használata további beállításokat igényel, jelenleg nem javasolt a használata.

OpenLayers

Az OpenLayers definícióknál tudunk összekötni egy SQL lekérdezést egy MapServer réteggel. Erre azért van szükség, mert a mapserverben alap esetben nem statikus lekérdezések vannak, hanem a webes felületen végrehajotott lekérdezéseket kapja meg a MapServer. Válasszuk ki, hogy melyik SQL lekérdezést melyik MapServer réteghez szeretnénk kapcsolni, adjunk egy tetszőleges nevet az OpenLayers rétegnek és többi változót hagyjuk az alapértelmezett értéken.

“OpenLayers réteg definíció” mező kiürítésével és a sor mentésével törölhető egy definíció.

Modulok

A beépülő modulokkal számos extra funkció válik elérhetővé a rendszerünkben, de ezek többnyire további beállításokat igényelnek. A modulokat lehet saját igények szerint módosítani, habár ezek karbantartásáról ez után nekünk kell gondokodni. A módosított modulokat meg lehet osztani a közösséggel!

Az engedélyezett modulok használatát felhasználókhoz/csoportokhoz lehet rendelni.

A paramétereket JSON objektumként tudjuk megadni a moduloknak.

Az elérhető modulok listája és leírásai itt találhatóak: modulok

Nyelvi definíciók

Meg lehet tekinteni itt az egész projektre globálisan definiált fordításokat. Ezek itt szerkeszthetőek: https://github.com/OpenBioMaps/translations/blob/master/global_project_translations.csv

Itt lehet a projektre érvényes fordításokat megadni. A fordítások mindig a projektre beállított nyelvre vontakoznak. Minden fordítható stringet str_somesthing_special_text formában kell megadni ahol az “str_” előtag kötelező elem. Fordítások használhatók űrlap nevekben, oszlop nevekben, listákban, űrlap leírásokban, mező leírásokban.

SQL lekérdezés beállítások szöveges és térképi lekérdezésekhez

Itt konfigurálhatja azokat az SQL-lekérdezéseket, amelyeket a Mapserver a térképadatok megjelenítéséhez, a webalkalmazás pedig a lekérdezések szöveges eredményeinek megjelenítéséhez használ. Ezek többnyire nem valódi SQL-parancsok, hanem az SQL-lekérdezések összeállítására szolgáló sablonok, közelítő SQL-szintaxissal.

A Mapserver/térkép fájlban a WMS rétegeknek tartalmazniuk kell egy DATA definíciós sort egy %query% helyettesítő karakterlánccal, hogy az itt definiált SQL sablon alapján dinamikusan generált SQL parancsot használhasson.

Minden SQL-lekérdezést egy webtérkép-réteghez kell kapcsolni. Az utolsó oszlopban állíthatja be ezeket a kapcsolatokat. Az SQL-lekérdezésekben két helyettesítő változó van a dinamikus lekérdezések végrehajtásához: %qstr% és %morefilters%.

A lekérdezés tartalmazhat varázsszavakat. Ezek % karakterekkel vannak elválasztva. Ezeket dinamikusan valódi SQL karakterláncokkal helyettesíti az OBM SQL-értelmező. Egyes modulok is generálhatnak ilyen varázsszavakat!

SELECT obm_id, %grid_geometry% AS obm_geometry
    %selected%
FROM %F%nestbox c%F%
    %uploading_join%
    %rules_join%
    %taxon_join%
    %grid_join%
    %search_join%
    %morefilter%
WHERE %geometry_type% %envelope% %qstr%

A %grid_geometry% AS obm_geometry helyett használd csak az obm_geometry kifejezést, ha nincs beállítva grid modul! Szintén ne tedd be a %grid_join% se a lekérdezésbe, ha nincs beállítva a grid modul. A %search_join% is modul specifikus.

Használd %F% és egy alias nevet is a FROM tábla megadásánál. Ez feltétlenül szükséges a lekérdezés feldolgozásához Ha egy másik táblát is szeretnél JOIN-olni akkor használd a %J% határolót a JOIN kifejezés körül. Például:

SELECT n.obm_geometry,n.obm_id,-2 AS date_part,nestbox_type,project_id,beinaction
    %selected%
FROM %F%nestbox n%F%
    %J%LEFT JOIN nestbox_observations o ON o.nestbox_id=n.obm_id%J%
    %taxon_join%
    %morefilter%
WHERE %envelope% %qstr%

Lehetséges még komplexeb lekérdezés összerekasára is:

WITH aall AS (
    SELECT o.obm_id,n.obm_geometry,nestbox_type,project_id,beinaction,
    COALESCE(extract(days FROM (CURRENT_DATE-datum)::interval),'-1') as  date_part
        %selected%
    FROM %F%nestbox_observations o%F%
    %J%LEFT JOIN nestbox n ON (nestbox_id=n.obm_id) %J%
    %taxon_join%
    %morefilter%
    WHERE 1=1 %envelope% %qstr%
)
SELECT * FROM aall ORDER BY date_part DESC

Egy tipikus egyszerű SQL lekérdezés így néz ki:

SELECT obm_id, obm_geometry %selected%
FROM %F%nestbox c%F%
    %uploading_join%
    %rules_join%
    %taxon_join%
    %morefilter%
WHERE %geometry_type% %envelope% %qstr%

Szerver infó

Számos alap info elérhető a projektről, mint az alkalmazás verzió száma, tárhely használati adatok, rendszer terhelé és memória használat, továbbá a Supervisor projekt adminisztrációs felület linkje.

Szerver logok

Hibakeresésre szolgál. A projekt szerver belső üzenetei és a mapserver üzenetei tekinthetők meg itt.

Tagok

A projektbe regisztrált tagok listája. Felhasználói státuszt lehet itt megani. Ezek a következők: Normál, Üzemeltető, Felfüggesztett. A felfüggesztett felhasználók semmihez nem férnek hozzá a projektben, majdnem egyenértékű a profil törlésével. Az üzemeltetőknak minden funkcióhoz és adathoz van hozzáférésük. Az adatbázis alapítónak nem muszáj üzemeltetőnek lennie ahhoz, hogy mindenhez hozzáférjen. A normál felhasználók alap esetben a projekt jogosultság beállítása szerint férnek hozzá adatfeltöltési és adatlekérdezéi lehetőségekhez. Ez az alapeset módosítható csoportok létrehozásával és különféle jogosítványok csoportokhoz rendelésével. Lásd Csoportok és Adminisztratív hozzáférések.

A tagok csoport hozzárendelései is módosíthatók itt, de erre kényelmesebb felület a Csoportkezelő.

A tagok neve egy hivatkozás ezen a felületen. Ezt a hivatkozást követve a felhasználó profil lapjára léphetünk. Adminisztratív jogkörrel ilyenkor a lap cím sávban - jobboldalt, felül megjelenik egy fa-user-secret ikon (https://forkaweso.me/Fork-Awesome/icon/user-secret/). Erre kattitva a saját felhasználói bejelentkezési adatainkkal át tudunk lépni egy másik felhasználó profiljába.

Háttérfolyamatok kezelése

[web] -> [profile] -> [Projektadminisztráció] -> [háttérfolyamatok]

Az OBM képes háttérben feladatokat elvégezni. Háttérfolyamat szkripteket le tudunk tölteni a lapról elérhető git repo-ból és ezeket is módosíthatjuk, vagy a sablon szkript alapján teljesen újat írhatunk. A héttérfolyamatoknak van egy run és egy lib állománya. Az ütemező a run állományunkat hívja meg, ami sztenderd php job esetén a lib állományban lévő feladatokat hajtja végre.

Az ütemezés cron-szerű, perc - óra - nap mezőket kell kitölteni hozzá, amely miden esetben lehet * is, azaz minden perc, óra, nap értékű. A jobot, ha nem engedélyezzük nem fut le. Engedélyezés nélkül is tudjuk tesztelni [run]. A [results]-al pedig az adott job utolsó eredményeit tudjuk megnézni.

Ahhoz, hogy az ütemező fusson, a gazdagépnek is kell egy ütemező Cron bejegyzés minden projekt job futtató scriptjéhez lennie. Ezt a szerver rendszergazdája tudja beállítani. Pl:

` */5 * * * * /usr/local/bin/docker-compose -f /srv/docker/openbiomaps/docker-compose.yml exec -u www-data -T app php /var/www/html/biomaps/root-site/projects/myproject/jobs.php `

Projekt leírás

Itt állíthatja be a projekt lap fejlécében látható nevét (rövid leírás) és a projekt hosszú leírását minden egyes nyelvhez.