Een aangepast manifest implementeren – Help

Aan de hand van dit artikel kunt u een aangepast manifest implementeren voor Rainbow-gebruikers. U zult het verschil zien tussen implementatie via de beheerconsole en lokale import, hoe de implementatieprioriteit werkt en hoe u een manifest indien nodig kunt verwijderen.

Overzicht

Een custo-manifest is een JSON-bestand waarmee u de Rainbow-interface voor uw gebruikers kunt aanpassen: actieknoppen, API-aanroepen, ingebedde applicaties, widgets… Zodra het is geïmplementeerd, wordt het automatisch toegepast telkens wanneer de Rainbow-client wordt gestart.

Licentievereiste: Voor uitbreidingen via een aangepast manifest (actieknoppen, API-aanroepen, ingebedde applicaties, widgets) is een Business-licentie of hoger vereist. Zonder een Business-licentie zijn alleen PBX-gebeurtenissen (het monitoren van inkomende/uitgaande gesprekken) beschikbaar.

Er zijn twee implementatiemodi:

Modus	Wie	Toepassingsgebied	Prioriteit
Beheerconsole	U, vanuit de beheerconsole	Alle gebruikersclients (web + desktop, alle sessies)	Heeft prioriteit
Lokale import	Eindgebruiker	Alleen de computer of browser die voor de import wordt gebruikt	Overschreven door implementatie via de beheerconsole

Opmerking: Implementatie via de beheerconsole heeft altijd voorrang. Indien een manifest via de console wordt toegewezen, vervangt dit elke lokale import en verdwijnt de optie Importeren/Exporteren uit de Rainbow-client.

Lokale import uitschakelen: U kunt de optie ‘Importeren/Exporteren’ voor uw gebruikers uitschakelen via profielen: Bedrijf → Profielen → [profiel] → Machtigingen → Aangepast manifest. Zodra deze optie is uitgeschakeld, verdwijnt deze uit het clientmenu en wordt uitsluitend het via de beheerconsole toegewezen manifest toegepast.

Implementatie via de beheerconsole

Dit is de aanbevolen methode voor de productieomgeving. U uploadt het manifest één keer, waarna Rainbow het automatisch toepast op alle relevante gebruikers.

Configuratiescherm

Het manifest en de vertrouwde domeinen worden op dezelfde plaats geconfigureerd:

Bedrijf → Informatie → Aanpassing

Rainbow-console — Bedrijf → Informatie → Aanpassing

Importeren in de console

Ga naar Bedrijf → Informatie → Aanpassing → Aangepast manifest
Klik op Importeren en selecteer het .json- of .zip-bestand
Controleer of het manifest in de lijst verschijnt

Toewijzen aan gebruikers

Er zijn twee toewijzingsmethoden:

Per individuele gebruiker

Ga naar Lid → Informatie → Aangepast manifest
Selecteer het manifest dat u wilt toepassen

Per gebruikersprofiel

Ga naar Bedrijf → Profielen
Bewerk het profiel → Sectie Custo-manifest
Selecteer het manifest — dit geldt voor alle leden van het profiel

Via bulkprovisioning (CSV-import of LDAP-synchronisatie)

De toewijzing van het custo-manifest kan worden opgenomen in een bulk-CSV-import of in een LDAP-synchronisatie
Het bijbehorende veld in het CSV-bestand is selectedAppCustomisationTemplate
In LDAP is het attribuut eveneens geselecteerd: AppCustomisationTemplate

Opmerking: Deze methode is met name geschikt om in één bewerking een manifest aan een groot aantal gebruikers toe te wijzen.

Gebruik door de client

Het geïmplementeerde manifest wordt automatisch gedownload bij de volgende opstart van de client. Uw gebruikers hoeven hiervoor niets te doen.

Web: het manifest wordt bij elke sessiestart geladen. Een update wordt daarom pas van kracht bij de volgende aanmelding.

Desktop: het manifest wordt gedownload wanneer de toepassing wordt gestart.

Vertrouwde domeinen

Controleer vóór de implementatie of alle URL-bronnen waarnaar in het manifest wordt verwezen, zijn opgegeven in:

Bedrijf → Informatie → Aanpassing → Custo-manifest-domeinen

Zonder deze vermelding wordt er bij het laden een waarschuwing weergegeven en mislukken de uitbreidingen zonder melding. Zie het artikel Netwerkbeveiliging en vertrouwde domeinen voor custo-manifest-uitbreidingen.

Een geïmplementeerd manifest bijwerken

Wijzig het manifest

Bewerk het JSON-bestand lokaal
In de console: Bedrijf → Aanpassing → Custo-manifest → Vervangen
Importeer de nieuwe versie

De oude versie wordt vervangen. Klanten downloaden deze bij de volgende opstart.

