Telesherpa Ontology Platform

Activate a registered account with the voucher code from the activation email. Meldet sich intern mit loginusername/loginpassword an und loest dann den Voucher ein. Nach der Registrierung per E-Mail erhaltenen 7-stelligen Aktivierungscode hier eingeben. Den Code bekommst du entweder vom Menschen genannt (Standardweg — einfach danach fragen, die Mail kommt in einer Minute) oder per IMAP aus dem Postfach. Benötigt die Login-Daten (E-Mail + Passwort) des registrierten Accounts. Entfernt die 'notactivated'-Rolle und gibt vollen Zugriff. | EN: activation, onboarding, account setup

Eine einzelne E-Mail-Adresse oder ein Adressmuster zur Allowlist eines Codes hinzufuegen. Ergaenzt bestehende Eintraege (loescht nichts). Nutze es fuer einzelne Nachzuegler; fuer viele Adressen ist der Excel-Upload upload_code_allowlist der richtige Weg. Entfernen: delete_code_allowlist_entry. | EN: allowlist, permission, whitelist, code

Zeigt den Auth-Zustand dieser Verbindung: ob der Bearer-Token gueltig ist, welche Rollen er traegt und welcher naechste Schritt ansteht. Rein lesend, aendert nichts am Konto. Nuetzlich, wenn unerwartet wenige Tools sichtbar sind — die Antwort nennt Rollen, Tool-Zahlen und den weiteren Weg (login, refresh_access_token, register). Referenz zur Plattform-Dokumentation: SKILL.md im Repo https://codeberg.org/telesherpa/skill-telesherpa-com (Unterordner telesherpa-ontology-platform/); die Antwort fuehrt dazu guide_repo, guide_entry und guide_version. | EN: auth, status, documentation, tool-reference, login

Das Passwort des EIGENEN Kontos aendern. Nutze es, wenn der Mensch das Passwort wechseln will. Das alte Passwort ist Pflicht; das neue muss zweimal identisch uebergeben werden. Es aendert nur das eigene Konto — fremde Passwoerter kann auch ein Administrator nicht setzen (Konten verwaltet er mit onto_user_update). Nach der Aenderung sind laufende Tokens des Kontos weiterhin gueltig; eine Neuanmeldung ist nicht noetig. | EN: password, credentials, account

Das Profil des EIGENEN Kontos lesen oder aendern (Anzeigename, Telefon, Organisation, Notizen, Skills). Ohne Felder aufgerufen liefert es den Ist-Stand; mit Feldern aendert es. Nutze es fuer Stammdaten der eigenen Person. Es aendert KEINE Zugriffsrechte (Rollen) — dafuer ist ein Administrator zustaendig (onto_user_update). Fremde Profile: onto_user_update_profile. Das eigene Konto samt Rollen lesen: onto_user_get. | EN: file, upload, document, attachment

Einen Einladungscode anlegen, mit dem sich neue Mitglieder selbst registrieren koennen. Der Code steuert, welchen Zugang der Beitragende erhaelt. Nutze es zum Anwerben von Mitgliedern/Subunternehmern. Den Code weitergeben (nicht hier ablegen) und mit list_invite_codes verwalten; ungueltig machen: revoke_invite_code. Weg (b) nach der Registrierung: nach dem eigenen Aufbau Menschen und andere Agenten in deinen Scope einladen. Die Einladung geht in beide Richtungen | EN: invitation, invite, voucher, code, bundle

Einen Eintrag aus der Allowlist eines Codes entfernen. Betrifft nur die Zulassung — bereits registrierte Konten bleiben bestehen. Nutze es, um einzelne Adressen zu sperren. Bulk-Ersetzung der ganzen Liste: upload_code_allowlist. | EN: allowlist, permission, whitelist, code

Ein Dokument (PDF, Office-Datei) ueber urlslug und filetoken als Rohdatei abrufen. Rein lesend. Nutze es, wenn du die beiden Kennungen hast. Fuer Bilder gibt es get_image; die Kennungen bekommst du aus dem Objekt (onto_object_show). Nicht zum Hochladen: dafuer upload_file_to_object. | EN: get, document

Ein Bild ueber urlslug und filetoken als Rohdatei abrufen. Rein lesend. Nutze es, wenn du die beiden Kennungen hast (sie stehen an Objekten/Bildablagen). Ohne filetoken kommst du an die Datei nicht heran — die Kennungen liefert dir das Objekt (onto_object_show) oder die strukturierte Ablage (onto_file_structured). Nicht zum Hochladen: dafuer upload_file_to_object. | EN: get, image

Die eigenen Benachrichtigungen abrufen (Meldungen des angemeldeten Kontos). Rein lesend. Nutze es, um neue Meldungen zu finden. Die Self-Service-Variante mit gleichem Inhalt ist ontouser_notification_index — nimm sie, wenn du als Scope-Nutzer arbeitest. Meldungen als gelesen markieren: ontouser_notification_read. Systemprotokolle (Admin): onto_action_logs. | EN: notification, message, alert, inbox, unread

Eigenes Profil rein lesend abrufen (Name, E-Mail, Organisation, Notizen, Skills). Kein Schreibpfad. | EN: who am i, my account, profile

Die E-Mail-Allowlist eines Einladungscodes lesen (welche Adressen/Muster zugelassen sind). Rein lesend. Nutze es als Ist-Stand vor Aenderungen. Einzelne Eintraege ergaenzen/entfernen: add_code_allowlist_entry / delete_code_allowlist_entry. Massen-Upload per Excel: upload_code_allowlist. | EN: allowlist, permission, whitelist, code

Liste aller Formulare (formdefs), die fuer dich sichtbar sind - mit udid, Titel, Feld-Anzahl und je Feld key/label/widget/required. ERSTER SCHRITT, um fachlich das passende Formular zu waehlen: hier siehst du, welche Formulare es gibt und welche Felder sie haben. Die udid nimmst du fuer show_formdef. Sichtbar sind nur Formulare in deinen Scopes (fail-closed). | EN: list, formdefs

