Bereitstellung eines benutzerdefinierten Manifests – Hilfe

Anhand dieses Artikels können Sie ein benutzerdefiniertes Manifest für Rainbow-Benutzer bereitstellen. Sie erfahren den Unterschied zwischen der Bereitstellung über die Verwaltungskonsole und dem lokalen Import, wie die Bereitstellungspriorität funktioniert und wie Sie ein Manifest bei Bedarf entfernen können.

Übersicht

Ein „custo-manifest“ ist eine JSON-Datei, mit der die Rainbow-Benutzeroberfläche für Ihre Nutzer angepasst wird: Aktionsschaltflächen, API-Aufrufe, eingebettete Anwendungen, Widgets … Nach der Bereitstellung wird es bei jedem Start des Rainbow-Clients automatisch angewendet.

Lizenzvoraussetzung: Custo-Manifest-Erweiterungen (Aktionsschaltflächen, API-Aufrufe, eingebettete Anwendungen, Widgets) erfordern eine Business-Lizenz oder höher. Ohne Business-Lizenz sind lediglich PBX-Ereignisse (Überwachung eingehender/ausgehender Anrufe) verfügbar.

Es gibt zwei Bereitstellungsmodi:

Modus	Wer	Gültigkeitsbereich	Priorität
Verwaltungskonsole	Sie, über die Verwaltungskonsole	Alle Benutzer-Clients (Web + Desktop, alle Sitzungen)	Hat Priorität
Lokaler Import	Endbenutzer	Nur der für den Import verwendete Computer oder Browser	Wird durch die Bereitstellung über die Verwaltungskonsole überschrieben

Hinweis: Die Bereitstellung über die Verwaltungskonsole hat stets Vorrang. Wird ein Manifest über die Konsole zugewiesen, ersetzt es jeden lokalen Import, und die Option „Import/Export“ verschwindet aus dem Rainbow-Client.

Deaktivieren des lokalen Imports: Sie können die Option „Import/Export“ für Ihre Benutzer über Profile deaktivieren: Unternehmen → Profile → [Profil] → Berechtigungen → Benutzerdefiniertes Manifest. Nach der Deaktivierung verschwindet die Option aus dem Client-Menü, und es wird ausschließlich das über die Verwaltungskonsole zugewiesene Manifest angewendet.

Bereitstellung über die Verwaltungskonsole

Dies ist die empfohlene Methode für den Produktivbetrieb. Sie laden das Manifest einmal hoch, woraufhin Rainbow es automatisch auf alle betroffenen Benutzer anwendet.

Konfigurationsbildschirm

Das Manifest und die vertrauenswürdigen Domänen werden an derselben Stelle konfiguriert:

Unternehmen → Informationen → Anpassung

Rainbow-Konsole – Unternehmen → Informationen → Anpassung

In die Konsole importieren

Gehen Sie zu Unternehmen → Informationen → Anpassung → Benutzerdefiniertes Manifest
Klicken Sie auf „Importieren“ und wählen Sie die .json- oder .zip-Datei aus
Vergewissern Sie sich, dass das Manifest in der Liste angezeigt wird

Benutzern zuweisen

Zwei Zuweisungsmethoden:

Nach einzelnen Benutzern

Gehen Sie zu „Mitglied“ → „Informationen“ → „Benutzer-Manifest“
Wählen Sie das anzuwendende Manifest aus

Nach Benutzerprofil

Gehen Sie zu „Unternehmen“ → „Profile“
Bearbeiten Sie das Profil → Abschnitt „Custo-Manifest“
Wählen Sie das Manifest aus – es gilt für alle Mitglieder des Profils

Per Massenprovisionierung (CSV-Import oder LDAP-Synchronisierung)

Die Zuordnung des „custo-manifest“ kann in einen CSV-Massenimport oder in die LDAP-Synchronisation einbezogen werden
Das entsprechende Feld in der CSV-Datei lautet „AppCustomisationTemplate“
In LDAP ist das Attribut ebenfalls „AppCustomisationTemplate“

Hinweis: Diese Methode eignet sich besonders dafür, einer großen Anzahl von Benutzern in einem einzigen Vorgang ein Manifest zuzuweisen.

Client-Übernahme

Das bereitgestellte Manifest wird beim nächsten Start des Clients automatisch heruntergeladen. Von Ihren Benutzern sind keine Maßnahmen erforderlich.

Web: Das Manifest wird bei jedem Sitzungsstart geladen. Eine Aktualisierung wird daher erst bei der nächsten Anmeldung wirksam.

Desktop: Das Manifest wird beim Start der Anwendung heruntergeladen.

Vertrauenswürdige Domänen

Überprüfen Sie vor der Bereitstellung, ob alle im Manifest referenzierten URL-Ursprünge unter folgendem Pfad deklariert sind:

Unternehmen → Informationen → Anpassung → Custo-Manifest-Domänen

Ohne diese Deklaration wird beim Laden eine Warnung angezeigt, und die Erweiterungen schlagen ohne Fehlermeldung fehl. Lesen Sie dazu den Artikel „Netzwerksicherheit und vertrauenswürdige Domänen für Custo-Manifest-Erweiterungen“.

Aktualisieren eines bereitgestellten Manifests

Ändern Sie das Manifest

Bearbeiten Sie die JSON-Datei lokal
In der Konsole: Unternehmen → Anpassung → Custo-Manifest → Ersetzen
Importieren Sie die neue Version

Die alte Version wird ersetzt. Die Clients laden sie beim nächsten Start herunter.

