Champs des paramètres

Champs de paramètres du module complémentaire de navigateur Robot JavaScript SDK, y compris les options de configuration du numéro de port, de l'intervalle d'interrogation, de la télémétrie et de l'origine de l'application.

Paramètres du SDK

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	Lets you configure custom ports on which the back-end services run on. The default port number is 2323.
pollTimeInterval	Permet de spécifier la durée en millisecondes pendant laquelle le SDK JavaScript du Robot suit l’exécution d’un 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 l'indicateur de télémétrie. La valeur par défaut est false.
appOrigin	Identifies the application that uses the SDK in the SDK telemetry. The default value is picked up from the window.location.origin property.

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

Add-on settings are configured in the UiPath.config file: %ProgramFiles%\UiPathPlatform\Robot\<version>\UiPath.config for a per-machine installation, or %LocalAppData%\Programs\UiPathPlatform\Robot\<version>\UiPath.config for a per-user installation. For details, see Configuration files.

The robotJsSettings section of the configuration file can contain the following keys. By default, the section is empty and the add-on uses the default values, 2323 for ListenerPort and 30 for TokenExpiryInDays:

<robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings>

Attribut	Description
ListenerPort	Le UiPath.RobotJS.ServiceHost.exe démarre un HttpListener sur le port configuré et contient les informations sur les autres processus d'écoute locaux de la session utilisateur active sur ce système. La valeur du port doit correspondre à celle configurée dans les paramètres du SDK.
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.

Superposition par défaut

Il est possible de personnaliser l'écran de consentement affiché lorsqu'une demande est levée à partir d'un nouveau domaine. Deux écrans sont fournis 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é dans l'exemple suivant.

// Consent code will be written to the console instead of showing default overlay
// Error logged to console when required components are missing instead 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') });