Opsæt MetadataEditor

Formål

Vejledningen beskriver, hvordan MetadataEditor aktiveres, hvordan adgang for brugere, der ikke er logget ind, styres, hvordan tabellerne oprettes i databasen, og hvordan de to opslagstabeller udfyldes.

Forudsætninger

• Adgang til den aktive localConfig.json.
• Adgang til NQGIS-databasen (typisk nqgis) og NQGIS API’ets konfiguration.

Berørte filer og tjenester

• mapstore/configs/localConfig.json
• api/src/main/resources/db-config.properties – db.jdbc.schema.metadata angiver schemaet (standard nqgis_metadata).
• NQGIS API, endpoints under /v1/metadata.

Aktivér pluginnet

Tilføj pluginnet i plugins.desktop:

{
  "name": "MetadataEditor",
  "cfg": {
    "allowAnonymous": false
  }
}

MetadataEditor kan også vælges i kontekster (pluginsConfig.json). Alle parametre er beskrevet på pluginsiden.

Adgang uden login

allowAnonymous (standard false) viser metadata-knappen for brugere, der ikke er logget ind. De får kun læseadgang; redigering kræver altid rollen ADMIN.

Adgang uden login skal slås til begge steder:

1. "allowAnonymous": true i pluginets cfg.
2. metadataAllowAnonymous=true i NQGIS API’ets config.properties (standard false). Så tillader API’et opslag af metadata, ansvarlige og opdateringsfrekvenser uden login.

Er kun det første slået til, får brugere, der ikke er logget ind, beskeden Du skal være logget ind for at se metadata. og ingen advarsels-popups.

Panelet lukker altid, når en bruger logger ud, uanset allowAnonymous.

Opret tabellerne

NQGIS API opretter ikke selv sine tabeller, og der er endnu ingen automatisk opsætning. Kør derfor SQL’en herunder én gang mod NQGIS-databasen (db.jdbc.dbname), før MetadataEditor tages i brug. Kør den som den databasebruger, API’et forbinder med (db.jdbc.user), så den bruger ejer tabellerne.

CREATE SCHEMA IF NOT EXISTS nqgis_metadata;

CREATE TABLE nqgis_metadata.metadata (
    id                  varchar(255) PRIMARY KEY,
    name                varchar(128),
    url                 varchar(256),
    responsible         bigint,
    update_frequency    bigint,
    created             timestamp(6) with time zone,
    updated             timestamp(6) with time zone,
    data_updated        timestamp(6) with time zone,
    warning             boolean NOT NULL DEFAULT false,
    warning_header      varchar(256),
    warning_description text,
    description         text
);

CREATE TABLE nqgis_metadata.responsible (
    id   bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    name varchar(128)
);

CREATE TABLE nqgis_metadata.update_frequency (
    id    bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    label varchar(32)
);

Bruger installationen et andet schema end nqgis_metadata (db.jdbc.schema.metadata), så ret navnet i SQL’en. Mangler en tabel, giver API’ets metadata-endpoints fejl, og panelet kan ikke hente data.

Udfyld opslagstabellerne

To opslagstabeller i schemaet nqgis_metadata giver valgmulighederne i panelet:

Felt i panelet	Tabel	Kolonne	Indhold
Ansvarlig	responsible	name (maks. 128 tegn)	Den person eller enhed, der vedligeholder lagets metadata.
Aktualitet	update_frequency	label (maks. 32 tegn)	Hvor ofte data opdateres.

Eksempel:

INSERT INTO nqgis_metadata.update_frequency(id, label)
  VALUES (1, 'Dagligt'), (2, 'Ugentligt'), (3, 'Hver måned'), (4, 'Halvårligt');

INSERT INTO nqgis_metadata.responsible(id, name)
  VALUES (1, 'Jens Jensen'), (2, 'Hans Hansen'), (3, 'Ole Olesen');

Bruger installationen et andet schema, så ret nqgis_metadata til værdien af db.jdbc.schema.metadata.

Ret, men slet ikke

Metadata gemmer id’et fra opslagstabellerne, ikke teksten. Retter du en tekst, ændres den på alle lag, der bruger den. Sletter du en række, peger eksisterende metadata på et id, der ikke findes længere. Ret derfor teksten i stedet for at slette og oprette igen.

Kontrol

1. Log ind som administrator, vælg et lag, og åbn metadata-panelet.
2. Kontrollér, at Ansvarlig og Aktualitet viser værdierne fra tabellerne.
3. Opret metadata, og kontrollér, at en almindelig bruger kan se dem.