Panoramica sulla sincronizzazione delle rubrica

La sincronizzazione delle directory assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica chiamate completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e chiamare qualsiasi entità chiamante dal server BroadWorks.

La sincronizzazione delle directory include la sincronizzazione delle informazioni di chiamata dell'utente nonché degli elenchi telefonici. I record dell'elenco telefonico sincronizzati vengono scritti in uno di due tipi di contatto all'interno della rubrica Webex:

  • Contatti organizzazione: questi contatti vengono memorizzati in un'organizzazione e sono disponibili per ogni utente nell'organizzazione.

  • Contatti utente: questi contatti vengono memorizzati in base a un utente e sono disponibili solo all'utente proprietario del contatto.


Webex per il provisioning Cisco BroadWorks include una sincronizzazione predefinita degli utenti di messaggistica e le informazioni di chiamata associate dal server BroadWorks alla rubrica Webex. Tuttavia, la sincronizzazione di provisioning predefinita omette gli utenti non di messaggistica e le entità non utente (ad esempio, un telefono sala conferenze, un fax o un gruppo di risposta numero). L'attivazione della sincronizzazione delle directory assicura che tutte le entità chiamanti vengono aggiunte alla rubrica Webex.

Condizioni di sincronizzazione rubrica

  • Gli amministratori dei partner devono attivare la funzione a livello di partner. Gli amministratori dei partner possono attivare o disattivare la funzione per più organizzazioni clienti con una sola operazione.

  • Per impostazione predefinita, la sincronizzazione iniziale viene eseguita una settimana dopo l'abilitazione della sincronizzazione (il tempo scelto per avviare la sincronizzazione è casuale). Tuttavia, le organizzazioni dei clienti possono utilizzare l'opzione Sincronizza ora per ignorare il periodo di attesa di una settimana e completare una sincronizzazione immediata per una determinata organizzazione cliente.

  • Per impostazione predefinita, la sincronizzazione delle directory viene eseguita settimanalmente per ciascun cliente. Ciascuna sincronizzazione viene eseguita una settimana dopo l'ultima sincronizzazione, indipendentemente se tale sincronizzazione è stata pianificata o attivata manualmente con Sincronizzaora.

  • Se si verifica un errore di sincronizzazione, la sincronizzazione viene risincronizzazione automaticamente ogni 24 ore fino alla successiva sincronizzazione pianificata.

  • La sincronizzazione ignora gli utenti che non dispongono di un numero di telefono.

  • In Partner Hub, è possibile visualizzare le informazioni sullo stato della sincronizzazione per un determinato cliente. Inoltre, è possibile esportare informazioni dettagliate sull'ultima sincronizzazione con un record CSV. Il record CSV è più dettagliato rispetto alla visualizzazione di Control Hub e consente di risolvere problemi, analisi e audit.

  • I contatti utente vengono memorizzati in un formato crittografato solo con l'utente proprietario del contatto che ha accesso alla chiave di decrittografia.

  • Questa funzione sincronizza i seguenti tipi di elenco di telefoni dal server BroadWorks:

    • Elenchi di telefoni comuni aziendali

    • Elenchi dei telefoni comuni di gruppo

    • Elenchi telefonici personali

Valori massimi di sincronizzazione rubrica e contatti