Opmerking: Er is geen automatische versiebeheerfunctie in de Rainbow-console. Bewaar eerdere versies lokaal, zodat u indien nodig een terugzetting kunt uitvoeren.

Herladen forceren (Web)

Op Rainbow Web zorgt het leegmaken van de browsercache of het uitloggen en opnieuw inloggen ervoor dat het manifest opnieuw wordt geladen.

Het manifest verwijderen

Om het manifest voor een van uw gebruikers te verwijderen: ga naar Leden → Informatie → Custo-manifest en selecteer Geen manifest. De client keert bij de volgende opstart terug naar de standaardstatus.

Lokale import (ontwikkeling en testen)

Met lokale import kan een gebruiker een manifest rechtstreeks in zijn Rainbow-client laden zonder via de beheerconsole te gaan. Dit wordt aanbevolen voor de ontwikkelingsfase en het testen vóór de implementatie.

Beperkte reikwijdte: een lokaal geïmporteerd manifest is alleen van toepassing op de computer of browser die voor de import is gebruikt. Het volgt de gebruiker niet naar andere werkstations of sessies.

Importeren in Rainbow Desktop

Open Rainbow Desktop
Ga naar Instellingen → Telefonie → Aanpassing
Klik op Importeren en selecteer het .json- of .zip-bestand
Het manifest wordt onmiddellijk toegepast

Om een startsjabloon te verkrijgen: klik op Exporteren voordat u iets importeert — Rainbow genereert een voorbeeldbestand met alle ondersteunde uitbreidingspunten.

Importeren in Rainbow Web

Lokaal importeren in Rainbow Web verloopt volgens dezelfde procedure als op de desktop (menu Instellingen → Aanpassing), maar is beperkt tot de browser die op dat moment in gebruik is.

Verouderde configuratie via CLI

Verouderde procedure: geef de voorkeur aan implementatie via de beheerconsole. Centrale implementatie heeft voorrang boven deze verouderde Desktop-configuratiemodus en is eenvoudiger te beheren.

Voor oudere Rainbow Desktop-integraties kon tijdens de installatie een manifest worden opgegeven met de installatieoptie /Custom.

RainbowSetup.exe /Custom=C:\pad\naar\manifest.json

Wanneer deze modus wordt gebruikt, is de optie ‘Importeren/Exporteren’ verborgen voor de eindgebruiker. Indien een beheerder later via de Rainbow-beheerconsole een manifest toewijst, heeft het centraal geïmplementeerde manifest voorrang.

Veelvoorkomende problemen

Het manifest wordt niet toegepast

Mogelijke oorzaak	Hoe u dit kunt controleren	Oplossing
Manifest is niet aan de gebruiker toegewezen	Console → Lid → Custo-manifest	Wijs het manifest toe
Client is niet opnieuw opgestart	—	Vraag de gebruiker om Rainbow opnieuw op te starten
Ongeldige JSON	Ontwikkelaarstools → Console → fouten tijdens het laden	Controleer de geldigheid van de JSON (Online tool of Rainbow Generator)
Lokale import uitgeschakeld door de beheerder	De optie Importeren/Exporteren ontbreekt	Gebruik de implementatie door de beheerder

Er verschijnt een waarschuwing bij het laden van het manifest

Het manifest verwijst naar een URL waarvan de herkomst niet is opgegeven in de vertrouwde domeinen.

Oplossing: geef de herkomstop in Bedrijf → Aanpassing → Aangepaste manifestdomeinen.

Waarschuwing: het negeren van de waarschuwing lost het probleem niet op — de betreffende extensies zullen tijdens de uitvoering stilzwijgend mislukken.

Extensies worden niet weergegeven in de client

Mogelijke oorzaak	Oplossing
Manifest toegewezen, maar client niet opnieuw opgestart	Start Rainbow opnieuw op
Uitbreidingspunt wordt niet ondersteund op de client (web versus desktop)	Controleer de compatibiliteit van Web/Desktop-uitbreidingspunten in de documentatie
Maximaal aantal acties bereikt (3 per EP)	Verminder het aantal acties in het manifest
Lokale import overschreven door beheerdersmanifest	Verwacht gedrag — het beheerdersmanifest heeft voorrang

Lokale import is niet mogelijk (optie is grijs weergegeven of ontbreekt)

De beheerder heeft lokale import via het profiel uitgeschakeld. Neem contact op met de Rainbow-beheerder om toegang te verkrijgen of vraag om implementatie via de console.

Checklist voor implementatie vóór productie

JSON gevalideerd (geen syntaxisfout, "version": "2", "jsonType" aanwezig)
Manifest getest via lokale import op Rainbow Desktop en Web
Alle URL-bronnen zijn opgegeven in de Custo-manifest-domeinen
Indien lokale bronnen: ZIP-archief aangemaakt met custo-manifest.json in de hoofdmap
Manifest toegewezen aan de juiste gebruikers of profielen in de console