Connettore in entrata gerarchia organizzativa

Informazioni sul connettore in entrata della gerarchia dell’organizzazione

È possibile utilizzare il connettore in entrata Gerarchia dell’organizzazione per caricare e aggiornare le gerarchie dell’organizzazione tramite file archiviati su un server SFTP (Secure File Transfer Protocol) in XM Discover. Questo connettore in entrata consente di eseguire quanto segue:

• Caricare e pianificare gli aggiornamenti alle gerarchie organizzative.
• Estrarre i file da un archivio Zip o Gzip prima dell’elaborazione.
• Decodificare i file prima dell’elaborazione.
• Configurare notifiche avanzate.
• Applicare trasformazioni.
  Qtip: le gerarchie dell’organizzazione funzionano allo stesso modo indipendentemente da dove (Studio o Connettori) vengono create o aggiornate.

Formati dei file della gerarchia dell’organizzazione

Prima di configurare un processo utilizzando il connettore in entrata Gerarchia dell’organizzazione, assicurarsi di avere preparato il file della gerarchia dell’organizzazione rilevante in 1 dei seguenti formati di file supportati:

• File Excel (XLS, XLSX)
• File di testo delimitati (CSV)

Gerarchia dell’organizzazione in formato Excel

Il connettore in entrata Gerarchia dell’organizzazione consente di definire tutti gli aspetti di un’organizzazione tramite un unico foglio di calcolo MS Excel.

• È possibile salvare la gerarchia dell’organizzazione come foglio di calcolo MS Excel con estensione XLS o XLSX.
• Si consiglia di inserire tutti i dati della gerarchia dell’organizzazione nel primo foglio del file Excel.
• Assicurarsi che la prima riga del foglio elettronico contenga nomi di colonna. Questi nomi verranno utilizzati per mappare le colonne ai parametri dell’organizzazione.
• Le colonne del foglio di calcolo possono essere in qualsiasi ordine.
• Ogni colonna viene attribuita a un determinato parametro della gerarchia organizzativa durante la fase di mappaggio.

Esempio: Di seguito è riportato un esempio di gerarchia dell’organizzazione definita in formato Excel:

Esempio: Di seguito è riportato un esempio di come mappare le colonne dai file della gerarchia dellorganizzazione durante la fase di mappaggio:

Gerarchia dell’organizzazione in formato CSV

Il connettore in entrata Gerarchia dell’organizzazione consente di definire tutti gli aspetti di un’organizzazione tramite un unico file CSV.

• Salvare la gerarchia dell’organizzazione come file CSV.
• Separare le colonne utilizzando una virgola.
• Tutte le righe devono avere lo stesso numero di colonne, nello stesso ordine.
• Assicurarsi che la prima riga del file CSV contenga nomi di colonna. Questi nomi verranno utilizzati per mappare le colonne ai parametri della gerarchia dell’organizzazione.
• L’ordine delle colonne non importa.
• Ogni colonna viene attribuita a un determinato parametro della gerarchia organizzativa durante la definizione della gerarchia della fase di mappaggio in un file CSV.

Esempio: ecco un esempio di come una gerarchia dell’organizzazione viene definita in un file CSV. Diverse manager vengono attribuite a diversi livelli gerarchici e l’arricchimento “Opinione di destinazione” viene definito per ogni livello.

Esempio: ecco un esempio di come le colonne dei file della gerarchia dell’organizzazione devono essere mappate durante la fase di mappaggio:

Per esempi e suggerimenti per la risoluzione dei problemi relativi alle gerarchie dell’organizzazione in XM Discover, consultare Best Practices for Organization Hierarchies (Studio).

Configurazione della connessione

1. Accedere ai connettori.
2. Fare clic sul pulsante Nuova mansione nell’angolo in alto a destra della pagina Processi.
   
3. Nella pagina Connettori, passare alla sezione SELEZIONA UN’ORIGINE.
   
4. Fare clic sul pulsante Gerarchia dell’organizzazione.
   

Creazione di un processo del connettore in entrata della gerarchia dell’organizzazione

