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 démarre un HttpListener sur un port aléatoire et s'enregistre si l'écouteur s'exécute à partir du processus UiPath.RobotJS.ServiceHost.exe . L'écouteur local exécuté sur la session utilisateur doit savoir sur quel port et sur quel point de terminaison le HttpListener du UiPath.RobotJS.ServiceHost.exe est en cours d'exécution.
TokenExpiryInDays	Toute demande provenant d’un nouveau domaine doit obtenir le consentement de l’utilisateur pour permettre l’accès aux UiPath Robots à partir d’une application Web. Ces consentements sont valables pour le nombre de jours mentionnés dans ce paramètre.
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 requêtes Robot. Changer cette valeur en ““ restaure l'authentification NTML fournie par Windows. Veuillez noter que si les paramètres sont modifiés pour utiliser l'authentification NTML, les paramètres du navigateur doivent également être modifiés pour permettre aux noms d'utilisateur Windows d'être envoyés avec les requêtes. Cela s'effectue comme suit : 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

Il est possible de personnaliser l'écran de consentement affiché lorsqu'une demande est générée à partir d'un nouveau domaine. Deux écrans sont actuellement livrés avec le Robot JavaScript SDK :

Invitation au consentement

La superposition consent-prompt s'affiche lorsqu’une demande d’accès à l’UiPath Assistant est levée à partir d’un nouveau domaine.

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	Permet de spécifier la durée en millisecondes pendant laquelle le Robot JavaScript SDK effectue le suivi de l'exécution d'un processus à partir d'une page Web. La valeur par défaut est définie sur 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';