Connettori: più istanze dello stesso tipo
Puoi collegare più account dello stesso tipo di connettore (per esempio due HaloPSA, o due Freshservice), ciascuno con le proprie credenziali e i propri clienti. Ti serve quando gestisci più tenant separati dello stesso sistema e vuoi tenerli distinti dentro ServiceBoard.
Come si fa passo-passo
- Apri Impostazioni dal menu a sinistra (solo amministratori).
- Vai al gruppo Dati & Sync e apri la voce Connettori.
- Seleziona la card del connettore che ti interessa.
- Sotto la card trovi due aree: Istanza principale e Istanze aggiuntive.
- Nell'area Istanze aggiuntive, premi Aggiungi istanza per avviare la procedura guidata.
- Completa i passaggi del wizard (credenziali, prefisso, clienti, campi custom) descritti qui sotto.
Istanza principale e istanze aggiuntive
Dopo aver selezionato un connettore vedi due aree distinte:
- Istanza principale — è la configurazione già esistente di quel connettore. Continua a funzionare esattamente come prima: aggiungere altre istanze non cambia nulla nel suo comportamento.
- Istanze aggiuntive — qui colleghi gli altri account dello stesso tipo. Ogni istanza ha credenziali proprie, un prefisso proprio e i propri clienti. Puoi così tenere separati, per esempio, due tenant HaloPSA diversi senza che si mescolino.
Tutti i connettori PSA/RMM supportano più istanze: HaloPSA, Freshservice, Autotask, NinjaOne, Atera.
Nota: ogni istanza usa le proprie credenziali, cifrate a riposo con AES-256-GCM e sempre gestite lato server: i dati delle istanze restano separati e non si mescolano tra loro.
A cosa serve il prefisso
Quando aggiungi un'istanza ti viene chiesto un prefisso (per esempio HALO1). È obbligatorio e deve essere univoco tra tutte le connessioni.
Serve a tenere distinti i ticket di istanze diverse: ogni ticket viene importato con un identificativo che inizia con il prefisso (per esempio HALO1_1234). Due istanze possono usare gli stessi numeri di ticket: senza prefissi diversi, il ticket 1234 di una istanza sovrascriverebbe il 1234 dell'altra, con perdita di dati. Il prefisso evita questa collisione.
Il sistema propone un prefisso suggerito, ma puoi cambiarlo: sono ammessi da 2 a 12 caratteri tra lettere, numeri, - o _ (viene salvato in maiuscolo).
Attenzione: usa un prefisso univoco per ogni istanza. Due istanze con lo stesso prefisso finiscono per sovrascriversi i ticket con lo stesso numero, con perdita di dati: è proprio la collisione che il prefisso serve a evitare.
La procedura "Aggiungi istanza"
La procedura guidata ti accompagna in pochi passaggi:
- Credenziali — inserisci nome, URL e credenziali dell'account e scegli il prefisso. Il sistema verifica subito la connessione prima di proseguire; se il test fallisce, correggi i dati e riprova.
- Clienti — l'istanza individua automaticamente i clienti disponibili sull'account (auto-discovery). Selezioni quelli che ti interessano e li abbini a un cliente del tuo database, così i ticket finiscono sotto il cliente giusto.
- Campi custom — per i clienti scelti puoi decidere quali campi personalizzati rendere disponibili in dashboard, report e tabelle. Il sistema li rileva da un campione di ticket.
- Conferma — completi la configurazione e l'istanza è pronta a sincronizzare.
Sincronizzazione per cliente
Dalla card dell'istanza puoi espandere l'elenco dei clienti sincronizzati. Per ciascuno puoi:
- attivare o disattivare la sincronizzazione;
- avviare una sincronizzazione manuale con il pulsante di aggiornamento, quando ti serve subito il dato fresco;
- configurare i campi custom;
- aggiungere altri clienti o rimuoverli.
Anche le istanze aggiuntive vengono coperte dalla sincronizzazione automatica periodica, oltre che dal trigger manuale.
Cosa succede se elimini
Eliminando un cliente da un'istanza, o un'intera istanza, i ticket già sincronizzati restano nel database: rimuovi la connessione, non i dati storici già importati.
Esempio pratico
Partner Alpha gestisce due tenant HaloPSA separati, uno per la propria struttura e uno per Cliente Beta. L'Istanza principale è già impostata sul primo tenant. Per il secondo, apri Impostazioni → Dati & Sync → Connettori → HaloPSA, vai su Istanze aggiuntive e premi Aggiungi istanza. Inserisci le credenziali del secondo tenant, imposti il prefisso HALO2 (univoco) e superi il test. Nel passo Clienti selezioni l'azienda di Cliente Beta e la abbini alla sua scheda nel database. Da quel momento i ticket dei due tenant convivono senza sovrapporsi, ciascuno riconoscibile dal proprio prefisso.
Domande frequenti
- Dopo il collegamento non vedo i clienti? L'auto-discovery mostra le aziende/organizzazioni presenti sull'account collegato: se l'elenco è vuoto, verifica che le credenziali abbiano i permessi per leggerle e che il test connessione sia andato a buon fine. Ricorda che ogni cliente trovato va abbinato a un cliente del tuo database perché i ticket compaiano sotto di lui.
- Il prefisso viene rifiutato? Deve essere univoco rispetto a tutte le altre connessioni e rispettare il formato (2–12 caratteri tra lettere, numeri,
-,_). Se è già usato da un'altra istanza, scegline uno diverso. - L'istanza aggiuntiva non sincronizza? Controlla che l'istanza sia abilitata, che il singolo cliente abbia la sincronizzazione attiva e prova un aggiornamento manuale. Verifica anche l'esito dell'ultimo test sulla card.
- Se elimino un'istanza perdo i ticket? No: i ticket già importati restano nel database. Viene rimossa solo la connessione e la sua configurazione.