Opzione 5: esegui la soluzione Node per recuperare i token, quindi crea un'integrazione in un'origine esterna come Workday per l'importazione basata su API

Dopo aver registrato una nuova app nel interfaccia di amministrazione di Microsoft 365, generato un segreto client e configurato l'importazione nel interfaccia di amministrazione di Microsoft 365, puoi eseguire la soluzione Node per recuperare i token nella console. L'esecuzione di questa soluzione genera i token necessari per creare l'integrazione API nell'origine esterna, come Workday. Scopri come su GitHub.

1. Eseguire la soluzione

  1. Clona questa app nel computer eseguendo il comando seguente nella riga di comando:

    git clone https://github.com/microsoft/orgdata_apibasedimport.git

  2. Includi i valori della console seguenti:

  • AppID/ID client
  • Segreto client
  • ID tenant di Microsoft Entra
  • ID connettore
  • Unità di scala
  1. Lo script verrà eseguito e aprirà una nuova finestra del browser. Accedere con lo stesso indirizzo di posta elettronica immesso in ID app o UPN durante la configurazione dell'importazione nell'interfaccia di amministrazione di Microsoft 365.

  2. Nella pagina Configurazione integrazione HRIS , copia in modo sicuro i seguenti valori, che potrai utilizzare per creare l'integrazione nella tua fonte esterna , ad esempio Workday Report as a Service (RaaS):

  • Indirizzo HTTP
  • Token di accesso
  • Aggiorna token
  • Aggiorna URL token

2. Creare un report personalizzato in Workday

Si applica a: amministratore globale di Microsoft 365 o amministratore dell'origine dati dell'organizzazione

  1. Aprire Workday, cercare "Crea report personalizzato" e selezionarlo.

    Uno screenshot mostra come cercare un report personalizzato.

  2. Immettere un nome per il report.

  3. Accanto a Tipo di rapporto, seleziona Avanzate.

  4. Accanto a Origine dati selezionare Lavoratori per la creazione di report HCM.

  5. Lascia deselezionata l'opzione Ottimizzato per le prestazioni per filtrare i lavoratori che non hanno un indirizzo di posta elettronica. Microsoft identifica i lavoratori in base all'indirizzo di posta elettronica, quindi è un campo obbligatorio.

    Uno screenshot mostra la pagina dei dettagli del report.

  6. Selezionare OK nella parte inferiore della pagina.

  7. Per aggiungere campi di posta elettronica del manager:

    1. Selezionare il menu a tre punti a destra del nome del report.

    2. Selezionare Campo calcolato per il report>Crea campo calcolato.

      Una schermata mostra come creare un campo calcolato.

    3. Immettere un nome per il nuovo campo, ad esempio "Manager Email".

    4. Accanto a Business Object immettere "Lavoratore".

    5. Accanto a Funzione immettere "Valore correlato alla ricerca".

      Uno screenshot mostra i dettagli del campo calcolato.

    6. Selezionare OK.

    7. Nella schermata successiva, accanto a Campo di ricerca, immettere "Manager - Livello 01".

    8. Accanto a Valore restituito, immettere il campo e-mail desiderato, ad esempio Indirizzo Email lavoro primario pubblico.

      Uno screenshot mostra i dettagli della ricerca dei campi calcolati.

    9. Selezionare OK nella parte inferiore della pagina.

  8. Aggiungere campi e personalizzare il report in base alle esigenze dell'organizzazione:

    1. Selezionare il menu a tre punti a destra del nome del report.

    2. Selezionare Modifica report> personalizzato.

    3. Accanto a Filtro origine dati immettere "Tutti i ruoli di lavoro attivi (tutti i tipi)".

    4. Nella scheda Colonne , seleziona l'icona "+" in alto a sinistra per aggiungere campi.

      Uno screenshot mostra come personalizzare il report.

Esempio di mapping per la maggior parte dei campi riservati elencati qui

  • Il campo Manager Email fa riferimento al campo calcolato impostato in precedenza.

  • Questa è la migliore ipotesi per la mappatura di ciascun campo; Potrebbero essere disponibili mapping più adatti specifici per il tenant.

  • Uno qualsiasi dei campi riservati collegati sopra può essere aggiunto qui, se non lo è già. È anche possibile aggiungere qualsiasi campo personalizzato con qualsiasi nome e importarlo in qualsiasi app che usa campi personalizzati.

