File Importa origini per automazioni

Informazioni su File Importa origini per automazioni

Con le automazioni di importazione dei contatti e le automazioni di importazione dei dipendenti, è possibile ottimizzare la gestione delle directory. Quando è pianificata l’esecuzione dell’automazione, essa elaborerà tutti i file designati che non sono ancora stati elaborati dall’automazione, inclusi i file appena caricati. Tuttavia, prima di poter eseguire questa operazione, l’automazione deve sapere da dove recuperare i file.

La sorgente file per le automazioni di importazione dei contatti e dei dipendenti può essere:

1. File Service Qualtrics
2. Il tuo server SFTP
3. Archivio file OAuth (Google Drive o Dropbox)

File Service Qualtrics

Il File Service Qualtrics è un’API di archiviazione file protetta che ti consente di caricare file da importare per questa automazione. È possibile caricare un file in un endpoint HTTPS, che verrà fornito in una casella grigia (mostrata di seguito) come dati in formato multiparte.

Quando è pianificata l’esecuzione dell’automazione, essa elaborerà tutti i file che non sono ancora stati elaborati dall’automazione, inclusi quelli appena caricati.

Per utilizzare il File Service Qualtrics, sarà necessario chiamare il punto finale HTTPS fornito. Se il file viene generato dal sistema, si intende fornire la documentazione API e la seguente implementazione di esempio al proprio team IT o di progettazione software per l’integrazione con il nostro servizio.

curl -X POST -H "X-API-TOKEN: [TUO TOKEN API]" \
 -F 'file=@/path/to/import/file/sample-file.txt' \
 https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files

curl -X POST -H "X-API-TOKEN: [YOUR API TOKEN]" ^
 -F "file=@/path/to/import/file/sample-file.txt" ^
 https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files

POST https://datacenterid.qualtrics.com/automations-file-service/automations/AU_XXXXXXXXX/files HTTP/1.1 
 Content-Type: multipart/form-data
 X-API-TOKEN: [YOUR API TOKEN]
 
 -----------------------------
 Content-Disposition: form-data; name="upfile"; filename="sample-file.txt"
 Content-Type: text/plain
 
 [DATI FILE]
 -----------------------------

Gestisci manualmente i file caricati con API

Puoi anche gestire manualmente i file caricati utilizzando l’API Qualtrics. I seguenti collegamenti spiegano come interagire con l’API File Service di Qualtrics:

• Elenca tutti i file caricati per questa automazione.
• Carica un file che deve essere utilizzato da questa automazione.
• Ottenere i metadati associati a un file.
• Ottiene il contenuto di un file.
• Rimuovere un file.

A volte, queste chiamate API richiederanno un ID di automazione. Qualtrics ti fornirà queste informazioni, formattate come AU_XXXXX.

Fasi successive – Automazione importazione contatti directory XM

Ora che hai terminato di impostare il file Service di Qualtrics come origine di importazione, è il momento di concludere la creazione dell’automazione di importazione contatti.

• Fase 3: Crittografia PGP
• Passo 4: selezione dei percorsi cartella
• Passaggio 5: Mappatura dei campi dati e liste di invio
• Fase 6: Collegamento alle automazioni di distribuzione
• Passo 7: invio di report di esecuzione e attivazione dell’automazione

Fasi successive – Automazione importazione dipendenti Directory dipendenti

• Fase 3: Crittografia PGP
• Passo 4: selezione dei percorsi cartella
• Passo 5: mappaggio campi dati
• Passo 6: invio di report di esecuzione e attivazione dell’automazione

Server SFTP

Potresti voler integrare i tuoi record di contatto con Qualtrics utilizzando Secure File Transfer Protocol (SFTP). Ad esempio, potresti voler importare contenuti da un elenco di file quotidiani ospitati, quindi importare e pianificare le distribuzioni dei sondaggi per quei contatti, il tutto con i metodi di trasferimento più sicuri e sicuri.

Quando è pianificata l’esecuzione dell’automazione, essa elaborerà tutti i file che non sono ancora stati elaborati dall’automazione, inclusi quelli appena caricati. Quando un file viene elaborato, viene rimosso dal server SFTP.

Nel passaggio Configura origine importazione sono presenti 2 opzioni SFTP: Nome utente & Password e nome utente & Chiave SSH.

1. Nella fase Configura origine importazione, selezionare uno dei server SFTP.
   
2. Fare clic su Continua.
3. Immettere l’ URL host.
   
   Qtip: l’URL di solito assomiglia a sftp.example.com.
4. Inserire il nome utente. Viene fatta distinzione tra maiuscole e minuscole.
5. Immettere la Porta. Questo è facoltativo. 22 viene inserito come valore di default.
6. Fai clic su Continua.

A seconda che sia stata selezionata la password o lachiave SSH, i passaggi successivi varieranno.

Configurazione tramite nome utente & password

1. Immettere la password.
   
   Qtip: se sono già stati forniti l’host, il nome utente e la porta esatti, non verrà richiesta una password.
2. Fai clic su Continua.

Configurazione tramite nome utente & chiave SSH