Die eigenen Einladungscodes auflisten (wer wurde eingeladen, ist der Code noch gueltig). Rein lesend. Nutze es, um den Code fuer die Weitergabe oder zum Widerrufen zu finden. Neuen Code anlegen: create_invite_code. Ungueltig machen: revoke_invite_code. Die E-Mail-Allowlist eines Codes zeigt list_code_allowlist. | EN: invitation, invite, voucher, code, bundle

Die Mitglieder eines eigenen Bereiches auflisten (wer gehoert dazu). Rein lesend. Nutze es, um den Ist-Stand vor Aenderungen zu sehen. Rechte aendern: toggle_member_flag; entfernen: remove_member. Zugang einladen: create_invite_code. | EN: member, participant, membership, team

Ein Bearer-Token holen: tauscht client_id (E-Mail) und client_secret (Passwort) gegen access_token + refresh_token. Das ist der Einstieg — ohne Token sind nur die oeffentlichen Tools sichtbar. Nutze es einmalig am Anfang; das Token gilt 10 Stunden. Danach NICHT erneut einloggen, sondern mit refresh_access_token erneuern (dafuer braucht es kein Passwort). Passwort vergessen? Dafuer gibt es kein Tool — das macht der Mensch ueber die Weboberflaeche. Ein Konto gibt es noch nicht: vorher register. Speichere access_token (10 h) UND refresh_token (30 Tage) sofort dauerhaft — die Antwort kommt nur einmal. Mit refresh_access_token (grant_type=refresh_token) erneuerst du ohne Passwort. | EN: login, authentication, sign in, token

Das Aktionsprotokoll lesen (wer hat wann welche Aktion ausgefuehrt). Rein lesend, in der Regel nur fuer Administratoren. Nutze es zur Nachvollziehbarkeit von Aenderungen und Fehlern. Die ausfuehrbaren Aktionen selbst zeigt onto_actiondef_list. | EN: audit, log, activity, history, trace

Actiondef loeschen (Button entfernen). Rechte: Scope-Manager/Schreiber (can_manage_scope/can_write). | EN: action, button, definition, gate, condition, rule

Action-Definitionen auflisten (ausfuehrbare Buttons am Objekt, Konfigurationssicht). Rein lesend. Nutze es als Administrationssicht ueber alle Actiondefs. Nur die fuer dich nutzbaren zeigt onto_actiondef_list — das ist meist der bessere Einstieg, wenn du eine Action AUSFUEHREN willst (onto_object_execute_action). | EN: action, button, definition, gate, condition, rule

Die nutzbaren Action-Definitionen auflisten (welche Buttons an welchen Objekten erscheinen). Rein lesend. Nutze es, wenn du wissen willst, welche Aktion du auf einem Objekt ausfuehren kannst — den key uebergibst du an onto_object_execute_action. Anlegen/Aendern: onto_actiondef_save. | EN: action, button, definition, gate, condition, rule

Actiondef anlegen/aendern (Button am Objekt). PFLICHT: body.scopes mit den Scope-IDs, an denen der Button erscheinen soll — du musst dort Manager (can_manage_scope) oder Schreiber (can_write) sein, sonst 403. PUBLIC (15) nur fuer Admins. Beispiel fuer 'Formular am Standort ausfuellen': body = {"object_types":["building"],"scopes":[7],"roles":["member"],"action":{"type":"form_answer","name":"Visite","form":"<formdef-udid>"}}. action.type 'form_answer' oeffnet das Formular und verknuepft die Antwort mit dem Objekt. Actions sind SCOPE-Daten, nicht global. Sehen darf sie, wer einen der Scopes in body.scopes[] lesen darf; AUSFUEHREN nur, wenn das Scope des Objekts in body.scopes[] steht (oder die Def public:true traegt). Ein Mitglied mit can_manage_scope auf SEINEM Scope darf dort eigene Actions anlegen (Kopie der Plattform-Action mit body.scopes=[eigener Scope]) und so die Standard-Actions im eigenen Scope nutzbar machen. Beim Anlegen genau EIN Ziel-Scope. public:true und der PUBLIC-Scope 15 sind Administratoren vorbehalten, SQL-Bedingungen ebenfalls. Ein Scope-Manager kann Actions in seinem Scope per hidden_actions abschalten. | EN: action, button, definition, gate, condition, rule action.result_scope_id (Ergebnis-Scope): bei 'create'/'form_answer' bestimmt er, WO das neue Objekt entsteht. Bei 'update' ist er die BRUECKE: die Aktion darf ein BESTEHENDES Objekt in diesem Scope fortschreiben, auch wenn der Ausfuehrende dort NUR Leserecht hat — schreibbar sind genau die Eigenschaften aus action.props, nur am Zielobjekt der Aktion; danach ist die Bruecke zu (andere Felder 403). Pflicht: Personenbindung ({current_user_email}, {current_profile_id}, {current_user_id}, {user_email} oder {user_person}); bei 'update' zusaetzlich action.props, sonst 400. Merksatz: ein Mitarbeiter braucht KEIN Schreibrecht im Planungs-Scope — Aktion im Planungs-Scope definieren, result_scope_id setzen, Eigenschaften in action.props auflisten. Beispiel Einstempeln: object_types [shift], scopes [80,81], guards [{type: linked_to_user, linktype: worksShift, message: 'Nur die eigene Schicht'}], action {type: update, result_scope_id: 80, props: {actualStart: '{now}', stempelStatus: 'eingestempelt', istGeaendertVon: '{user_email}'}}. guards pruefen VOR dem Ausfuehren und rein lesend: 'linked_to_user' verlangt, dass das Zielobjekt ueber diesen Linktyp mit der handelnden Person verknuepft ist (Richtung egal), sonst 403 mit der eigenen message. Fuer 'nur die eigene Schicht' NIEMALS links.require 'present' nehmen — require ist eine Pruefung, kein Auftrag.

