RobotsHighBond Command Language (HCL)
HighBond Command Language (HCL) è la nostra libreria Python personalizzata per l'analisi dei dati incentrata sul dominio e l'automazione di Diligent One. Lo sviluppo di HCL è in corso e la nostra intenzione è che nel tempo HCL replichi molti dei comandi e delle funzioni disponibili in ACLScript.
È possibile combinare HCL, Python e librerie Python come Pandas e Richieste (per le chiamate API) nello stesso script Diligent One in Robot. Non è possibile combinare ACLScript e Python/HCL nello stesso script.
Per lavorare efficacemente con HCL è fondamentale avere competenze di base in Python. Il consiglio per chi vuole passare da ACLScript a Python/HCL è di seguire un buon corso introduttivo a Python.
Metodi HCL
Metodi di analisi dei dati
Consente di eseguire operazioni su un dataframe HCL esistente.
| Metodo HCL | Descrizione |
|---|---|
| Metodo append() | Combina le righe di due o più dataframe in un unico dataframe aggiungendo un dataframe alla fine di un altro dataframe. |
| Metodo benford() | Conta il numero di volte in cui ciascuna cifra iniziale (1–9) o combinazione di cifre iniziali si verifica in una colonna numerica e confronta il conteggio effettivo con quello previsto. Il conteggio effettivo viene calcolato con la formula di Benford. |
| Metodo count() | Conta il numero di righe in un dataframe. |
| Metodo duplicates() | Rileva se in un dataframe sono presenti valori duplicati o intere righe duplicate. |
| Metodo extract() | Estrae colonne da un dataframe in un nuovo dataframe. |
| metodo head() | Restituisce un numero specificato di righe dall'inizio di un dataframe. |
| Metodo join() | Basandosi su una chiave comune, combina le colonne di due dataframe in un unico dataframe. |
| Metodo outliers() | Identifica i valori statistici anomali in una colonna numerica. I valori anomali possono essere identificati per l'intera colonna o per gruppi separati in base a valori identici in una o più colonne chiave. |
| Metodo rename() | Rinomina una o più colonne in un dataframe. |
| Metodo select() | Seleziona le colonne specificate in un dataframe per includerle in un nuovo dataframe. |
| Metodo sort() | Ordina le righe in un dataframe in ordine sequenziale crescente o decrescente, in base a una o più colonne chiave specificate. |
| Metodo summarize() | Raggruppa le righe in un dataframe in base a valori identici in una o più colonne. Conta il numero di righe in ciascun gruppo e calcola anche i subtotali delle colonne numeriche specificate per ciascun gruppo. |
Metodi di dataframe e file
Consente di gestire dataframe e file in script Python/HCL.
| Metodo HCL | Descrizione |
|---|---|
| Metodo read_csv() | Legge un file di valori separati da virgola (*.csv) o un file di testo (*.txt) in un dataframe HCL. |
| metodo from_pandas() | Converte un dataframe Pandas o una serie Pandas in un dataframe HCL. |
| Metodo to_pandas() | Converte un dataframe HCL in un dataframe Pandas. |
| Metodo save_result_file() | Salva un file di risultati generato da uno script Python/HCL durante l'esecuzione di un'attività. |
| Metodo save_working_file() | Viene salvato un file prodotto da uno script Python/HCL nella scheda Dati di lavoro, dove viene archiviato per un uso futuro o per scopi storici. |
| metodo load_working_file() | Viene caricato un file di lavoro dall'area Dati di lavoro per renderlo disponibile per gli script Python/HCL. Il file caricato è una copia, non l'originale. |
| Metodo from_hb_results() | Importa una tabella dei risultati in un dataframe HCL. |
| Metodo to_hb_results() | Salva un dataframe HCL in una tabella dei risultati. |
| Metodo publish() | Viene salvato un dataframe HCL in un set di dati del Centro attività. |
Metodi di variabili HCL
È possibile utilizzare diversi tipi di variabili HCL negli script Python/HCL.
| Metodo HCL | Descrizione |
|---|---|
| Metodo secret[] | Restituisce il valore di una variabile password HCL. |
| Metodo system_variable[] | Restituisce il valore di una variabile di sistema HCL. |
| Metodo variable[] | Restituisce il valore di una variabile carattere HCL. |
Metodi di API di HighBond
Consente di inviare una richiesta all'API di HighBond.
| Metodo HCL | Descrizione |
|---|---|
| Metodo api_delete() | Invia una richiesta DELETE all'API di HighBond. |
| Metodo api_get() | Invia una richiesta GET all'API di HighBond. |
| Metodo api_patch() | Invia una richiesta PATCH all'API di HighBond. |
| metodo api_post() | Invia una richiesta PUT all'API di HighBond. |
| Metodo api_put() | Invia una richiesta PUT all'API di HighBond. |