Dopo aver configurato la connessione, seguire questi passaggi per creare un processo del connettore in entrata Gerarchia dell’organizzazione e configurare i dati inviati a XM Discover:

• Fase 1: fornisci nome job
• Fase 2: specificare progetto e descrizione
• Fase 3: Fornisci le credenziali per una cartella SFTP Qualtrics
• Fase 4: token API gerarchia
• Passo 5: Impostazioni gerarchia dell’organizzazione
• Fase 6: fornire la configurazione dei file
• Fase 7: Mappa i campi desiderati in XM Discover
• Fase 8: configurazione delle notifiche (facoltativo)
• Passo 9: configura opzioni supplementari per job
• Passo 10: conferma tutte le impostazioni del job

Consiglio Q: Fare clic sui pulsanti Indietro e Avanti per spostarsi tra le pagine, oppure utilizzare i tasti freccia: SINISTRA per tornare indietro, DESTRA per andare avanti. Per annullare la configurazione, fare clic sul pulsante Annulla.

Fase 1: fornisci nome job

Immettere un nome processo riconoscibile nella casella Nome processo nell’angolo in alto a sinistra della pagina.

Fase 2: specificare progetto e descrizione

1. Nella pagina Specifica progetto e descrizione, selezionare il progetto in cui devono essere caricati i dati dal menu a discesa dei progetti.
   
   Consiglio Q: è possibile inserire una nota relativa al processo nella casella Descrizione lavoro. La descrizione del job immessa nella casella Descrizione job è accessibile solo nell’elenco Connettori e non viene caricata come parte dei dati di un processo.
2. Fare clic su Successivo.

Fase 3: Fornisci le credenziali per una cartella SFTP Qualtrics

1. Nella pagina Fornisci credenziali per una cartella SFTP Qualtrics, puoi selezionare un insieme esistente di credenziali del server SFTP dal menu a discesa.
   
   Consiglio Q: è possibile aggiungere un nuovo insieme di credenziali SFTP attenendosi alla procedura descritta in Aggiunta di nuove credenziali SFTP sezione.
2. Fare clic su Successivo.

Fase 4: token API gerarchia

1. Nella pagina Token API gerarchia, fornire il token di autenticazione della gerarchia nella casella Token API gerarchia.
   
   Consiglio Q: per ulteriori informazioni sulla generazione di un token di autenticazione della gerarchia e sull’aggiornamento di un token di autenticazione della gerarchia dopo la creazione di un processo, consultare API della gerarchia.
2. Fare clic su Successivo.

Passo 5: Impostazioni gerarchia dell’organizzazione

1. Nella pagina Impostazioni gerarchia dell’organizzazione, fornire il nome della gerarchia organizzativa nella casella NOME.
   
2. Selezionare 1 delle seguenti opzioni della modalità di caricamento per specificare il modo in cui il sistema deve gestire le gerarchie organizzative.

• Carica gerarchia dell’organizzazione (predefinito): crea e attiva una gerarchia dell’organizzazione. Per ulteriori informazioni, consultare Carica gerarchia organizzativa sezione.
  Consiglio Q: 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. Per ulteriori informazioni, consultare Carica gerarchia dell’organizzazione e pubblica sezione.
  Consiglio Q: 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. Per ulteriori informazioni, consultare Reporting di pari livello e principale e Reporting di destinazione e varianza.
  Consiglio Q: per ulteriori informazioni sull’aggiornamento delle impostazioni della gerarchia organizzativa dopo la creazione di un job, consultare Aggiornamento delle impostazioni dei processi del connettore in entrata della gerarchia organizzativa sezione.

3. Fare clic su Successivo.

Passaggio 6: fornire la configurazione dei file

1. Nella pagina Fornisci configurazione file, selezionare 1 delle seguenti caselle di controllo per scegliere il tipo di file che contiene i dati da caricare:

• File di testo delimitati (CSV)
• File Excel (XLS, XLSX)
  
  

2. Applica le opzioni di impostazione per il tipo di file selezionato:

