Gerarchia dell’organizzazione Connettore in entrata

Informazioni sul connettore in entrata Gerarchia dell’organizzazione

Le gerarchie di organizzazione consentono di caricare la propria struttura organizzativa su XM DISCOVER per migliorare l’analisi dei dati, la personalizzazione degli utenti e il controllo dell’accessibilità dei dati. È possibile utilizzare il connettore in entrata delle gerarchie dell’organizzazione per caricare e aggiornare le gerarchie dell’organizzazione.

Preparazione del file di gerarchia dell’organizzazione

Prima di impostare un lavoro in entrata di gerarchia dell’organizzazione, è necessario assicurarsi che i dati della gerarchia dell’organizzazione siano nel formato corretto e contengano la struttura dell’organizzazione.

Le gerarchie di organizzazioni possono essere caricate utilizzando un file CSV o Excel (XLS o XLSX).

Per esempi e linee guida di formattazione per ciascun tipo di file, consultare le Best Practice per le gerarchie di organizzazione.

Esempio: Di seguito è riportato un file Excel che mostra un esempio di organizzazione per un’azienda alberghiera.

Impostazione di una Gerarchia dell’organizzazione Lavoro in entrata

Seguire i passaggi indicati di seguito per impostare un lavoro in entrata della Gerarchia dell’organizzazione. Questa configurazione richiede la generazione di un token API di Gerarchia in Studio, che si consiglia di eseguire prima di completare i passaggi seguenti.

1. Nella scheda Lavori, fare clic su Nuovo lavoro.
   
2. Scegliere Gerarchia dell’organizzazione.
   
3. Date un nome al vostro lavoro per poterlo identificare.
   
4. Scegliere il progetto in cui caricare i dati.
5. Date al vostro lavoro una descrizione, in modo da conoscerne lo scopo.
6. Fare clic su Successivo.
7. Scegliere il metodo di autenticazione per il server SFTP:
   • Autenticazione di base: Connettersi utilizzando un nome utente e una password.
   • Chiave SSH: Connettersi utilizzando una chiave Secure Shell (SSH) fornita dall’utente o una chiave fornita da QUALTRrics.
8. Utilizzare il menu a tendina per selezionare una connessione esistente o selezionare Aggiungi nuovo per creare una nuova connessione. Per ulteriori informazioni sulla creazione di una nuova connessione, vedere Aggiunta di un account SFTP.
9. Fare clic su Successivo.
10. Scegliere il tipo di gerarchia:
    • Filtro personalizzato
      • Classificazione Delta
      • Classificazione tradizionale
    • Filtro degli attributi
      Consiglio Q: passate il mouse sull’icona informativa avanti al nome della gerarchia per saperne di più su di essa e sui suoi casi d’uso.
11. Fare clic su Successivo.
12. Se si utilizza un tipo di gerarchia “Classificazione tradizionale”, è necessario inserire anche una Token API di Gerarchia. Altrimenti, passare al passo successivo.
13. Date un nome alla vostra gerarchia.
    Consiglio Q: È possibile aggiornare una gerarchia esistente assicurandosi che il nome inserito qui corrisponda esattamente al nome della gerarchia esistente.
