Options par défaut dans la configuration du Robot à Moteur Basique

Cet onglet contient les propriétés générales de chargement, utilisées à la fois pour le chargement de la page et pour d'autres types de chargement.

Identifiants

Par défaut : Standard

Comme identifiants, vous pouvez utiliser des identifiants standard nom d'utilisateur / mot de passe ou des identifiants OAuth.

Si vous sélectionnez Standard, les propriétés suivantes sont disponibles :

Nom d'utilisateur

Cette propriété spécifie le nom d'utilisateur à utiliser pour la connexion. Cette valeur peut être spécifiée de plusieurs manières à l'aide du Sélecteur de valeur. Notez que ce nom d'utilisateur est utilisé uniquement pour la connexion HTTP et FTP. Ces types de connexion affichent normalement une fenêtre contextuelle dans un navigateur et sont différents de la méthode de connexion par formulaire classique, plus couramment utilisée.

Mot de passe

Cette propriété spécifie le mot de passe à utiliser pour la connexion. Cette valeur peut être spécifiée de plusieurs manières à l'aide du Sélecteur de valeur. Notez que ce mot de passe est utilisé uniquement pour la connexion HTTP et FTP. Ces types de connexion affichent normalement une fenêtre contextuelle dans un navigateur et sont différents de la méthode de connexion par formulaire classique, plus couramment utilisée.

Voir Authentification web pour plus d'informations.

Vous pouvez également utiliser les identifiants OAuth. OAuth est le mécanisme d'authentification préféré pour un certain nombre d'API REST populaires. Voir OAuth pour plus d'informations sur l'utilisation d'OAuth dans Design Studio et Management Console.

Certificat client

Par défaut : Automatique

Cette propriété définit comment récupérer un certificat client lors du chargement depuis les URL HTTPS. Le certificat client peut être fourni directement, ou vous pouvez vous référer à l'un de ceux qui ont été installés comme décrit dans Certificats client HTTPS. Les options sont :

• Automatique : Sélectionne l'un des certificats installés qui est marqué comme « par défaut ». Si aucun certificat n'a été installé ou qu'aucun des certificats installés n'est marqué comme « par défaut », aucun certificat client ne sera utilisé pour la connexion.

• Certificat installé : Sélectionne l'un des certificats installés en donnant son ID, qui a été défini lors de son installation.

• Certificat depuis variable : Le certificat est fourni comme la valeur d'une variable binaire. Le mot de passe du certificat doit également être indiqué, comme valeur d'une autre variable. Si un fichier de certificat contient plusieurs certificats, sélectionnez le certificat requis dans le champ « Alias ». La valeur par défaut « Aucune » ne spécifie pas l'entrée du certificat et sa sélection se fait automatiquement.

• ID depuis variable : Sélectionne l'un des certificats installés en donnant son ID comme valeur d'une variable.

Protocoles de chiffrement SSL/TLS

Par défaut : TLS sécurisé

Cette propriété spécifie le mode à utiliser lors du chargement depuis des URL HTTPS. Ceci est configurable car certains sites donnent des résultats différents, en fonction de la version SSL/TLS utilisée, par exemple lorsqu'ils ne prennent pas en charge les protocoles TLS modernes ou parce qu'ils n'acceptent pas les protocoles plus faibles fournis par le client. Deux options sont disponibles :

• TLS sécurisé : Limite les connexions chiffrées uniquement à l'utilisation de protocoles et de chiffrements sécurisés. Cette option prend en charge TLS 1.3 et TLS 1.2.
• TLS moins sécurisé : N'applique aucune restriction et utilise tous les protocoles et chiffrements pris en charge. Cette option prend en charge TLS 1.3, TLS 1.2, TLS 1.1, TLS 1.0 et SSL3.

  SSL3, TLS 1.0 et TLS 1.1 sont bloqués par défaut dans les étapes « Appeler le service web REST » et « Appeler le service web SOAP » dans le Robot à Moteur Basique. Pour activer ces protocoles, accédez à C:\Program Files\Kofax RPA (Version)\jre\conf\security\java.security et supprimez les valeurs SSLv3, TLSv1, TLSv1.1 du paramètre jdk.tls.disabledAlgorithms.

  jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, DH keySize < 1024, \
  EC keySize < 224, 3DES_EDE_CBC, anon, NULL, \
  include jdk.disabled.namedCurves

Vérifier les certificats SSL

Par défaut : Sélectionné

Si cette option est sélectionnée, le robot vérifie le certificat SSL présenté.