• File di testo delimitati (CSV): per ulteriori informazioni, consultare Impostazioni file di testo delimitati (CSV) sezione.
• File Excel (XLS, XLSX): Per ulteriori informazioni, vedere Impostazioni file Microsoft Excel sezione.
  

3. Fare clic su Sfoglia nella sezione Percorso file per puntare alla cartella in cui sono archiviati i file nel server SFTP.
   
4. Nella finestra Scegli percorso file, selezionare la cartella in cui sono archiviati i file.
   
   Consiglio Q: fare clic sul nome della cartella per selezionarla. Fare clic sull’icona della cartella per aprirla.
5. Una volta selezionata la cartella in cui sono archiviati i file, fare clic su Ok.
   
   Attenzione: vengono elaborati solo i file nella cartella selezionata; le sottocartelle devono essere elaborate separatamente.
6. Inserire un’espressione regolare per elaborare solo i file con nomi corrispondenti nella casella Nome file espressione regolare.
   
   Consiglio Q: È possibile aggiornare le impostazioni di posizione dei file dopo la creazione di un processo.
   Attenzione: le funzionalità di codifica personalizzata sono fornite così com’è e richiedono conoscenze di programmazione per l’implementazione. Il Supporto Qualtrics non offre assistenza o consulenza riguardo alla programmazione personalizzata. Puoi invece provare a domandare alla nostra community di utenti esperti. Se desideri maggiori informazioni sui nostri servizi di programmazione personalizzata, contatta il tuo Account Executive Qualtrics.
7. Nella pagina Fornisci configurazione file, passare alla sezione Decrittografia e compressione (facoltativa).
   
8. Se i file sono archiviati in un archivio Zip o Gzip, selezionare la casella di controllo Decomprimi file.
9. Inserire un’espressione regolare per decomprimere solo i file con nomi corrispondenti nella casella Espressione regolare nome file compresso.
   Attenzione: le funzionalità di codifica personalizzata sono fornite così com’è e richiedono conoscenze di programmazione per l’implementazione. Il Supporto Qualtrics non offre assistenza o consulenza riguardo alla programmazione personalizzata. Puoi invece provare a domandare alla nostra community di utenti esperti. Se desideri maggiori informazioni sui nostri servizi di programmazione personalizzata, contatta il tuo Account Executive Qualtrics.
10. Se i file sono crittografati, selezionare la casella di controllo Decrypt file(s).
    
11. Inserire un’espressione regolare per decifrare solo i file con nomi corrispondenti nella casella Espressione regolare nome file crittografato.
    Attenzione: le funzionalità di codifica personalizzata sono fornite così com’è e richiedono conoscenze di programmazione per l’implementazione. Il Supporto Qualtrics non offre assistenza o consulenza riguardo alla programmazione personalizzata. Puoi invece provare a domandare alla nostra communitydi utenti esperti. Se desideri maggiori informazioni sui nostri servizi di programmazione personalizzata, contatta il tuo Account Executive Qualtrics.
12. Inserire una chiave PGP/GPG per la decodifica nella casella chiave PGP/GPG.
13. Immettere una frase chiave per la decodifica nella casella Passphrase.
14. Se un archivio non crittografato contiene file crittografati, selezionare l’opzione Decomprimi e decodifica in alternativa. Se un archivio crittografato contiene file non crittografati, selezionare l’opzione Decodifica e decomprimi.
    Consiglio Q: queste opzioni sono disponibili solo se sono selezionate sia le opzioni Decomprimi file che Decrypt file.
    Attenzione: gli archivi crittografati con file crittografati non sono supportati.
    Qtip: È possibile aggiornare le impostazioni di decrittografia e compressione dopo la creazione del lavoro.
15. Per fornire un file di esempio per i mapping dei campi, è possibile selezionare una delle seguenti opzioni:

• Scarica un campione dall’archivio file: Per ulteriori informazioni, vedere Download di un file di esempio dal server SFTP sezione.
• Caricare un file dal computer: Per ulteriori informazioni, consultare Caricamento di un file campione dal computer sezione.
  

