Variabler (organisationsvariabler)
Organisationens Variabler er et fælles nøgle-værdi-lager. Du gemmer en værdi én gang under et navn (fx FIRMANAVN) og genbruger den i alle organisationens agenter med {database.NØGLE}. Alle værdier indsættes automatisk, når agenten kører. Skjulte værdier vises aldrig — output og kørselslog viser referencen {database.NØGLE} i stedet for værdien (se Skjulte værdier).
Adgang
| Rolle | Rettighed |
|---|---|
| Udvikler | Kan indsætte {database.NØGLE} i sine agenter og se hvilke nøgler der findes, men ikke åbne Variabler-siden eller se nogen del af en skjult værdi |
| Organisationsadministrator | Kan åbne siden og oprette, redigere og slette værdier |
Du finder siden under Organisation → Variabler. Siden er forbeholdt organisationsadministratorer — den vises hverken i menuen for en udvikler eller kan åbnes direkte.
En udvikler møder i stedet værdierne ét sted: i flow-editorens skabelon-editor. Under overskriften Database står der et lille mærkat pr. nøgle — {database.NØGLE} — med en hængelås på en skjult værdi og en advarselstrekant på en værdi, der ikke kan læses. Et klik indsætter referencen i teksten. Der vises intet af en skjult værdis indhold her; først-og-sidst-visningen (fx sk-…ret) findes kun i Værdi-kolonnen på administratorens Variabler-side.
Hvad kan jeg bruge det til?
En organisationsvariabel er nyttig, når den samme værdi går igen på tværs af mange agenter, og du vil kunne rette den ét sted:
- Firmaoplysninger — firmanavn, adresse, CVR-nummer, standard-afsender af emails
- Konfiguration — en fast basis-URL til et API, et team-postkasse-navn, en standard-underskrift
- Genbrugelige tekstblokke — en fast ansvarsfraskrivelse eller signatur, der skal med i mange dokumenter
- Nøgler og adgangskoder — en API-nøgle eller et kodeord gemmes som skjult værdi: den bruges i flows som enhver anden værdi, men vises aldrig
Retter du værdien her, slår ændringen automatisk igennem i alle agenter, der refererer nøglen — uden at du skal redigere hvert flow.
Opret en værdi
Siden har to faner — Variabler og Skjulte værdier — og opret-knappen hører til den fane, du står på: Ny variabel på fanen Variabler, Ny skjult værdi på fanen Skjulte værdier. Om en værdi er skjult, vælger du altså med den knap, du opretter den med; valget kan ikke ændres bagefter.
- Klik Ny variabel (eller Ny skjult værdi).
- Udfyld felterne:
| Felt | Beskrivelse |
|---|---|
| Nøgle | Navnet du refererer med. Det skal begynde med et bogstav eller _ og derefter kun indeholde bogstaver, tal og _. Danske bogstaver er tilladt (fx API_NØGLE), men et tal må ikke stå først (fx FIRMANAVN, SUPPORT_EMAIL). |
| Værdi | Teksten der indsættes ved kørsel. En skjult værdi skal være mindst 4 tegn, så den kan skjules sikkert i output og kørselslog. |
| Beskrivelse | Valgfri note om, hvad værdien bruges til. |
- Klik Opret.
Nøglen er fast efter oprettelsen. Åbner du Rediger, vises nøglen som skrivebeskyttet tekst med bemærkningen »Nøglen er fast efter oprettelsen — flows refererer den ved navn«, og et forsøg på at ændre den bliver afvist. Skal navnet være et andet, opretter du en ny værdi og flytter referencerne over.
Skjulte værdier
Alle værdier opbevares felt-niveau-krypteret. For en skjult værdi gælder derudover:
- Vises aldrig — værdien indsættes i byggeklodsens tekst ved kørsel, men alle steder du kan se den (output, kørselslog, fejlbeskeder) står
{database.NØGLE}i stedet. Bemærk: indholdet af genererede filer (fx et dokument, der bevidst fletter værdien ind) er flowets eget output og skjules ikke. - Kun begyndelsen og slutningen vises — oversigten viser højst værdiens første og sidste par tegn (fx
sk-…ret), og færre jo kortere værdien er; midten vises aldrig. Værdien kan ikke vises i sin helhed — heller ikke af en administrator. Er værdien tabt, indtaster du en ny via Rediger. - Skjult i kørselsloggen — optræder værdien i en byggeklods' input, output eller fejlbesked, viser kørselshistorikken referencen
{database.NØGLE}i stedet for selve værdien. - Redigering uden at gentaste — redigeringsdialogen viser aldrig den gemte værdi. Lader du værdi-feltet stå tomt, beholdes den eksisterende værdi; udfylder du det, erstattes den.
Om en værdi er skjult, vælges ved oprettelsen og kan ikke ændres — hverken den ene eller den anden vej. Skal en skjult værdi være synlig (eller omvendt), sletter du den og opretter den på ny med den anden opret-knap. Det samme gælder nøglenavnet, der også ligger fast efter oprettelsen.
Hvor bruges værdien?
Tabellen har fem kolonner — Nøgle, Værdi, Beskrivelse, Bruges i og Handlinger. Kolonnen Bruges i viser, hvem der refererer nøglen: et klikbart mærkat pr. agent (blå) og pr. udgiven app (lilla), der bruger den. Står der —, bruger ingen den. Klikker du på et mærkat, åbner du agenten eller appen. Bemærk, at agent-siden dækker alle ikke-arkiverede agenter — også godkendte, ikke kun kladder.
Det afgør også, hvad der sker, når du klikker Slet:
- Bruges nøglen af en eller flere udgivne apps — Slet-knappen er deaktiveret, og dialogen nævner appsene ved navn. Du skal først fjerne referencerne fra de bagvedliggende flows (det kræver ny kvalitetskontrol) eller arkivere appsene. Forsøger man alligevel, afviser platformen kaldet med en fejl.
- Bruges nøglen kun af agenter — dialogen er en advarsel, der nævner agenterne ved navn og forklarer, at de vil modtage den bogstavelige tekst
{database.NØGLE}i stedet for værdien. Knappen hedder Slet alligevel. - Bruger ingen den — du får en almindelig bekræftelse.
Hvis en værdi ikke kan læses
Viser en række Kan ikke læses, kan platformen ikke længere åbne den gemte værdi — typisk fordi krypteringsnøglen er blevet skiftet. Resten af siden og alle andre værdier virker fortsat, og flows kører stadig; en reference til den ramte nøgle bliver dog stående som {database.NØGLE} i stedet for at blive erstattet (flow-editoren viser en advarsel, hvis et flow bruger den). Reparationen er at redigere rækken og indtaste værdien igen — det gemmer den under den aktuelle nøgle — eller slette den. Skyldes tilstanden en opsætningsfejl (nøglen mangler helt), siger beskeden det i stedet: så kan værdien gendannes uden at blive indtastet igen, og du bør kontakte support frem for at erstatte den.
Skjulingen beskytter mod, at værdien ses ved et uheld. En udvikler med redigeringsadgang til flows kan bevidst konstruere et flow, der udleder værdien — adgangen til at bygge flows er derfor også adgangen til at bruge organisationens nøgler.
Brug en variabel i en agent
Skriv {database.NØGLE} i et hvilket som helst tekstfelt på en byggeklods — fx i en Skabelon, en Sprogmodel-instruktion eller emnefeltet i Send Email.
Kære kunde,
Tak for din henvendelse til {database.FIRMANAVN}.
Du kan altid kontakte os på {database.SUPPORT_EMAIL}.
Når agenten kører, erstatter platformen {database.FIRMANAVN} og {database.SUPPORT_EMAIL} med de aktuelle værdier.
Hver værdi har en Kopiér reference-knap, der lægger {database.NØGLE} på udklipsholderen, så du kan indsætte den direkte i din agent.
Godt at vide
- Ukendte nøgler bevares: refererer du en nøgle, der ikke findes, står
{database.NØGLE}uændret i teksten — den fjernes ikke. En skjult nøgle indsættes kun dér, hvor flow-byggeren selv har skrevet referencen — en reference, der opstår under kørslen, forbliver tekst. - Men et kald udad sendes ikke: står en henvisning stadig uudfyldt i URL eller headers på Hent fra API, stopper trinnet med en besked, der navngiver variablen — i stedet for at sende
{database.NØGLE}til den anden tjeneste som fx en API-nøgle. - Værdien indsættes ved kørsel: den er ikke en del af selve flowets version, så du kan opdatere værdien uden at lave en ny agent-version.
- Adskilt fra input-felter: punktummet i
{database.NØGLE}adskiller den fra almindelige skabelon-pladsholdere som{navn}, der bliver til input-felter.
Sletter du en værdi, får agenter, der refererer den, ikke længere en værdi indsat — de modtager i stedet den bogstavelige tekst {database.NØGLE}. Du behøver ikke selv lede efter dem: kolonnen Bruges i viser, hvem der bruger nøglen, og bruges den af en udgiven app, blokerer platformen sletningen (se Hvor bruges værdien?).