Di seguito viene riportato il numero massimo di contatti che la sincronizzazione rubrica consente per ciascun tipo di contatto Webex:

  • 500 contatti organizzazione

  • 500 contatti utente: per un utente, il valore massimo include contatti utente sincronizzati e contatti manuali (contatti aggiunti manualmente tramite l'app Webex)

Si applicano le seguenti condizioni:

  • Se un'organizzazione ha più di 500 contatti in una delle due categorie, la sincronizzazione esclude le voci superiori alla soglia di 500 contatti. Nessun ordine particolare applicato ai contatti sincronizzati o omessi.

  • Se un utente aggiunge manualmente i contatti nell'app Webex, il numero massimo di contatti dell'utente è determinato dalla sottrazione manuale dei contatti manuali dai contatti utente sincronizzati. Ad esempio, se un utente aggiunge manualmente 100 contatti nell'app Webex, la sincronizzazione delle directory consente la sincronizzazione di fino a 400 contatti utente da BroadWorks per tale utente.

  • Si consiglia di generare un caso se una delle organizzazioni clienti contiene più di 500 contatti in una delle due categorie, generare un caso con Cisco per fare in modo che tale organizzazione sia esclusa dalla sincronizzazione delle rubrica.

La tabella seguente associa i tipi di contatto Webex all'elenco telefonico BroadWorks da cui vengono sincronizzati i record:

Tabella 1. Tipi di contatto Sincronizzazione rubrica e Origine sincronizzazione

Tipo di contatto Webex

Sincronizzazione da BroadWorks...

API utilizzata per la sincronizzazione

Contatti organizzazione

Elenchi di telefoni comuni aziendali

/directories/enterprisecommon

Elenchi di telefoni comuni di gruppo (durante la provider di servizi mobile)**

/directories/groupcommon

Contatti utente

Elenchi di telefoni comuni di gruppo (durante la modalità Enterprise)**

/directories/groupcommon

Elenchi telefonici personali

/directories/personal


**Gli elenchi di telefoni comuni del gruppo vengono sincronizzati in modo diverso a seconda che BroadWorks sia in modalità Enterprise o provider di servizi interattiva. Il valore della casella di controllo isBroadWorksEnterprise il parametro (vero o falso) determina la modalità di sincronizzazione dell'elenco:

  • True: esegue la sincronizzazione come contatto dell'organizzazione

  • False: sincronizza come contatto utente

Aggiornamenti

Dopo aver aggiornato un contatto su BroadWorks, le seguenti informazioni vengono visualizzate quando l'aggiornamento viene visualizzato nell'app Webex di un utente:

  • Gli aggiornamenti dei contatti dell'organizzazione vengono visualizzati nell'app Webex dopo che l'utente ha riavviato l'app o dopo la scadenza del timer della cache di 72 ore locale dell'app.

  • Gli aggiornamenti dei contatti dell'utente vengono visualizzati immediatamente nell'app Webex per tale utente.

Di seguito viene descritto come la rubrica Webex gestisce gli aggiornamenti:

  • Se il nome del contatto cambia su BroadWorks, il contatto esistente viene eliminato dalla directory Webex e viene creato un nuovo contatto.

  • Se il numero del contatto cambia su BroadWorks, il contatto esistente nella rubrica Webex viene aggiornato con il nuovo numero.

Prerequisiti sincronizzazione rubrica

Requisiti di attivazione/disattivazione

Per questa funzione esistono i seguenti interruttori di funzione. Contattare il rappresentante Webex per Cisco BroadWorks per impostare questi elementi.

Attiva/disattiva funzione

Applicato a...

Disattivazione scripton

webex-for-broadworks-phone-list-sync

Partner

Attivazione/disattivazione obbligatoria. Abilita la sincronizzazione dell'elenco telefonico per tutte le organizzazioni cliente in questo partner.

Deve essere abilitato.

webex-for-broadworks-phone-list-sync-disable

Organizzazione cliente

Interruttore opzionale. Disabilita la sincronizzazione dell'elenco dei telefoni per una determinata organizzazione, anche se la funzione è abilitata a livello di partner e nel modello del cliente.

Applicare questa opzione/disattivazione solo se si desidera disabilitare la sincronizzazione dell'elenco telefonici per una specifica organizzazione cliente. Altrimenti, è possibile lasciarla disabilitata.


 
Ad esempio, è necessario applicare questo interruttore a qualsiasi organizzazione che richiede più di 500 contatti.

hidden-personal-contacts-enabled-ga

Utente

Interruttore opzionale. Nasconde i contatti personali alle ricerche nella rubrica completate da questo utente.

hidden-org-contacts-enabled-ga

Utente

Interruttore opzionale. Nasconde i contatti dell'organizzazione alle ricerche nelle directory completate da questo utente.

Requisiti di preconfigurazione

Si consiglia di utilizzare le seguenti impostazioni:


Gli esempi seguenti presuppongono che si utilizzi un server XSP. Per i server ADP, sostituire (XSP_CLI) con (ADP_CLI).
  • Valori limite velocità—Impostare le seguenti proprietà di sistema OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryLimit: impostare su un valore nullo.

    • globalDirectoryLimit: impostata su un valore nullo.


    Si consiglia di impostare userDirectoryLimit e globalDirectoryLimit su un valore nullo. Tuttavia, se si decide di assegnare i 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/System/CommunicationUtility/DefaultSettings):

    • userLimit: impostare almeno 100.

    • transactionLimitPeriodSecs: impostata su 1.

  • Valori di cercapersone— Impostare le proprietà del sistema di cercapersone (XSP_CLI/Applicazioni/Xsi-Azioni/Cercapersone):

    • defaultPageSize—Imposta su 50

    • availableUserMaxLimit: impostato su 100

  • Interfaccia CTI: accertarsi di caricare i certificati CA Webex nell'archivio di attendibilità dell'interfaccia CTI e abilitare l'autenticazione del client sull'interfaccia CTI.

