Commande HB_API_GET

Envoie une requête GET à l'API API HighBond.

Syntaxe

HB_API_GET URL_demande_API_URL_demande_API_HighBond HEADERS informations_en-tête PASSWORD num TO fichier_réponse

Paramètres

Nom Description
URL_demande_API_HighBond

Les détails de la requête pour la ressource Diligent One.

Indiquez les informations suivantes dans l'URL de requête :

  • informations sur l'hôte, dont la région Diligent One

  • numéro de version de l'API (numéro de version principale actuel)

  • ID d'instance Diligent One (ID organisation)

  • nom du point de terminaison de l'API API HighBond et toute autre information relative au point de terminaison tel que le numéro d'ID

Par exemple :

"https://apis-us.highbond.com/v1/orgs/11594/robots"

Pour la syntaxe de la requête concernant une ressource Diligent One One spécifique, consultez la page Référence d'API API HighBond.

HEADERS informations_en-tête

Les informations sur l'en-tête de requête.

Dans l'en-tête, indiquez le type de contenu de la requête de l'API API HighBond :

'{"content-type": "application/vnd.api+json"}'

PASSWORD num

Définition de mot de passe à utiliser.

Vous n'utilisez pas PASSWORD num pour inviter à saisir ou pour spécifier un mot de passe réel. La définition de mot de passe renvoie à un mot de passe fourni ou défini auparavant à l'aide de la commande PASSWORD, de la commande SET PASSWORD ou de la balise d'outil d'analyse PASSWORD.

num correspond au numéro de la définition de mot de passe. Par exemple, si deux mots de passe ont été fournis ou définis auparavant dans un script, ou lors de la planification d'un script d'analyse de données, PASSWORD 2 indique que le mot de passe n° 2 est utilisé.

Pour plus d'informations sur la fourniture ou définition de mots de passe, consultez les rubriques :

La valeur du mot de passe obligatoire est un jeton d’accès à Jeton d’accès Diligent One One. Pour de plus amples informations, consultez la section Création d'une définition de mot de passe et spécification d'une valeur de mot de passe.

Selon l'environnement d'exécution du script, PASSWORD num peut être requis ou non :

Environnement d'exécution du scriptCondition requise relative à PASSWORD num
Analytics

(activation en ligne)

Le numéro de PASSWORD n'est pas obligatoire.

Le jeton d’accès Jeton d’accès Diligent One One de l’utilisateur actuel stocké dans son registre Windows est utilisé automatiquement.

Analytics

(activation hors ligne)

Le numéro de PASSWORD est obligatoire.

Robots
TO fichier_réponse

Nom du fichier qui contient la réponse de requête.

Indiquez fichier_réponse sous forme de chaîne entre guillemets avec une extension de fichier *.json. Par exemple :

TO "response.json"

Emplacement d'enregistrement du fichier JSON de réponse

L'emplacement auquel vous enregistrez le fichier JSON de réponse dépend de l'emplacement où vous exécutez le script.

Exécuter le script dans Analytics

Par défaut, le fichier JSON de réponse est enregistré dans le dossier contenant le projet Analytics.

Ajoutez un chemin de fichier avec le nom pour enregistrer le fichier vers un autre dossier existant :

TO "C:\API HighBond responses\response.json"

Exécuter le script dans Robots

Si vous indiquez une balise //RESULT FILE dans l'en-tête d'outil d'analyse, le fichier JSON de réponse est enregistré en tant que sortie pour chaque tâche exécutée dans le robot.

Indiquez uniquement le nom de fichier. N'indiquez pas de chemin de fichier.

Exemples

Renvoyer une liste de tous les robots de votre organisation

Le premier exemple enregistre le fichier JSON de réponse dans le dossier de projet Analytics :

HB_API_GET "https://apis-us.highbond.com/v1/orgs/11594/robots" HEADERS '{"content-type": "application/vnd.api+json"}' TO "all_robots.json"

Le deuxième exemple enregistre le fichier JSON de réponse à un endroit autre que le dossier de projet Analytics :

HB_API_GET "https://apis-us.highbond.com/v1/orgs/11594/robots" HEADERS '{"content-type": "application/vnd.api+json"}' TO "C:\API HighBond responses\all_robots.json"

Dans les deux exemples ci-dessus, la liste des robots dans le fichier de réponse all_robots.json est identique. Par exemple :

