Configurare un Agente Robot on-premise

La configurazione predefinita dell'Agente Robot viene impostata durante l'installazione. Prima di utilizzare l'Agente Robot, rivedere le impostazioni di configurazione e assicurarsi che siano appropriate per la propria organizzazione. In particolare, assicurarsi che Caricamenti di file consentiti sia impostato correttamente.

Nota

L'informazione in questo argomento si applica solo alle organizzazioni che utilizzano un Agente Robot on-premise per eseguire script ACL in robot ACL.

Le persone e le organizzazioni che possiedono l'edizione ACL Robotics Professional non dispongono di un Agente Robot on-premise. Gli script Python/HCL che eseguono in robot HighBond o robot del workflow non utilizzando l'Agente Robot.

Dove specificare le impostazioni di configurazione

È possibile specificare le impostazioni di configurazione dell'Agente Robot in due posizioni:

  • nella schermata Gestione degli agenti in Robot
  • nel file Agent.exe.config nella directory di installazione dell'Agente Robot sul server Windows

Nota

Le impostazioni di configurazione nella schermata Gestione degli agenti hanno la precedenza sulle impostazioni nel file Agent.exe.config.

Configurare le impostazioni nella schermata Gestione degli agenti

Nota

Le impostazioni di configurazione nella schermata Gestione degli agenti si applicano a tutti gli agenti in un cluster multi-agente.

  1. Dalla home page di Launchpad (www.highbond.com), selezionare l'applicazione Robot per aprirla.

    Se si è già in Diligent One, è possibile utilizzare il menu di navigazione a sinistra per passare all'applicazione Robot.

  2. Nell'angolo in alto a destra della dashboard, fai clic su Impostazioni.
  3. Nel pannello di sinistra, assicurati che Gestione degli agenti sia selezionato.
  4. In Configurazione, selezionare l'opzione appropriata per Caricamenti di file consentiti.

    Caricamenti di file consentiti: consente di controllare quali risultati di output vengono caricati dall'Agente Robot all'applicazione Robot nel cloud:

    • Solo file e log dei risultati

      Se specificato in un'intestazione di analisi, vengono caricati i file (come Excel) e i log dei risultati. È anche possibile caricare manualmente i file correlati nella scheda Input/Output di Robot.

    • Tabelle, file e log dei risultati

      Se specificato in un'intestazione di analisi, vengono caricati i file (come Excel), i log e le tabelle dei risultati di analisi. È anche possibile caricare manualmente i file correlati nella scheda Input/Output di Robot.

    • Caricamenti di file non consentiti

      Gli utenti non possono caricare file di alcun tipo tramite script o manualmente. Gli script di analisi con tag //RESULT FILE o //RESULT LOG non verranno eseguiti.

  5. In Configurazione, specificare le directory appropriate per Configurazione dei percorsi e fare clic su Salva.
    • Archiviazione dei dati

      La directory di rete o del server Windows per l'archiviazione permanente dell'output delle tabelle di dati di Analytics generate dagli script di analisi con un tag //DATA.

      Una directory separata per le tabelle dei dati consente di specificare una posizione di archiviazione a freddo più economica per i file di grandi dimensioni a cui si accede solo saltuariamente.

    • Percorso dei risultati

      Il server Windows o la directory di rete per l'output delle tabelle dei risultati di Analytics generate dagli script di analisi con un tag //RESULT TABLE.

    Importante

    La directory o le directory specificate in Configurazione devono essere accessibili all'Agente Robot o a tutti gli agenti se si utilizza un cluster multi-agente. Per ogni directory specificata, l'account di servizio che esegue l'agente deve disporre delle autorizzazioni di Lettura/scrittura/elenco. Per maggiori informazioni, consultare Sicurezza di Agente Robot on-premise.

Configurare le impostazioni nel file Agent.exe.config

Per aggiornare le impostazioni di configurazione, modificare il file Agent.exe.config nella directory di installazione dell'Agente Robot, quindi riavviare il servizio Windows Agente Robot.

Il percorso predefinito del file di configurazione è:

C:\Program Files (x86)\ACL Software\Robots Agent\agent\Agent.exe.config.