16. Fare clic su Successivo.
    

Fase 7: Mappa i campi desiderati in XM Discover

1. Nella pagina Mappa i campi desiderati in XM Discover, definire la gerarchia dell’organizzazione mappando i campi ai parametri della gerarchia appropriati nella scheda MAPPATURA FONTE:

• Nome campo: il nome del campo dal file.
  
• Valori possibili: esempi di valori possibili.
• Trasformazioni: utilizzare questa opzione per trasformare i dati. Per ulteriori informazioni, consultare Applicazione di trasformazioni.
• Mappaggio: selezionare l’aspetto della gerarchia dell’organizzazione a cui mappare i campi. Valori possibili:
  • Da Livello 1 a Livello 10. Definire la struttura della gerarchia. I livelli della struttura organizzativa sono definiti da colonne nel file Excel o CSV.
    Consiglio Q: il numero massimo di livelli gerarchici è 10.
  • Utenti: mappare gli utenti alla gerarchia.
  • Filtri: definire i filtri per la gerarchia.
  • Arricchimenti: crea parametri di arricchimento per la tua gerarchia…|
    Consiglio Q: il numero massimo di arricchimenti è 6.
    Consiglio Q: fare clic sull’icona più ( + ) a destra per aggiungere nuovi campi di dati personalizzati; fare clic sull’icona meno ( – ) per rimuovere i campi.

2. Fare clic su Successivo.
   

Fase 8: configurazione delle notifiche (facoltativo)

1. Nella pagina Configurazione notifiche, è possibile selezionare le notifiche che gli osservatori di un processo devono ricevere se si verifica uno degli eventi elencati di seguito.

• Invia notifica quando l’esecuzione del processo non riesce
• Notificare quando non sono stati trovati file per l’elaborazione
• Invia una notifica quando il job termina con un timeout
  

2. Fare clic su Successivo.
   

Fase 9: Configura opzioni aggiuntive per il job

1. Nella pagina Configura opzioni supplementari per job, nella sezione Pianifica job storico/incrementale, selezionare 1 delle seguenti opzioni:

• Pianifica esecuzioni incrementali: per configurare una pianificazione per le rilevazioni dati incrementali.
  Consiglio Q: per ulteriori informazioni sulla pianificazione di esecuzioni incrementali, consultare Pianificazione job.
• Configurare pull una tantum: per eseguire un recupero di dati una tantum.
  
  Consiglio Q: Per ulteriori informazioni, consultare Pianificazione di un’esecuzione incrementale per un processo di pull una tantum.

2. Nella pagina Configura opzioni aggiuntive per il processo, nella sezione Periodo di conservazione, è possibile specificare il periodo di conservazione dei file di archiviazione per ogni processo per un periodo di tempo definito.
   
   Consiglio Q: per ulteriori informazioni sulle impostazioni di conservazione, consultare Aggiornamento delle impostazioni di conservazione.
3. Fare clic su Successivo.
   

Passo 10: conferma tutte le impostazioni del job

1. Nella pagina Conferma tutte le impostazioni processo, è possibile visualizzare un riepilogo di tutte le impostazioni di un processo e modificarle, se necessario, prima di eseguire il caricamento dei dati.
   
2. Per eseguire l’upload dei dati, fare clic sul pulsante Concludere quando si è pronti per eseguire l’upload dei dati.
   
   Verrà visualizzato un messaggio di conferma che conferma che il processo è stato inviato correttamente. Quando si fa clic su Fine, si verifica quanto segue:

• I tiri una tantum vengono eseguiti immediatamente.
• A meno che non sia stata attivata l’opzione “Crea job ma non estrarre dati”, i pull pianificati vengono eseguiti immediatamente, quindi impostati per l’esecuzione in base alla pianificazione definita.
  Per ulteriori informazioni sul monitoraggio dei job, consultare Riepilogo pagina dei job.

Aggiunta di nuove credenziali SFTP

Nella pagina Fornisci credenziali per una cartella SFTP Qualtrics, puoi aggiungere nuove credenziali SFTP.

