Hinweis: Nutzen Sie diesen Artikel, um die richtigen Aktions- und Befehlsfelder in einem „custo-manifest“ auszuwählen.
Anhand dieses Artikels können Sie die richtigen Stammaktionsfelder und Befehlsfelder in einem „custo-manifest“ auswählen. Sie erfahren, wie Rainbow die einzelnen Felder verwendet und welche Felder von der Erweiterungspunktfamilie abhängen.
Stamm-Aktionsfelder
| Feld | Beschreibung |
|---|---|
name |
In Rainbow angezeigter Text: Schaltflächenbeschriftung, Widget-Titel oder Menüeintrag. Optional bei automatischen Ereignissen. |
Symbol / Symbol-ID
|
Symbol-URL, Pfad zur gepackten Ressource oder Kennung eines integrierten Symbols. Für die meisten Erweiterungspunkte für Schaltflächen obligatorisch. |
Tooltip |
Tooltip, der angezeigt wird, wenn der Mauszeiger über eine Schaltfläche geführt wird. |
Befehl |
Obligatorisches Objekt, das beschreibt, was Rainbow ausführen oder aufrufen muss. |
responseType |
Anzeigeformat für sichtbare Ergebnisse: Markdown, JSON oder adaptiveCard. |
displayJsonField |
Wenn eine REST-Antwort im JSON-Format vorliegt, identifiziert dieses Feld die Eigenschaft, die den anzuzeigenden Markdown-Code enthält. |
adaptiveCardTemplate |
Inline-Vorlage für Adaptive Cards. |
adaptiveCardTemplateJsonField |
JSON-Feld, das die vom REST-Dienst zurückgegebene Adaptive-Card-Vorlage enthält. |
adaptiveCardContentJsonField |
JSON-Feld, das die Daten enthält, mit denen die Adaptive-Card-Vorlage ausgefüllt wird. |
adaptiveCardSubmitUrl |
REST-URL, die per POST aufgerufen wird, wenn eine „Adaptive Card Action.Submit“-Aktion ausgelöst wird. |
Das Befehlsobjekt
"command": {
"url": "https://api.example.com/customer",
"params": "email=${contact.email}",
"commandType": "rest",
"method": "GET",
"header": ["Authorization: Bearer TOKEN"],
"bodyParameters": {
"user": "${localUser.email}"
}
}| Feld | Wann es verwendet wird |
|---|---|
url |
Obligatorisch. Web-URL, REST-Endpunkt, lokaler Dateipfad oder Pfad zu einer gepackten Ressource. |
params |
Optionale Abfrageparameter. Variablen werden unterstützt. |
commandType |
Optional. Gängige Werte sind „rest “ und „file“. Wird dieser Parameter weggelassen, hängt das Verhalten vom Erweiterungspunkt ab. |
method |
Für REST-Befehle. Unterstützte Werte: „GET “ und „POST“. |
header |
Für REST-Befehle. Array von HTTP-Header-Zeichenketten. |
bodyParameters |
Für REST-POST-Befehle. Als Anfragetext gesendetes JSON-Objekt. Variablen werden unterstützt. |
Sekundäre Felder
| Feld | Verwendung mit | Zweck |
|---|---|---|
AnswerOnClick |
Schaltfläche „Eingehender Anruf“ | Nehmen Sie den Anruf an, wenn auf die Schaltfläche geklickt wird. |
NoShortNumber |
PBX-Ereignisse | Verwenden Sie gegebenenfalls die vollständige Telefonnummer anstelle der Kurznummer. |
Anruf weiterleiten |
PBX-Ereignisse | Steuert das Verhalten bei Änderungen des Anrufstatus für bestimmte Telefonie-Workflows. |
Popup |
on-main-window-actions |
Öffnet die Anwendung in einem Browserfenster, anstatt sie in Rainbow einzubetten. |
auchFürTeams |
GUI-Erweiterungspunkte | Stellen Sie die Erweiterung für Teams bereit, sofern dies unterstützt wird. |
urlConfig |
Anwendungsfälle für Widgets/Frames | URL zur Konfiguration des Widgets oder der eingebetteten Anwendung. |
firstNameJsonField |
Extraktion von Kontaktdaten | Feld, das einen Vornamen in einer JSON-Antwort enthält. |
lastNameJsonField |
Extraktion von Kontaktdaten | Feld, das einen Nachnamen in einer JSON-Antwort enthält. |
companyJsonField |
Extraktion von Kontaktdaten | Feld, das einen Namen eines Unternehmens in einer JSON-Antwort enthält. |
Dateibefehle und gepackte Ressourcen
Auf Rainbow Desktop kann mit ` commandType: "file"` eine lokale Anwendung oder ein Skript ausgeführt werden. Auf Rainbow Web ist die native Ausführung nicht verfügbar; dateibasierte Anwendungsfälle müssen auf Ressourcen zurückgreifen, die in der Manifest-ZIP-Datei verpackt sind.
„command“: {
„commandType“: „file“,
„url“: „${custo.path}\display.html“
}
Warnung: Verwenden Sie in Produktions-Manifesten keine maschinenspezifischen absoluten Pfade. Verwenden Sie stattdessen
${custo.path} und packen Sie die erforderlichen Ressourcen nach Möglichkeit in ein ZIP-Archiv.