Ein Preset auf einen Scope anwenden und damit dessen Objekttypen anlegen/aendern. Aendert das Modell des Scopes und kann bestehende Typdefinitionen ueberschreiben. Pruefe vorher mit onto_catalog_index, was enthalten ist. Rueckgaengig: onto_catalog_clear. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: catalog, preset, template, apply, clear

Die per Preset angelegten Objekttypen eines Scopes wieder entfernen. Einschneidend — pruefe vorher, ob Objekte dieser Typen existieren (onto_object_index); sonst werden sie unerreichbar. Nutze es zum Zuruecknehmen von onto_catalog_apply. Einzelne Typen entfernst du gezielter mit onto_type_delete. | EN: catalog, preset, template, apply, clear

Den Objekttypen-Katalog lesen (welche Typen in welchen Presets gebuendelt sind). Rein lesend. Nutze es, um zu sehen, was ein Preset enthalten wuerde, BEVOR du es anwendest. Die verfuegbaren Presets listet onto_catalog_presets. | EN: catalog, preset, template, apply, clear

Die verfuegbaren Objekttyp-Presets auflisten (vorbereitete Typ-Buendel zur Auswahl). Rein lesend. Nutze es als Einstieg, wenn ein Scope mit Standardtypen ausgestattet werden soll. Anwenden: onto_catalog_apply. Inhalt eines Presets: onto_catalog_index. | EN: catalog, preset, template, apply, clear

Zustand des Schluesseltresors pruefen: Schluesseldatei geladen, Entschluesselung moeglich, Zeilenzahl. Rein lesend, zeigt keine Geheimnisse. | EN: connection, vault, key, check, health, diagnosis

Alle Verbindungen (Zugangsdaten fuer Fremdsysteme) auflisten, die das eigene Profil sehen darf. Zeigt Ziel, Bezeichnung, Basis-URL und Bindung, niemals das Geheimnis. Rein lesend. | EN: connection, credential, vault, secret, integration, list

Verbindung per id loeschen. Loescht nur eigene Eintraege; fremde antworten 404, ohne ihre Existenz zu verraten. Systemschluessel nur fuer die Verwaltung. | EN: connection, credential, delete, remove, revoke

Verbindung anlegen oder ersetzen: gleiches target_key ersetzt den eigenen Eintrag, die id bleibt, es gibt keine Historie. Das Geheimnis wird verschluesselt abgelegt und nie zurueckgegeben. | EN: connection, credential, save, store, secret, upsert

Das aktuelle Credit-Guthaben abrufen (Pay-per-Use-Konto). Rein lesend. Nutze es, um vor kostspieligen Aktionen zu pruefen, ob Guthaben vorhanden ist. Was eine Aktion kostet, zeigt onto_credit_pricing; aufladen kannst du mit onto_credit_chargeup oder onto_credit_checkout. | EN: credit, balance, pricing, billing, top-up, checkout

Credits aufladen (Guthaben erhoehen). Bewegt echtes Geld bzw. loest eine Zahlung aus — nutze es nur auf ausdrueckliche Ansage. Der Betrag ist eine Zahlung, keine Rueckgabe. Alternative Zahlwege: onto_credit_checkout oder onto_credit_create_prepaid. Stand danach: onto_credit_balance. | EN: credit, balance, pricing, billing, top-up, checkout

Credits per Checkout erwerben (Bezahlvorgang starten). Loest einen Zahlungsvorgang aus — nur auf ausdrueckliche Ansage ausfuehren. Fuer eine direkte Aufladung gibt es onto_credit_chargeup, fuer vorausbezahlte Kontingente onto_credit_create_prepaid. Den Erfolg prueft onto_credit_balance. | EN: credit, balance, pricing, billing, top-up, checkout

Ein vorausbezahltes Credit-Kontingent anlegen (Prepaid-Vereinbarung). Legt eine Abrechnungsgrundlage an — keine Sofortzahlung. Nutze es beim Einrichten von Prepaid-Kunden. Den aktuellen Stand zeigt onto_credit_balance, Preise onto_credit_pricing. | EN: credit, balance, pricing, billing, top-up, checkout

Credit-Kosten pro Aktion (Pay-per-Use). Zeigt, wie viele Credits jede Operation verbraucht. Flat-User (billing_model=flat) zahlen keine Credits. 1 Credit = 0,01 EUR. | EN: credit, balance, pricing, billing, top-up, checkout

Beleg zu einer SumUp-Aufladung lesen (Bestellnummer, Datum, Betrag, Credits, Status, Transaktion, Zahlungsdaten). Rein lesend; nur der eigene Beleg, fremde und nicht vorhandene Bestellnummern ergeben dieselbe 404. Kartentoken und BIN werden nicht ausgegeben. Die Bestellnummer steht in onto_credit_balance. | EN: credit, receipt, invoice, bill, sumup, order, paid, top-up

Rueckstand und Gesundheit der Automatik: offene Ereignisse, Fehler, die letzten Laeufe. Regeln (Trigger) laufen NICHT sofort, sondern ueber die Warteschlange: Ereignisse alle 60 s, zeitgesteuerte Regeln alle 5 min. Genau deshalb ist dieses Werkzeug da — nach dem Anlegen oder Aendern einer Regel hier nachsehen statt die Aktion zu wiederholen oder auf ein Ergebnis zu warten, das noch in der Schlange steht. | EN: automation queue, trigger status, backlog, last runs

Ein Objekt zu den eigenen Favoriten hinzufuegen (merken). Wirkt nur auf das eigene Konto und aendert keine Objektdaten. Nutze es fuer haeufig gebrauchte Objekte. Jeder Aufruf legt einen NEUEN Eintrag an — auch bei gleicher URL, weil der aktuelle Filter mitgespeichert wird. Mehrfaches Aufrufen mit gleichen Argumenten erzeugt also Duplikate; vorher mit onto_favorite_index pruefen. Entfernen: onto_favorite_delete. | EN: favorite, bookmark, quick access