Nota

È necessario riavviare il servizio Agente Robot affinché le modifiche abbiano effetto.

Per installazioni multi-agente, è necessario aggiornare il file Agent.exe.config e riavviare il servizio Agente Robot su ogni server Windows. Le impostazioni di configurazione per ogni agente possono essere identiche o diverse, a seconda delle esigenze specifiche.

Proprietà di configurazione in Agent.exe.config

Chiave Valore
RuntimeBasePath

Cartella di base per:

  • Cartelle dei lavori analitici temporanee

  • file di risultati non di Analytics generati da script di analisi con un tag //RESULT FILE

  • file di log di Analytics generati da script di analisi con un tag //RESULT LOG

  • output di file di log di Analytics generati da script di analisi non riusciti

La cartella di base predefinita è C:\acl\robots\data\

Una cartella di base runtime separata consente di individuare l'elaborazione del lavoro di analisi su un dispositivo più veloce e ad alte prestazioni, ad esempio un'unità a stato solido (SSD).

Esempio di percorso completo per una cartella di lavoro di analisi con una cartella di base configurata dall'utente: E:\acl\robots\runtime\Production\Robot12\Task1\Run29\Temp

DataBasePath

La cartella di base per l'archiviazione permanente delle tabelle di dati di Analytics generate dagli script di analisi con un tag //DATA.

La cartella di base predefinita è C:\acl\robots\data\

Una cartella di base separata per le tabelle di dati di Analytics consente di specificare una posizione di archiviazione a freddo più economica per i file di grandi dimensioni a cui si accede solo saltuariamente.

Esempio di percorso completo per una cartella di file di dati con una cartella di base configurata dall'utente: D:\acl\robots\data\Production\Robot12\Data

Nota

Il valore DataBasePath non viene utilizzato se un valore diverso appare nell'impostazione di configurazione Archiviazione dei dati nella schermata Gestione degli agenti in Robot.

Per maggiori informazioni, consultare Configurare le impostazioni nella schermata Gestione degli agenti.

ResultsBasePath

La cartella di base per l'output delle tabelle dei risultati di Analytics generate dagli script di analisi con un tag //RESULT TABLE.

La cartella di base predefinita è C:\acl\robots\data\

Esempio di percorso completo per una cartella di risultati con una cartella di base configurata dall'utente: C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions

Nota

Il valore ResultsBasePath non viene utilizzato se un valore diverso appare nell'impostazione di configurazione Percorso dei risultati nella schermata Gestione degli agenti in Robot.

Per maggiori informazioni, consultare Configurare le impostazioni nella schermata Gestione degli agenti.

AclSEProfileBase

Cartella di base per lavorare con le tabelle quando ci si connette da Analytics all'Agente Robot tramite Servizio di Dati Robot.

La cartella di base predefinita è C:\acl\robots\aclse\

LogFile

Percorso e nome del file di log dell'Agente Robot.

Il percorso e il nome predefiniti sono C:\acl\robots\logs\application.log

EnginePath

Percorso del file eseguibile che esegue le attività.

La posizione predefinita è C:\Program Files (x86)\ACL Software\Robots Agent\AclScript.exe

KeepJobFolder

Specifica se la cartella temporanea del lavoro di analisi viene conservata quando un'attività del robot fallisce.

  • true la cartella temporanea del lavoro di analisi viene conservata dopo il fallimento dell'attività

  • false la cartella temporanea del lavoro di analisi viene eliminata dopo il fallimento dell'attività

    Il valore predefinito è false.

Nota

L'impostazione KeepJobFolder non ha effetto quando un'attività del robot riesce. Dopo l'esecuzione corretta di un'attività, la cartella temporanea del lavoro di analisi viene eliminata automaticamente.

Attenzione

È possibile impostare il valore su true per conservare i file per finalità di risoluzione dei problemi. Lasciare il valore impostato su true in modo permanente potrebbe causare l'esaurimento dello spazio sul disco rigido del server o su un'unità a stato solido.

AllowExecuteCommand