Inoltre, in base alla release BroadWorks in uso, si consiglia di applicare le seguenti patch di sistema alla distribuzione BroadWorks prima di abilitare questa funzione:


Per un elenco completo dei requisiti di patch che formano il requisito minimo per Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella Guida alla soluzione per Webex per CiscoBroadWorks.

Abilita sincronizzazione rubrica (nuovo modello)

Gli amministratori dei partner possono abilitare la sincronizzazione delle directory per un modello del cliente durante la creazione del nuovo modello. Per tutte le nuove organizzazioni clienti assegnate a tale modello, la sincronizzazione delle directory sarà abilitata. Per informazioni dettagliate, vedere "Configurazione dei modelli cliente" in Configurazione dell'organizzazione partner in Partner Hub all'interno della Guida alla soluzione per Webex per CiscoBroadWorks.

Operazioni successive

Accertarsi che gli utenti sappiano che devono fare clic sulla scheda Contatti nell'app Webex almeno una volta per attivare la funzione sull'app Webex. Questa operazione deve essere completata una sola volta.

Abilita sincronizzazione rubrica (modello esistente)

Gli amministratori dei partner possono completare le seguenti operazioni per attivare la sincronizzazione delle rubrica all'interno di un modello cliente esistente al fine di abilitare la funzione per le organizzazioni dei clienti che utilizzano il modello.

1

Accedere all'hub partner e scegliere Impostazioni.

2

Scorrere fino a BroadWorks Calling e fare clic su View Templates (Visualizzamodelli).

3

Selezionare il modello del cliente appropriato e scorrere fino a Sincronizzazione rubricaBroadWorks.

4

Per abilitare per impostazione predefinita la sincronizzazione delle cartelle per i nuovi clienti che utilizzano questo modello:

  1. Impostare l'opzione Abilita sincronizzazione elenco elenchi telefonici e rubrica BroadWorks per tutte le nuove organizzazioni cliente su Attivato.

  2. Fare clic su Salva.

5

Per abilitare la sincronizzazione delle rubrica per le organizzazioni dei clienti esistenti che utilizzano questo modello:

  1. Fare clic su Show list of customers sync status (Mostra elenco di sincronizzazioneclienti) .

  2. Selezionare le caselle di controllo accanto a ciascuna organizzazione per cui si desidera attivare la funzione.

  3. Fare clic su Enable Sync (Abilita sincronizzazione).


 

Se si desidera disabilitare la sincronizzazione delle directory, seguire la procedura precedente e:

  • Al punto 4a, impostare l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti su Disattiva per disabilitare automaticamente la sincronizzazione delle rubrica per le nuove organizzazioni clienti che utilizzano questo modello.

  • Al punto 5c, fare clic su Disabilita sincronizzazione per disattivare la funzione per le organizzazioni esistenti.