Hinweis: In der Rainbow-Konsole gibt es keine automatische Versionsverwaltung. Bewahren Sie frühere Versionen lokal auf, damit Sie bei Bedarf ein Rollback durchführen können.

Neuladen erzwingen (Web)

In Rainbow Web wird das Neuladen des Manifests erzwungen, indem Sie den Browser-Cache leeren oder sich ab- und wieder anmelden.

Manifest entfernen

So entfernen Sie das Manifest für einen Ihrer Benutzer: Gehen Sie zu „Mitglied“ → „Informationen“ → „Custo-Manifest“ und wählen Sie „Kein Manifest“ aus. Der Client kehrt beim nächsten Start in seinen Standardzustand zurück.

Lokaler Import (Entwicklung und Tests)

Der lokale Import ermöglicht es einem Benutzer, ein Manifest direkt in seinen Rainbow-Client zu laden, ohne die Verwaltungskonsole zu nutzen. Dies wird für die Entwicklungsphase und Tests vor der Bereitstellung empfohlen.

Eingeschränkter Geltungsbereich: Ein lokal importiertes Manifest gilt nur für den Rechner oder Browser, der für den Import verwendet wurde. Es wird nicht auf andere Arbeitsplätze oder Sitzungen des Benutzers übertragen.

Import in Rainbow Desktop

Öffnen Sie Rainbow Desktop
Gehen Sie zu „Einstellungen“ → „Telefonie“ → „Anpassung“
Klicken Sie auf „Importieren“ und wählen Sie die .json- oder .zip-Datei aus
Das Manifest wird sofort übernommen

So erhalten Sie eine Startervorlage: Klicken Sie vor jedem Import auf „Exportieren“ – Rainbow generiert eine Beispieldatei, die alle unterstützten Erweiterungspunkte enthält.

Import in Rainbow Web

Der lokale Import in Rainbow Web erfolgt nach dem gleichen Verfahren wie auf dem Desktop (Menü „Einstellungen“ → „Anpassung“), ist jedoch auf den aktuell verwendeten Browser beschränkt.

Veraltete Einrichtung über die CLI

Veraltetes Verfahren: Bevorzugen Sie die Bereitstellung über die Verwaltungskonsole. Die zentrale Bereitstellung hat Vorrang vor diesem veralteten Desktop-Einrichtungsmodus und ist einfacher zu verwalten.

Bei älteren Rainbow-Desktop-Integrationen konnte bei der Installation mit der Einrichtungsoption „/Custom“ ein Manifest bereitgestellt werden.

RainbowSetup.exe /Custom=C:\Pfad\zu\manifest.json

Bei Verwendung dieses Modus wird die Option „Importieren/Exportieren“ für den Endbenutzer ausgeblendet. Wenn ein Administrator später über die Rainbow-Verwaltungskonsole ein Manifest zuweist, hat das zentral bereitgestellte Manifest Vorrang.

Häufige Probleme

Das Manifest wird nicht angewendet

Mögliche Ursache	So überprüfen Sie dies	Behebung
Das Manifest ist dem Benutzer nicht zugewiesen	Konsole → Mitglied → Benutzer-Manifest	Weisen Sie das Manifest zu
Client wurde nicht neu gestartet	—	Bitten Sie den Benutzer, Rainbow neu zu starten
Ungültiges JSON	Entwicklertools → Konsole → Fehler beim Laden	Überprüfen Sie die Gültigkeit der JSON-Datei (Online-Tool oder Rainbow Generator)
Lokaler Import vom Administrator deaktiviert	Die Option „Importieren/Exportieren“ fehlt	Verwenden Sie die Administratorbereitstellung

Beim Laden des Manifests wird eine Warnung angezeigt

Das Manifest verweist auf eine URL, deren Herkunft nicht in den vertrauenswürdigen Domänen deklariert ist.

Behebung: Deklarieren Sie die Herkunft unter „Unternehmen“ → „Anpassung“ → „Benutzerdefinierte Manifest-Domänen“.

Warnung: Das Schließen der Warnung behebt das Problem nicht – betroffene Erweiterungen schlagen zur Laufzeit stillschweigend fehl.

Erweiterungen werden im Client nicht angezeigt

Mögliche Ursache	Behebung
Manifest zugewiesen, aber Client nicht neu gestartet	Starten Sie Rainbow neu
Erweiterungspunkt wird auf dem Client nicht unterstützt (Web vs. Desktop)	Überprüfen Sie die Kompatibilität der Web-/Desktop-Erweiterungspunkte in der Dokumentation
Maximale Anzahl an Aktionen erreicht (3 pro Erweiterungspunkt)	Reduzieren Sie die Anzahl der Aktionen im Manifest
Lokaler Import wurde durch das Administrator-Manifest überschrieben	Erwartetes Verhalten – das Administrator-Manifest hat Vorrang

Lokaler Import ist nicht möglich (Option ist ausgegraut oder fehlt)

Der Administrator hat den lokalen Import über das Profil deaktiviert. Wenden Sie sich an den Rainbow-Administrator, um Zugriff zu erhalten, oder beantragen Sie die Bereitstellung über die Konsole.

Checkliste für die Bereitstellung vor der Produktion

JSON validiert (keine Syntaxfehler, „version“: „2“, „jsonType“ vorhanden)
Manifest über lokalen Import auf Rainbow Desktop und Web getestet
Alle URL-Ursprünge in den „Custo-manifest“-Domänen deklariert
Bei lokalen Ressourcen: ZIP-Archiv mit „custo-manifest.json“ im Stammverzeichnis erstellt
Manifest in der Konsole den richtigen Benutzern oder Profilen zugewiesen