14. Scegliere le impostazioni della gerarchia. Le opzioni qui presenti dipendono dal tipo di gerarchia selezionato al punto 10:
    • Classificazione Delta
      • Caricare la Gerarchia delle organizzazioni: Creare e attivare una gerarchia di organizzazioni. Per impostazione predefinita, la gerarchia dell’organizzazione attivata non è pubblicata e abilita solo la personalizzazione della dashboard. Se attivate, sono disponibili anche le seguenti sotto-opzioni:
        • Generare gruppi basati su questo file di utenti: Crea gruppi basati sul file della gerarchia dell’organizzazione.
        • Saltare gli utenti inesistenti: Salta gli utenti che non corrispondono agli utenti esistenti di Discover.
    • Caricare la Gerarchia dell’organizzazione e pubblicare: Creare, attivare e pubblicare una gerarchia di organizzazioni. Pubblicare una gerarchia dell’organizzazione consente di raggruppare i dati in base ai livelli. Si tratta di un prerequisito per i rapporti con i pari e i genitori e per i rapporti sulle destinazioni e sulle varianze. In questo modo si crea anche un modello di categoria nascosto per supportare ulteriori casi d’uso. Il modello rispecchia la struttura e i filtri della gerarchia dell’organizzazione. Se attivate, sono disponibili anche le seguenti sotto-opzioni:
      • Includere i record senza testo: Includere i record con verbali vuoti nella gerarchia dell’organizzazione.
      • Includere nei flussi di dati incrementali: Includere la gerarchia dell’organizzazione nel flusso di dati
        incrementale
        Consiglio Q: se si prevede che la pubblicazione di una gerarchia di organizzazioni possa entrare in conflitto con altri flussi di dati, si consiglia di deselezionare questa opzione. Il modello creato e successivamente classificato non bloccherà altri flussi di dati se questa opzione è disattivata.
      • Applicare ai dati storici: Applica la gerarchia dell’organizzazione ai dati storici.
      • Generare gruppi basati su questo file di utenti: Crea gruppi basati sul file della gerarchia dell’organizzazione.
      • Saltare gli utenti inesistenti: Salta gli utenti che non corrispondono agli utenti esistenti di Discover.
    • Classificazione tradizionale:
      • Caricare la Gerarchia delle organizzazioni: Creare e attivare una gerarchia di organizzazioni. Per impostazione predefinita, la gerarchia dell’organizzazione attivata non è pubblicata e abilita solo la personalizzazione della dashboard. Se attivata, è disponibile anche la seguente sotto-opzione:
        • Generare gruppi basati su questo file di utenti: Crea gruppi basati sul file della gerarchia dell’organizzazione.
      • Caricare la Gerarchia dell’organizzazione e pubblicare: Creare, attivare e pubblicare una gerarchia di organizzazioni. Pubblicare una gerarchia dell’organizzazione consente di raggruppare i dati in base ai livelli. Si tratta di un prerequisito per i rapporti con i pari e i genitori e per i rapporti sulle destinazioni e sulle varianze. In questo modo si crea anche un modello di categoria nascosto per supportare ulteriori casi d’uso. Il modello rispecchia la struttura e i filtri della gerarchia dell’organizzazione. Se attivate, sono disponibili anche le seguenti sotto-opzioni:
        • Includere i record senza testo: Includere i record con verbali vuoti nella gerarchia dell’organizzazione.
        • Includere nei flussi di dati incrementali: Includere la gerarchia dell’organizzazione nel flusso di dati
          incrementale
          Consiglio Q: se si prevede che la pubblicazione di una gerarchia di organizzazioni possa entrare in conflitto con altri flussi di dati, si consiglia di deselezionare questa opzione. Il modello creato e successivamente classificato non bloccherà altri flussi di dati se questa opzione è disattivata.
        • Generare gruppi basati su questo file di utenti: Crea gruppi basati sul file della gerarchia dell’organizzazione.
    • Filtro degli attributi
      • Saltare gli utenti inesistenti: Salta gli utenti che non corrispondono agli utenti esistenti di Discover.
15. Fare clic su AVANTI.
16. Scegliere il tipo di file da caricare:
    
    • File “piatti” separati da un delimitatore
    • File Excel (XLS, XLSX)
17. Per i file piatti separati da delimitatori, è possibile scegliere ulteriori impostazioni:
    
    • Codifica del file: Scegliere il sistema di codifica del file (UTF-8, ASCII, ecc.)
    • Carattere delimitatore: Inserire il carattere utilizzato per delimitare le voci dei dati. Per impostazione predefinita, si tratta di una virgola per i file CSV.
    • Carattere di chiusura: Inserire il carattere che racchiude l’inserimento dei dati. Lasciare questo campo vuoto se è stato selezionato “Nessun recinto”.
    • Nessun allegato: Attivare questa opzione se il file non contiene caratteri di allegato.