Operazione successivi

Accertarsi che gli utenti sappiano che devono fare clic sulla scheda Contatti nell'app Webex almeno una volta per attivare la funzione sull'app Webex. Questa operazione deve essere completata una sola volta.

Completa sincronizzazione immediata

L'opzione Sincronizza ora consente all'amministratore del partner di completare una sincronizzazione su richiesta per una determinata organizzazione cliente. Questa opzione può essere selezionata solo per le singole organizzazioni dei clienti; non è presente alcuna opzione di massa per la sincronizzazione ora.

1

Accedere all'hub partner (http://admin.webex.com) e scegliere Impostazioni.

2

Scorrere fino a BroadWorks Calling e fare clic su View Templates (Visualizzamodelli).

3

Selezionare il modello del cliente appropriato e scorrere fino a Sincronizzazione rubricaBroadWorks.

4

Fare clic su Show list of customers sync status (Mostra elenco di sincronizzazioneclienti) .

5

Per l'organizzazione del cliente che si desidera sincronizzare, fare clic sui tre puntini all'estrema destra e selezionare Sincronizzaora.

6

Fare clic su Refresh (Aggiorna) per visualizzare i risultati della sincronizzazione.

Esporta record di sincronizzazione in CSV

Gli amministratori dei partner possono esportare informazioni dettagliate sull'ultima sincronizzazione con un file CSV. Il file CSV contiene una vista più dettagliata del record di sincronizzazione rispetto alla GUI di Control Hub e può essere di aiuto nella risoluzione dei problemi e nelle analisi.

1

Accedere all'hub partner (http://admin.webex.com) e scegliere Impostazioni.

2

Scorrere fino a BroadWorks Calling e fare clic su View Templates (Visualizzamodelli).

3

Selezionare il modello del cliente appropriato e scorrere fino a Sincronizzazione rubricaBroadWorks.

4

Fare clic su Show list of customers sync status (Mostra elenco di sincronizzazioneclienti) .

5

Selezionare le caselle di controllo accanto a ciascuna organizzazione che si desidera includere nell'esportazione.

6

Fare clic su Export results (Esportarisultati).

API pubbliche per la sincronizzazione delle directory

Api pubbliche sono disponibili sul developer.webex.com che consentono agli amministratori dei partner di aggiornare le impostazioni di sincronizzazione delle directory per le organizzazioni dei clienti gestite, attivare una sincronizzazione immediata o ottenere informazioni sullo stato della sincronizzazione. I metodi di sincronizzazione delle directory vengono raggruppati sotto Aziende BroadWorks. Sono disponibili quattro API:

  • Elenca aziende BroadWorks — Utilizzare questo metodo API per ottenere un elenco delle aziende sotto una determinata provider di servizi e il sistemaaziendale id. È necessario immettere il spEnterpriseId come assegnato nel provisioning.

  • Aggiornamento della sincronizzazione delle directory per un'aziendaBroadWorks— Inserire l'azienda id per aggiornare lo stato syc della rubrica per tale azienda, abilitando o disabilitando la sincronizzazione delle directory.

  • Attiva sincronizzazione rubrica per un'azienda:utilizzare questo metodo API se si desidera attivare una sincronizzazione immediata per una determinata azienda id. Per la syncStatus, inserire SYNC_NOW Comando.

  • Ottieni stato di sincronizzazione rubrica per un'azienda:inserire l'azienda id ed eseguire per ottenere uno stato e trackingId dell'ultima sincronizzazione. È possibile utilizzare trackingID eseguire funzionalità di analisi aggiuntive attraverso strumenti come Kibana e Grafana.

Per informazioni dettagliate sulla documentazione API, vedere https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Sincronizzazione di più aziende con API

