Questo articolo descrive come distribuire la sincronizzazione rubriche in Webex per Cisco BroadWorks. L'articolo è destinato agli amministratori di provider di servizi presso organizzazioni partner.
Panoramica sulla sincronizzazione delle rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex dell'app Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Questa funzione sincronizza le informazioni di chiamata BroadWorks che non erano parte del provisioning utente nella rubrica Webex .
Il provisioning utenti di Webex per Cisco BroadWorks aggiorna la rubrica Webex con i dettagli della chiamata per gli utenti di Webex per Cisco BroadWorks ( numero di telefono principale , numero numero cellulare, interno), ma omette i record delle chiamate esterne. Tuttavia, quando la sincronizzazione della rubrica è attiva, la funzione sincronizza anche i seguenti record delle chiamate nella rubrica Webex .
Utenti che chiamano solo BroadWorks (non presenti in Webex)
Entità chiamanti non utenti (ad esempio, un telefono di sala conferenze, un fax, un numero di gruppo di ricerca di risposta)
Voci dell'elenco telefonico BroadWorks
La tabella seguente riassume i record delle chiamate BroadWorks e mostra come vengono aggiunti alla rubrica Webex .
Record di chiamata BroadWorks |
Descrizione |
Aggiunto a Webex Directory tramite... |
---|---|---|
Webex per gli utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
Provisioning utente (es. provisioning flusso) |
Utenti che chiamano solo BroadWorks |
Chiamata per utenti che sono non integrato in Webex |
Sincronizzazione rubrica |
Entità chiamanti non utenti |
Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca |
Sincronizzazione rubrica |
Elenchi telefonici BroadWorks |
Voci dell'elenco telefonico BroadWorks:
|
Sincronizzazione rubrica (sincronizzazione dell'elenco telefonico) |
Per maggiori dettagli sul provisioning utente, vedere il Guida alla soluzione di Webex per Cisco BroadWorks .
|
Condizioni di sincronizzazione rubriche
Gli amministratori partner devono abilitare la funzione a livello di partner. Gli amministratori partner possono attivare o disattivare la funzione per più organizzazioni di clienti con una singola operazione.
Per impostazione predefinita, la sincronizzazione iniziale viene eseguita una settimana dopo l'abilitazione della sincronizzazione (l'ora scelta per avviare la sincronizzazione è casuale). Tuttavia, le organizzazioni clienti possono utilizzare il Sincronizza ora opzione per ignorare il periodo di attesa di una settimana e attivare una sincronizzazione immediata per una determinata organizzazione cliente.
Per impostazione predefinita, la sincronizzazione rubriche viene eseguita settimanalmente per ciascun cliente. Ogni sincronizzazione viene eseguita una settimana dopo l'ultima sincronizzazione, indipendentemente dal fatto che l'ultima sincronizzazione sia stata pianificata o attivata manualmente con Sincronizza ora .
Il numero massimo di sincronizzazioni simultanee per cluster BroadWorks è due: una sincronizzazione pianificata e una sincronizzazione su richiesta (tramite API o GUI di Partner Hub). Tuttavia, gli amministratori non possono eseguire due sincronizzazioni su richiesta contemporaneamente dallo stesso BroadWorks. Questa restrizione esiste indipendentemente dal fatto che la sincronizzazione sia stata avviata tramite l' API o tramite il Sincronizza ora opzione in Partner Hub. Inoltre, Webex non pianificherà due sincronizzazioni pianificate per l'esecuzione contemporaneamente dallo stesso BroadWorks.
Se si verifica un errore di sincronizzazione, Webex riprova automaticamente la sincronizzazione ogni 24 ore fino alla sincronizzazione successiva pianificata.
La sincronizzazione ignora gli utenti che non dispongono di un numero di telefono.
In Partner Hub, è possibile visualizzare le informazioni sullo stato di sincronizzazione per un determinato cliente. Inoltre, è possibile esportare informazioni dettagliate sull'ultima sincronizzazione in un record CSV . Il record CSV fornisce più dettagli rispetto alla visualizzazione di Control Hub e può essere utile nella risoluzione dei problemi, nell'analisi e nel controllo.
Webex memorizza i contatti utente in formato crittografato. Solo l'utente che possiede il contatto ha accesso alla chiave di decrittografia.
Per gli utenti chiamanti solo BroadWorks e le entità chiamanti non utenti, questa funzione sincronizza i seguenti tipi di numero di telefono da BroadWorks:
Numero di telefono principale
Numero telefono cellulare
Estensione
Tuttavia, la sincronizzazione esclude gli utenti chiamanti solo BroadWorks e le entità chiamanti non utenti dalla sincronizzazione se non è presente un numero di telefono principale o un interno.
Elenco telefonico e numero massimo di contatti BroadWorks
La sincronizzazione rubriche sincronizza anche le voci dell'elenco telefonico BroadWorks nei contatti Webex . Le voci sincronizzate vengono aggiunte a uno dei seguenti tipi di contatto:
Contatti organizzazione: Webex memorizza questi contatti in base a un'organizzazione. Ogni utente può accedere ai contatti dell'organizzazione per la propria organizzazione. Il numero massimo è fino a 30000 contatti.
Contatti utente: Webex memorizza questi contatti rispetto a un utente. Solo l'utente che possiede il contatto può accedere alla voce del contatto. Il numero massimo di contatti è 2000 (1500 contatti sincronizzati + 500 contatti ad inserimento manuale).
Solo le voci dell'elenco telefonico vengono aggiunte ai contatti Webex . Gli utenti chiamanti solo BroadWorks e le entità chiamanti non utenti incluse nella sincronizzazione rubrica non vengono aggiunti ai contatti a meno che un utente Webex non li aggiunga manualmente ai contatti.
|
La tabella seguente associa i tipi di contatti Webex all'origine del contatto (sincronizzata da un elenco telefonico BroadWorks o aggiunta manualmente):
Tipo di contatto Webex |
Origine contatto |
Massimo |
Sincronizzato da BroadWorks... |
API utilizzata per la sincronizzazione |
---|---|---|---|---|
Contatti organizzazione |
Sincronizzazione rubrica |
30000 contatti |
Elenchi telefonici comuni Enterprise |
|
Elenchi telefonici comuni di gruppo (per un gruppo di provider di servizi)** |
|
|||
Contatti utente |
Sincronizzazione rubrica |
1500 contatti |
Elenchi telefonici personali |
/directories/personal |
Aggiunto manualmente dall'utente |
500 contatti |
N/A |
N/A |
|
Raggruppa i contatti |
Sincronizzazione rubrica |
30000 contatti per gruppo |
Elenchi telefonici comuni di gruppo (per un gruppo Enterprise)** |
/directories/groupcommon |
**Le voci di gruppi di elenchi telefonici comuni vengono sincronizzate in modo diverso a seconda che BroadWorks sia in modalità Enterprise o in modalità provider di servizi. Il valore di
|
Le seguenti condizioni si applicano al modo in cui la sincronizzazione rubriche gestisce i numeri massimi di contatti:
Se un'organizzazione supera il numero massimo di contatti consentiti per la sincronizzazione (30000 contatti dell'organizzazione o 30000 contatti comuni di gruppo per gruppo), la sincronizzazione della rubrica esclude le voci al di sopra della soglia massima. Non esiste un ordine particolare applicato ai contatti sincronizzati od omessi.
Se uno dei clienti supera il numero massimo di contatti consentito in una delle categorie, si consiglia di sollevare un caso con Cisco per escludere l'organizzazione dalla sincronizzazione rubriche.
I contatti manuali sono contatti che un utente aggiunge manualmente sull'app Webex . Un utente può aggiungere fino a 500 contatti manuali. I contatti manuali rientrano nella categoria di contatti utente più grande su Webex, ma non sono inclusi nella sincronizzazione.
Il limite generale combinato per i contatti dell'organizzazione (30000) e i contatti di gruppo (30000 per gruppo) è 200000.
Aggiornamenti
Di seguito la modalità di gestione degli aggiornamenti nella rubrica Webex :
Se il nome contatto cambia su BroadWorks, il contatto esistente viene eliminato dalla rubrica Webex e ne viene creato un nuovo contatto.
Se il numero di contatto cambia su BroadWorks, Webex aggiorna il contatto esistente nella rubrica Webex con il nuovo numero.
Quando un amministratore aggiorna un contatto su BroadWorks, le seguenti condizioni delineano quando l'aggiornamento viene visualizzato nell'app Webex di un utente:
Se l'aggiornamento è per un utente chiamante solo BroadWorks o un'entità chiamante non utente, l'aggiornamento viene visualizzato nell'app Webex di un utente immediatamente dopo la sincronizzazione della rubrica successiva.
Se l'aggiornamento è relativo a una voce dell'elenco telefonico BroadWorks:
Per i contatti utente: gli aggiornamenti vengono visualizzati nell'app Webex dell'utente immediatamente dopo la successiva sincronizzazione della rubrica.
Per i contatti di gruppo: gli aggiornamenti vengono visualizzati nell'app Webex degli utenti immediatamente dopo la sincronizzazione della rubrica successiva.
Per i contatti dell'organizzazione: la rubrica Webex viene aggiornata alla successiva sincronizzazione della rubrica, ma gli utenti non visualizzeranno la modifica nell'app Webex finché non riavviano l'app Webex o fino alla scadenza del timer della cache locale di 72 ore.
Gli aggiornamenti informazioni utente di Webex per Cisco BroadWorks vengono gestiti come parte dei processi di provisioning.
|
Control Hub contiene un'opzione per aggiungere o modificare i contatti a livello di organizzazione in Control Hub tramite un file CSV. Gli amministratori partner e gli amministratori dei clienti con accesso a Control Hub possono accedere a questa opzione. Tuttavia, l'aggiornamento dei contatti tramite Control Hub non è supportato da Webex per Cisco BroadWorks. Gli aggiornamenti dei contatti applicati in Control Hub non vengono sincronizzati nuovamente in BroadWorks e non sono disponibili per le ricerche nella rubrica dai telefoni della scrivania.
|
Prerequisiti per la sincronizzazione delle rubriche
Si consiglia di utilizzare le seguenti impostazioni:
Gli esempi seguenti presuppongono l'uso di un server XSP. Per i server ADP, sostituire (XSP_ CLI) con (ADP_ CLI).
|
Valori limite di velocità: impostare le seguenti proprietà del sistema OverloadControl (XSP_ CLI/Applicazioni/Xsi-Azioni/OverloadControl):
userDirectoryTransactionLimit: impostato su un valore null.
globalDirectoryTransactionLimit: impostato su un valore null.
È consigliabile impostare userDirectoryTransactionLimit e globalDirectoryTransactionLimit su un valore null. Tuttavia, se non si decide di assegnare valori, ciascuno deve essere impostato su almeno cinque volte il valore di TransactionLimitPeriodSeconds (che deve essere 1).Limiti transazione: impostare i seguenti valori (XSP_ CLI/Sistema/CommunicationUtility/DefaultSettings):
userTransactionLimit: impostato su almeno 100.
TransactionLimitPeriodSecs: impostato su 1.
Valori di cercapersone: impostare le proprietà del sistema di cercapersone (XSP_ CLI/Applicazioni/Xsi-Actions/Paging):
defaultPageSize: impostato su 50
availableUserMaxLimit: impostato su 100
Interfaccia CTI : assicurarsi di caricare i certificati CA Webex nell'archivio attendibile dell'interfaccia CTI e di abilitare l'autenticazione client sull'interfaccia CTI .
Inoltre, a seconda della release di BroadWorks, si consiglia di applicare le seguenti patch di sistema alla distribuzione di BroadWorks prima di abilitare questa funzione:
Per R22:
AP.as.22.0.1123.ap368517
Per R23:
AP.as.23.0.1075.ap368517
Per R24: non è richiesta alcuna patch
Abilita sincronizzazione rubriche (nuovo modello)
Gli amministratori partner possono abilitare la sincronizzazione rubriche per un modello cliente durante la creazione del nuovo modello. Qualsiasi nuova organizzazione cliente che viene assegnata a tale modello avrà la sincronizzazione rubriche abilitata. Per i dettagli, vedere "Configurazione dei modelli cliente" in Configura l'organizzazione partner in Partner Hub all'interno del Guida alla soluzione per Webex per Cisco BroadWorks .
Operazioni successive
Assicurarsi che gli utenti sappiano che devono fare clic su Contatti sull'app Webex almeno una volta per attivare la funzione sull'app Webex . Questa operazione deve essere completata una sola volta.
Abilita sincronizzazione rubriche (modello esistente)
1 | Accedere a Partner Hub e scegliere Impostazioni . |
||
2 | Scorrere fino a BroadWorks Calling e fare clic Visualizza modelli . |
||
3 | Selezionare il modello cliente appropriato e scorrere fino a Sincronizzazione rubrica BroadWorks . |
||
4 | Per abilitare la sincronizzazione delle rubriche per impostazione predefinita per le nuove organizzazioni di clienti che utilizzano questo modello:
|
||
5 | Per abilitare la sincronizzazione delle rubriche per le organizzazioni di clienti esistenti che utilizzano questo modello:
|
Operazioni successive
Assicurarsi che gli utenti sappiano che devono fare clic su Contatti sull'app Webex almeno una volta per attivare la funzione sull'app Webex . Questa operazione deve essere completata una sola volta.
Attiva la sincronizzazione immediata
1 | Accedi a Partner Hub (http://admin.webex.com ) e scegliere Impostazioni . |
2 | Scorrere fino a BroadWorks Calling e fare clic Visualizza modelli . |
3 | Selezionare il modello cliente appropriato e scorrere fino a Sincronizzazione rubrica BroadWorks . |
4 | Fare clic su Mostra l'elenco di stati di sincronizzazione dei clienti . |
5 | Per l'organizzazione del cliente che si desidera sincronizzare, fare clic sui tre punti all'estrema destra e selezionare Sincronizza ora . |
6 | Fare clic su Aggiorna per visualizzare i risultati della sincronizzazione. |
Esporta Sincronizza record in CSV
1 | Accedi a Partner Hub (http://admin.webex.com ) e scegliere Impostazioni . |
2 | Scorrere fino a BroadWorks Calling e fare clic Visualizza modelli . |
3 | Selezionare il modello cliente appropriato e scorrere fino a Sincronizzazione rubrica BroadWorks . |
4 | Fare clic su Mostra l'elenco di stati di sincronizzazione dei clienti . |
5 | Selezionare le caselle di controllo adiacenti per ciascuna organizzazione che si desidera includere nell'esportazione. |
6 | Fare clic su Esporta risultati . |
API pubbliche per la sincronizzazione rubriche
Le API pubbliche sono disponibili il sviluppatore.webex.com che consentono agli amministratori partner di aggiornare le impostazioni di sincronizzazione delle rubriche per le organizzazioni del cliente che gestiscono, di attivare una sincronizzazione immediata o ottenere informazioni sullo stato della sincronizzazione. I metodi di sincronizzazione delle rubriche sono raggruppati in BroadWorks Enterprises :
Elencare BroadWorks Enterprises —Utilizzare questo metodo API per ottenere un elenco di aziende di un determinato provider di servizi e di ciascuna azienda
id
. È necessario immettere ilspEnterpriseId
come assegnato nel provisioning.Sincronizzazione rubrica di aggiornamento per BroadWorks Enterprise —Inserire l'azienda
id
per aggiornare lo stato di sincronizzazione delle rubriche per tale organizzazione, abilitando o disabilitando la sincronizzazione delle rubriche.Attivare la sincronizzazione delle rubriche per un'azienda —Utilizzare questo metodo API se si desidera attivare una sincronizzazione immediata per una determinata azienda
id
. Per ilsyncStatus
, immettereSYNC_NOW
comando.Ottenere lo stato di sincronizzazione della rubrica per un'azienda —Inserire l'azienda
id
ed eseguire per ottenere uno stato etrackingId
dell'ultima sincronizzazione. È possibile utilizzare iltrackingID
per eseguire analisi aggiuntive tramite strumenti come Kibana e Grafana.
Inoltre, gli amministratori possono utilizzare il file Attiva la sincronizzazione della rubrica per un singolo utente API per attivare una sincronizzazione directory su richiesta per un singolo utente.
Per la documentazione dettagliata API , vederehttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Sincronizza più aziende con l' API
|
1 | Eseguire il Elencare BroadWorks Enterprises API per generare un elenco di aziende che si desidera sincronizzare.
|
2 | Eseguire il Attivare la sincronizzazione delle rubriche per un'azienda API sulla prima organizzazione nell'elenco. |
3 | Attendere alcuni secondi, quindi eseguire il Ottenere lo stato di sincronizzazione della rubrica API per ottenere lo stato della sincronizzazione.
|
4 | Al termine della sincronizzazione, completare i passaggi da 2 a 4 per l'organizzazione successiva nell'elenco. Ripetere questa procedura fino a quando non è stato sincronizzato l'intero elenco. |
Codici di errore per la sincronizzazione rubriche
I seguenti codici di errore si applicano a Sincronizzazione rubriche.
Codice errore |
Messaggio di errore |
---|---|
600000 |
Errore imprevisto di sincronizzazione utenti rubriche esterne Broadworks. |
600001 |
Sincronizzazione utenti rubriche esterne BroadWorks non riuscita. |
600002 |
È stato necessario terminare la sincronizzazione utenti rubriche esterne BroadWorks prima del completamento. |
600003 |
Sincronizzazione utenti rubriche esterne BroadWorks riuscita solo parzialmente. Alcune organizzazioni cliente non sono state sincronizzate. |
600004 |
Sincronizzazione utenti rubriche esterne BroadWorks non abilitata per ConfigSet. |
600005 |
Sincronizzazione utenti rubriche esterne BroadWorks in corso per ConfigSet. |
600006 |
I thread di sincronizzazione utenti rubriche esterne BroadWorks sono occupati o in fase di arresto, pertanto non verranno accettate altre richieste di sincronizzazione; riprova successivamente. |
600007 |
Organizzazione identità di CustomerConfig non trovata. |
600008 |
CustomerConfig non trovato nell'organizzazione partner. |
600009 |
Impossibile eseguire la sincronizzazione utenti rubriche esterne BroadWorks perché il cluster BroadWorks associato a CustomerConfig è occupato |
600010 |
La sincronizzazione utenti rubriche esterne BroadWorks non può essere eseguita poiché non è presente alcun cluster BroadWorks associato a CustomerConfig. |
600011 |
Sincronizzazione utenti rubriche esterne BroadWorks non abilitata per CustomerConfig. |
600012 |
La sincronizzazione utenti rubriche esterne Broadworks non può essere eseguita poiché la sincronizzazione delle rubriche ibride è già abilitata per CustomerConfig |
600013 |
La sincronizzazione utenti rubriche esterne BroadWorks non è riuscita ad aggiungere utenti e account macchina all'archivio identità. |
600014 |
Sincronizzazione utenti rubriche esterne Broadworks non riuscita durante il tentativo di connessione al cluster Broadworks. Errore da Broadworks - %s. |
600015 |
La sincronizzazione utenti rubriche esterne Broadworks non ha trovato alcun utente corrispondente nell'archivio identità. |
600017 |
La sincronizzazione dell'elenco telefonico BroadWorks non è riuscita a sincronizzare tutti i contatti utente e aziendale/organizzazione. |
600018 |
Sincronizzazione elenco telefonico BroadWorks non riuscita per gli utenti dell'azienda/organizzazione. |
600019 |
La sincronizzazione dell'elenco telefonico BroadWorks non è riuscita a sincronizzare i contatti dell'azienda/organizzazione. |
600020 |
Impossibile disabilitare la sincronizzazione utenti rubriche esterne BroadWorks poiché è In corso la sincronizzazione di CustomerConfig . |
600022 |
La sincronizzazione utente singolo della rubrica esterna BroadWorks non è possibile poiché l'azienda non dispone di un provisioning utente. |
600023 |
La sincronizzazione utente singolo della rubrica esterna BroadWorks non è possibile poiché l'utente esiste già in questa organizzazione. |
600024 |
La sincronizzazione utente singolo della rubrica esterna BroadWorks non è possibile poiché non è stato trovato nessun utente corrispondente in BroadWorks. |
600025 |
Sincronizzazione utenti rubriche esterne BroadWorks non è riuscito ad aggiornare l'account utente in CI. |
600026 |
Sincronizzazione utenti rubriche esterne BroadWorks non è riuscita ad aggiornare l'account macchina in CI. |
600027 |
La sincronizzazione utente singolo della rubrica esterna BroadWorks non è possibile poiché in BroadWorks sono stati trovati più utenti. |
600028 |
La sincronizzazione utente singolo della rubrica esterna BroadWorks non è possibile poiché almeno una sincronizzazione della rubrica aziendale dovrebbe essere stata completata. |
600029 |
Sincronizzazione utenti rubriche esterne BroadWorks non riuscita poiché l'azienda non dispone di un provisioning utente. |
Cronologia delle modifiche
Nella tabella seguente vengono riepilogati gli aggiornamenti apportati a questo articolo.
Data |
Revisione |
---|---|
14 febbraio 2023 |
Aggiornato Massime e origine di sincronizzazione delle rubriche sezione. |
10 dicembre 2022 |
Aggiornato il termine Sincronizzazione immediata completata a Attiva sincronizzazione rubrica |
19 luglio 2022 |
Chiarimenti e correzioni alle informazioni generali:
|
09 maggio 2022 |
|
07 aprile 2022 |
|
28 marzo 2022 |
|
24 marzo 2022 |
Aggiunto elenco di tipi di numero di telefono sincronizzati a Condizioni di sincronizzazione rubriche . La sincronizzazione ora include i numeri cellulare . |
16 marzo 2022 |
|
17 dicembre 2021 |
|
16 dicembre 2021 |
|
08 dicembre 2021 |
|