18. Fare clic su Sfoglia e scegliere il percorso della cartella sul server SFTP che contiene il file da caricare.
    Consiglio Q: quando si sceglie il percorso di una cartella, è possibile fare clic sull’icona di una cartella per espanderla. Fare clic sul nome della cartella per selezionarla, quindi fare clic su Ok al termine.
19. Inserire l’espressione regolare del nome del file che corrisponde ai file che si desidera caricare.
20. Se i file sono compressi, abilitare Unzip file(s) e inserire l’espressione regolare Zipped Filename che corrisponde ai file che devono essere decompressi.
    
21. Se i file sono decifrati, attivare Decifra file e immettere quanto segue:
    • Espressione regolare del nome del file crittografato: Inserire l’espressione regolare del nome del file per i file che devono essere decifrati.
    • Chiave PGP/GPG: Inserire la chiave PGP/GPG utilizzata per la crittografia.
    • Passphrase: Inserire la passphrase per la decrittazione.
22. Se i file sono sia compressi che crittografati, è necessario scegliere quale debba essere il primo:
    • Decomprimere e decrittografare: I file vengono decompressi e poi decifrati.
    • Decriptare e decomprimere: I file vengono decifrati e poi decompressi.
23. È necessario fornire un file campione, che può essere salvato sul computer o sul server SFTP:
    
    • Selezionare Scarica Campione da File Storage se il file del campione è salvato sul server SFTP.
    • Selezionare Carica campione dal mio computer se il campione è salvato sul computer.
      Consiglio Q: se necessario, è possibile scaricare un file modello facendo clic sul link qui visualizzato nell’impostazione del lavoro.
24. Per impostazione predefinita, il file campione non viene utilizzato per generare la gerarchia dell’organizzazione. Se si desidera che il file campione venga utilizzato per la prima esecuzione del lavoro, attivare Usa il file campione caricato per l’esecuzione iniziale del lavoro.
25. Fare clic sul pulsante Seleziona file e scegliere il file campione sul computer o sul server SFTP.
26. Viene visualizzata un’anteprima del file. Se al posto dell’anteprima viene visualizzato un messaggio di errore o il contenuto del file grezzo, è possibile che ci sia un problema con le opzioni di formato dei dati selezionate. Vedere Errori del file di Campione per la risoluzione dei problemi del file.
27. Fare clic su Successivo.
28. Iniziare a mappare i campi del file campione con i campi della gerarchia dell’organizzazione in XM Discover. Fare clic sulla casella nella colonna Mappatura per scegliere un campo della gerarchia dell’organizzazione XM Discover da mappare al campo importato. I possibili campi della gerarchia dell’organizzazione includono:
    
    • Dal Livello 1 al Livello 10: definire la struttura della gerarchia. Il numero massimo di livelli della gerarchia è 10.
    • Utenti: Mappate gli utenti nella vostra gerarchia.
    • Filtri: Definire i filtri per la gerarchia.
    • Arricchimenti: Creare parametri di arricchimento per la gerarchia. Il numero massimo di arricchimenti è 6.
29. Se necessario, è possibile trasformare i dati in arrivo facendo clic sull’icona dell’ingranaggio nella colonna Trasformazioni.
30. È possibile aggiungere altri campi facendo clic sul segno più ( + ) o rimuovere campi facendo clic sul segno meno ( – ) accanto al campo.
31. Fare clic su Avanti una volta terminata la mappatura dei campi.
32. Scegliere le impostazioni di notifica.
    
33. Fare clic su Successivo.
34. Scegliere Pianifica esecuzioni incrementali se si desidera che il lavoro venga eseguito periodicamente in base a una pianificazione, oppure Imposta un’estrazione una tantum se si desidera che il lavoro venga eseguito una sola volta. Per ulteriori informazioni, vedere Pianificazione dei lavori.
    
35. Scegliere un periodo di conservazione per i file elaborati. I file vengono eliminati dopo il periodo impostato.
36. Fare clic su Successivo.
37. Valutate la vostra configurazione. Se è necessario modificare un’impostazione specifica, fare clic sul pulsante Modifica per accedere alla fase di impostazione del connettore.
    
38. Fare clic su Fine per salvare il lavoro.