1. Per aggiungere un nuovo insieme di credenziali SFTP, selezionare Aggiungi Nuovo dal menu a discesa delle credenziali.
   
2. Immettere il nome del nuovo insieme di credenziali nella casella NOME CONNESSIONE.
   
3. Inserire il nome utente SFTP nella casella NOME UTENTE SFTP.
4. Fornire la password SFTP nella casella PASSWORD SFTP.
5. Immettere l’indirizzo del server SFTP nella casella HOST SFTP.
6. Fornire la porta SFTP nella casella PORTA SFTP.
   Qtip: la porta predefinita è 22.
7. È possibile impostare la scadenza delle credenziali SFTP dopo un determinato periodo di tempo (facoltativo). Per definire una data di scadenza per questo insieme di credenziali e impostare un promemoria per tutti gli osservatori dei processi, selezionare la casella di controllo Invia notifiche di scadenza. Questo abilita la casella Giorni prima della scadenza.
   
8. Immettere un valore nella casella Giorni prima della scadenza per impostare quanti giorni prima della scadenza devono iniziare le notifiche. I valori possibili sono compresi tra 1 e 100 giorni.
   Consiglio Q: questo promemoria viene avviato ogni volta che il processo viene eseguito una volta che la data di scadenza è inferiore al numero di giorni impostato nella casella Giorni prima della scadenza.
9. Selezionare la Data di scadenza dal selettore della data di calendario. La data di scadenza verrà quindi aggiunta alla casella Data di scadenza.

Download di un file di esempio dal server SFTP

1. Selezionare Scarica campione da archiviazione file.
   
2. Fare clic sul pulsante Seleziona file di esempio nella casella Sfoglia archivio file.
3. Nella finestra Scegli file campione, aprire la cartella in cui è archiviato il file campione.
   
4. Selezionare il file campione.
   
5. Fare clic su OK.
6. Attendere che XM Discover carichi il file di esempio e mostri un’anteprima.
   
   Consiglio Q: Per informazioni sui possibili errori di convalida, vedere Errori file di esempio.

Caricamento di un file campione dal computer

1. Selezionare Carica campione dal computer.
   
2. Fare clic sul pulsante Fare clic su per selezionare il file da caricare e puntare al file di dati o rilasciare il file nell’area di disegno grigia.
3. Attendere che XM Discover carichi il file di esempio e mostri un’anteprima.
   
   Consiglio Q: Per informazioni sui possibili errori di convalida, vedere Errori file di esempio.
   Consiglio Q: È possibile aggiornare le mappature dei campi aggiornando la configurazione delle intestazioni di file tramite un file di esempio dopo la creazione di un processo.

Impostazioni file di testo delimitati (CSV)

È possibile applicare le opzioni di impostazione per i file di testo delimitato (CSV) nella pagina Seleziona file.

1. Selezionare il sistema di codifica utilizzato nel file dal menu.
   
2. Immettere il carattere utilizzato per delimitare le immissioni di dati nel file nella casella Carattere delimitatore.
   
   Consiglio Q: immettere solo 1 carattere.
   Consiglio Q: il delimitatore predefinito è una virgola, che può essere utilizzata per i file CSV.
3. Immettere il carattere utilizzato per racchiudere ogni campo dati nel file nella casella Carattere di imballaggio.
   Consiglio Q: immettere solo 2 caratteri.
   Consiglio Q: selezionare la casella di controllo Carattere di imballaggio se i caratteri di imballaggio sono facoltativi.
4. È possibile fare clic sul collegamento qui per scaricare e utilizzare un modello predefinito con una struttura, filtri, utenti e arricchimenti predefiniti archiviati in un unico file come punto di partenza per creare la propria gerarchia organizzativa.
   
   Il file modello CSV per la struttura organizzativa verrà salvato nella posizione predefinita per i download sul computer. Dopo aver scaricato il modello, modificarlo in modo che corrisponda alla struttura organizzativa.
   
   

Impostazioni file Microsoft Excel