Pour des raisons de sécurité, nous vous recommandons de garder cette option sélectionnée à tout moment afin d'éviter les fuites de données ou des problèmes de performance du robot.

Méthode d'authentification

Par défaut : NTLM

Sélectionnez le protocole d'authentification à utiliser. Vous pouvez sélectionner NTLM et Négocier. Si vous sélectionnez Négocier, vous pouvez ajouter des paramètres de protocole spécifiques à Negotiate. Voir Authentification web pour plus d'informations.

HTTP User Agent

Par défaut : Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, comme Gecko) Chrome/43.0.2357.134 Safari/537.36

Cette propriété spécifie le texte exact à envoyer comme valeur de l'en-tête HTTP User-Agent. La modification de l'en-tête User-Agent – peut-être de manière aléatoire, en obtenant la valeur d'une variable – peut être utile pour mieux se mélanger à d'autres requêtes vers un serveur web distant.

Langue

Par défaut : Anglais (États-Unis) (en_US)

Cette propriété spécifie la langue du navigateur à utiliser, à la fois lors d'une requête de JavaScript et lors du chargement de quelque chose.

Taille de l'écran

Par défaut : 1280 x 1024

Cette propriété spécifie la taille de l'écran d'affichage, si requis par JavaScript.

En référence à cette URL

Par défaut : Non spécifié

Cette propriété spécifie l'URL à partir de laquelle vous voulez que l'activité semble avoir été référencée lors du chargement de quelque chose. Si vous ne spécifiez pas d'URL, l'action semblera être référencée à partir de la page actuelle dans le robot.

Activer les cookies

Par défaut : Sélectionné

Cette propriété spécifie si vous souhaitez que les cookies soient activés.

Cache HTTP

Par défaut : Activé

Cette propriété spécifie la façon souhaitée dont le robot utilise la mise en cache HTTP.

• Activé : Active le cache HTTP et met en cache les réponses HTTP en fonction des règles de la mise en cache HTTP.

• Désactivé : Désactive la mise en cache HTTP.

• Agressif remplace les directives de cache et active la mise en cache des ressources qui ne sont pas autrement mises en cache. L'option Agressif peut être utile pour améliorer les performances des sites à latence élevée.

Nombre maximal de tentatives

Par défaut : 1

Cette propriété spécifie le nombre de tentatives d'exécution de l'activité si une erreur de chargement se produit. La valeur minimale est « 1 ».

Temps entre les tentatives (s)

Par défaut : 5,0

Cette propriété spécifie le nombre de secondes à attendre entre chaque tentative d'exécution de l'activité.

Délai d'attente pour chaque tentative (s)

Par défaut : 60,0

Cette propriété spécifie le délai d'expiration de chaque tentative d'exécution de l'activité. La valeur doit être supérieure à zéro.

En-têtes supplémentaires à envoyer

Par défaut : Depuis une liste

Cette propriété spécifie une variable facultative ou une liste contenant des en-têtes HTTP supplémentaires à envoyer. Les en-têtes doivent être représentés sous forme de texte, dans le même format que dans un message HTTP.

Stocker le code d'état reçu ici

Par défaut : (Aucune)

Cette propriété spécifie une variable optionnelle dans laquelle stocker le code d'état des réponses HTTP. Le code sera un nombre entier et correspondra à la même réponse pour laquelle les en-têtes reçus ont été obtenus.

Stocker les en-têtes reçus ici

Par défaut : (Aucune)

Cette propriété spécifie une variable optionnelle dans laquelle stocker les en-têtes HTTP. Les en-têtes seront représentés sous forme de texte, dans le même format que dans un message HTTP.

Ignorer les erreurs de chargement

Par défaut : Non sélectionné

Cette propriété spécifie s'il faut ignorer les erreurs lorsque le chargement d'une page ou d'une ressource échoue.

Cet onglet contient les propriétés utilisées spécifiquement pour le chargement des pages.

Type de contenu de la page

Par défaut : Automatique

Cette propriété spécifie le type de contenu des pages chargées. En général, le paramètre Automatique devrait suffire, mais vous pouvez également spécifier directement un type de contenu, soit pour toutes les pages chargées dans l'activité, soit pour certaines d'entre elles seulement, en fonction de leur URL.

Respecter les redirections méta

Par défaut : Sélectionné

Cette propriété spécifie s'il faut suivre les redirections <meta>, c'est-à-dire les redirections définies par une balise <meta> dans une page chargée.

