Configurations pour utiliser Finances Workday l’API REST

Rversion finale: Xanadu

Mis à jour 1 août 2024

4 minutes de lecture

Configurez votre ServiceNow instance pour effectuer des actions qui utilisent l’API Finances Workday REST.

Avant de commencer

Demander un Hub d'intégration abonnement.
Activer Workday RH le spoke.
Dans Workday, obtenez ces valeurs et enregistrez-les pour une utilisation ultérieure. Ces valeurs sont nécessaires pour enregistrer votre client :
- ID client
- Secret client
- Finances Workday Point de terminaison de REST API
- Point de terminaison de jeton
- Point de terminaison d’autorisation
Rôle requis : administrateur

Pourquoi et quand exécuter cette tâche

Finances Workday L’API REST et RAAS (Report-as-a-Service) fonctionne avec OAuth 2.0 pour autoriser l’accès aux ressources dans votre Finances Workday locataire. Pour utiliser OAuth 2.0, vous devez enregistrer votre client dans le locataire, à l’aide de la tâche Enregistrer le client d’API.

Configurez votre ServiceNow instance pour utiliser l’API Finances Workday REST si vous avez besoin d’utiliser ces actions de spoke basées sur REST :

Obtenir la structure de mon reporting
Rechercher les champs personnalisés de l'objet
Mettre à jour les champs personnalisés de l'objet
Rechercher un bulletin de paie
Rechercher les rémunérations globales à l’aide de Rapport
Rechercher des rapports personnalisés
Rechercher des éléments dans la boîte de réception
Rechercher les détails du plan au mérite et du régime de prestations d'un employé.
Rechercher le WID de référence des calendriers des congés d'un employé
Rechercher le WID de référence de planification des calendriers d'un employé
Rechercher les calendriers des congés d'un employé

Remarque :

Ces configurations sont nécessaires pour utiliser les actions de spoke basées sur REST.

S’inscrire Workday RH en tant que fournisseur OAuth

Enregistrez l’instance Workday RH en tant que fournisseur OAuth afin qu’elle ServiceNow puisse demander des jetons OAuth 2.0.

Avant de commencer

Rôle requis : administrateur

Procédure

Accédez à la Tout > OAuth système > Registre d'application.
Cliquez sur Nouveau.
Le système affiche le message suivant : Quel type d’application OAuth ?
Sélectionnez Se connecter à un fournisseur OAuth tiers.

Renseignez ces valeurs sur le formulaire.

Tableau 1. Formulaire des registres d'application
Champ	Description
Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, entrez : `OAuth RH Workday`
Application	Application à laquelle l’enregistrement s’applique. Sélectionnez Spoke Workday RH.
ID client	ID client généré lors de l’enregistrement de votre client.
Secret client	Secret client généré lors de l’enregistrement de votre client.
URL d'autorisation	Point de terminaison d’autorisation généré lors de l’enregistrement de votre client.
URL de jeton	Point de terminaison de jeton généré lors de l’inscription de votre client.
URL de redirection	Point de terminaison de rappel OAuth au format suivant : `https://<instance>.service-now.com/oauth_redirect.do`
Type d'accord par défaut	Type d'accord utilisé pour établir le jeton. Sélectionnez Code d'autorisation.
Actif	Option permettant d’utiliser activement le registre d’application.

Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
Un profil d’entité OAuth est créé.

Créer un enregistrement d’informations d’identification pour le Workday RH spoke

Créez un enregistrement d’informations d’identification pour l’instance Workday RH . Les Workday RH alias de connexion et d’informations d’identification du spoke utilisent ces informations d’identification pour autoriser des actions.

Avant de commencer

Rôle requis : admin.

Procédure

Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
Cliquez sur Nouveau.

Le système affiche ce message : Quel type d’informations d’identification voulez-vous créer ?
Sélectionnez Informations d'identification OAuth 2.0.

Renseignez ces valeurs sur le formulaire.

Tableau 2. Formulaire Informations d'identification OAuth 2.0
Champ	Description
Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, `Cred. Workday RH`.
Actif	Option permettant d'utiliser activement l'enregistrement des informations d'identification.
Profil de l'entité OAuth	Profil d’entité OAuth créé lors de Workday RH l’inscription en tant que fournisseur OAuth. Par exemple, Profil OAuth.

Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Envoyer.
Pour générer le jeton OAuth, cliquez sur le lien connexe Obtenir le jeton OAuth.

Créer un enregistrement de connexion pour le spoke Workday RH

Créez un enregistrement de connexion pour votre Workday RH instance. Les alias de connexion et d’informations d’identification du spoke Workday RH utilisent ces connexions pour effectuer des actions dans Workday RH.

Avant de commencer

Rôle requis : admin.

Procédure

Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d’informations d’identification.
Ouvrez l’enregistrement d’alias, WorkdayHR.
Dans l’onglet Connexions , cliquez sur Nouveau.

Renseignez les champs suivants du formulaire.

Remarque :

Assurez-vous de créer l’enregistrement de connexion dans l’application Spoke Workday RH .

Tableau 3. Formulaire Connexion
Champ	Description
Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple : `Connexion aux RH Workday`
Informations d'identification	Enregistrement d’informations d’identification créé pour le spoke de Workday RH. Par exemple, `Cred. Workday RH`.
Alias de connexion	Enregistrement d'alias associé à cette connexion.
URL de connexion	URL pour vous connecter à votre Workday RH instance.
Actif	Option permettant d’utiliser activement l’enregistrement de connexion.

Renseignez ces valeurs dans l’onglet Attributs .


Champ	Valeur
Nom de locataire	Nom du locataire de votre Finances Workday application.
Version	v1

Cliquez sur Envoyer.