API esterne

Il software per la gestione delle associazioni Webling mette a disposizione un’API che può essere integrata con VOLAGIC.

Webling

Per collegare VOLAGIC e Webling, dovete innanzitutto generare una chiave API in Webling. Nella navigazione principale, andate su «Amministrazione». Nella navigazione laterale, sotto «Gestione abbonamento», trovate la voce «API». Qui potete aggiungere una descrizione per la chiave e gestire i diritti di accesso. VOLAGIC necessita dell’accesso ai dati dei membri. Avete le seguenti opzioni:

• Leggi tutti i membri – VOLAGIC può recuperare i dati di tutti i membri da Webling
• Leggi e modifica tutti i membri – VOLAGIC può recuperare e modificare i dati di tutti i membri
• Personalizzato – Definite quali Gruppi di membri devono essere resi disponibili e per quali devono essere applicati diritti di lettura o scrittura

Contabilità, appuntamenti e materiale non devono essere resi accessibili.

Una volta creata la chiave, la trovate nell’elenco e potete copiarla facendo clic sull’icona della chiave nella finestra di modifica.

VOLAGIC

Dopo aver copiato la chiave da Webling, potete fare clic sul pulsante «Configura ora» in VOLAGIC. In VOLAGIC potete quindi definire nuovamente quali diritti ha VOLAGIC sui dati di Webling (diritti di lettura o scrittura). IMPORTANTE: se in Webling avete concesso solo diritti di lettura, non potete attivare i diritti di scrittura in VOLAGIC. Inserite quindi il vostro sottodominio Webling e la chiave corrispondente, quindi fate clic su «Salva».

Modificare l’assegnazione dei campi degli Assistenti

Ora accedete all’assegnazione dei campi degli Assistenti. Collegate i campi Webling che desiderate importare ai campi corrispondenti in VOLAGIC.

Per impostazione predefinita, in VOLAGIC sono disponibili solo alcuni campi (e-mail, nome, cognome ecc.). Per importare ulteriori campi, dovete prima crearli come campi personalizzati in VOLAGIC in «Organizzazione» – «Dati degli Assistenti». Non è necessario collegare i campi di cui non avete bisogno in VOLAGIC. Sono obbligatori solo nome, cognome e indirizzo e-mail.

Assegnare i Gruppi

Una volta completata l’assegnazione dei campi, accedete all’assegnazione dei Gruppi. Come per l’assegnazione dei diritti in Webling, potete definire se devono essere importati solo i dati di determinati Gruppi. IMPORTANTE: le impostazioni definite durante la creazione dell’API in Webling non possono essere sovrascritte in VOLAGIC.

Se desiderate importare tutti i Gruppi disponibili, potete ora assegnarli ai Gruppi corrispondenti in VOLAGIC. Come per i campi degli Assistenti, i Gruppi VOLAGIC devono essere stati creati in precedenza per poter essere collegati ai Gruppi Webling. I Gruppi che non desiderate collegare possono rimanere con lo stato «Non collegato».

Configurazione principale

Una volta completata l’assegnazione dei Gruppi, accedete alla configurazione principale. Qui potete verificare tutte le impostazioni, visualizzare informazioni su eventuali assegnazioni aggiuntive e apportare modifiche se necessario.

Attivazione

Quando tutto è configurato correttamente, tornate alla voce «API esterne» nella navigazione e fate clic su «Attiva». Se desiderate avviare subito la prima importazione da Webling, fate clic su «Esegui importazione». La prima importazione inizierà immediatamente e potrebbe richiedere alcuni minuti.

Utilizzo dell’interfaccia

Informazioni

Una volta attivata l’interfaccia, sotto «API esterne» trovate le seguenti informazioni:

• Modalità – VOLAGIC dispone di diritti di lettura o scrittura su Webling?
• Ultima importazione – Quando è avvenuta l’ultima importazione e quanti Assistenti sono stati importati?
• Assegnazioni facoltative – Se sono presenti campi VOLAGIC non collegati, vengono visualizzati qui. Si tratta di un’informazione puramente indicativa nel caso in cui non desideriate collegarli.
• Errori di importazione – Se durante l’ultima importazione si sono verificati errori, vengono visualizzati qui e vi viene chiesto di verificarli.
• Assistenti non collegati a Webling – Questa voce si trova in fondo alla panoramica. Facendo clic, accedete all’elenco degli Assistenti registrati in VOLAGIC ma non collegati a Webling.

Comportamento dell’importazione

Se avete attivato i diritti di lettura e scrittura per VOLAGIC, sia nelle impostazioni dell’interfaccia in Webling sia nella configurazione di VOLAGIC, tutte le modifiche apportate da voi o dai vostri Assistenti in VOLAGIC vengono trasmesse direttamente a Webling.

L’importazione da Webling avviene durante la notte, poco dopo la mezzanotte. Le modifiche effettuate in Webling vengono quindi trasferite a VOLAGIC solo con l’importazione successiva.

Modifica degli Assistenti

Se avete definito solo diritti di lettura, dopo l’attivazione dell’interfaccia non potete più modificare in VOLAGIC gli Assistenti collegati. Webling diventa quindi il sistema principale e trasmette unicamente le informazioni a VOLAGIC – le modifiche ai dati dei membri devono essere effettuate in Webling.