Skip to main content

Unix Search Text

Unix Search Text | Sybot Documentation

UNIX SEARCH TEXT

  • Task type: ssh_searchtext

Descrizione​

Il Task Unix Search Text consente di cercare una stringa o un pattern di testo all’interno di un file, sia su un server remoto (tramite SSH) sia sulla macchina locale (modalità Default).

Può essere utilizzato per analizzare file di log, individuare messaggi di errore o verificare la presenza di specifiche informazioni in file di configurazione o di testo.

Configurazione

La configurazione del Task definisce i dettagli della connessione (se prevista), il file da analizzare e il testo da cercare. I campi di configurazione del Task possono essere valorizzati manualmente o tramite parametri e variabili del workflow.

Connessione al Server​

  • Modalità connessione: definisce l’origine delle credenziali utilizzate per la connessione. Può assumere tre modalità operative:
  • Default: la ricerca viene eseguita sulla macchina locale, senza connessione SSH.
  • Manuale: consente l’inserimento manuale dei parametri di connessione SSH.
  • Environment: utilizza un ambiente di connessione preconfigurato. In questa modalità viene visualizzato un menu che elenca le connessioni disponibili in base al ruolo associato al Workflow.
  • Indirizzo IP: indirizzo IP del server remoto.
  • Hostname: nome host del server remoto.
  • Utente: nome utente utilizzato per stabilire la connessione SSH.
  • Password: password associata all'utente di connessione.
  • Porta: porta utilizzata per la connessione SSH (il valore predefinito è 22).

Esegui comando come altro utente​

Attivando questa checkbox, è possibile eseguire la ricerca con un utente diverso da quello utilizzato per la connessione SSH.

  • Utente: nome dell'utente con cui verrà eseguito il comando.
  • Password: password dell’utente utilizzato per l’esecuzione del comando.

Dettagli della Ricerca​

  • Percorso File: il percorso completo del file sul server remoto in cui verrà effettuata la ricerca del testo.
  • Pattern: il testo o l'espressione da cercare all'interno del file. Accanto al campo di testo, una menu permette di specificare la modalità di ricerca:
  • Stringa: la ricerca tratterà il pattern come una semplice stringa di testo letterale.
  • RegExp: la ricerca interpreterà il pattern come un'espressione regolare, permettendo ricerche molto più complesse e flessibili.
  • Limite Righe: attivando la checkbox, è possibile specificare il numero massimo di righe corrispondenti al pattern che il Task deve restituire. Se non attivato, verranno restituite tutte le righe trovate.

Parametri di Output

Al termine della ricerca, il Task espone i seguenti parametri di output, fornendo non solo le righe trovate ma anche dati quantitativi sulla ricerca:

  • result: contiene un messaggio testuale che descrive l'esito dell'operazione.
  • resultJson: rappresenta il risultato dell’esecuzione del task in formato JSON, includendo informazioni generali, configurazioni e dettagli sull’esecuzione.
  • occurrences: un contatore numerico che indica il numero totale di volte in cui il Pattern è stato trovato. Questo è particolarmente utile perché, se una singola riga contiene più volte il pattern, occurrences le conterà tutte, mentre result restituirà la riga una sola volta.
  • exitStatus: restituisce il codice di uscita del comando grep eseguito sul server.
  • 0: indica che almeno una corrispondenza è stata trovata.
  • 1: indica che nessuna corrispondenza è stata trovata (questo, per grep, non è un errore di esecuzione).
  • Valori maggiori di 1: indicano un errore di sintassi o un problema nell'accesso al file.

Esempio parametro resultJson​

{
 "id": 19858,
 "name": "Unix Search Text",
 "description": "",
 "type": "ssh_searchtext",
 "type_name": "Unix Search Text",
 "type_description": "Ricerca Testo in File",
 "config": {
 "limit": false,
 "pattern": "Alias",
 "filepath": "/home/user_test/.../xml-to-table_v2_it.md",
 "max_rows": "0",
 "operation": "searchtext",
 "connection": {
 "ip": "",
 "port": "",
 "user": "",
 "hostname": "",
 "password": "",
 "use_password": "N",
 "connection_mode": "default",
 "hidden_task_pwd": "0",
 "env_connection_name": "---"
 },
 "output_links": [],
 "pattern_type": "string"
 },
 "run_info": {
 "run_id": 1503908,
 "start_datetime": "2026-04-20 16:01:45",
 "end_datetime": "2026-04-20 16:01:45",
 "start_epoch": 1776700905.76,
 "end_epoch": 1776700905.89,
 "duration": 0,
 "status": "Completed",
 "cmd_text": "",
 "run_result": "Success",
 "result_text": "Trovate 2 occorrenze in 2 righe",
 "full_result_text": "| *Alias* | Nome della colonna ... |\n| Tipo | Precisione | Alias | ..."
 },
 "output_parameters": {
 "exitStatus": "0",
 "occurrences": "2"
 }
}

Note​

  • Il task esegue un comando di ricerca sul file configurato, localmente o tramite connessione SSH.
  • Se si utilizza una connessione remota con autenticazione tramite chiavi SSH, è necessario che la chiave pubblica sia registrata sul server.
  • Se l’opzione “Esegui comando come altro utente” è abilitata, il comando viene eseguito con un utente diverso da quello della connessione principale.
  • In modalità Default, la ricerca viene eseguita sulla macchina locale e non è richiesta alcuna connessione SSH.