È possibile applicare le opzioni di impostazione per i file Microsoft Excel nella pagina Seleziona file. È possibile fare clic sul collegamento qui per scaricare e utilizzare un modello predefinito con una struttura, filtri, utenti e arricchimenti predefiniti archiviati in un unico file come punto di partenza per creare la propria gerarchia organizzativa.

Il file modello Excel per la struttura organizzativa verrà salvato nella posizione predefinita per i download sul computer. Dopo aver scaricato il modello, modificarlo in modo che corrisponda alla struttura organizzativa.

Aggiornamento delle impostazioni dei processi del connettore in entrata della gerarchia organizzativa

È possibile aggiornare le impostazioni per i job del connettore in entrata Gerarchia dell’organizzazione per specificare in che modo il sistema deve gestire le gerarchie organizzative dopo la creazione di un job. Si tratta principalmente di aggiornamenti al di sotto del cofano. Per ogni esecuzione incrementale del connettore Gerarchia dell’organizzazione avviene quanto segue:

1. Viene creata una versione della gerarchia organizzativa originale.
2. La versione creata viene modificata con nuovi file.
3. Se la struttura o i filtri vengono aggiornati, la versione viene pubblicata. La versione non viene pubblicata se vengono aggiornati solo gli utenti e gli arricchimenti.
4. La gerarchia organizzativa originale viene sostituita con una nuova versione.
5. La versione temporanea viene cancellata.
6. La gerarchia organizzativa viene attivata se non è attiva.

Modalità di aggiornamento delle impostazioni dei processi del connettore in entrata della gerarchia dell’organizzazione

1. Accedere ai connettori.
2. Accertarsi che la scheda JOBS sia selezionata.
   
3. Trovare il lavoro che si desidera aggiornare utilizzando i filtri o la ricerca.
4. Espandere il menu Azioni accanto al processo.
5. Selezionare Aggiorna impostazioni gerarchia dell’organizzazione.
6. Nella finestra Aggiorna impostazioni gerarchia dell’organizzazione, è possibile selezionare 1 delle seguenti opzioni della modalità di upload per specificare il modo in cui il sistema deve gestire le gerarchie organizzative:

• Carica gerarchia dell’organizzazione (predefinito): crea e attiva una gerarchia dell’organizzazione. Per ulteriori informazioni, consultare la sezione Carica gerarchia organizzativa.
  Consiglio Q: 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. Per ulteriori informazioni, consultare la sezione Carica gerarchia organizzativa e pubblica.
  Consiglio Q: 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. Per ulteriori informazioni, consultare Reporting di pari livello e principale e Reporting di destinazione e varianza.
  

7. Fai clic su Salva.
   In questo modo si aggiorna il processo e si applicano le nuove impostazioni.

Carica gerarchia organizzativa

Se selezioni l’opzione Carica modalità di caricamento gerarchia dell’organizzazione, puoi selezionare la casella di controllo Genera gruppi basati su questo file utenti per creare gruppi con la tua gerarchia organizzativa.

Carica gerarchia dell’organizzazione e pubblica

Se si seleziona l’opzione Carica gerarchia dell’organizzazione e pubblica la modalità di caricamento, è possibile effettuare le seguenti operazioni:

• Seleziona Genera gruppi basati su questo file utenti per creare gruppi con la tua gerarchia organizzativa.
• Selezionare Includi record senza testo per includere record con testo vuoto nella gerarchia dell’organizzazione.
• Deselezionare Includi record senza testo per escludere record con testo vuoto dalla gerarchia dell’organizzazione.
• Selezionare Includi nei flussi di dati incrementali per includere il modello di gerarchia dell’organizzazione in esecuzioni incrementali.
• Deselezionare Includi nei flussi di dati incrementali per escludere il modello di gerarchia dell’organizzazione dalle esecuzioni incrementali. Se si prevede che la pubblicazione di una gerarchia dell’organizzazione sarà in conflitto con altri flussi di dati Downstream in tempo reale, si consiglia di deselezionare questa opzione. Il modello che viene creato e successivamente classificato non bloccherà altri flussi di dati se questa opzione non è selezionata.
  
  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.