{
  "data": [
    {
      "id": "17504",
      "type": "robots",
      "attributes": {
        "active_app_version": 4,
        "app_versions_count": 5,
        "name": "Concur T&E Data Integration",
        "category": "acl",
        "drive_system_user": "exYRZqYABvrjHCjV7E7j"
      }
    },
    {
      "id": "24202",
      "type": "robots",
      "attributes": {
        "active_app_version": 2,
        "app_versions_count": 2,
        "name": "Test_Steele_Adverse_Media",
        "category": "highbond",
        "drive_system_user": "exYRZqYABvrjHCjV7E7j"
      }
    }
  ]
}

Utiliser la commande avec un mot de passe

Si vous utilisez une commande de requête de l'API API HighBond dans Robots, ou dans Analytics avec une activation hors connexion, vous devez inclure une définition de mot de passe dans la commande.

L'exemple ci-dessous montre comment configurer la définition de mot de passe dans une exécution de script dans Robots. Lorsque vous créez une tâche dans API HighBond pour exécuter le script, vous indiquez le mot de passe, qui est un jeton d'API Robots. Pour de plus amples informations, consultez la section Création d'une définition de mot de passe et spécification d'une valeur de mot de passe.

COMMENT
//ANALYTIC Échantillonnage de la requête de l'API HighBond			
//PASSWORD 1 Jeton d'API HighBond :				
//RESULT FILE all_robots.json				
END		
				
HB_API_GET "https://apis-us.highbond.com/v1/orgs/11594/robots" HEADERS '{"content-type": "application/vnd.api+json"}' PASSWORD 1 TO "all_robots.json"

Utiliser la version abrégée de la commande (pour les États-Unis uniquement)

Si votre organisation Diligent One One se trouve dans la région AWS pour les États-Unis, vous pouvez utiliser une version abrégée de la commande. La version abrégée fournit automatiquement la partie standard des détails de la requête de l'API et les informations sur l'en-tête en arrière-plan.

HB_API_GET "robots" TO "all_robots.json"

Les informations fournies automatiquement sont celles définies par défaut répertoriées ci-dessous. Pour effectuer une requête à l'API API HighBond en dehors de votre région ou de votre organisation par défaut, vous devez l'indiquer explicitement dans les informations relatives à la requête.

Détails de la requête par défaut

Les valeurs par défaut pour la région et l'ID d'organisation Diligent One dépendent de l'environnement dans lequel le script s'exécute.

Environnement d'exécution du script Valeurs par Défaut
Analytics

(activation en ligne)

Utilise la région ou l'ID d'organisation Diligent One qui ont été utilisés pour activer Analytics.

Analytics

(activation hors ligne)

Utilise la région ou l'ID d'organisation Diligent One où le script est exécuté.

Robots

Remarques

Création d'une définition de mot de passe et spécification d'une valeur de mot de passe

Lorsque vous exécutez un script dans Robots qui envoie une requête à l'API API HighBond, vous devez inclure une définition de mot de passe avec la commande qui envoie la requête. La même condition requise s'applique aux scripts exécutés dans Analytics si vous avez utilisé l'activation hors connexion.

Quelle que soit la méthode que vous utilisez pour créer la définition de mot de passe, la valeur de mot de passe requise est un jeton d’accès à Jeton d’accès Diligent One One, que vous pouvez générer dans Barre de lancement. Pour de plus amples informations, consultez la section Obtenir un jeton d’accès Jeton d’accès Diligent One One.

Méthodes de définition de mot de passe

Méthode Description

Balise d'outil d'analyse PASSWORD

(Pour les scripts exécutés dans Robots)

Si vous utilisez la balise d'outils d'analyse PASSWORD afin de créer la définition de mot de passe numéroté pour la connexion à Diligent One, aucune valeur de mot de passe n'est indiquée dans le script. Lorsque vous créez une tâche pour exécuter le script dans Robots, un champ d'entrée dans le Concepteur de tâches permet d'indiquer le mot de passe réel.

Pour plus d'informations, consultez la section Balise d'outils d'analyse PASSWORD.

Commande PASSWORD

(Pour les scripts exécutés dans Analytics, activation hors ligne)

Si vous utilisez la commande PASSWORD afin de créer la définition de mot de passe numéroté pour la connexion à Diligent One One, aucune valeur de mot de passe n'est indiquée dans le script. Une invite de mot de passe est affichée lorsque le script tente de se connecter.

Pour plus d'informations, consultez la rubrique Commande PASSWORD.

Commande SET PASSWORD

(Pour les scripts exécutés dans Analytics, activation hors ligne)