Charger des cadres

Par défaut : Sélectionné

Cette propriété spécifie s'il faut charger automatiquement les cadres d'une page.

Images à charger

Par défaut : Aucune

Cette propriété spécifie s'il faut charger automatiquement les images d'une page. En général, il n'est pas nécessaire que le robot charge les images, mais vous pouvez choisir de charger les images d'une page si vous pensez que le chargement de l'image a des effets secondaires nécessaires à la navigation de la page. Dans ce cas, vous pouvez choisir de charger toutes les images de la page ou seulement certaines, en fonction de leur URL.

Modifications de page

Par défaut : (Aucune)

Cette propriété vous permet de modifier les pages chargées à la volée avant qu'elles ne soient analysées. Ceci est utile pour des activités comme la correction des erreurs de syntaxe, la résolution d'autres problèmes d'analyse, la suppression ou la modification de balises, etc.

Les modifications sont effectuées en spécifiant un ou plusieurs convertisseurs de données qui seront appliqués aux pages avant l'analyse. Vous pouvez soit spécifier des convertisseurs de données à appliquer sur toutes les pages, soit des convertisseurs de données à appliquer à des pages individuelles en fonction de leur URL.

Les convertisseurs de données les plus courants à utiliser pour les modifications de page sont Remplacer du texte, Remplacer l'expression rationnelle et Supprimer les balises. Lors de la configuration des convertisseurs de données, n'oubliez pas qu'ils seront appliqués au texte original et non traité de la page, avant le décodage des caractères spéciaux, etc. Par conséquent, il est recommandé de récupérer ce texte, par exemple en utilisant la fonction Afficher la source de votre navigateur standard. Dans la fenêtre de configuration du convertisseur de données, vous pouvez coller le texte dans la zone de saisie dans l'angle inférieur gauche afin de vérifier que le convertisseur effectue l'action souhaitée sur le texte.

Si vous souhaitez apporter des modifications à JavaScript, utilisez plutôt la propriété Modifications JavaScript de l'onglet Exécution JavaScript.

Page Données de sortie si délai d'expiration dépassé

Par défaut : Sélectionné

Cette propriété spécifie ce qui se produit lorsque l'activité expire. Si elle est désactivée, l'activité échoue en cas d'expiration du délai. Si elle est activée, le résultat reçu jusqu'à présent est la sortie. Notez ce qui suit pour cette propriété :

• Lorsque des robots plus anciens du navigateur par défaut (WebKit) dont cette propriété est définie comme « false » par défaut sont ouverts dans une nouvelle version de Kofax RPA, Page de sortie en cas de dépassement de délai est défini sur false dans la configuration du navigateur du robot.

• Lors de la création d'un nouveau robot du navigateur par défaut, la propriété Page de sortie en cas de dépassement de délai est définie sur true par défaut.

Cet onglet contrôle la configuration des URL à bloquer, par exemple pour bloquer le chargement des fenêtres publicitaires. Les paramètres de cet onglet ne sont valables que pour les Robots à Moteur Basique.

Filtrer les URLs

Par défaut : Sélectionné

Cette propriété spécifie de bloquer ou non le chargement de certaines URL. Les URL à bloquer sont spécifiées comme expression rationnelle dans la liste des expressions rationnelles d'URL incluses et des expressions rationnelles d'URL exclues. Seules les URL présentes dans les balises suivantes peuvent être bloquées :

Expressions rationnelles d'URL incluses

Par défaut : Non spécifié

Si elles sont spécifiées, seules les URL qui correspondent à ces expressions rationnelles ne seront pas bloquées. Chaque expression rationnelle doit être écrit sur une ligne distincte. Une URL correspondant à l'une de ces expressions rationnelles peut toujours être bloquée si elle correspond à l'une des Expressions rationnelles des URL bloquées spécifiées ci-dessous. Une utilisation typique de cette propriété consiste à spécifier une expression rationnelle qui correspond uniquement aux URL d'un seul domaine, de sorte que seuls les fenêtres et les scripts de ce domaine soient chargés.

• <frame src="URL">
• <iframe src="URL">
• <script src="URL">

Si une URL est bloquée, aucune requête n'est effectuée et le contenu est laissé vide. Dans le cas des cadres et des iframes, il y aura toujours une nouvelle fenêtre dans la vue Page qui affichera un message expliquant pourquoi le chargement n'a pas été effectué. Une icône bloc rouge sur l'onglet de la fenêtre dans la vue Page indiquera que l'URL a été bloquée.