Oggetto business Campo Sostituzione intestazione di colonna Sostituzione dell'alias XML dell'intestazione di colonna
Lavoratore ID dipendente Microsoft_EmployeeID Impostare questa colonna in modo che corrisponda allo stesso valore di Sostituzione intestazione di colonna
Lavoratore Indirizzo Email di lavoro primario pubblico Microsoft_PersonEmail
Lavoratore Manager Email Microsoft_ManagerEmail
Lavoratore Organismo di vigilanza Microsoft_Organization
Lavoratore Livello dirigenziale Microsoft_LevelDesignation
Lavoratore Single Job Family Microsoft_JobDiscipline
Lavoratore Titolo dell'azienda Microsoft_JobTitle
Lavoratore Posizione - Nome Microsoft_CompanyOfficeLocation
Lavoratore Data assunzione Microsoft_HireDate
Lavoratore Nome Microsoft_FirstName
Lavoratore Cognome Microsoft_LastName
Lavoratore Nome legale nel formato di visualizzazione dei report Microsoft_DisplayName
Lavoratore Azienda - Nome Microsoft_Company
Lavoratore Indirizzo aziendale - Formattato alla riga 1 Microsoft_CompanyOfficeStreet
Lavoratore Indirizzo di lavoro - Città Microsoft_CompanyOfficeCity
Lavoratore Indirizzo di lavoro - Stato/provincia Microsoft_CompanyOfficeState
Lavoratore Indirizzo aziendale - CAP Microsoft_CompanyOfficePostalCode
Lavoratore Indirizzo aziendale - Paese/area geografica Microsoft_CompanyOfficeCountryOrRegion
Lavoratore Tipo di lavoro - Testo Microsoft_EmploymentType
Lavoratore Competenze attive Microsoft_UserSkillNames
Lavoratore Numero di telefono dell'ufficio principale pubblico Microsoft_Phone
Lavoratore Centro di costo - ID Microsoft_CostCenter
Lavoratore Divisione Microsoft_Division

Filtrare gli utenti che non hanno un indirizzo di posta elettronica aggiungendoli alla scheda Filtro , ad esempio:

Uno screenshot mostra come filtrare i lavoratori che non hanno un indirizzo di posta elettronica.

Dopo aver personalizzato il report, seleziona Avanzate. Quindi, in Opzioni servizi Web, selezionare Abilita come servizio Web.

3. Crea l'integrazione nella tua fonte esterna

Segui questi passaggi per creare l'integrazione API in Workday.

  1. Nella parte superiore dello schermo in Workday cercare "Crea EIB" e selezionarlo.

  2. Nella pagina Crea BEI:

    1. Immettere un nome per l'integrazione.
    2. Selezionare In uscita.
    3. Selezionare OK.
  3. Rivedere e confermare i dettagli nella pagina Impostazioni generali . Se è tutto come desiderato, selezionare Avanti.

  4. Nella pagina Recupera dati :

    1. Accanto a Tipo di origine dati selezionare Report personalizzato.

    2. Accanto a Report personalizzato selezionare il report da integrare con il connettore di Archiviazione BLOB di Azure.

    3. In Dettagli, accanto a Formato di output alternativo, selezionare CSV (Alternate Output Format).

      Uno screenshot mostra come immettere i dettagli nella pagina Recupera dati.

    4. Nella parte inferiore della pagina selezionare Avanti.

  5. Nella pagina Trasforma non è necessario apportare modifiche. Seleziona Avanti.

  6. Nella pagina Recapita :

    1. Accanto a Metodo di recapito selezionare HTTP/SSL.
    2. Accanto a Indirizzo HTTP immettere l'indirizzo generato dai passaggi precedenti.
    3. Accanto a Tipo di chiamata servizio Web, selezionare OAuth 2.0.
    4. Accanto a Token di accesso, immettere il token di accesso generato dai passaggi precedenti.
    5. Accanto ad Aggiorna token, immettere il token di aggiornamento generato dai passaggi precedenti.
    6. Accanto a URL token di aggiornamento immettere l'URL del token di aggiornamento generato dai passaggi precedenti.
    7. Accanto a ID client, immetti l'AppID/ClientID.
    8. Accanto a Segreto client immettere il segreto client.
    9. Accanto a Nome file immettere il nome del file desiderato, che deve essere .csv.
    10. Nella parte inferiore della pagina Recapita selezionare Avanti.
  7. Rivedere i dettagli nella pagina Rivedi e invia . Se sembra tutto corretto, selezionare OK.

  8. Accanto al nome dell'integrazione, selezionare Azioni.

  9. Passare il puntatore del mouse su Integrazione, quindi selezionare Avvia/Pianifica integrazione.

  10. Nella pagina Integrazione avvio/pianificazione :

    1. Accanto a Integrazione, seleziona il nome dell'integrazione creata.
    2. Accanto a Frequenza di esecuzione, scegli la frequenza desiderata.
    3. Selezionare OK.

    Uno screenshot mostra come immettere i dettagli dell'integrazione avviata.