HighBond Command Language (HCL)

HighBond Command Language (HCL) ist unsere benutzerdefinierte Python-Bibliothek zur domänenfokussierten Datenanalyse und der Automatisierung von Diligent One. HCL wird laufend weiterentwickelt und soll im Laufe der Zeit viele Befehle und Funktionen replizieren, die in ACLScript vorhanden sind.

Sie können in demselben Diligent One-Skript in der Robots-App sowohl HCL, Python und Python-Bibliotheken wie Pandas und Requests (für API-Aufrufe) verwenden. Sie können ACLScript und Python/HCL nicht in demselben Skript kombinieren.

Grundlegende Python-Kenntnisse sind eine Voraussetzung, um effizient mit HCL arbeiten zu können. Wenn Sie von ACLScript zu Python/HCL wechseln möchten, sollten Sie einen guten Python-Einführungskurs absolvieren.

HCL-Methoden

Kategorie Verwendung
Datenanalysemethoden

Operationen für einen bestehenden HCL-Datenrahmen ausführen.

Dataframe- und Dateimethoden

Sie verwalten Dataframes und Dateien in Python/HCL Skripts.

Methoden der HCL-Variablen

Verwenden Sie verschiedene Arten von HCL-Variablen in Python/HCL-Skripts.

HighBond-API-Methoden

Eine Anfrage an die HighBond-API senden.

Datenanalysemethoden

Operationen für einen bestehenden HCL-Datenrahmen ausführen.

HCL-Methode Beschreibung
append()-Methode

Kombiniert Zeilen aus zwei oder mehreren Datenrahmen in einem einzelnen Datenrahmen, indem einer der Datenrahmen unten an den anderen Datenrahmen angehängt wird.

Benford()-Methode

Zählt, wie oft jede führende Ziffer (1–9) oder führende Ziffernkombination in einer numerischen Spalte vorkommt, und vergleicht das tatsächliche mit dem erwarteten Ergebnis. Das erwartete Ergebnis wird mittels der Benford-Formel errechnet.

count()-Methode

Zählt die Anzahl der Zeilen in einem Datenrahmen.

duplicates()-Methode

Erkennt, ob doppelte Werte oder vollständige doppelte Zeilen in einem Datenrahmen existieren.

extract()-Methode

Extrahiert Spalten aus einem Datenrahmen in einen neuen Datenrahmen.

head()-Methode

Gibt eine bestimmte Anzahl von Zeilen ab dem Anfang eines Datenrahmens zurück.

join()-Methode

Kombiniert Spalten zweier Datenrahmen in einem einzelnen Datenrahmen auf Basis eines gemeinsamen Schlüssels.

outliers()-Methode

Identifiziert statistische Ausreißer in einer numerischen Spalte. Ausreißer können für die gesamte Spalte identifiziert werden oder für unterschiedliche Gruppen, basierend auf identischen Werten in einer oder mehreren Schlüsselspalten.

rename()-Methode

Benennt ein oder mehrere Spalten in einem Datenrahmen um.

select()-Methode

Wählt die angegebenen Spalten zur Aufnahme in einen neuen Datenrahmen aus.

sort()-Methode

Sortiert Zeilen in einem Datenrahmen in auf- oder absteigender sequenzieller Reihenfolge auf Basis festgelegter Schlüsselspalte(n).

summarize()-Methode

Gruppiert Zeilen basierend auf identischen Werten in einer oder mehreren Spalten. Zählt die Anzahl der Zeilen in jeder Gruppe und berechnet auch Zwischensummen angegebener numerischer Spalten jeder Gruppe.

Dataframe- und Dateimethoden

Sie verwalten Dataframes und Dateien in Python/HCL Skripts.

HCL-Methode Beschreibung
read_csv()-Methode

Liest eine Datei mit Werten, die durch Kommas getrennt wurden (*.csv), oder eine Textdatei (*.txt) in einen HCL-Datenrahmen ein.

from_pandas()-Methode

Konvertiert einen Pandas-Datenrahmen oder eine Pandas-Reihe in einen HCL-Datenrahmen.

to_pandas()-Methode

Konvertiert einen Pandas-Datenrahmen in einen HCL-Datenrahmen.

save_result_file()-Methode

Speichert eine Ergebnisdatei, die von einem Python/HCL-Skript während einer Aufgabenausführung ausgegeben wird.

save_working_file()-Methode

Speichert eine von einem Python/HCL-Skript erzeugte Datei auf der Registerkarte Arbeitsdaten, wo sie für die zukünftige Verwendung oder für historische Zwecke gespeichert wird.

load_working_file()-Methode

Lädt eine Arbeitsdatei von der Registerkarte Arbeitsdaten, um die Datei für die Python/HCL-Skripterstellung verfügbar zu machen. Die geladene Datei ist eine Kopie, nicht das Original.

from_hb_results()-Methode

Importiert eine Ergebnistabelle in einen HCL-Datenrahmen.

to_hb_results()-Methode

Speichert einen HCL-Datenrahmen in eine Ergebnisse-App-Tabelle.

Methoden der HCL-Variablen

Verwenden Sie verschiedene Arten von HCL-Variablen in Python/HCL-Skripts.

HCL-Methode Beschreibung
secret[]-Methode

Gibt den Wert einer HCL-Kennwort-Variablen zurück.

system_variable[]-Methode

Gibt den Wert einer HCL-Systemvariablen zurück.

variable[]-Methode

Gibt den Wert einer HCL-Zeichen-Variablen zurück.

HighBond-API-Methoden

Eine Anfrage an die HighBond-API senden.

HCL-Methode Beschreibung
api_delete()-Methode

Sendet eine DELETE-Anfrage an die HighBond-API.

api_get()-Methode

Sendet eine GET-Anfrage an die HighBond-API.

api_patch()-Methode

Sendet eine PATCH-Anfrage an die HighBond-API.

api_post()-Methode

Sendet eine POST-Anfrage an die HighBond-API.

api_put()-Methode

Sendet eine PUT-Anfrage an die HighBond-API.