1Wofür sie gedacht sind

Umgebungsvariablen sind für Werte, die man nicht hart codieren will und die keine fachlichen Funktionsparameter sind. (PH „Was sind Umgebungsvariablen?")

Typische Beispiele: API-Tokens, Client Secrets, Tenant-IDs, Datenbankzugangsdaten, Service-Account-JSON, Refresh-Tokens, produktionsabhängige URLs.

In der Funktion stehen sie als globale Bezeichner bereit:

var apiKey = api_token;     // Umgebungsvariable api_token
var dbHost = db_host;

1Die zwei Ebenen

An der Organisation

wird in jeden Funktionsaufruf eingetragen — für Werte, die mehrere Funktionen brauchen (gemeinsamer Token, Tenant-ID, Basis-URL).

An der Funktion

gilt nur für diese Funktion. Export-Vorteil: beim Funktions-Export werden die Deklarationen mitgegeben, nicht die Werte — sicherer Import in andere Orgs ohne Geheimnis-Transfer.

1Die vordefinierte Variable timeout

timeout (int, Sekunden) überschreibt den Funktions-Timeout. Default 600 s (10 min). Nur an der Funktion wirksam — an der Organisation gesetzt wird er ignoriert. Sinnvoll für Funktionen, die viele/aufwendige AI-Services oder externe Dienste aufrufen. (PH „Vordefinierte Umgebungsvariablen")

2Validieren ohne zu loggen

getModule("log");

if (!api_token || typeof api_token !== "string" || api_token.trim() === "") {
  log_error("Pflichtvariable api_token fehlt");
  return "FEHLER: API-Konfiguration fehlt.";
}

var cleanToken = api_token.trim();
log_info("Konfiguration geprüft");
return "bereit";

1Die Checkbox „Vertraulich"

Beim Anlegen/Bearbeiten einer Umgebungsvariable gibt es „Vertraulicher Wert (in Tabelle maskiert)": die Übersicht zeigt dann ********, der Klartext erscheint nur im Edit-Dialog. (PH „Vertrauliche Werte")

1Das organisation-Modul

organisation_getOrganisation() liefert eine Kopie der ausführenden Organisation — mit sensiblen Feldern im Klartext. (PH „Organisation Modul")

getModule("organisation");
var org = organisation_getOrganisation();

Sensible Felder u. a.: Env, EnvConfidential, ADConfig.MsgraphClientSecret, TeamsBotConfig.MsAppPassword. Diese dürfen nicht in Logs, Antworten oder ungesicherten externen Aufrufen erscheinen.

2Vorher / Nachher

// Falsch:
log_info(JSON.stringify(org));

// Besser:
log_info("Organisation geladen: " + org.Name);

1Die globale Variable

Läuft eine Funktion als Schritt eines AI-Workflows, stellt AuxData die Ergebnisse aller vorherigen Schritte als globale Variable aiserviceresults bereit — ohne getModule(...). (PH „Ergebnisse vorheriger Workflow-Schritte")

Typ

Array<string> oder null (außerhalb eines Workflow-Kontextes).

Reihenfolge

chronologisch; [0] = ältester, [length-1] = direkt vorheriger Schritt.

Inhalt

das Result-Feld des jeweiligen AI-Service-Ergebnisses als String.

if (aiserviceresults === null || aiserviceresults.length === 0) {
  return "Kein vorheriger Schritt vorhanden.";
}
var letztesErgebnis = aiserviceresults[aiserviceresults.length - 1];
return "Vorheriges Ergebnis war: " + letztesErgebnis;