Estrarre i dati dei dipendenti dall'attività SuccessFactors
Cosa puoi trovare in questa pagina
Informazioni sull’estrazione dei dati dei dipendenti da SuccessFactor
L’attività Estrai i dati dei dipendenti da SuccessFactors automatizza l’esportazione dei dati dei dipendenti da SuccessFactors. È possibile importare i dati principali dei dipendenti (nome, e-mail, identificatore univoco), i metadati dei dipendenti (sesso, ruolo, reparto, ecc.) e i dati della gerarchia dell’organizzazione (manager, sede) secondo una pianificazione ricorrente impostata dall’utente. Dopo aver importato i dati in Qualtrics, è necessario salvarli utilizzando un’attività di caricamento dei dati, di solito l’attività load users into EX directory.
Consiglio Q: Per informazioni sui limiti generali che si applicano ai flussi di lavoro ETL, vedere Limiti del flusso di lavoro. Per i limiti specifici dell’attività, fare riferimento alle informazioni riportate in questa pagina.
Impostazione di un’attività di estrazione dei dati dei dipendenti da SuccessFactors
Consiglio Q: Questa attività può importare solo campi booleani e stringhe da SuccessFactors.
Consiglio Q: Dopo aver fatto clic su Aggiungi nuovo account utente, sarete indirizzati a inserire le informazioni del vostro account SuccessFactors. Per trovare i campi necessari, consultate le informazioni sul vostro account SuccessFactors.
Consiglio Q: La piattaforma Qualtrics non supporta impieghi multipli per un singolo partecipante di SuccessFactors. Se un campo ha più valori, l’estrattore estrarrà il valore che è stato modificato più di recente. Attualmente non supportiamo la selezione di altri valori. Inoltre, se in SuccessFactors sono presenti più record per lo stesso dipendente, è necessario utilizzare l’attività Trasformazione di base per filtrare tutti i valori che non sono l’impiego principale.
Consiglio Q: I campi personalizzati possono essere importati inserendo il nome del campo SuccessFactors appropriato (ad esempio, personal_information/custom_fieldname). I campi personalizzati non vengono visualizzati nei risultati della ricerca durante la digitazione. I campi personalizzati devono avere un sottocampo “lastModifiedDateTime” per essere importati.
Dopo aver impostato l’attività SuccessFactors, è necessario indicare a Qualtrics dove salvare i dati con un’attività di caricamento dati. Di solito, si tratta dell’attività di caricamento degli utenti nella directory EX.
Consiglio Q: si consiglia di far passare i dati attraverso un’attività di trasformazione di base prima di inviarli a un’attività di caricamento dati. Ciò consente di assicurarsi che i campi siano nel formato giusto per una facile mappatura nell’attività del caricatore.
Consiglio Q: se si desidera testare il flusso di lavoro senza impattare sulla directory EX live, è possibile utilizzare l’attività Carica in un progetto dati. In questo modo è possibile testare il flusso di lavoro per verificare che tutti i campi siano importati correttamente prima di iniziare ad aggiungere i dipendenti alla directory degli impiegati.
Trovare le informazioni sul vostro account SuccessFactors
Attenzione: I flussi di lavoro precedenti non richiedevano una chiave API o un certificato X.509 per l’autenticazione. Entro maggio 2022, è necessario assicurarsi che tutti i flussi di lavoro che estraggono dati da SuccessFactors utilizzino una chiave API e un certificato X.509 per l’autenticazione. Le istruzioni su come configurare questa autenticità sono disponibili qui. La comunicazione verrà inviata ai clienti in anticipo rispetto a questa modifica.
Dopo aver fatto clic su Aggiungi nuovo account utente, verrà visualizzata una schermata in cui inserire le credenziali OAuth di SuccessFactors. Visitate la pagina Configurazione delle attività di SuccessFactors con credenziali OAuth per le informazioni sui prerequisiti necessari per la configurazione.
- Nome: È l’etichetta che si dà all’account. Questo campo non viene utilizzato per l’autenticatore.
- Nome utente: l’ID utente SAP. Attenzione: Il nome utente e l’ID utente SAP potrebbero essere diversi. L’ID utente è sensibile alle maiuscole e alle minuscole.
- Chiave API, chiave privata del certificato X.509: L’autenticità del certificato X.509 aggiunge un ulteriore livello di protezione ai vostri dati. Quando si registra un client Oauth utilizzando questo certificato, viene generata anche una chiave API. Consiglio Q: Esistono due opzioni per la generazione del certificato e della chiave privata. È possibile generare il proprio certificato e la propria chiave privata, oppure SAP offre un’opzione di generazione durante la registrazione dell’applicazione client OAuth2, che può essere scaricata da SuccessFactors. Se si genera una chiave privata, questa deve essere in formato PKCS8. Per ulteriori informazioni, consultare la documentazione di SAP.
Per maggiori dettagli su questo processo, consultare la seguente documentazione SAP:
-
- Registrazione dell’applicazione client OAuth2
- Creazione di un certificato X.509 in SAP SuccessFactors
- Generazione di un’asserzione SAML
- Richiesta di un gettone di accesso
- Visualizzazione della convalida di un token di accesso Consiglio Q: gli ultimi 3 documenti di questa lista sono destinati agli utenti amministratori di SuccessFactors o a qualsiasi altro utente con il permesso di creare integrazioni OAuth. Per ulteriore assistenza sull’autenticità dei certificati, contattate il supporto di SuccessFactors.
- Dominio del datacenter: Il vostro dominio SuccessFactors. Consiglio Q:non includere http:// nell’URL.
- ID azienda: l’ID dell’azienda SuccessFactors.
Alcuni di questi campi si trovano nella pagina di login di SuccessFactors:
Attenzione: Il nome utente e l’ID utente SAP potrebbero essere diversi. L’ID utente è sensibile alle maiuscole e alle minuscole.
Esempio: Un esempio di ID azienda è BenefitsSB.
Consiglio Q:non includere http:// nell’URL.
Esempio: Un esempio di dominio del datacenter è apisalesdemo4.successfactors.com.
Se avete bisogno di aiuto per accedere alle informazioni di SuccessFactors, consultate la pagina Configurazione delle attività di SuccessFactors con credenziali OAuth o contattate il supporto di SuccessFactors.
Risoluzione dei problemi delle attività di SuccessFactors
Per risolvere i problemi del flusso di lavoro, accedere alla sezione Flussi di lavoro e visualizzare l’output del flusso di lavoro. Se il flusso di lavoro non è andato a buon fine, contiene informazioni sul motivo del fallimento.
Credenziali dell’account non corrette
Vedere Configurazione delle attività di SuccessFactors con le credenziali OAuth.
I campi importati sono vuoti
L’attività Estrai i dati dei dipendenti da SuccessFactors visualizza tutti i campi non personalizzati associati a un account SuccessFactors, ma è possibile che il campo selezionato nell’attività non abbia informazioni associate in SuccessFactors. Assicuratevi che il percorso del campo selezionato corrisponda a un campo riempito in SuccessFactors. Si noti che alcuni nomi campo potrebbero essere associati a più sedi all’interno di SuccessFactors. Ad esempio, “/informazioni_personali/creato_da” e “indirizzo_informazioni/creato_da” sono campi diversi!
Errori di campo comuni
In questa lista sono elencati gli errori più comuni e le relative soluzioni. Questi errori vengono visualizzati durante l’anteprima dei dati importati nell’attività Estrai i dati dei dipendenti da SuccessFactors.
| Messaggio di errore | Risoluzione |
|---|---|
| Richiesta di anteprima della registrazione riuscita, ma sono stati ricevuti zero risultati. | Contattate il supporto di SuccessFactors per sapere perché vengono restituiti zero record. |
| Impossibile analizzare il percorso del campo {{Percorso del campo qui}} dalla risposta. Il percorso del campo deve essere di tipo booleano o stringa. | Questo è un messaggio di avviso che indica che il percorso del campo non è un booleano o una stringa nel record di anteprima. Controllare il tipo di campo nel dizionario ODATA di SuccessFactors. |
| Errore riscontrato durante il recupero del token OAuth da SuccessFactors: {{Errore da SuccessFactors}}. | Errore di credenziale durante la richiesta del token OAuth. Il motivo specifico sarà riportato nel messaggio di SuccessFactors. Motivi noti: Per risolvere questo errore, aggiornare le credenziali in modo che siano corrette. Per ulteriori informazioni, vedere Configurazione delle attività di SuccessFactors con le credenziali OAuth. |
| Errore riscontrato da SuccessFactors durante il recupero del record di anteprima: {{Errore da SuccessFactors}}. | Errore nella chiamata API OData da SuccessFactors. Il motivo specifico sarà riportato nel messaggio di SuccessFactors. Questo errore si verifica perché la proprietà non può essere trovata. Per ulteriori informazioni sulla risoluzione di questo errore, consultare la sottosezione “Proprietà non trovata”. |
| Si è verificato un errore interno imprevisto durante io recupero dell’anteprima della registrazione da SuccessFactors. | Errore interno da parte di QUALTRICS. Contattare il Supporto Qualtrics. |
Proprietà non trovata
Se si sta cercando di importare campi personalizzati di SuccessFactors, il formato non può essere convalidato nella nostra tendina dei campi. Se durante l’anteprima dell’importazione si verifica un errore imprevisto, come “Nomi campo non validi”, verificare in SuccessFactors che il percorso del campo sia corretto.
Per cercare un campo, accedete all’Admin Center di SuccessFactors e navigate fino al Dizionario dei campi dati API OData.
Da qui, andare alla scheda Entità e cercare il campo che si desidera aggiungere. Confermate che il campo esiste e che il percorso del campo corrisponde a quello aggiunto nell’attività di Qualtrics Estrarre i dati dei dipendenti da SuccessFactors. In generale, “PerPerson” è l’entità di base da cui partire per trovare il percorso di campo corretto. Se il percorso del campo è corretto e l’errore persiste, contattate il supporto di SuccessFactors per assistenza.
FAQs
Ho accesso a tutte le estensioni disponibili tramite i modelli di workflow?
Ho accesso a tutte le estensioni disponibili tramite i modelli di workflow?
Esiste un collegamento a tutti i trigger evento workflow, al flusso di controllo e ai task?
Esiste un collegamento a tutti i trigger evento workflow, al flusso di controllo e ai task?
Che cosa sono i modelli di workflow?
Che cosa sono i modelli di workflow?
Che cosa sono i flussi di lavoro? / Dove sono le azioni?
Che cosa sono i flussi di lavoro? / Dove sono le azioni?
Non sono presenti modifiche alla funzionalità del flusso di lavoro come parte di questo aggiornamento.
Come posso distinguere la differenza tra le estensioni di prima parte e quelle di terze parti? Dove vado a chiedere sostegno per entrambi i tipi?
Come posso distinguere la differenza tra le estensioni di prima parte e quelle di terze parti? Dove vado a chiedere sostegno per entrambi i tipi?
Come vengono definiti i criteri di estrazione per questo task?
Come vengono definiti i criteri di estrazione per questo task?
- Se la configurazione del campo non è stata modificata, Qualtrics utilizza la data e l’ora dell’estrazione precedente per filtrare la query OData successiva. La maggior parte delle entità in SuccessFactors contiene un campo “lastModifiedDateTime” e Qualtrics controlla se questa entità è stata modificata dall’ultima estrazione.
- Se la configurazione dei campi è cambiata, Qualtrics fornisce un'opzione per eseguire un'estrazione completa alla prossima esecuzione. Per abilitarlo, fare clic sul collegamento Ricarica i dati visualizzato nel task del caricatore concatenato nello stesso workflow.
È fantastico! Grazie per il tuo feedback!
Grazie per il tuo feedback!