1. Se non è già presente una chiave, selezionare l’opzione Genera nuova coppia di chiavi SSH.
   
   Qtip: Genera nuova coppia di chiavi SSH è ancora presente anche se è già stata generata una chiave. Questa opzione può essere selezionata se l’utente intende creare una nuova chiave, tuttavia ciò non è necessario se le stesse credenziali SFTP vengono utilizzate per la nuova automazione. La coppia di chiavi viene condivisa tra tutte le automazioni utilizzando le stesse credenziali SFTP all’interno di un singolo account utente.
2. Fare clic su Scarica la chiave pubblica.
   
3. Caricare la chiave pubblica sul server SFTP.

Cifrature supportate

La connessione a un server SFTP richiede una serie di handshakes SSH per coordinare la crittografia utilizzata tra il server e l’automazione. Per stabilire una connessione, il server SFTP dovrà avere almeno un cifrario per ogni tipo di cifrario che corrisponda a un cifrario supportato dalle automazioni. Di seguito l’elenco dei cifrari supportati dalle automazioni raggruppate in base al tipo di cifrario.

Codici di conversione supportati:

• curve25519-sha256@libssh.org
• diffie-hellman-group14-sha1
• diffie-hellman-group1-sha1
• diffie-hellman-group-exchange-sha256
• ecdh-sha2-nistp256
• ecdh-sha2-nistp384
• ecdh-sha2-nistp521

Ciphers Mac supportati:

• hmac-sha2-256
• hmac-sha2-512

Cifrature di crittografia supportate:

• aes128-ctr
• aes192-ctr
• aes256-ctr
• aes128-cbc
• Arcfour256
• Arcfour128
• Arcfour
• 3des-cbc

Supportato Cipher Suites:

• chacha20-poly1305@openssh.com: Chacha20 è un algoritmo di crittografia simmetrica, mentre Poly1305 è un cifrario autenticante.
• aes128-gcm@openssh.com: Advanced Encryption Standard (AES) con una chiave a 128 bit che utilizza il Galois/Counter Mode (GCM).

Se il server SFTP non supporta le crittografie appropriate, si consiglia di utilizzare una delle altre origini di importazione presentate in questa pagina.

Fasi successive – Automazione importazione contatti directory XM

Ora che hai terminato di configurare un server SFTP come origine di importazione, è il momento di concludere la creazione dell’automazione dell’importazione contatti.

• Fase 3: Crittografia PGP
• Passo 4: selezione dei percorsi cartella
• Passaggio 5: Mappatura dei campi dati e liste di invio
• Fase 6: Collegamento alle automazioni di distribuzione
• Passo 7: invio di report di esecuzione e attivazione dell’automazione

Fasi successive – Automazione importazione dipendenti Directory dipendenti

• Fase 3: Crittografia PGP
• Passo 4: selezione dei percorsi cartella
• Passo 5: mappaggio campi dati
• Passo 6: invio di report di esecuzione e attivazione dell’automazione

Google Drive & Dropbox

È possibile utilizzare il proprio account Google Drive o Dropbox come archiviazione file per le automazioni di importazione dei contatti. Le informazioni di accesso per questi servizi rimarranno private; OAuth File Storage consente a Qualtrics di utilizzare le informazioni dell’account di un utente finale senza esporre la password dell’utente. Le informazioni di questo account vengono utilizzate per connettersi all’archiviazione file dalle automazioni nella directory XM, comportandosi in modo simile a un’impostazione SFTP.

Quando è pianificata l’esecuzione dell’automazione, essa elaborerà tutti i file che non sono ancora stati elaborati dall’automazione, inclusi quelli appena caricati. Quando un file viene elaborato, viene rimosso dall’archivio file OAuth.

1. Nella fase Configura origine di importazione, selezionare Google Drive o Dropbox.
   
2. Fai clic su Continua.
3. Sarà necessario accedere al proprio account Google o Dropbox facendo clic su Accedi.  In questo modo si verrà reindirizzati a una nuova finestra in cui è possibile accedere tramite OAuth.
   
4. Una volta eseguito correttamente l’accesso, si verrà reindirizzati per concludere la configurazione o, se necessario, si passerà dagli account a un altro utente OAuth. È inoltre possibile rimuovere l’account OAuth facendo clic su Modifica sull’origine dati e selezionando un’origine dati alternativa.
   
5. Passare alla sezione Seleziona origine file di importazione dopo aver configurato l’origine di importazione. Qui potrai dichiarare il tuo percorso cartella (ad es., “NomeCartella/Cartella2”).
   

Fasi successive – Automazione importazione contatti directory XM

Ora che hai terminato di configurare un server SFTP come origine di importazione, è il momento di concludere la creazione dell’automazione dell’importazione contatti.

• Fase 3: Crittografia PGP
• Passo 4: selezione dei percorsi cartella
• Passaggio 5: Mappatura dei campi dati e liste di invio
• Fase 6: Collegamento alle automazioni di distribuzione
• Passo 7: invio di report di esecuzione e attivazione dell’automazione

Fasi successive – Automazione importazione dipendenti Directory dipendenti

• Fase 3: Crittografia PGP
• Passo 4: selezione dei percorsi cartella
• Passo 5: mappaggio campi dati
• Passo 6: invio di report di esecuzione e attivazione dell’automazione