Ein Objekt aus den eigenen Favoriten entfernen. Loescht NUR die Merkung, nicht das Objekt selbst — das bleibt unberuehrt. Wirkt nur auf das eigene Konto. Das Objekt selbst loeschst du mit onto_object_delete. | EN: favorite, bookmark, quick access

Die eigenen Favoriten auflisten (gemerkte Objekte des angemeldeten Kontos). Rein lesend. Nutze es, um schnell auf haeufig gebrauchte Objekte zuzugreifen. Ein Objekt merken: onto_favorite_add; entfernen: onto_favorite_delete. Alle Objekte (nicht nur Favoriten) zeigt onto_object_index. | EN: favorite, bookmark, quick access

Favoriten-Status eines Objekts umschalten (merken <-> nicht gemerkt). Wirkt nur auf das eigene Konto. Achtung: Nebenwirkung — ist die URL schon Favorit, wird der Eintrag GELOESCHT, sonst angelegt. Ein zweiter Aufruf mit gleicher URL macht den ersten rueckgaengig. Nutze es, wenn du den Ausgangszustand nicht kennst — du brauchst dann kein Vorab-Lesen. Gezielt merken: onto_favorite_add, gezielt entfernen: onto_favorite_delete. | EN: favorite, bookmark, quick access

Eine Datei aus der strukturierten Ablage loeschen. Unwiderruflich — pruefe vorher, ob Objekte darauf verweisen. Der Datensatz des Objekts bleibt bestehen, nur die Datei entfaellt. Zum Ersetzen einfach erneut hochladen (upload_file_to_object). | EN: file, image, document, attachment, upload

Eine Datei aus der strukturierten Ablage abrufen (Metadaten und/oder Inhalt). Rein lesend. Nutze es, wenn du die Datei ueber ihre Kennung kennst. Einen Upload machst du mit upload_file_to_object; die Kategorien der Ablage zeigt onto_scope_structuredimage_categories. | EN: file, image, document, attachment, upload

NEUES Formular anlegen. Legt das form-Objekt an und schreibt eine minimale gueltige Definition (1 Feld), die du danach mit onto_formdef_save ausbaust. MIT from_udid wird die Definition einer Vorlage kopiert (dann werden Felder uebernommen, Sichtbarkeit auf den Ziel-Scope gestellt und adminsql entfernt, falls du kein Admin bist). Ein so kopiertes Formular bringt auch dessen buttons/template_file mit — nach dem Kopieren mit onto_formdef_save pruefen. Rechte: form_writer/admin + Schreibzugriff auf den Scope — sonst 403. | EN: form, form definition, fields, template, PDF, submission

VORLAGEN auflisten: sichtbare Formulare im PUBLIC-Scope (generische Vorlagen). Rein lesend. Nutze die udid mit onto_formdef_create + from_udid, um eine firmenspezifische Kopie zu bauen, oder onto_formdef_show zum vollstaendigen Ansehen. Vorlagen (PUBLIC-Scope) sind der einfachste Weg an eine funktionierende Vorlage samt buttons/template_file. | EN: form, form definition, fields, template, PDF, submission

Formular-DEFINITION speichern (der EINZIGE Schreibweg fuer formdef). Pflichtfelder: version (int>=1), title, answer_type (muss existierender Objekttyp sein, z.B. 'inspection'), fields (nicht-leer). Jedes Feld: key (Buchstabe am Anfang, a-zA-Z0-9_), widget, label; optional required, options (bei select), source (bei picker), validation. Widgets: text, textarea, int, float, select, picker, switch, slider, datepicker, file, label, subform, images, documents, signature. Reservierte Keys: formdef, usesForm, performs, udid, name, external_id. adminsql/sql/sqlparameters nur als Admin. Rechte: form_writer/admin + Schreibzugriff auf den Scope. Mit 'name'/'scope_id' werden auch die Stammdaten gesetzt. ACHTUNG: buttons/template_file/template_filename sind KEINE eigenen Parameter, sondern Felder INNERHALB des formdef-JSON (buttons/template_file/template_filename). BUTTONS: formdef.buttons=[{type,label,...}]; erlaubte type-Werte: 'save' (nur speichern), 'saveandgoto' (+url: Weiterleitung), 'send' (Mailversand mit PDF-Anhang; PFLICHT to[]; optional cc[], bcc[], subject; '$currentuseremail' wird durch die Adresse des Ausfuellenden ersetzt). Empfaenger kommen IMMER aus der formdef, nie aus dem POST. PDF-VORLAGE aus Excel: formdef.template_file = file_udid als 32-hex aus upload_file_to_object (NICHT bin2hex!) und formdef.template_filename = Dateiname — beide parallel setzen. Die Auswahl per Dateiname ueberlebt einen Neu-Upload gleichen Namens. PLATZHALTER im Excel: ##feldkey## (doppeltes Hash; ## key ## mit Leerzeichen geht auch) — {feldkey} oder %%feldkey%% funktionieren NICHT. Subform-Felder fuellen zeilenweise den naechsten freien Platzhalter (das Excel bestimmt die Maximalzahl, ueberzaehlige Zeilen werden verworfen); Bildfelder/signature werden Bildanker. | EN: form, form definition, fields, template, PDF, submission

