1Die Module der ScriptEngine

Die ScriptEngine kapselt externe Systeme in fertigen Modulen — das spart Boilerplate und liefert geprüfte Signaturen. (PH „Verfügbare Module")

graphapi

Microsoft Graph / Microsoft 365.

googlemail · googlecalendar · googledrive · googleapi

Google Workspace (Mail, Kalender, Drive, generisch).

Hilfsmodule

aiservice, user, organisation, log, docdb.

Jedes Modul wird per getModule("name") initialisiert; danach stehen seine Funktionen global bereit:

getModule("graphapi");
getModule("log");

log_info("Graph-Modul initialisiert");

1Das Konfigurationsobjekt

Das M365-Modul wird mit getModule("graphapi") geladen; die Zugangsdaten trägt das Objekt graphApiConfig. (PH „MS Graph API Modul")

var graphApiConfig = new Object();
graphApiConfig["TenantId"]     = tenant_id;
graphApiConfig["ClientId"]     = client_id;
graphApiConfig["ClientSecret"] = client_secret;   // aus Umgebungsvariable (E7)
graphApiConfig["Account"]      = "user@contoso.onmicrosoft.com";

TenantId

Verzeichnis-/Tenant-ID aus Entra ID.

ClientId

Application/Client-ID der App-Registrierung.

ClientSecret

Secret (oder Zertifikat-Äquivalent) — nicht hart codieren.

Account

UPN der Mailbox/des Users, in dessen Namen gearbeitet wird.

1App-Registrierung in 6 Schritten

M365-Zugriff nutzt den Client-Credentials-Flow: kein interaktiver Login — AuxData authentifiziert sich als konfigurierte App. (PH „Microsoft 365 Zugriff einrichten")

1. App-Registrierung in Microsoft Entra ID anlegen.
2. Client Secret oder Zertifikat erzeugen.
3. Microsoft-Graph-Berechtigungen als Application Permissions setzen.
4. Tenant-Admin-Consent erteilen.
5. Optional: Zugriff per Application Access Policy auf bestimmte Mailboxen einschränken.
6. Werte in der ScriptEngine-Konfiguration hinterlegen.

2Beispiel-Permissions

Mail lesen/verschieben/verwalten

Mail.ReadWrite

Mail versenden

Mail.Send

Kalender

Calendars.ReadWrite

OneDrive-/SharePoint-Dateien

Files.ReadWrite.All

SharePoint Sites

Sites.ReadWrite.All

User-Sync

User.Read.All

1Graph-Funktionen

Ressourcen

graphapi_getResource / postResource / putResource / deleteResource(config, url[, body])

Mail

graphapi_send, getNewFromInbox, getNewFromFolder, move, delete

Kategorien (Outlook-Labels)

setLabel (überschreibt) · addLabel (additiv) · removeLabel (no-op wenn nicht gesetzt) · getLabels

getModule("graphapi");
getModule("log");

var mails = graphapi_getNewFromInbox(graphApiConfig, 10);
for (var i = 0; i < mails.length; i++) {
  graphapi_addLabel(graphApiConfig, mails[i].MailServerId, "AuxData-geprüft");
}
log_info("Mails verarbeitet: " + mails.length);
return String(mails.length);

1Variante A — Service Account (empfohlen)

Für Workspace-Tenants: Service Account mit Domain-wide Delegation — zentral, ohne Einzel-Login. (PH „Google Workspace Zugriff einrichten")

var creds = {
  Account: "user@example.com",
  ServiceAccountJson: google_service_account_json
};

Voraussetzungen: Google-Cloud-Projekt · APIs aktivieren (Gmail, Calendar, Drive) · Service Account + JSON-Schlüssel · Domain-wide Delegation im Admin Center · Scopes whitelisten (gmail.modify, calendar, drive).

2Variante B — OAuth2 mit Refresh-Token

Für einzelne Accounts oder Consumer-Gmail:

var creds = {
  Account: "user@example.com",
  ClientId: google_client_id,
  ClientSecret: google_client_secret,
  RefreshToken: google_refresh_token
};

1Funktionen je Modul

googlemail

getNewFromInbox, getByCriteria, move, changeReadState, createDraft

googlecalendar

getEventsInRange, findFreeSlots, createEvent, updateEvent, getEventById, findMeetingTimes (liefert konstant Confidence 100), deleteEvent, acceptEvent / declineEvent / tentativelyAcceptEvent

googledrive

listFiles, findFolderByPath, getFileContent, uploadFile, exportFile

googleapi

generisch: getResource/postResource/putResource/deleteResource

getModule("googlemail");

var newMails = googlemail_getNewFromInbox(creds, 25);
for (var i = 0; i < newMails.length; i++) {
  var mail = newMails[i];
  if (mail.Subject.toLowerCase().indexOf("invoice") !== -1) {
    googlemail_move(creds, mail.MailServerId, "Processed/Invoices");
    googlemail_changeReadState(creds, mail.MailServerId, true);
  }
}
return String(newMails.length);

1Hilfsmodule

user

aktueller Benutzer.

organisation

Org-Konfiguration über organisation_getOrganisation().

log

log_info/log_warn/log_error/log_fatal.

docdb

Dokumente in DocumentDB laden/speichern/löschen.