Connettore in entrata gerarchia organizzativa

Informazioni sul connettore in entrata della gerarchia dell’organizzazione

Le gerarchie organizzative consentono di caricare la struttura organizzativa in XM Discover per migliorare l’analisi dei dati, la personalizzazione degli utenti e il controllo di accesso ai dati. È possibile utilizzare il connettore in entrata della gerarchia organizzativa per caricare e aggiornare le gerarchie organizzative.

Preparazione di un file di gerarchia dell’organizzazione

Prima di poter configurare una mansione in entrata della gerarchia organizzativa, è necessario assicurarsi che i dati della gerarchia organizzativa siano nel formato corretto e contengano la propria struttura organizzativa.

Le gerarchie dell’organizzazione possono essere caricate utilizzando un file CSV o Excel (XLS o XLSX).

Vedere le best practice per le gerarchie dell’organizzazione per esempi e linee guida di formattazione per ogni tipo di file.

Esempio: di seguito è riportato un file Excel che mostra una struttura organizzativa di esempio per un’azienda alberghiera.

Configurazione di un job in entrata Gerarchia dell’organizzazione

Attenersi alla seguente procedura per configurare un job in entrata della gerarchia organizzativa. Questa configurazione richiede la generazione di un token API gerarchia in Studio, consigliato prima di completare i passaggi di seguito.

1. Nel tab Processi, fare clic su Nuovo job.
   
2. Selezionare Gerarchia dell’organizzazione.
   
3. Assegnare un nome al job in modo da poterlo identificare.
   
4. Selezionare il progetto in cui caricare i dati.
5. Fornisci una descrizione del tuo lavoro in modo da conoscerne lo scopo.
6. Fare clic su Successivo.
7. Scegliere un account SFTP da utilizzare o selezionare Aggiungi Nuovo per aggiungerne uno nuovo.
   
8. Se si aggiunge un nuovo account, immettere le seguenti informazioni per l’account SFTP:
   • Nome connessione: assegnare un nome alla connessione in modo da poterla riconoscere in un secondo momento.
   • Nome utente SFTP: immettere il nome utente per connettersi al server SFTP.
   • Password SFTP: immettere la password per connettersi al server SFTP.
   • Host SFTP: immettere l’URL dell’host del server SFTP.
   • Porta SFTP: immettere la porta SFTP. Di solito si tratta di 22.
   • Invia notifiche di scadenza: se desideri che le tue credenziali SFTP scadano dopo un certo periodo di tempo, seleziona questa opzione.
   • Giorni prima della scadenza: se si abilitano le notifiche di scadenza, immettere quanti giorni si desidera ricevere una notifica prima della scadenza. È possibile inserire un valore compreso tra 1 e 100 giorni.
   • Data di scadenza: impostare la data di scadenza delle credenziali. Fare clic sulla casella per aprire un calendario per scegliere la data.
9. Fare clic su Successivo.
10. Inserisci il tuo Token API gerarchia.
    
11. Fare clic su Successivo.
12. Assegnare un nome alla gerarchia organizzativa.
    
13. Scegli se pubblicare o meno la tua gerarchia organizzativa:
    • Carica gerarchia dell’organizzazione: crea e attiva una gerarchia dell’organizzazione. Per impostazione predefinita, la gerarchia dell’organizzazione attivata non è pubblicata e attiverà solo la personalizzazione della dashboard.
    • Carica gerarchia dell’organizzazione e pubblica: crea, attiva e pubblica una gerarchia dell’organizzazione. La pubblicazione di una gerarchia dell’organizzazione consente di raggruppare i dati in base ai relativi livelli. Questo è un requisito per il reporting di pari livello e sovraordinato, nonché per il reporting di destinazione e varianza.
      Consiglio Q: la pubblicazione di una gerarchia organizzativa crea un modello di categoria corrispondente nascosto per supportare ulteriori casi di utilizzo. Il modello categoria creato rifletterà la struttura e i filtri della gerarchia dell’organizzazione e si comporterà come un modello, laddove applicabile.
14. Selezionare ulteriori opzioni di gerarchia in base alle proprie preferenze:
    • Genera gruppi in base a questo file utenti: crea gruppi in base al file della gerarchia dell’organizzazione.
    • Includi record senza testo: includi i record con verbatimi vuoti nella gerarchia dell’organizzazione. Questa opzione è disponibile solo se si sta pubblicando la gerarchia dell’organizzazione.
    • Includi nei flussi di dati incrementali: includi la gerarchia organizzativa nelle esecuzioni di flussi di dati incrementali. Questa opzione è disponibile solo se si sta pubblicando la gerarchia dell’organizzazione.
      Consiglio Q: se si prevede che la pubblicazione di una gerarchia dell’organizzazione sia in conflitto con altri flussi di dati, si consiglia di deselezionare questa opzione. Se questa opzione è disabilitata, il modello che viene creato e successivamente classificato non bloccherà altri flussi di dati.