RECHENREGEL anlegen: eine Function. Anders als ein Trigger hat sie EINGABEN und einen AUSDRUCK — sie rechnet, statt nur zu reagieren. "inputs": Liste von {key, type, required}; Typen: object, string, int, float, bool, datetime, list. "body": der Ausdruck. body-Format: {"inputs":[{"key":"kmStand","type":"int","required":true}],"body":{"if":[{">":[{"field":["kmStand"]},{"field":["letzterService"]}]},"faellig","ok"]},"effects":[]}. Der Ausdruck AST hat IMMER die Form {"operator":[argumente]} — also {"-":[a,b]} fuer a minus b, nicht {"op":...}. Operatoren u.a.: field/var, source, link, linklist, and/or/!/if, ==/!=/</<=/>/>=/in/notin/empty/notempty/matches, +/-/*///%/min/max/abs/round, cat/lower/upper/len/trim, count_of/sum_of/max_of/min_of. Kein eval — nur diese Operatoren. Das Ergebnis steht als {result} bereit und wird in Regeln per run_function genutzt. Optional "effects" (set_property/create_object/create_link). RECHTE: scope_id muss ein Scope sein, den du VERWALTEST (can_manage_scope=1). | EN: function, automation, expression, script, effect ZEITREGEL: Datum/Zeit liegt in der DB als UTC und wird von MCP ROH als UTC ausgegeben — im Browser eingegebene 10:00 erscheinen hier als 09:00 (Winter) / 08:00 (Sommer); die Oberflaeche rechnet in die Betrachterzone um (Cookie -> Profilfeld -> Europe/Berlin). Zeit-Operatoren: minutes_of, minutes_between[von,bis], hours_between[von,bis,pause_minuten].

RECHENREGEL loeschen. Soft-Delete (status=deleted), umkehrbar. Achtung: Regeln, die sie per run_function aufrufen, laufen danach ins Leere — vorher mit onto_trigger_index pruefen, wer sie nutzt. Rechte: can_manage_scope im Scope. | EN: function, automation, expression, script, effect

Alle hinterlegten Funktionen auflisten (serverseitige Automatiken). Rein lesend. Nutze es, um den Namen/die udid fuer onto_function_run zu finden. Anlegen/Aendern: onto_function_create / onto_function_update. Zeitgesteuerte Ablaeufe sind Triggers: onto_trigger_index. | EN: function, automation, expression, script, effect

Eine hinterlegte Funktion ausfuehren (serverseitige Automatik/Skript). Der Effekt haengt an der Funktion und kann Daten schreiben — also nicht rein lesend. Nutze es, wenn die Funktion bekannt ist; die verfuegbaren zeigt onto_function_index. Eingaben uebergibst du als inputs-Objekt. | EN: function, automation, expression, script, effect

RECHENREGEL aendern: bestehende Function ueberschreiben. body ersetzt die Definition vollstaendig. Format siehe onto_function_create. Rechte: can_manage_scope im Ziel-Scope. | EN: function, automation, expression, script, effect

Einen NEUEN Uebersetzungs-Schluessel anlegen (Schluessel selbst + erste Werte). Nutze es nur, wenn der Schluessel noch nicht existiert — sonst onto_i18n_translate. Den Bestand prueft onto_i18n_index. Schluessel entfernst du mit onto_i18n_delete. | EN: translation, i18n, language, label, locale, export

Einen Uebersetzungs-Schluessel samt seiner Werte loeschen. Unwiderruflich. Pruefe vorher, ob der Schluessel in der Anwendung verwendet wird — sonst zeigt die Oberflaeche den Rohschluessel statt Text. Nur einen einzelnen Wert aendern: onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Die Uebersetzungen als Export ausgeben (Auslieferungsformat fuer die Anwendung). Rein lesend fuer das System, erzeugt aber eine Ausgabe mit Seiteneffekt in der Pipeline. Nutze es nach dem Review (onto_i18n_review) — nicht uebersetzte Werte fehlen dann im Export. Den Bestand prueft onto_i18n_matrix. | EN: translation, i18n, language, label, locale, export

Alle Uebersetzungs-Schluessel auflisten (i18n-Bestand mit Werten je Sprache). Rein lesend. Nutze es fuer einen Ueberblick; fuer gezielte Luecken nimm onto_i18n_missing, fuer die Vollmatrix je Sprache onto_i18n_matrix. Einen Schluessel anlegen/aendern: onto_i18n_create / onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Die Uebersetzungsmatrix lesen: alle Schluessel gegen alle Sprachen mit ihren Werten. Rein lesend, kann gross werden. Nutze es fuer einen vollstaendigen Abgleich. Nur die fehlenden Uebersetzungen zeigt onto_i18n_missing. Werte eintragen: onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Die noch fehlenden Uebersetzungen auflisten (Luecken je Sprache). Rein lesend. Nutze es als Arbeitsliste, bevor du uebersetzt — das ist billiger als die volle Matrix (onto_i18n_matrix). Vorschlaege dazu: onto_i18n_suggestions. Eintragen: onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Eine Uebersetzung pruefen und freigeben (Review-Status setzen). Aendert den Status, nicht den Text. Nutze es als Abschluss nach onto_i18n_translate. Was ueberhaupt fehlt, zeigt onto_i18n_missing. Zur Auslieferung an die Anwendung: onto_i18n_export. | EN: translation, i18n, language, label, locale, export

Uebersetzungs-VORSCHLAEGE fuer fehlende Schluessel abrufen. Rein lesend. Nutze es, wenn du nicht selbst formulieren willst. Was ueberhaupt fehlt, zeigt onto_i18n_missing. Vorschlaege sind nicht verbindlich — gespeichert wird mit onto_i18n_translate, freigegeben mit onto_i18n_review. | EN: translation, i18n, language, label, locale, export

Den Wert eines BESTEHENDEN Schluessels in einer Sprache setzen oder aendern. Nutze es zum Uebersetzen und Korrigieren. Sprache ist der volle Locale (fr_FR, it_IT, en_US), NICHT der Kurzcode. Fehlt der Schluessel, leg ihn zuerst mit onto_i18n_create an. Pruefen/freigeben: onto_i18n_review. | EN: translation, i18n, language, label, locale, export

Eine Analyse des Quelldatenbestands starten (Struktur/Vorschau vor dem Import). Ruft die Analyse auf und liefert die analysierte Struktur. Nutze es VOR onto_import_run_step, um Feldzuordnungen zu pruefen. Bereits vorhandene Analyseergebnisse eines Schritts: onto_import_analyze_step. | EN: import, data load, staging, CSV, source, pipeline

Das Ergebnis der Analyse fuer einen bestimmten Schritt abrufen. Rein lesend. Nutze es, um eine mit onto_import_analyze gestartete Analyse auszuwerten. Den Lauf startest du dann mit onto_import_run_step. | EN: import, data load, staging, CSV, source, pipeline

Eine NEUE Importquelle anlegen (Verbindung/Datei fuer Massendatenimport). Nutze es beim Einrichten eines neuen Imports. Eine bestehende Quelle aenderst du mit onto_import_update_source. Schritte hinzufuegen: onto_import_save_step. Vorhandene Quellen: onto_import_sources. | EN: import, data load, staging, CSV, source, pipeline

Eine Importquelle samt ihrer Schritte entfernen. Pruefe ZUERST mit onto_import_steps, was daran haengt — geloeschte Schritte sind nicht wiederherstellbar. Nutze es beim Stilllegen obsoleter Importe. Zum reinen Deaktivieren genuegt onto_import_update_source. | EN: import, data load, staging, CSV, source, pipeline

Einen Import-Schritt aus der Pipeline entfernen. Betrifft nur die Definition — bereits importierte Daten bleiben. Nutze es beim Umbau einer Quelle. Die verbleibenden Schritte zeigt onto_import_steps. | EN: import, data load, staging, CSV, source, pipeline

Alle Importquellen auflisten (definierte Datenimporte fuer Massendaten). Rein lesend. Nutze es als Einstieg, um eine vorhandene Quelle zu finden. Die Verarbeitungsschritte einer Quelle zeigt onto_import_steps; eine neue Quelle legst du mit onto_import_create_source an. | EN: import, data load, staging, CSV, source, pipeline

Reihenfolge der Verarbeitungsschritte einer Quelle neu setzen. Uebergib ALLE Step-IDs der Quelle in der gewuenschten Reihenfolge; step_no wird 1..N neu vergeben. Nur Steps dieser Quelle werden akzeptiert. Nutze onto_import_steps, um die aktuellen IDs zu holen. | EN: import, data load, staging, CSV, source, pipeline

Einen Import-Schritt ausfuehren (SQL, Check oder Python). Aendert Daten — vorher onto_import_steps lesen. Enthaelt der Schritt den Platzhalter {{file_udid}}, MUSS file_udid mitgegeben werden: die udid des file-Objekts, das gelesen werden soll. Ohne gueltige udid bricht der Lauf ab, statt irgendeine Datei zu lesen. Die udid liefert der Auftraggeber; der Kunde sieht sie ueber ontouser_object_show am Elternobjekt (Feld files[].udid). Ein Python-Schritt erhaelt die Verbindungen der Anbindungen ueber tscred (credential, targets, info); die Datei mit den Klartextwerten wird nach dem ersten Lesen geloescht. Der Bericht nennt unter 'zugangsdaten', wie viele Verbindungen uebergeben wurden. | EN: import, data load, staging, CSV, source, pipeline

Einen Import-Schritt anlegen oder aendern (Bestandteil der Importpipeline). Aendert die Definition, fuehrt nichts aus. Nutze es beim Aufbau einer Quelle. Ausfuehren dann mit onto_import_run_step; entfernen mit onto_import_delete_step. Der bisherige Wert ist danach weg (keine Historie, kein Undo). In einem Python-Schritt stehen die Verbindungen der Anbindungen als Modul tscred bereit: from tscred import credential, targets, info — credential('ziel') liefert das entschluesselte Geheimnis, targets() die verfuegbaren Ziele. Geheimnisse nie ausgeben oder protokollieren, nur Laengen oder Statuscodes. Mehrdeutige Ziele (gleicher Name an mehreren Profilen) werden bewusst nicht durchgereicht. | EN: import, data load, staging, CSV, source, pipeline

Aktive Importquellen auflisten (Alternative zur vollen Liste). Rein lesend. Nutze es, wenn du nur die einsatzbereiten Quellen brauchst. Schritte einer Quelle: onto_import_steps. Analyse starten: onto_import_analyze. | EN: import, data load, staging, CSV, source, pipeline

Einen laufenden Import-Schritt abbrechen. Bereits geschriebene Datensaetze bleiben bestehen — der Abbruch ist kein Rollback. Nutze es bei Fehlkonfiguration, statt den Lauf durchlaufen zu lassen. Status vor/nach: onto_import_step_status. | EN: import, data load, staging, CSV, source, pipeline

Den aktuellen Status eines einzelnen Import-Schritts lesen (laeuft/fertig/Fehler). Rein lesend. Nutze es zum Nachfassen NACH onto_import_run_step, statt den Lauf zu wiederholen. Die Schrittliste liefert onto_import_steps; einen laufenden Schritt brichst du mit onto_import_step_cancel ab. | EN: import, data load, staging, CSV, source, pipeline

Die Verarbeitungsschritte einer Importquelle auflisten (Pipeline des Imports). Rein lesend. Nutze es, um zu sehen, welche Schritte definiert sind und was als naechstes laeuft. Den Status eines einzelnen Schritts zeigt onto_import_step_status. Einen Schritt ausfuehren: onto_import_run_step. | EN: import, data load, staging, CSV, source, pipeline

Eine bestehende Importquelle aendern (Verbindungsparameter, Bezeichnung, Aktivierung). Nutze es zum Korrigieren oder Umstellen einer Quelle. Eine neue Quelle legst du mit onto_import_create_source an. Entfernen: onto_import_delete_source — pruefe vorher die Schritte. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: import, data load, staging, CSV, source, pipeline

Eine neue Interface-Definition anlegen (neue Sicht/Maske). Aendert das Modell. Nutze es, wenn ein Objekttyp eine zusaetzliche Ansicht bekommen soll. Bestehende Interfaces aenderst du mit onto_interface_update_def. | EN: onto, interface, create, def Verengung (optional): table.scopes mit Scopenamen schraenkt die Zeilen dieser Ansicht zusaetzlich auf diese Scopes ein (nur einschraenkend, unbekannter Name = 400). Die Ansicht zeigt sie unter der Ueberschrift an; trage sie zusaetzlich in die description des Interfaces ein.

Eine Interface-Definition entfernen. Entfernt die Sicht, NICHT die Objekte oder Felder. Pruefe vorher, ob Objekttypen das Interface verwenden. Ein einzelnes Feld aus dem Modell entfernst du mit onto_property_def_delete. | EN: onto, interface, delete, def

Alle Interfaces auflisten (Sichten/Masken, die festlegen, welche Felder ein Objekt zeigt). Rein lesend. Nutze es, um den Interface-Namen fuer onto_object_create oder die Anzeige zu finden. Ein einzelnes Interface: onto_interface_show. | EN: onto, interface, index

Die Kartenmarker eines Interfaces abrufen (Objekte mit Koordinaten zur Anzeige auf der Karte). Rein lesend, ruft keine Kartendaten extern ab. Nutze es fuer Karten-/Karten-Ansichten; fehlende Koordinaten erst mit onto_object_geocode setzen. Die identische Antwort liefert ontouser_interface_map_markers. | EN: onto, interface, map, markers

Ein einzelnes Interface vollstaendig lesen (enthaltene Felder, Gruppierung, Sichtbarkeit). Rein lesend. Nutze es, wenn der Name bekannt ist. Ohne Namen: onto_interface_index. Die identische Antwort liefert ontouser_interface_show. | EN: onto, interface, show

Eine bestehende Interface-Definition aendern (Felder, Reihenfolge, Sichtbarkeit). Betrifft die Sicht, nicht die Daten. Nutze es zum Anpassen einer Maske; welche Felder es ueberhaupt gibt, zeigt onto_property_def_index. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: onto, interface, update, def Verengung (optional): table.scopes mit Scopenamen schraenkt die Zeilen dieser Ansicht zusaetzlich auf diese Scopes ein (nur einschraenkend, unbekannter Name = 400). Die Ansicht zeigt sie unter der Ueberschrift an; trage sie zusaetzlich in die description des Interfaces ein.

ALLE Einladungscodes ueber alle Scopes auflisten — nur fuer Administratoren, rein lesend. Zeigt je Code: Scope, Vorlage, Art (scope/management/revoke), Rechte R/W/M, AUSSTELLER, Status, Ablauf, Nutzungen mit Maximum, Label, letzte Aenderung und die Zahl der Einloesungen. Die Filter gehoeren in den JSON-BODY, nicht in die URL: q (Code/Label/Scope, Wildcard *), scope_id, status (active|inactive|expired), kind (scope|management|revoke), sort (modified_datetime|id|code|scope|issuer|expires_at|use_count), dir (asc|desc), page. Anlegen und Zurueckziehen passiert bewusst NICHT hier, sondern beim Scope-Manager (Scope-Verwaltung, Reiter Codes). Einen einzelnen Code samt Einloesungen: onto_invite_code_show. | EN: invite code, invitation, admin, overview, issuer, redemption, audit

Einen einzelnen Einladungscode mit Kopfdaten und ALLEN Einloesungen lesen — nur fuer Administratoren, rein lesend. Kopfdaten: Code, Scope, Vorlage, Art, requires_management, Rechte, Status, Ablauf, Nutzungen/Maximum, Label, Aussteller (Name + E-Mail), letzte Aenderung. Einloesungen: wer (Profil + E-Mail), wann und mit welchen Rechten — die Spur bleibt auch nach einem Zurueckziehen des Codes stehen. Alle Codes findest du mit onto_invite_code_index. | EN: invite code, redemption, who joined, audit, admin

Eine neue Link-Definition anlegen (erlaubt einen Beziehungstyp zwischen zwei Objekttypen). Aendert das Schema — nach dem Anlegen koennen Objekte so verknuepft werden. Nutze es beim Modellaufbau; fuer eine bestehende Definition onto_link_update_def. Loeschen: onto_link_delete_def. | EN: link, relation, edge, connection, graph

Eine Link-Definition entfernen. Entfernt die Beziehungsart aus dem Modell — pruefe vorher, ob noch Kanten darauf zeigen (onto_object_graph). Um nur eine einzelne Kante zu loesen, nimm onto_object_delete_link. | EN: link, relation, edge, connection, graph

Alle Link-Definitionen auflisten (welche Beziehungen es zwischen Objekttypen gibt). Rein lesend. Nutze es, um den fuer onto_object_create_link noetigen Link-Typ zu finden. Eine Definition anlegen/aendern: onto_link_create_def / onto_link_update_def. | EN: link, relation, edge, connection, graph

Eine bestehende Link-Definition aendern (Name, beteiligte Typen, Regeln). Betrifft das Schema, nicht einzelne Objektkanten. Nutze es zum Korrigieren einer Definition; bestehende Kanten aenderst du mit onto_object_update_link. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: link, relation, edge, connection, graph

Einen Kommentar an ein Objekt anhaengen (Verlaufseintrag mit Autor und Zeitstempel). Rein anhaengend — bestehende Kommentare bleiben. Nutze es fuer Notizen und Rueckfragen am Datensatz. Es aendert KEINE Properties; dafuer onto_object_set_property. Ein Kommentar ist ein eigenes Objekt vom Typ comment, per hascomment-Link am Zielobjekt. Loeschen: onto_object_delete mit der udid des Kommentars (status wird deleted, er verschwindet aus dem Panel). Aendern geht nicht - loeschen und neu schreiben. | EN: object, record, entry, property, link, search

Dieselbe Aktion auf viele Objekte in einem Aufruf anwenden (Massenbearbeitung). Nutze es ab mehreren Datensaetzen statt einer Schleife aus Einzelaufrufen. Wirkung und Seiteneffekte sind die der jeweiligen Action und koennen nicht zurueckgenommen werden — vorher mit onto_object_index die Zielmenge eingrenzen. | EN: object, record, entry, property, link, search

Ein neues Objekt anlegen. Schreibt in die Datenbank — kein Trockenlauf. Pflicht ist mindestens type; properties ist eine Map Property-key -> Wert, interfaces eine Liste von Interface-Namen. Nutze es fuer neue Datensaetze; zum Aendern eines bestehenden nimm onto_object_update oder onto_object_set_property. Legt bei Bedarf NICHT automatisch Verknuepfungen an — dafuer onto_object_create_link. | EN: object, record, entry, property, link, search

Zwei Objekte ueber einen Link-Typ miteinander verbinden. Schreibt eine neue Kante; mehrfaches Aufrufen erzeugt keine Dublette, sondern aktualisiert die Kante. Die verfuegbaren Link-Typen zeigt onto_link_index. Bestehende Kanten aendern: onto_object_update_link. | EN: object, record, entry, property, link, search

Ein Objekt unwiderruflich loeschen, samt seiner Properties. Nutze es nur, wenn der Datensatz wirklich entfallen soll — es gibt kein Undo. Zum Deaktivieren/Archivieren stattdessen ein Status-Property via onto_object_set_property setzen. Fuer mehrere Objekte auf einmal: onto_object_bulk_action. | EN: object, record, entry, property, link, search

Eine Verknuepfung zwischen zwei Objekten entfernen. Loescht nur die Kante, NICHT die beteiligten Objekte. Unwiderruflich. Zum Anlegen derselben Kante wieder onto_object_create_link. | EN: object, record, entry, property, link, search

Ein einzelnes Property von einem Objekt entfernen (der Wert verschwindet, das Objekt bleibt). Unwiderruflich. Nutze es zum Aufraeumen fehlerhafter Felder; um nur den Wert zu leeren, genuegt onto_object_set_property mit leerem Wert. Zum Loeschen des ganzen Objekts onto_object_delete. | EN: object, record, entry, property, link, search

Eine hinterlegte Action (Button/Automatik) auf einem Objekt ausfuehren. Der Effekt haengt an der Action-Definition und kann Properties aendern, Links setzen oder Folgeprozesse starten — also nicht rein lesend. Nutze es, wenn am Objekt eine Action angeboten wird; die verfuegbaren Actions zeigt onto_actiondef_list. | EN: object, record, entry, property, link, search

Koordinaten zu einem Objekt ermitteln und hinterlegen (Adresse -> Lat/Lon). Schreibt in das Objekt und ruft dazu einen externen Kartendienst auf (offene Welt). Nutze es nach dem Anlegen eines Objekts mit Adresse, wenn Kartenmarker gebraucht werden. Kartenanzeige selbst: onto_interface_map_markers. | EN: object, record, entry, property, link, search

Ein Objekt samt seinen Verknuepfungen als Graph lesen (Knoten + Kanten). Rein lesend. Nutze es fuer Beziehungsfragen ('womit haengt X zusammen'). Fuer die reine Feldansicht eines Objekts genuegt onto_object_show; fuer die Liste aller Link-Definitionen onto_link_index. | EN: object, record, entry, property, link, search

Alle Objekte auflisten, seitenweise und nach optionalem Filter. Rein lesend. Nutze es fuer Uebersichten und Zaehlungen. Wenn du EIN Objekt ueber seine udid kennst, nimm onto_object_show (billiger); fuer Volltextsuche ueber mehrere Felder onto_object_search. | EN: object, record, entry, property, link, search

Objekte ueber ihre Feldwerte suchen (Filter/Textsuche ueber Properties). Rein lesend. Nutze es, wenn du Objekte NICHT ueber die udid kennst — das ist der Einstieg vor onto_object_show. Fuer die reine Scope-Auswahl vor der Suche onto_object_search_scopes. | EN: object, record, entry, property, link, search

Die durchsuchbaren Scopes ermitteln, bevor du onto_object_search aufrufst. Rein lesend. Nutze es, um zu erfahren, welche Bereiche fuer dein Konto ueberhaupt sichtbar sind (fail-closed: nur eigene Zuordnungen). Fuer die Suche selbst onto_object_search. | EN: object, record, entry, property, link, search

Genau ein Property eines Objekts setzen oder ueberschreiben. Nutze es fuer gezielte Einzelkorrekturen; fuer mehrere Felder auf einmal onto_object_update. Ein Property entfernt dagegen onto_object_delete_property. Der bisherige Wert ist danach weg (keine Historie, kein Undo). Zeitpunkt-Properties: Eingaben gelten in der Zeitzone des Betrachters (Default Europe/Berlin) und werden als UTC gespeichert; die JSON-Ausgabe zeigt UTC. Wer UTC schickt, bekommt je nach Zone einen Versatz. | EN: object, record, entry, property, link, search ZEITREGEL: Datum/Zeit liegt in der DB als UTC und wird von MCP ROH als UTC ausgegeben — im Browser eingegebene 10:00 erscheinen hier als 09:00 (Winter) / 08:00 (Sommer); die Oberflaeche rechnet in die Betrachterzone um (Cookie -> Profilfeld -> Europe/Berlin). Zeit-Operatoren: minutes_of, minutes_between[von,bis], hours_between[von,bis,pause_minuten].

Ein einzelnes Objekt ueber seine udid vollstaendig lesen — alle Properties und Interfaces. Rein lesend. Nutze es, wenn du die udid schon hast. Ohne udid: erst onto_object_search oder onto_object_index. Die identische Antwort liefert ontouser_object_show. | EN: object, record, entry, property, link, search