Expressions rationnelles d'URL bloquée

Par défaut : Cliquez sur Définir par défaut pour voir la liste par défaut des URL à bloquer

Cette propriété spécifie les URL à bloquer. Il suffit pour cela d'écrire la liste des expressions rationnelles avec un expression par ligne.

Cet onglet contient les propriétés utilisées pour l'exécution du JavaScript. Ces propriétés vous permettent de personnaliser l'exécution du JavaScript au cas où l'exécution automatique par défaut ne fonctionnerait pas correctement.

Exécuter JavaScript

Par défaut : Sélectionné

Cette propriété spécifie si JavaScript doit être exécuté ou non.

Ignorer les messages d'alerte

Par défaut : Non sélectionné

Une manière courante de gérer les messages d'alerte dans un robot consiste à configurer cette propriété pour les ignorer, puis à configurer la Stocker les messages d'alerte ignorés ici (voir ci-dessous) afin que les messages d'alerte ignorés soient stockés dans une variable appropriée. Dans une étape ultérieure, cette variable peut ensuite être testée et une activité appropriée prise si elle contient un message d'alerte.

Stocker les messages d'alerte ignorés ici

Par défaut : (Aucune)

Cette propriété spécifie une variable dans laquelle les messages d'alerte ignorés doivent être stockés. Ceci n'est pertinent que lorsque l'option Ignorer les messages d'alerte a été sélectionnée ci-dessus.

Délai entre les frappes au clavier (ms)

Par défaut : 0

Cette propriété spécifie le nombre de millisecondes à attendre entre les pressions sur les touches lors de l'émulation d'un utilisateur tapant sur un clavier. Cela n'a de pertinence que pour les étapes qui saisissent du texte dans un formulaire.

Modifications JavaScript

Par défaut : Non spécifié

Les modifications JavaScript sont une liste facultative de convertisseurs de données qui s'appliqueront au JavaScript avant son exécution. Les modifications s'appliquent à tous les JavaScript exécutés, qu'il s'agisse de gestionnaires d'événements, de scripts internes ou de scripts externes. Les convertisseurs de données sont utiles pour apporter des modifications et des corrections à JavaScript, par exemple, lorsque JavaScript ne peut pas fonctionner correctement dans un navigateur qui utilise des constructions de langage non prises en charge.

Lors de la configuration des convertisseurs de données, n'oubliez pas qu'ils s'appliqueront au JavaScript d'origine. Par conséquent, il est recommandé d'obtenir ce code, par exemple en utilisant la fonction Afficher la source de votre navigateur standard pour le JavaScript en ligne ou en téléchargeant le fichier en cas de JavaScript externe. Dans la fenêtre de configuration du convertisseur de données, vous pouvez coller le texte dans la zone de saisie dans l'angle inférieur gauche afin de vérifier que le convertisseur effectue l'action souhaitée sur le texte.

Cette option affecte la façon dont JavaScript est exécuté sur les pages que vous chargez.

Polyfills JavaScript

Par défaut : Non spécifié

Le navigateur Kofax RPA par défaut (WebKit) peut ne pas prendre en charge certaines fonctionnalités JavaScript, notamment les instructions récentes, les fonctions intégrées et les objets. Pour activer la prise en charge de nouvelles fonctionnalités, Kofax RPA peut charger des polyfills JavaScript prédéfinis ou personnalisés.

Un polyfill est un bout de code (généralement JavaScript sur le web) qui fournit des fonctionnalités modernes dans les navigateurs qui ne le prennent pas en charge de manière native.

En cas d'erreur, la console JavaScript montre quel objet JavaScript n'existe pas. Grâce à ces informations, un polyfill nécessaire peut être trouvé et appliqué pour résoudre une erreur.

Cliquez sur Ajouter (+) pour sélectionner un objet ou une API que vous souhaitez que le navigateur prenne en charge. Vous pouvez également inclure un code personnalisé qui prend en charge certains objets JavaScript ou API. Pour inclure une implémentation personnalisée, cliquez sur Ajouter (+) et sélectionnez Personnalisé dans la liste. La boîte de dialogue Personnalisé contient deux volets, tels que Nom et Code. Spécifiez le nom de votre implémentation de code dans le volet Nom et collez votre code JavaScript dans le volet Code.

Le code d'implémentation de l'objet JavaScript est exécuté avant le chargement de la page.

Voir la liste des polyfills prédéfinis dans Polyfills JavaScript prédéfinis.