15. Fare clic su Successivo.
16. Scegliere il tipo di file da caricare:
    
    • File “piatti” separati da delimitatori
    • File Excel (XLS, XLSX)
17. Per i file piatti separati da delimitatore, è possibile scegliere tra impostazioni aggiuntive:
    
    • Codifica file: scegli il sistema di codifica del file (UTF-8, ASCII, ecc.)
    • Carattere delimitatore: immettere il carattere utilizzato per delimitare gli inserimenti di dati. Per impostazione predefinita, si tratta di una virgola per i file CSV.
    • Carattere di imballaggio: immettere il carattere che racchiude la registrazione dati. Lasciare vuoto questo campo se è selezionato “Nessun imballaggio”.
    • Nessun imballaggio: attivare questa opzione se il file non contiene caratteri di imballaggio.
18. Fai clic su Sfoglia e scegli il percorso della cartella sul tuo server SFTP che contiene il file che desideri caricare.
    Qtip: 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 il nome file dell’espressione regolare che corrisponde ai file da caricare.
20. Se i file sono compressi, attivare Decomprimi file e inserire l’espressione regolare Nome file compresso che corrisponde ai file da decomprimere.
    
21. Se i file vengono decrittografati, abilitare Decrypt file(s) e immettere quanto segue:
    • Espressione regolare nome file crittografato: inserire il nome file espressione regolare per i file che devono essere decrittografati.
    • Chiave PGP/GPG: immettere la chiave PGP/GPG utilizzata per la crittografia.
    • Frase chiave: immettere la frase chiave per la decrittografia.
22. Se i file sono sia compressi che crittografati, è necessario scegliere quale deve accadere per primo:
    • Decomprimere quindi Decrypt: i file vengono decompressi e quindi decrittografati.
    • Decodifica quindi Decomprimi: i file vengono decrittografati e quindi decompressi.
23. È necessario fornire un file di esempio, che può essere salvato sul computer o sul server SFTP:
    
    • Selezionare Scarica campione da archivio file se il file di esempio viene salvato sul server SFTP.
    • Selezionare Carica campione dal mio computer se il campione viene salvato sul computer.
      Consiglio Q: Se necessario, è possibile scaricare un file modello facendo clic sul collegamento qui visualizzato nella configurazione del processo.
24. Per impostazione predefinita, il file di esempio non viene utilizzato per generare la gerarchia dell’organizzazione. Se si desidera che il file di esempio venga utilizzato per la prima esecuzione del processo, attivare Utilizza il file campione caricato per l’esecuzione del processo iniziale.
25. Fare clic sul pulsante Seleziona file e scegliere il file di esempio sul computer o sul server SFTP.
26. Verrà visualizzata un’anteprima del file. Se al posto dell’anteprima viene visualizzato un messaggio di errore o contenuti di file grezzi, potrebbe verificarsi un problema con le opzioni di formato dei dati selezionate. Vedere Errori file di esempio per assistenza nella risoluzione dei problemi del file.
27. Fare clic su Successivo.
28. Inizia a mappare i campi dal tuo file campione ai campi della gerarchia dell’organizzazione in XM Discover. Fai clic sulla casella nella colonna Mappatura per scegliere un campo della gerarchia organizzativa XM Discover da mappare al campo importato. I possibili campi della gerarchia dell’organizzazione includono:
    
    • Da livello 1 a livello 10: definire la struttura della gerarchia. Il numero massimo di livelli gerarchici è 10.
    • Utenti: mappare gli utenti alla 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 entrata facendo clic sull’icona a forma di ingranaggio nella colonna Trasformazioni.
30. È possibile aggiungere campi supplementari facendo clic sul segno più ( + ) o rimuovere i campi facendo clic sul segno meno ( – ) accanto al campo.
31. Al termine della mappatura dei campi, fare clic su Avanti.
32. Selezionare le impostazioni di notifica.
    
33. Fare clic su Successivo.
34. Selezionare Pianifica esecuzioni incrementali se si desidera che il job venga eseguito periodicamente in base a una pianificazione oppure Configura pull una tantum se si desidera che il job venga eseguito una sola volta. Per ulteriori informazioni, consultare Pianificazione job.
    
35. Selezionare un periodo di conservazione per i file elaborati. I file vengono eliminati dopo il periodo impostato.
36. Fare clic su Successivo.
37. Rivedere la configurazione. Se è necessario modificare un’impostazione specifica, fare clic sul pulsante Modifica per passare a quella fase nella configurazione del connettore.
    
38. Fare clic su Fine per salvare la mansione.