Specifica come l'Agente Robot gestisce il comando EXECUTE quando viene rilevato in uno script di analisi:

  • true il comando EXECUTE viene elaborato

  • false il comando EXECUTE non viene elaborato e lo script contenente il comando non riesce

    Il valore predefinito è false.

    Viene scritto un messaggio nel log, che spiega il motivo del fallimento.

MaxLogSizeKB

Dimensione massima del file di log dell'Agente Robot prima che il file venga archiviato e ne venga creato uno nuovo.

Il valore predefinito è 102400 (100 MB).

Il file di log attuale è application.log. I file di log archiviati vengono salvati nella stessa cartella del file di log attuale e viene assegnato loro un suffisso numerico incrementale: application.0.log, application.1.log e così via.

SkipPathAccessCheck

Controllare a quali cartelle l'Agente Robot può accedere durante la lettura o la scrittura di tabelle o file.

  • true L'accesso alle cartelle non è controllato. Gli script eseguiti dall'Agente Robot possono leggere o scrivere tabelle o file in qualsiasi robot ACL.

  • false L'accesso alle cartelle è controllato. Gli script eseguiti dall'Agente Robot possono leggere o scrivere tabelle o file solo nello stesso robot dello script.

    Il valore predefinito è false.

Impostando il valore su true e saltando il controllo di accesso alla cartella, è possibile migliorare le prestazioni dell'Agente Robot quando esegue script in alcuni ambienti. È inoltre possibile eseguire operazioni di lettura o scrittura tra robot.

Attenzione

La limitazione delle cartelle a cui uno script può accedere è una funzionalità di sicurezza di Robot che impedisce violazioni accidentali o intenzionali dell'accesso ai dati. Impostare il valore su true solo se si è certi che consentire agli script ACL di leggere o scrivere tabelle o file in qualsiasi robot ACL non rappresenti un rischio per la sicurezza.

Nota

L'impostazione SkipPathAccessCheck non ha alcun effetto sulla possibilità di condividere e collegare tabelle di dati di Analytics specifiche tra robot. Per maggiori informazioni, consultare Condividere e collegare tabelle di dati nei robot ACL.

Configurare l'Agente Robot per lavorare con un server proxy specifico

È possibile configurare manualmente l'Agente di Robot per connettersi all'applicazione Robot tramite un server proxy designato. Per eseguire la configurazione manuale è necessario procedere come segue:

  • Aggiungere una sezione aggiuntiva al file Agent.exe.config

  • Aggiornare due file di configurazione aggiuntivi, AgentService.exe.config e Worker.exe.config

Passaggi

  1. Sul server su cui è installato l'Agente Robot, andare alla directory di installazione dell'Agente Robot.

    La posizione predefinita della directory di installazione è:

    C:\Program Files (x86)\ACL Software\Robots Agent\agent\

  2. Fare riferimento alla tabella seguente per aggiornare i file di configurazione nella sottocartella \agent.

  3. Dopo aver salvato tutti i file, riavviare il servizio Windows Agente Robot per iniziare la comunicazione tra l'Agente Robot e l'applicazione Robot tramite il server proxy designato.

Nota

Sono possibili diverse impostazioni di configurazione del server proxy. Le informazioni di configurazione di esempio riportate di seguito potrebbero non corrispondere esattamente ai propri requisiti. Per ulteriori informazioni, consultare la documentazione tecnica Microsoft:

Nome del file Informazioni di configurazione
Agent.exe.config

Aggiornare questo file aggiungendo la sezione <system.net> nella posizione mostrata nell'esempio.

  • Sostituire l'indirizzo e la porta del server proxy appropriati per la propria organizzazione.

  • useDefaultCredentials="true" specifica che le credenziali per l'account che esegue il servizio Windows Agente Robot vengono utilizzate per accedere al server proxy.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <other configuration settings>
    </appSettings>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

AgentService.exe.config

Worker.exe.config

In entrambi questi file, aggiornare la sezione <defaultProxy> in base all'esempio mostrato di seguito.

  • Sostituire l'indirizzo e la porta del server proxy appropriati per la propria organizzazione.

  • useDefaultCredentials="true" specifica che le credenziali per l'account che esegue il servizio Windows Agente Robot vengono utilizzate per accedere al server proxy.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>