Aggiornare la soluzione Workday per employee Self-Service

Importante

Questo articolo è destinato alle distribuzioni già incluse nell'integrazione semplificata di Workday e che applicano una versione successiva della soluzione Workday. Se si applica uno scenario diverso, iniziare da qui:

Questa versione della soluzione Workday rimuove una dipendenza dall'operazione SOAP solo Get_References amministratore di Workday per gli argomenti Self-Service employee selezionati. In precedenza, alcuni scenari dei dipendenti connessi potevano non riuscire perché la chiamata sottostante richiedeva l'accesso a livello di amministratore al dominio Integration Build di Workday.

Per risolvere questo requisito, i dati di riferimento usati dagli argomenti interessati, ad esempio i tipi di dispositivo telefono e i codici di telefono paese, sono ora incorporati nella soluzione Workday come configurazioni di modello. L'agente legge questi valori incorporati in fase di esecuzione, quindi la chiamata SOAP solo amministratore non è più necessaria per i dipendenti connessi.

Per fare spazio ai dati incorporati, la lunghezza massima del campo Valore nella tabella Employee Self-Service Template Configuration è passata da 10.000 a 50.000 caratteri. Questa modifica viene fornita nelle soluzioni Employee Self-Service Core, HR e IT, non nella soluzione Workday, quindi l'ordine in cui si esegue l'aggiornamento è importante.

Novità di questa versione

  • L'argomento di aggiornamento del telefono non ha più esito negativo per i dipendenti che hanno eseguito l'accesso a causa del Get_References gap di autorizzazioni.
  • 17 set di dati di riferimento vengono forniti all'interno della soluzione Workday come configurazioni di modello. È possibile personalizzarli in Dataverse se il tenant di Workday usa ID di riferimento non predefiniti. Vedere Personalizzare i dati di riferimento di Workday.
  • La colonna Valore della tabella Employee Self-Service Template Configuration è aumentata a 50.000 caratteri.
  • Non sono necessarie modifiche al connettore o alle credenziali. Le connessioni Workday esistenti continuano a funzionare.

Prima di iniziare

Prima di iniziare l'aggiornamento, verificare quanto segue:

  • Si dispone dell'accesso dell'amministratore di sistema all'ambiente Power Platform in cui sono installate le soluzioni employee Self-Service.
  • È disponibile la versione più recente di ogni soluzione employee Self-Service installata (Employee Self-Service Core, Employee Self-Service HR e Employee Self-Service IT), oltre alla nuova soluzione Workday. Controllare le note sulla versione per i numeri di build esatti.
  • È stata pianificata una finestra di manutenzione per gli utenti finali. L'aggiornamento viene completato in pochi minuti, ma un aggiornamento non riuscito può disabilitare gli argomenti di Workday fino a quando non si completano i passaggi di ripristino.
  • È stato eseguito il backup di tutte le configurazioni di modello personalizzate nell'ambiente. Le personalizzazioni per i record della soluzione gestita vengono reimpostate durante gli aggiornamenti del pacchetto. Vedere Personalizzare i dati di riferimento di Workday per i passaggi di backup e ripristino.

In ambienti in cui è già installata una versione precedente di Employee Self-Service, seguire esattamente questo ordine:

  1. Aggiornare ogni soluzione employee Self-Service presente nell'ambiente, inclusi Employee Self-Service Core, Employee Self-Service HR e Employee Self-Service IT. Aggiornarli alla versione che include le dimensioni del campo di 50.000 caratteri per la colonna Employee Self-Service Template Configuration Value.Upgrade them to the version that includes the 50,000-character field size for the Employee Self-Service Template Configuration Value column.
  2. Aggiornare la soluzione Workday dopo che tutte le soluzioni employee Self-Service sono disponibili nella nuova versione.

Le installazioni fresche non hanno requisiti di ordine speciale. In un ambiente pulito, le soluzioni employee Self-Service vengono installate prima di Workday, quindi la dipendenza si risolve naturalmente.

Screenshot dell'elenco soluzioni Copilot Studio che mostra le soluzioni employee Self-Service da aggiornare prima della soluzione Workday.

Importante

Se l'ambiente esegue più agenti Self-Service dipendenti affiancati, ad esempio Employee Self-Service Core, Employee Self-Service HR e Employee Self-Service IT nello stesso ambiente, aggiornare ogni soluzione Employee Self-Service installata prima di aggiornare la soluzione Workday. Power Platform risolve le dimensioni del campo di un attributo gestito al livello di soluzione attivo più basso. Se anche una soluzione Employee Self-Service è ancora nella versione precedente, le dimensioni del campo rimangono a 10.000 caratteri e l'aggiornamento di Workday non riesce. Ad esempio, se sono installate tre soluzioni employee Self-Service, tutte e tre devono trovarsi nella nuova versione prima di aggiornare Workday.

