RobotsHighBond Command Language (HCL)
HighBond Command Language (HCL) est notre bibliothèque Python personnalisée pour l'analyse de données axée sur le domaine et l'automatisation de Diligent One. Le développement de HCL est en cours et notre intention est qu'au fil du temps, HCL reproduise un grand nombre des commandes et fonctions disponibles dans ACLScript.
Vous pouvez mélanger HCL, Python et les bibliothèques Python telles que Pandas et Requests (pour les appels d'API) dans le même script Diligent One dans Robots. Vous ne pouvez pas mélanger du ACLScript et du Python/HCL dans le même script.
Des compétences de base en Python sont une condition préalable pour travailler efficacement avec HCL. Le conseil pour ceux qui cherchent à faire la transition d'ACLScript à Python/HCL est de suivre un bon cours d'introduction à Python.
Méthodes HCL
Méthodes d'analyse des données
Effectuez des opérations sur un cadre de données HCL existant.
| Méthode HCL | Description |
|---|---|
| Méthode append() | Combine les lignes de deux ou plusieurs cadres de données en un seul cadre de données en concaténant un cadre de données en bas d'un autre cadre de données. |
| Méthode benford() | Compte le nombre d'occurrences de chaque chiffre de tête (1-9) ou combinaison de chiffres de tête dans une colonne numérique, et compare le compte réel au compte probable. Le compte probable est obtenu en utilisant la formule Benford. |
| Méthode count() | Compte le nombre de lignes dans un cadre de données. |
| Méthode duplicates() | Détecte si des valeurs dupliquées ou des lignes entièrement dupliquées existent dans un cadre de données. |
| Méthode extract() | Extrait des colonnes d'un cadre de données vers un nouveau cadre de données. |
| Méthode head() | Renvoie un nombre déterminé de lignes à partir du haut d'un cadre de données. |
| Méthode join() | À partir d'une clé commune, combine les colonnes de deux cadres de données dans un seul cadre de données. |
| Méthode outliers() | Identifie les valeurs statistiques aberrantes dans une colonne numérique. Des valeurs aberrantes peuvent être identifiées pour la colonne dans son ensemble ou pour des groupes distincts basés sur les valeurs identiques contenues dans une ou plusieurs colonnes clés. |
| Méthode rename() | Renomme une ou plusieurs colonnes dans un cadre de données. |
| Méthode select() | Sélectionne les colonnes spécifiées dans un cadre de données pour les inclure dans un nouveau cadre de données. |
| Méthode sort() | Trie les lignes d'un cadre de données dans un ordre séquentiel croissant ou décroissant, en fonction d'une ou plusieurs colonnes clés indiqués. |
| Méthode summarize() | Regroupe les lignes d'un cadre de données basées sur des valeurs identiques dans une ou plusieurs colonnes. Compte le nombre de lignes dans chaque groupe et calcule également le sous-total des colonnes numériques spécifiées pour chaque groupe. |
Méthodes de cadre de données et de fichiers
Gérez des cadres de données et des fichiers dans des scripts Python/HCL.
| Méthode HCL | Description |
|---|---|
| Méthode read_csv() | Lit un fichier de valeurs séparées par des virgules (*.csv) ou un fichier texte (*.txt) dans un cadre de données HCL. |
| Méthode from_pandas() | Convertit un cadre de données Pandas ou une série Pandas vers un cadre de données HCL. |
| Méthode to_pandas() | Convertit un cadre de données HCL en cadre de données Pandas. |
| Méthode save_result_file() | Enregistre une sortie fichier de résultats par un script Python/HCL pendant l'exécution de la tâche. |
| Méthode save_working_file() | Enregistre un fichier produit par un script Python/HCL dans la section Données de travail où il est stocké pour une utilisation future ou à des fins historiques. |
| Méthode load_working_file() | Charge un fichier de la section Données de travail pour le rendre accessible lors de la création de scripts Python/HCL. Le fichier chargé est une copie et non l'original. |
| Méthode from_hb_results() | Importe une table Résultats dans un cadre de données HCL |
| Méthode to_hb_results() | Enregistre un cadre de données HCL dans une table Résultats. |
| Méthode publish() | Enregistre un cadre de données Pandas ou HCL dans un ensemble de données du Centre d'activité. |
Méthodes de variables HCL
Utilisez différents types de variables HCL dans les scripts Python/HCL.
| Méthode HCL | Description |
|---|---|
| Méthode secret[] | Retourne la valeur d'une variable de mot de passe HCL |
| Méthode system_variable[] | Retourne la valeur d'une variable de système HCL. |
| Méthode variable[] | Retourne la valeur d'une variable de caractère HCL |
Méthodes API HighBond
Envoyez une requête à l'API HighBond.
| Méthode HCL | Description |
|---|---|
| Méthode api_delete() | Envoie une requête DELETE à l’API HighBond. |
| Méthode api_get() | Envoie une requête GET à l'API HighBond. |
| Méthode api_patch() | Envoie une requête PATCH à l'API HighBond. |
| Méthode api_post() | Envoie une requête POST à l'API HighBond. |
| Méthode api_put() | Envoie une requête PUT à l’API HighBond. |
