Créer un API Task

Vous pouvez créer un API Task avec divers packages pris en charge sur Automation Anywhere Control Room.

Prérequis

Vous devez disposer d\'une Bot Creator licence.
Dans cette rubrique, nous vous expliquons comment créer une API Task à l\'aide d\'une API d\'exemple qui prend en entrée un code postal aux États-Unis et renvoie en sortie les noms Lieu et État. Vous pouvez créer un API Task avec les actions propres à votre cas d\'utilisation.

Procédure

  1. Connectez-vous à votre instance du Automation Anywhere Control Room en tant que créateur de robots.
  2. Créez un nouveau API Task:
    1. Dans le volet de gauche, cliquez sur Automatisation.
    2. Cliquez sur Créer un nouveau > API Task .
    3. Dans la fenêtre Créer API Task , saisissez le nom du API Task.
    4. Acceptez l\'emplacement par défaut du dossier : \Bots\.
      Pour modifier l\'emplacement de stockage de votre API Task, cliquez sur Choisir, puis suivez les invites.
    5. Cliquez sur Créer et modifier.
  3. Créez une variable Code postal comme entrée qui sera utilisée dans l\'URL du code postal.
  4. Utilisez l\'Méthode Getaction pour récupérer le Lieu et l\'État d\'un code postal.
    Remarque : Des packages prédéfinis sont disponibles pour la plupart des applications d\'entreprise courantes. Pour une liste des packages pris en charge, consultez Tableau 1.
    1. Double-cliquez sur l\' Services Web REST > Méthode Get action ou faites-la glisser.
      Services Web REST - Méthode Get
    2. Saisissez l\'URI suivant. $ZipCode$ dans l\'URI correspond à la variable d\'entrée créée à l\'étape 3.
      https://api.zippopotam.us/us/$ZipCode$
      Remarque :

      Vous pouvez appeler plusieurs API dans le cadre d\'une API Task unique. Ce peut simplifier votre automatisation et réduire la nécessité d\'effectuer plusieurs tâches distinctes tâches. Par exemple, vous pouvez appeler l\'API 1 pour récupérer les données produit, l\'API 2 pour récupérer les données de tarification, puis utiliser l\'API 3 pour créer un devis dans le même API Task.

    3. Dans la liste déroulante Mode d\'authentification, sélectionnez Aucune authentification car ce point de terminaison ne nécessite une authentification.
      Remarque : En général, les points de terminaison nécessitent une authentification pour assurez-vous que seules les applications autorisées peuvent accéder aux données. Sélectionner un mécanisme d\'authentification approprié pour autoriser l\'accès au point de terminaison que vous veut accéder.
    4. Créez la variable pDictZipCodeApiResponse dans le Attribuer la sortie à une variable champ. Pour en savoir plus Pour obtenir des informations sur la création d\'une variable, consultez Création d'une variable.
      Remarque :
      • La réponse JSON complète de l\'API est attribuée à ce dictionnaire variable : pDictZipCodeApiResponse.
      • Les types de variables suivants ne sont pas pris en charge pour les API Tasks : Fichier, Fenêtre et Formulaire.
  5. Dans le volet Actions, faites glisser le JSON > Démarrer la session action et déposez-le dans le canevas ci-dessous le REST Web Services action.
    1. Dans le champ Data Source, sélectionnez Texte et entrer$pDictZipCodeApiResponse{Body}$.
    2. dans le champ Session d\'objet JSON, sélection session locale et saisissez Par défaut.

      API Task Dictionnaire
      Vous disposez maintenant de l\'ensemble du Corps. La prochaine tâche est extraire les champs obligatoires du corps. Voici un exemple de JSON Corps:
      {
          "post code": "90210",
          "country": "United States",
          "country abbreviation": "US",
          "places": [
              {
                  "place name": "Beverly Hills",
                  "longitude": "-118.4065",
                  "state": "California",
                  "state abbreviation": "CA",
                  "latitude": "34.0901"
              }
          ]
      }
  6. Extrayez le place name du JSON.
    1. Dans le volet Actions, faites glisser le Json > Obtenir la valeur du nœud action et déposez-le dans le canevas ci-dessous le Json > Session d\'état action.
    2. Spécifiez les nœuds à extraire. Par exemple, pour extraire le lieu, vous pouvez utilisez places[0].["nom du lieu"]
    3. Créez une variable Place et attribuez la sortie à cette variable.
  7. Extrayez l\'state du JSON.
    1. Dans le volet Actions, faites glisser le Json > Obtenir la valeur du nœud action et déposez-le dans le canevas ci-dessous le Json > Session d\'état action.
    2. Spécifiez les nœuds à extraire. Par exemple, pour extraire le lieu, vous pouvez utilisez places[0].["state"]
    3. Créez une variable État et attribuez la sortie à cette variable.
  8. Cliquez sur Enregistrer.
    Pour tester le API Task, cliquez sur le Débogueur. Pendant le débogage, le périphérique local est utilisé pour exécuter le API Task. Le API Task créé dans cet échantillon récupère le Lieu et État pour toute saisie de code postal.