Convalidare prima di aggiornare Workday

Prima di importare la soluzione Workday, verificare che le soluzioni employee Self-Service siano pronte usando una delle opzioni seguenti.

Opzione A: Controllare le dimensioni del campo in Dataverse

  1. Nel portale di Power Apps Maker selezionare Soluzioni.
  2. Aprire Soluzione predefinita.
  3. Selezionare Tabelle, cercare Employee Self-Service Template Configuration e quindi aprire Colonne.
  4. Individuare la colonna Valore , aprire Altri comandi e quindi selezionare Avanzate>Vedi livelli della soluzione.
  5. Aprire il livello della soluzione superiore e verificare che la lunghezza massima sia 50.000.

Screenshot della visualizzazione dei livelli della soluzione per la colonna Valore che mostra una lunghezza massima di 50000.

Opzione B: Controllare le versioni della soluzione installata

Nel portale di Power Apps Maker aprire Soluzioni e verificare che ogni versione della soluzione Employee Self-Service corrisponda alla versione elencata nelle note sulla versione per questa versione. Se una soluzione è ancora in una versione precedente, aggiornarla prima di continuare.

Convalidare dopo l'aggiornamento di Workday

Al termine dell'aggiornamento di Workday, chiedere a un utente finale di eseguire "Qual è il centro di costo?" o una richiesta rapida simile. Una risposta normale conferma che il flusso ESS HR Workday è attivo e che l'agente risponde. Eseguire quindi "aggiorna il numero di telefono" per verificare che il flusso di aggiornamento del telefono funzioni end-to-end.

Cosa accade se si perde l'ordine di aggiornamento

Se si aggiorna la soluzione Workday prima delle soluzioni Employee Self-Service, l'importazione avrà esito negativo con questo errore di convalida:

A validation error occurred. The length of the 'msdyn_value' attribute of the 'msdyn_employeeselfservicetemplateconfig' entity exceeded the maximum allowed length of '10000'.

Questo errore viene visualizzato nell'area Soluzioni e nel log di importazione della soluzione.

Screenshot della pagina Impostazioni che mostra un errore di installazione di Workday non riuscito con un collegamento per scaricare il file di log.

Vale la pena conoscere un secondo sintomo. Quando l'aggiornamento della soluzione Workday non riesce, il flusso cloud di Power Automate denominato ESS HR Workday è disattivato. Questo flusso orchestra le chiamate a Workday dall'agente. Mentre il flusso è disattivato, l'utente finale richiede che funzioni prima che l'aggiornamento si interrompa. Ad esempio:

  • "Qual è il mio centro di costo?"
  • "Chi è il mio manager?"
  • "Mostrami i miei passaporti."
  • Qualsiasi altra richiesta che chiama un argomento Workday.

La versione di lavoro installata in precedenza della soluzione Workday è ancora presente nell'ambiente. L'aggiornamento non è stato eseguito in avanti, ma il flusso di supporto viene lasciato in uno stato disabilitato.

Ripristinare se è già stato raggiunto l'errore

Se l'aggiornamento ha già avuto esito negativo e le richieste dell'utente finale non rispondono più, seguire questa procedura.

Passaggio 1: Ripristinare lo stato di lavoro precedente

  1. Accedere a Power Automate nello stesso ambiente di un amministratore di sistema.
  2. Aprire Flussi e selezionare ESS HR Workday.
  3. Aprire il flusso e selezionare Attiva dalla barra dei menu in alto.

Screenshot del flusso ESS HR Workday in Copilot Studio con il comando Attiva evidenziato.

Dopo che il flusso è stato nuovamente attivato, le richieste che funzionavano prima dell'aggiornamento rispondono come in precedenza. A questo punto, si torna alla versione precedente del pacchetto, con l'aggiornamento del telefono originale o gli argomenti del visto ancora presenti, ma tutto il resto funziona.

Passaggio 2: Ritentare l'aggiornamento nell'ordine corretto

  1. Aggiornare ogni soluzione Employee Self-Service (Core, HR e IT) alla versione più recente.
  2. Aggiornare la soluzione Workday.

Al termine dell'aggiornamento di Workday, tornare a Power Automate e verificare che il flusso ESS HR Workday sia nello stato Attivato . Se è disattivato per qualsiasi motivo, riattivarlo come descritto nel passaggio 1.

Ottenere assistenza

Se si verifica l'errore di aggiornamento descritto in questo articolo o si nota un comportamento imprevisto dopo l'aggiornamento, contattare il canale di supporto consueto. Includere il messaggio di errore, il log di importazione della soluzione, le versioni della soluzione Employee Self-Service installate e la versione della soluzione Workday.