RobotsConfigurare 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
il file Agent.exe.config nella directory di installazione di Agente Robot sul server Windows
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.
Dalla home page della piattaforma (www.diligentoneplatform.com), seleziona l'applicazione Robot per aprirla.
Se si è già in Diligent One, è possibile utilizzare il menu di navigazione a sinistra per passare all'applicazione Robot.
Nell'angolo in alto a destra della dashboard, fai clic su Impostazioni.
Nel pannello di sinistra, assicurati che Gestione degli agenti sia selezionato.
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
Nessun file può essere caricato da script o manualmente dagli utenti. Gli script analitici con i tag //RESULT FILE o //RESULT LOG non verranno eseguiti.
Per impedire il caricamento di qualsiasi tipo di file in ogni situazione, devi anche impostare l'impostazione di configurazione AllowUploadsOnFailure in Agente Robots su false.
In Configurazione, specificare le directory appropriate per Configurazione dei percorsi e fare clic su Salva.
Archiviazione dei dati
Il server Windows o la directory di rete per l'archiviazione permanente delle tabelle di dati di Analytics prodotte dagli script analitici 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 le tabelle dei risultati di Analytics prodotte dagli script analitici 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, modifica il file Agent.exe.config nella directory di installazione di Agente Robot e poi riavvia il servizio Agente Robot di Windows.
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 le installazioni multi-agente, devi 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:
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 di una cartella di lavoro analitica 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 prodotte dagli script analitici con il 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 di una cartella di file di dati con una cartella di base configurata dall'utente: D:\acl\robots\data\Production\Robot12\Data |
| ResultsBasePath | La cartella di base per le tabelle dei risultati di Analytics prodotte dagli script analitici con il tag //RESULT TABLE. La cartella di base predefinita è C:\acl\robots\data\ Esempio di percorso completo di una cartella di risultati con una cartella di base configurata dall'utente: C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions |
| 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.
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 Agente Robot gestisce due comandi ACLScript, EXECUTE e AICOMMAND, quando si verificano in uno script analitico.
|
| 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.
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 ulteriori informazioni, consulta Condividere e collegare tabelle di dati nei robot ACL. |
| AllowUploadsOnFailure | Quando un'attività del robot non riesce, specifica se un log dei risultati di Analytics viene caricato da Agente Robot all'applicazione Robot nel cloud.
Nota Se la proprietà AllowUploadsOnFailure non è presente nel file Agent.exe.config, aggiungila manualmente e imposta il valore su true o false, a seconda dei requisiti della tua organizzazione. Per esempio: <add key="AllowUploadsOnFailure" value="true"></add> |
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:
Aggiungi un'ulteriore sezione al file Agent.exe.config
Aggiorna altri due file di configurazione, AgentService.exe.config e Worker.exe.config
Passaggi
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\
Fai riferimento alla tabella seguente per aggiornare i file di configurazione nella sottocartella \agent.
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.
<?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.
<?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> |
