Champs des paramètres

La propriété Settings du Robot JavaScript SDK vous permet de personnaliser et d'améliorer votre contrôle sur la configuration de l'extension du navigateur.

class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}

Attribut	Description
portNumber	Vous permet de configurer des ports personnalisés sur lesquels les services back-end s’exécutent. Le numéro de port par défaut est 2323. Veuillez noter que cela n’est disponible que pour les installations Enterprise.
pollTimeInterval	Vous permet de spécifier la durée en millisecondes durant laquelle le Robot JavaScript SDK suit une exécution de processus à partir d’une page Web. La valeur par défaut est de 250 millisecondes. Cette valeur détermine la fréquence d'interrogation à partir du navigateur Web
disableTelemetry	Vous permet de désactiver le drapeau de télémétrie. La valeur par défaut est false.
appOrigin	Vous permet de spécifier l’application qui utilise le SDK. La valeur par défaut est récupérée dans la classe window.location.origin.

const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000;
robot.settings.disableTelemetry = true;
robot.settings.appOrigin = 'MyApp';

Paramètres de module complémentaire

Afin de modifier les paramètres des modules complémentaires, vous devez créer un fichier de configuration nommé RobotJSAddOn.config dans le dossier de module complémentaire du Robot, à savoir :

C:\ProgramData\UiPath\Robot JS Add-on\RobotJSAddOn.config

Le fichier de configuration doit contenir les éléments suivants :

<?xml version="1.0" encoding="utf-8"?>
<appSettings>
    <add key="ListenerPort" value="2323" />
    <add key="PortDiscoveryServiceEndpoint" value="http://127.0.0.1:2323" />
    <add key="TokenExpiryInDays" value="30" />
    <add key="AuthenticationProtocol" value="Custom" />
</appSettings>

Attribut	Description
ListenerPort	Le UiPath.RobotJS.ServiceHost.exe commence un HttpListener sur le port configuré et contient les informations sur les autres auditeurs locaux de la session d'utilisateur active sur ce système. Veuillez noter que la valeur du port doit correspondre à celle configurée dans les paramètres SDK.
PortDiscoveryServiceEndpoint	Le UiPath.RobotJS.UserHost.exe lance un HttpListener sur un port aléatoire et s’enregistre si l’auditeur est connecté à partir d'un processus UiPath.RobotJS.ServiceHost.exe. L’auditeur local connecté sur la session d'utilisateur doit savoir sur quel port et point de terminaison le HttpListener de la UiPath.RobotJS.ServiceHost.exe est en cours d’exécution.
TokenExpiryInDays	Any request coming from a new domain needs to have consent from the user to allow access of UiPath® Robots from a web application. These consents are valid for the said number of days mentioned in this setting.
AuthenticationProtocol	Les instances HttpListener communiquent entre elles à l’aide d’informations utilisateur chiffrées. Par défaut, notre cryptage personnalisé est utilisé pour déterminer les informations utilisateur sur les demandes Robot. Passer cette valeur à ““ entraîne un retour vers l’authentification NTML fournie par Windows. Veuillez noter que si les paramètres sont modifiés pour utiliser l’authentification NTLM, les paramètres du navigateur doivent également être modifiés pour permettre l’envoi de noms d’utilisateur Windows ainsi que les demandes. Voici la marche à suivre : Accédez à Internet Explorer → Paramètres d’outils → Options Internet → Onglet sécurité → Intranet local ou Sites de confiance. Cliquez sur le bouton Sites pour modifier les options de sites. Cliquez sur Avancées pour modifier la liste des URL pour la zone. Ajoutez http://127.0.0.1 à la liste des URL pour activer l’authentification NTLM.

Superposition par défaut

It is possible to customize the consent screen displayed when a request is raised from a new domain. There are currently two screens that are delivered with the Robot JavaScript SDK:

Invitation au consentement

The consent-prompt overlay is displayed when a request to access the UiPath^® Assistant is raised from a new domain.

Composants manquants

La superposition missing-components s'affiche lorsque le module complémentaire requis n’est pas présent sur la machine locale.

Les messages de superposition peuvent être configurés comme illustré ci-dessous.

// Consent code will be written to the console instead of showing default overlay
// Error logged to console when required components are missing insread of showing
// default error overlay
const robot = UiPathRobot.init();
robot.on('consent-prompt', function(consentCode){ console.log(consentCode) });
robot.on('missing-components', function(){ console.log('Missing components') });

Paramètres du SDK

class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}

Attribut	Description
portNumber	Vous permet de configurer des ports personnalisés sur lesquels les services back-end s’exécutent. Le numéro de port par défaut est 2323. Veuillez noter que cela n’est disponible que pour les installations Enterprise.
pollTimeInterval	Allows you to specify the time in milliseconds in which the Robot JavaScript SDK keeps track of a process execution from a web page. The default value is 250 milliseconds. This value determines the polling frequency from the web browser
disableTelemetry	Vous permet de désactiver le drapeau de télémétrie. La valeur par défaut est false.
appOrigin	Vous permet de spécifier l’application qui utilise le SDK. La valeur par défaut est récupérée dans la classe window.location.origin.

const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000;
robot.settings.disableTelemetry = true;
robot.settings.appOrigin = 'MyApp';