Si vous utilisez la commande SET PASSWORD pour créer la définition de mot de passe numéroté pour la connexion à Diligent One One, aucune valeur de mot de passe n'est indiquée dans le script et aucune invite de mot de passe n'est affichée. Cette approche convient pour les scripts conçus pour être exécutés sans assistance, mais elle dévoile un mot de passe réel en texte clair dans le script, ce qui risque de ne pas être adapté à votre situation.

Pour plus d'informations, consultez la rubrique Commande SET PASSWORD.

Obtenir un jeton d’accès Jeton d’accès Diligent One One

Attention

Le jeton d'accès généré correspond au compte utilisé pour se connecter à la Barre de lancement. En tant que rédacteur de scripts, indiquer votre propre jeton d'accès dans un script n'est peut-être pas très approprié si le script sera utilisé par d'autres personnes.

Protégez les jetons d’accès comme n’importe quel mot de passe de compte.

Utilisez un jeton d'accès existant sauf si vous avez une bonne raison d'en créer un nouveau. Si le jeton existant ne fonctionne pas, créez-en un nouveau. L'utilisation d'un jeton existant réduit le nombre de jetons que vous devez gérer.

  1. Effectuez l'une des actions suivantes :

    • Dans le menu principal Analytics, sélectionnez Outils > Jeton d’accès Diligent One.

    • Dans l'Éditeur de script, cliquez avec le bouton droit de la souris, puis sélectionnez Insérer > Jeton Diligent One.

    La page Gérer des jetons API s'ouvre dans votre navigateur. Il se peut que vous deviez d'abord vous connecter à la Barre de lancement.

    L'accès à la page Gérer des jetons API via Analytics est une fonctionnalité d'ordre pratique. Vous pouvez également vous connecter à Diligent One et accéder à la page via votre profil utilisateur sans l'aide d'Analytics.

  2. Effectuez l'une des actions suivantes :

    • Utiliser un jeton existant

      1. Dans la colonne Jeton, cliquez sur le jeton en partie masqué que vous voulez utiliser.

      2. Saisissez votre mot de passe Diligent One et cliquez sur Confirmer

        Le jeton démasqué s'affiche.

      3. Cliquez sur Copier pour copier le jeton.

        Astuce

        Ne fermez pas la boîte de dialogue contenant le jeton tant que vous n'avez pas fini de copier-coller le jeton.

    • Créer un nouveau jeton

      1. Cliquez sur Ajouter un jeton > Analytics.

      2. Dans le panneau latéral Nouveau jeton Analytics, indiquez les informations suivantes :

        Champ ou option Description
        Description

        Saisissez une description qui fournit des informations utiles, telles que :

        • L'objet du jeton
        • L'emplacement d'utilisation du jeton : par exemple, le nom et l'emplacement du script Analytics, ou le nom et l'emplacement des tâches du robot
        Expiration du jeton
        • ActivéLe jeton expire au bout du nombre de jours que vous avez spécifié
        • DésactivéLe jeton n’expire pas

        Note

        Votre organisation dispose peut-être d'une politique de sécurité qui demande à ce que les jetons expirent au bout d'un certain temps. Créer des jetons avec une date d'expiration est une bonne pratique. Diligent One vous envoie une notification automatique par e-mail quelques jours avant la date d'expiration.

        Expire dans Indiquez le nombre de jours avant l'expiration du jeton (de 1 à 365)
        Mot de passe Saisissez le mot de passe de votre compte Diligent One One.
      3. Cliquez sur Générer un jeton.

      4. Cliquez sur Copier pour copier le jeton.

        Astuce

        Ne fermez pas le panneau latéral contenant le jeton tant que vous n'avez pas fini de copier-coller le jeton.

  3. Selon la méthode de définition de mot de passe utilisée, effectuez l'une des actions suivantes :

    • Balise d’analyse de données PASSWORDDans le Concepteur de tâches d’un robot ACL, collez le jeton copié dans un champ de paramètre de mot de passeRobot ACL robot

    • Commande PASSWORDDans Analytics, collez le jeton copié dans l’invite de mot de passe qui apparaît lors de l’exécution du script.

    • Commande SET PASSWORDDans Analytics, collez le jeton à l’endroit approprié dans la syntaxe de la commande SET PASSWORD dans un script

  4. Dans la barre de lancement, fermez la boîte de dialogue ou le panneau latéral contenant le jeton.

    Si vous avez créé un nouveau jeton, une version partiellement masquée du jeton est ajoutée en haut de votre liste de jetons.

    Pour de plus amples informations, consultez la section Créer et gérer Jetons d’accès Diligent One.