Aperçu

Création de définitions d'action

Pour lier les champs d'entrée d'action aux champs Apps, vous avez besoin d'une définition d'action.

1. Préparation de la définition de l'action

Avant d'ajouter la définition d' Action à Action Center, vous devez créer un schéma JSON pour celle-ci. Le fichier doit suivre la norme du schéma JSON. Vous pouvez également télécharger l'exemple de schéma, le modifier et télécharger une version modifiée de celui-ci.

1. Commencez par ajouter une accolade ouverte pour indiquer le début de l'objet JSON.
2. À l'intérieur de l'objet JSON, définissez les propriétés Name et Description sous forme de chaînes, avec leurs valeurs.

   {
       "Name": "Sample Definition",
       "Description": "Sample Definition Description"

3. Ajoutez une propriété Allowed Actions sous la forme d'un tableau de chaînes pour spécifier les actions autorisées que vous pouvez effectuer à la fin de l'action. Les valeurs doivent être l'équivalent de Approuver (Approve) ou Rejeter(Reject).

   "AllowedActions": [
           "Start On-boarding",
           "Request more details"
       ],

4. Ajoutez une propriété Schema et attribuez-lui un objet qui respecte la norme JSONSchema : http://json-schema.org/draft-07/schema#.

   "Schema": {
           "$schema": "http://json-schema.org/draft-07/schema#",
           "type": "object",

5. Dans l'objet properties , définissez chaque propriété que vous souhaitez inclure dans le schéma. Pour chaque propriété, spécifiez ses type et description.
   Chaque propriété du Schema est l'équivalent des champs d'entrée que vous ajouterez dans l'action d'application.

   "properties": {
               "employee_id": {
                   "type": "string",
                   "description": "The unique identifier of the employee."
               },
               "first_name": {
                   "type": "string",
                   "description": "The first name of the employee."
               },
               "last_name": {
                   "type": "string",
                   "description": "The last name of the employee."
               },
               "email": {
                   "type": "string",
                   "format": "email",
                   "description": "The email address of the employee."
               },
               "address": {
                   "type": "object",
                   "properties": {
                       "street": {
                           "type": "string",
                           "description": "The street address of the employee."
                       },
                       "city": {
                           "type": "string",
                           "description": "The city where the employee resides."
                       },
                       "state": {
                           "type": "string",
                           "description": "The state where the employee resides."
                       },
                       "zip_code": {
                           "type": "string",
                           "description": "The zip code of the employee's address."
                       },
                       "country": {
                           "type": "string",
                           "description": "The country where the employee resides."
                       }
                   },
                   "required": [
                       "street",
                       "city",
                       "state",
                       "zip_code",
                       "country"
                   ],
                   "description": "The address of the employee."
               },
               "hire_date": {
                   "type": "string",
                   "format": "date",
                   "description": "The date the employee was hired in the format YYYY-MM-DD."
               },
               "salary": {
                   "type": "number",
                   "minimum": 0,
                   "description": "The salary of the employee."
               }
           }

   Si vous avez des objets imbriqués comme address, selon cet exemple, définissez-les de la même manière dans l'objet properties , en spécifiant leur type et leurs propriétés.
6. Si certaines propriétés sont requises, incluez un tableau required , dans lequel vous répertoriez les propriétés que vous souhaitez marquer comme requises dans l'action.

   "required": [
               "employee_id",
               "first_name",
               "last_name",
               "email",
               "address",
               "salary",
               "hire_date"
           ]

7. Fermez l'objet JSON en ajoutant une accolade de fermeture.

2. Téléchargement de la définition d'action dans Action Center

Après avoir créé le schéma JSON de la définition d'action, vous pouvez le télécharger dans Action Center.

1. Ouvrez Action Center, accédez à Paramètres d’administration ( Admin Settings) et sélectionnez Locataire(Tenant).
2. Dans l'onglet Définitions d'actions ( Action Definitions ), sélectionnez Ajouter une définition d'action ( Add Action Definition).
3. Sélectionnez Télécharger l'exemple de définition d'action (Download action definition sample) pour télécharger un exemple de schéma JSON afin de vous aider à préparer la définition d'action.
4. Sélectionnez Importer à partir d'un fichier (Import from file) et sélectionnez le fichier JSON que vous avez préparé précédemment.
5. Saisissez un nom et une description appropriés pour la définition d' action, puis sélectionnez Créer(Create).

Résultat: vous pouvez maintenant ajouter la définition d' Action (Action) en tant que contrôle à votre application Action dans App Studio.