HighBond Command Language (HCL)

HighBond Command Language (HCL) is onze aangepaste Python-bibliotheek voor domeingerichte gegevensanalyse en Diligent One-automatisering. De ontwikkeling van HCL is voortdurend gaande en ons doel is dat HCL mettertijd veel van de opdrachten en functies die beschikbaar zijn in ACLScript zal repliceren.

U kunt HCL, Python en Python-bibliotheken zoals Pandas en Requests (voor API-aanroepen) door elkaar gebruiken in hetzelfde Diligent One-script in Robots. U kunt ACLScript en Python/HCL niet combineren in hetzelfde script.

Basisvaardigheden in Python zijn een vereiste om effectief met HCL te kunnen werken. Het advies voor degenen die de overstap van ACLScript naar Python/HCL willen maken, is om een goede inleidende cursus Python te volgen.

HCL-methoden

Categorie Gebruik
Gegevensanalysemethoden

Voer bewerkingen uit op een bestaand HCL-dataframe.

Dataframe- en bestandsmethoden

Dataframes en bestanden beheren in Python/HCL-scripts.

HCL-variabelenmethoden

Gebruik verschillende soorten HCL-variabelen in Python/HCL-scripts.

HighBond API-methoden

Een aanvraag naar de HighBond API verzenden.

Gegevensanalysemethoden

Voer bewerkingen uit op een bestaand HCL-dataframe.

HCL-methode Beschrijving
append() methode

Combineert rijen van twee of meer dataframes tot één dataframe door een dataframe onder aan een ander dataframe toe te voegen.

benford() methode

Telt het aantal keren dat elk eerste cijfer (1-9), of combinatie van eerste cijfers, voorkomt in een numerieke kolom, en vergelijkt het werkelijke aantal met het verwachte aantal. De verwachte telling wordt berekend met behulp van de Benford-formule.

count() methode

Telt het aantal rijen in een dataframe.

duplicates() methode

Detecteert of er dubbele waarden of volledig dubbele rijen bestaan in een dataframe.

extract() methode

Extraheert kolommen uit een dataframe naar een nieuw dataframe.

head() methode

Retourneert een opgegeven aantal rijen vanaf de bovenkant van een dataframe.

join() methode

Op basis van een gemeenschappelijke sleutel worden kolommen uit twee dataframes gecombineerd tot één dataframe.

outliers() methode

Identificeert statistische uitschieters in een numerieke kolom. Uitschieters kunnen worden geïdentificeerd voor de hele kolom of voor afzonderlijke groepen op basis van identieke waarden in een of meer sleutelkolommen.

rename() methode

Wijzigt de naam van een of meer kolommen in een dataframe.

select() methode

Selecteert de opgegeven kolommen in een dataframe voor opname in een nieuw dataframe.

sort() methode

Sorteert rijen in een dataframe in oplopende of aflopende volgorde, op basis van een of meer opgegeven sleutelkolommen.

summarize() methode

Groepeert rijen in een dataframe op basis van identieke waarden in een of meer kolommen. Telt het aantal rijen in elke groep en berekent ook subtotalen van opgegeven numerieke kolommen voor elke groep.

Dataframe- en bestandsmethoden

Dataframes en bestanden beheren in Python/HCL-scripts.

HCL-methode Beschrijving
read_csv() methode

Leest een bestand met door komma's gescheiden waarden (*.csv) of een tekstbestand (*.txt) naar een HCL-dataframe.

from_pandas() methode

Zet een Pandas-dataframe of een Pandas-reeks om in een HCL-dataframe.

to_pandas() methode

Converteert een HCL-dataframe naar een Pandas-dataframe.

save_result_file() methode

Slaat een resultaatbestand op dat tijdens een taakuitvoering door een Python/HCL-script is gegenereerd.

save_working_file() methode

Slaat een bestand dat is geproduceerd door een Python/HCL-script op in het tabblad Werkgegevens waar het wordt bewaard voor toekomstig gebruik of voor historische doeleinden.

load_working_file() methode

Laadt een werkbestand uit het tabblad Werkgegevens om het bestand beschikbaar te maken voor Python/HCL-scripting. Het geladen bestand is een kopie, niet het origineel.

from_hb_results() methode

Importeert een Resultaten-tabel naar een HCL-dataframe.

to_hb_results() methode

Saves an HCL dataframe to a Results table.

publish()-methode

Slaat een Pandas- of HCL-dataframe op in een Activiteitencentrum-dataset.

HCL-variabelenmethoden

Gebruik verschillende soorten HCL-variabelen in Python/HCL-scripts.

HCL-methode Beschrijving
secret[] methode

Retourneert de waarde van een HCL-wachtwoordvariabele.

system_variable[] methode

Retourneert de waarde van een HCL-systeemvariabele.

variable[] methode

Retourneert de waarde van een HCL-tekenvariabele.

HighBond API-methoden

Een aanvraag naar de HighBond API verzenden.

HCL-methode Beschrijving
api_delete() methode

Stuurt een DELETE-verzoek naar de HighBond API.

api_get() methode

Stuurt een GET-verzoek naar de HighBond API.

api_patch()-methode

Stuurt een PATCH-aanvraag naar de HighBond API.

api_post() methode

Stuurt een POST-verzoek naar de HighBond API.

api_put() methode

Verstuurt een PUT-verzoek naar de HighBond API.