Completare questa procedura per utilizzare le API pubbliche per completare la sincronizzazione delle directory per più aziende.

  • La sincronizzazione delle directory consente di sincronizzare una sola azienda alla volta. Se si tenta di sincronizzare più di una azienda, si riceverà un errore 429.

  • Il tempo necessario per completare una sincronizzazione per una singola azienda varia in base alla dimensione dell'azienda.

1

Eseguire l'API di List BroadWorks Enterprises per generare un elenco di aziende che si desidera sincronizzare.

  1. Impostare startWith sulla stringa iniziale dell'identificativo dell'azienda o del provider di servizi.

  2. Fare clic su Correre.

2

Eseguire il trigger della sincronizzazione delle directory per un'API aziendale sulla prima azienda nell'elenco.

  1. Immettere l'IDaziendale.

  2. Imposta syncStatus su SYNC_NOW

  3. Fare clic su Correre.

    Viene attivata una sincronizzazione immediata per l'azienda. Questa sincronizzazione conta in base al limite di una sincronizzazione per istanza.
3

Attendere alcuni secondi, quindi eseguire l'API Ottieni stato sincronizzazione rubrica per ottenere lo stato di sincronizzazione.

  1. Inserire l'ID aziendale

  2. Fare clic su Correre.

4

Al termine della sincronizzazione, completare i passaggi da 2 a 4 nella successiva azienda nell'elenco. Ripetere queste operazioni finché non si sincronizza l'intero elenco.

Codici di errore per Sincronizzazione rubrica

I seguenti codici di errore si applicano alla sincronizzazione delle rubrica.

Codice errore

Messaggio di errore

600000

Errore imprevisto della sincronizzazione utente delle rubrica esterne Broadworks.

600001

Sincronizzazione utente rubrica esterna Broadworks non riuscita.

600002

La sincronizzazione utente delle directory esterne Broadworks deve essere terminata prima del completamento.

600003

Sincronizzazione utente rubrica esterna Broadworks riuscita solo parzialmente. Sincronizzazione di alcune organizzazioni cliente non riuscita.

600004

Sincronizzazione utente rubrica esterna Broadworks non abilitata per ConfigSet.

600005

Sincronizzazione utente rubrica esterna Broadworks in corso per ConfigSet.

600006

Le discussioni di sincronizzazione utente delle directory esterne sono occupate o in fase di arresto. Pertanto, non accetterà ulteriori richieste di sincronizzazione. Riprovare successivamente.

600007

Organizzazione identità ClienteConfig non trovata.

600008

CustomerConfig non trovato nell'organizzazione partner.

600009

La sincronizzazione utenti rubrica esterna Broadworks non può essere eseguita poiché il cluster broadworks associato a CustomerConfig è occupato

600010

Non è possibile eseguire la sincronizzazione utenti rubrica esterna Broadworks poiché non esiste un cluster Broadworks associato a CustomerConfig.

600011

La sincronizzazione utenti rubrica esterna Broadworks non è abilitata per CustomerConfig.

600012

Impossibile eseguire la sincronizzazione utenti rubrica esterna Broadworks poiché la sincronizzazione delle directory ibride è già abilitata per CustomerConfig.

600013

Sincronizzazione utente rubrica esterna Broadworks non è riuscita ad aggiungere utenti e account macchina all'archivio delle identità.

600014

Sincronizzazione utente rubrica esterna Broadworks non riuscita nel tentativo di connettersi al cluster Broadworks. Errore di Broadworks - %s.

600015

Sincronizzazione utente rubrica esterna Broadworks non ha trovato alcun utente corrispondente nell'archivio di identità.

600017

Sincronizzazione dell'elenco telefonici BroadWorks non riuscita a tutti i contatti utente/aziendale/organizzazione.

600018

Sincronizzazione dell'elenco telefonici BroadWorks non riuscita per gli utenti dell'azienda/organizzazione.

600019

Sincronizzazione dell'elenco telefonici BroadWorks non riuscita a sincronizzare i contatti aziendali/aziendali.