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.