Mais il existe de nombreuses constructions JavaScript modernes, où l'application des polyfills ne résout pas une erreur. Voir la liste des problèmes JavaScript connus dans Limitations Kofax RPA.

Cet onglet contient des paramètres pour ajouter et configurer des plugins simulés lors de l'utilisation du navigateur.

Simuler une prise en charge de

Par défaut : Depuis une liste

• Depuis une liste : Cliquez sur le signe plus et sélectionnez un plugin dans la liste.

• Depuis une variable JSON : Construisez vos propres plugins à l'aide d'une variable JSON.

  Voir Simulation de plug-in depuis une variable JSON pour plus d'informations.

Cet onglet contient des propriétés qui ne doivent pas être modifiées dans la plupart des cas. Les propriétés héritées ont été introduites pour garantir la rétrocompatibilité avec l'ancienne version du produit. Si une nouvelle fonctionnalité est introduite dans le produit qui entre en conflit avec la façon dont les choses étaient faites précédemment, une option est introduite sur cet onglet pour garantir que les anciens robots fonctionneront et seront rétrocompatibles. Dans cet onglet, le paramètre par défaut représente la méthode actuelle et l'autre paramètre est l'ancienne méthode.

Gestion des formats

Par défaut : Télécharger le code non-HTML

Cette option spécifie comment gérer les différents formats de document.

Télécharger le code non-HTML

Kofax RPA charge tout le contenu non-HTML pris en charge avec lequel travailler. Vous pouvez prévisualiser les contenus CSV, JSON, texte, Excel, XML et binaires et leur appliquer des étapes. Utilisez le bouton Aperçu pour modifier le type de contenu.

Chargement classique

Vous pouvez spécifier comment gérer les différents formats de document pour le moteur du navigateur classique.

JSON

Par défaut : Ne pas convertir

Cette propriété spécifie comment gérer le JSON, qui est l'un des types de réponse courants lors d'un appel aux services web. Vous pouvez convertir le JSON en XML, ce qui le rend facile à gérer de manière standard dans Design Studio. Alternativement, il peut être converti en HTML. Le HTML est plus lisible que le XML, mais un peu plus difficile à extraire automatiquement.

Convertir XML en HTML

Par défaut : Non sélectionné

Cette propriété spécifie s'il faut convertir les documents XML en documents HTML ou les conserver tels quels. Cette propriété est principalement utilisée dans les anciens robots qui travaillent sur les documents convertis, car c'était auparavant la seule option. Dans les robots plus récents, il est normalement plus pratique de travailler directement sur la structure XML.

Pour afficher le contenu XML avec la transformation XSLT appliquée dans la vue Applications, sélectionnez Configurer le robot > Options par défaut > Configurer > Ancien > Gestion des formats > Chargement classique et décochez l'option Convertir XML en HTML.

Convertir Excel en HTML

Par défaut : Non sélectionné

Cette propriété spécifie s'il faut convertir les documents Excel en documents HTML ou les conserver tels quels. Cette propriété est principalement utilisée dans les anciens robots qui travaillent sur les documents convertis, car c'était auparavant la seule option. Dans les robots plus récents, il est normalement plus pratique de travailler directement sur le document Excel, car cette propriété fournit un affichage et une interface utilisateur plus rapides et plus semblables à une feuille de calcul.

CSV

Par défaut : Convertir en HTML

Cette propriété spécifie s'il faut convertir les documents CSV en documents HTML ou les conserver sous forme de texte (dans une balise PRE). Cette propriété est principalement utilisée dans les anciens robots qui travaillent sur la représentation de texte, car c'était auparavant la seule option. Dans les robots plus récents, il est normalement plus pratique de travailler sur une représentation de tableau HTML du document CSV et d'utiliser toute la puissance de Design Studio pour ce faire. Supposons que les documents CSV sont codés en utilisant des virgules (,) comme caractère de séparation, des guillemets (") comme guillemet et une barre oblique inverse (\\) comme caractère d'échappement. Si le document que vous chargez n'est pas conforme à cette convention, vous devez utiliser l'option Convertir en texte et travailler sur le document sous forme de texte, par exemple à l'aide de l'étape Extraire le CSV.

Cet onglet contient un journal de migration du robot qui a été mise à niveau du navigateur classique vers le navigateur webKit (par défaut). Le journal répertorie toutes les valeurs qui ont été modifiées pendant la mise à niveau. Voir Mettre à niveau les Robot à Moteur Basique pour plus d'informations.