Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Paramétrage des Connecteurs

Ces connecteurs et agents optionnels s'installent et se paramètrent au niveau du serveur, en complément du moteur Efalia Process.

Connecteur Conversion .docx vers .pdf

com.clog.workey.connectors.DocxToPdfConnector

Action : transformation de fichiers docx contenus dans un champ pièce-jointe en PDF.

  • En entrée : un champ de type pièce-jointe (peut être multivalué).

  • En sortie : la liste des UUID des pièces-jointes converties en PDF, pouvant servir à alimenter un champ pièce-jointe.

Agent d'Extraction

Classe de l'agent: com.clog.workey.agents.extract.ExtractionAgent

Cet agent permet l'extraction des documents et de leurs pièces-jointes ayant été modifiés depuis sa dernière exécution.

Par défaut, les documents sont exportés en XML, sous la même forme que l'archiveur ou l'API Rest. Les fichiers XML extraits sont nommés document-III-yyyyMMddHHmm.xml, où III est l'identifiant du document, suivi du timestamp de l'agent d'exportation. S'il existait un précédent document avec le même identifiant dans le répertoire il sera supprimé, de même que pour le répertoire des pièces-jointes.

Il est également possible d'exécuter d'autres types de traitement sur ces documents à l'aide de classes Java ou de scripts Groovy.

Installation

Le fichier workey-agent-extraction-x.y.z.jar (où x.y.z est le numéro de version) doit être placé dans le répertoire $TOMCAT_HOME/workey/libs.

Paramètres

  • outputDirectory : Répertoire où seront exportés les documents et les pièces jointes. Ce paramètre est obligatoire si le processeur par défaut est appelé (voir plus bas).

  • processName : Nom interne du processus à traiter. Si cette valeur est absente, tous les documents, de tous les processus sont pris en compte.

  • doctypeName : Nom interne du type de document à traiter. Si ce paramètre est rempli, il est nécessaire d'avoir aussi défini le nom du processus.

  • workflowManager (obligatoire) : Identifiant du gestionnaire de workflow qui va extraire les données.

  • processorClass : Nom d'une classe Java implémentant l'interface com.clog.workey.agents.extract.ExtractionDocumentProcessor qui autorise un traitement supplémentaire lors de l'export de chaque document et pièce-jointe. Ce paramètre permet de faciliter l'intégration avec des moteurs de reporting. Plusieurs noms de classes peuvent être indiqués, séparés par les caractères suivants : ";", ":" ou ",". Voir ci-dessous.

  • exportAttachments : Si la valeur de cette propriété est "true", les pièces-jointes seront extraites.

  • dateRange : Si cette option est activée, le mode de sélection de l'agent n'est plus le mode normal (export des documents modifiés depuis son dernier lancement). Les documents compris entre les dates définies dans ce paramètre seront exportés. Le format de ce paramètre est yyyyMMddHHmm-yyyyMMddHHmm. Cette option peut être utile pour faire une exportation globale des documents déjà présent sur le serveur.

N.B.: si cette option est utilisée, la date d'exécution de l'agent n'est pas mise à jour afin de ne pas fausser des extractions ultérieures en mode "normal".

Classes de traitement des documents

Traitement par défaut

Export des documents

Afin d'éviter de se retrouver avec un trop grand nombre de fichiers par répertoire, les fichiers sont uniformément distribués dans 2*255 sous-niveaux de répertoire (de 00/ à ff/). Si les pièces-jointes sont exportées, elles seront toujours dans la même branche que leur document. Ainsi, un document et ses pièces-jointes seront par exemple exportés ainsi :

N.B. les fichiers sont sauvegardés sur disque de cette manière seulement si le processeur par défaut est appelé (dans les cas où le paramètre processorClass est vide, ou bien s'il contient la valeur <D>).

Export des pièces-jointes

Les pièces jointes sont copiées dans un sous-répertoire nommé "document-{docId}-attachments/". Le nom des fichiers extrait est constitué de l'identifiant unique de la pièce-jointe (uuid) et de son nom original.

Appel d'autres classes de traitement

Pour combiner cette classe avec d'autres classes de traitement, vous pouvez utiliser son nom raccourci "<D>" dans le paramètre processorClass. Également, si le nom de la classe commence par "P", le package com.clog.workey.agents sera utilisé.

Par exemple pour sauvegarder les fichier et créer un fichier Excel, vous pouvez mettre comme valeur : <D>;P.ExcelExtractionProcessor (qui est équivalent à com.clog.workey.agents.extract.DefaultExtractionProcessor;com.clog.workey.agents.extract.ExcelExtractionProcessor, mais en plus succinct).

À l'instar des connecteurs Workey, si des classes de traitements externes sont développées, le fichier .jar contenant ces classes doit être placé dans le répertoire $TOMCAT_HOME/workey/libs.

ExcelExtractionProcessor – Récapitulatif Excel

  • Classe "com.clog.workey.agents.extract.ExcelExtractionProcessor" : Créé un fichier Excel récapitulant les données extraites lors de l'exécution de l'agent, avec une feuille pour les documents exportés et une autre pour les pièces-jointes.

GroovyExtractionProcessor – Exécution d'un processor par script groovy

  • Classe "com.clog.workey.agents.extract.GroovyExtractionProcessor" : Charge un script nommé ExtractionGroovy.groovy dans le répertoire de sortie de l'agent, ou le script indiqué par la propriété système com.clog.workey.agents.extract.GroovyExtractionProcessor.script. Ce script doit comporter les méthodes suivantes pour fonctionner correctement. Elles seront appelées de la même manière qu'une classe java implémentant l'interface ExtractionDocumentProcessor (voir ci-dessous).

Voici un autre exemple d'un script insérant des données des documents et des pièces-jointes dans une base de données externe :

Ce script existe également sous forme de classe Java "com.clog.workey.agents.extract.DatabaseExtractionProcessor".

StarpageStart – Démarrage Starpage

Classe "com.clog.workey.agents.extract.StarpageStart" : création d'un fichier "start" en fin de traitement de l'agent pour le démarrage automatique du _daemon_Starpage.

Interface ExtractionDocumentProcessor

Cette interface est composée de cinq méthodes :

  • initDocumentProcessor(ExtractionAgent extractionAgent): Elle est exécutée avant le traitement des documents. Une instance de l'agent est passée en paramètre, qui permet d'accéder au répertoire de sortie (getBaseOutputDirectory()), au timestamp utilisé par cet agent (getAgentTimestamp()), aux noms du processus et du type de document le cas échéant (getProcessName() et getDocumentTypeName()).

  • filterDocument(long docId, Document xmlDoc) : Cette méthode est appelée après chaque ouverture de document pour savoir s'il doit être inclus dans l'export. Doit renvoyer "true" si le document doit être exporté, "false" s'il ne doit pas l'être.

  • processDocument(long docId, Document xmlDoc) : Cette méthode est appelée après l'export de chaque document.

  • processAttachment(long docId, Document xmlDoc, Element attachmentElement, DocumentData attachment, InputStream data) : Cette méthode est appelée après l'export de chaque pièce-jointe.

  • closeDocumentProcessor() : Cette méthode est appelé à la fin de l'exécution de l'agent.

De plus, la classe ExtractionAgent dispose d'un méthode Map<String, Object> getExtractionContext() qui permet d'échanger des informations entre les différentes classes de traitement. Ainsi, la classe de traitement par défaut inclura le nom du document en cours de traitement dans la clé DefaultExtractionProcessor.XML_OUTPUT_FILE, et les fichiers des pièces-jointes sauvegardés dans les clés avec le UUID de la pièce-jointe.

Par exemple une classe minimaliste de traitement pourrait ressemble à :

Connecteur CSV Sage

Connecteur permettant la création d'un fichier CSV pour Sage comportant des informations relatives à une facture.

Format du fichier CSV

Le fichier CSV produit par ce connecteur contient les champs dans l'ordre de la table ci-dessous. Le caractère séparateur de champ est ";", sans échappement des chaînes de caractères. Les nombres sont au format français, sans séparateur des milliers ("1234,56" par ex).

Champ CSV
Description

Nom du journal

Nom du journal à utiliser ("ACH", par ex.)

Date de la facture

Date de la facture au format YYYYMMDD

Date d'échéance

Date d'échéance de la facture au format YYYYMMDD

Numéro chronologique

Identifiant unique (Id du document Workey, par ex)

Numéro de la facture

Numéro indiqué sur la facture

Compte à imputer

Numéro d'imputation comptable

Code fournisseur

Identifiant du fournisseur (présent seulement sur la première ligne)

Libellé de l'écriture

Libellé de l'écriture

Montant TTC

Montant TTC de l'entrée

Débit/Crédit

Indique si l'entrée est une opération de débit ou crédit ("D" ou "C")

Moyen de paiement

Code du moyen de paiement (entier)

Devise

Code de la devise ("EUR", par ex)

Cours de la devise

Cours de la devise ("1" si aucune conversion n'est nécessaire)

Total devise

Résultat de l'opération Montant TTC * Cours devise

Bon à payer

Indique si la facture est validée pour paiement ("OUI" ou "NON")

Champs CSV exportés par le connecteur

Appel du connecteur

Classe : com.clog.workey.connectors.sage.ExportSage

Paramètres d'entrée

  1. Champ ayant comme valeur un objet JSON comportant la configuration (voir Configuration JSON) des différents champs à utiliser.

Valeurs de sortie

  1. (Aucune)

Configuration

Propriétés systèmes

Plusieurs propriétés systèmes peuvent être configurées dans le fichier $TOMCAT/conf/catalina.properties pour définir des valeurs par défaut à utiliser :

  • com.clog.workey.connectors.ExportSage.exportDir : Répertoire où seront créés les fichiers CVS pour Sage (par défaut $TOMCAT/workey/sage/)

  • com.clog.workey.connectors.ExportSage.journal : Nom par défaut du journal si aucun champ journal n'est présent dans le formulaire ("ACH", par ex).

  • com.clog.workey.connectors.ExportSage.compteTiers : Compte tiers par défaut si aucun champ n'est présent dans le formulaire.

Configuration JSON

La configuration permet d'effectuer un "mapping" entre les champs présents dans le formulaire Workey et les champs attendus dans le CVS Sage. Pour chaque propriété (voir la liste ci-dessous), il est possible d'indiquer le nom du champ qui lui correspond. Sinon, le nom de champ par défaut et/ou la valeur par défaut sera utilisé.

Liste des propriétés

Propriété
Nom du champ par défaut
Observations

journal

Journal

propriété com.clog.workey.connectors.ExportSage.journal

compteTiers

Compte_tiers

propriété com.clog.workey.connectors.ExportSage.compteTiers

compteGeneral

Compte_general

dateFacture

Date_facture

dateEcheance

Date_echeance

numeroFacture

Numero_facture

codeFournisseur

Code_fournisseur

libelleEcriture

Libelle_ecriture

montant

Montant_TTC

valeur par défaut : 0

detailMontant

Montant_net

champ multivalué

detailCompte

Compte_general

champ multivalué

detailLibelle

Libelle

champ multivalué

modePaiement

Moyen_paiement

devise

Devise

valeur par défaut : EUR

coursDevise

Cours_devise

valeur par défaut : 1

bonAPayer

Bon_a_payer

valeur par défaut : false

tvaIntracommunautaire

TVA_Intracommunautaire

valeur par défaut : false

compteTvaIntraCredit

Compte_TVA_intra_credit

compteTvaIntraDebit

Compte_TVA_intra_debit

typeFacture

Type_facture

valeurs possibles : INVOICE (facture) ou CREDIT NOTE (avoir)

Propriétés pour la correspondance Workey/CSV

En plus de ces propriétés utilisées pour la correspondance entre les champs Workey et les champs CSV, il est possible de redéfinir le nom du fichier de sortie avec la propriété "fileTemplate". Sa valeur par défaut est "ExportSage-%s.csv", où le "%s" représente la date (au format YYYYMMDD). Par conséquent, un seul fichier d'export par jour est créé, qui va contenir toutes les factures traitées dans la journée.

TVA Intracommunautaire

Si la propriété "tvaIntracommunautaire" est à "true", deux lignes supplémentaires seront créés dans le fichiers CSV : l'une pour l'opération de crédit avec le compte d'imputation indiqué par la propriété "compteTvaIntraCredit" et l

Limitations

Actuellement, la ventilation de la facture sur plusieurs compte n'est pas supportée.


Statistiques MixPanel

Lorsque la fonctionnalité de suivi MixPanel est activée, certaines actions du moteur vont alimenter de manière anonyme la base d'événement MixPanel.

Afin de minimiser l'impact de la collecte de ces événements, ils sont envoyés dans une queue JMS qui les traitera au fur et à mesure de manière asynchrone. Cependant, il n'est pas garanti que 100% des messages devant générer un événement MixPanel soient pris en compte.

Installation

Par défaut, cette fonctionnalité est désactivé. Pour la mettre en place, il suffit d'ajouter la propriété suivante au fichier $TOMCAT_HOME/conf/catalina.properties :

Évènements suivis

  • Create Document : Déclenché lors de la demande de création d'un nouveau document. En plus des propriétés standard, il contient les propriétés workey-process, workey-document-type, workey-state et workey-role.

  • Open Document : (non suivi car peu fiable)

  • Submit Document : Déclenché à la fin de la soumission d'un document (donc pas en cas d'erreur). En plus des propriétés standard, il contient les propriétés :

    • workey-document,

    • workey-process,

    • workey-document-type,

    • workey-state,

    • workey-role,

    • workey-agent, booléen indiquant si la soumission a été faite par un agent

    • workey-document-alive, booléen indiquant si le document est arrivé en fin de vie (plus d'état suivant disponible)

  • Save Document : Déclenché lors de l'enregistrement d'un document (sans changement d'état). En plus des propriétés standard, il contient les propriétés workey-document, workey-process, workey-document-type, workey-state et workey-role.

  • Open View : Déclenché lors de l'ouverture ou rafraîchissement d'une vue. En plus des propriétés standard, il contient les propriétés workey-view.

  • Error during submit : (non suivi actuellement)

  • Execute Search : Déclenché lorsque une recherche est effectué. Aucune propriété particulière n'est envoyée.

  • Deploy Process : Déclenché lorsqu'un processus est déployé. Pour des raisons techniques, l'utilisateur effectuant ce déploiement ne peut pas être distingué, un utilisateur avec un id "-1" et unique pour la license est utilisé. En plus des propriétés standard, il contient les propriétés :

    • workey-process-name

    • workey-deploy-roles, le nombre de rôles déployés dans ce processus

    • workey-deploy-operations, le nombre d'opérations déployées dans ce processus

    • workey-deploy-doctypes, le nombre de types de document déployés dans ce processus

    • workey-deploy-forms, le nombre de formulaires déployés dans ce processus

    • workey-deploy-views, le nombre de vues déployées dans ce processus

Propriétés MixPanel

Pour des raisons de sécurités, toutes les propriété ci-dessus (hormis les champ booléen) sont pseudonymisées à partir de la licence.

Cette pseudonymisation prend la forme d'un UUID créé à partir du nom du client, du type de données (document-id, operation-id, etc.) et de l'identifiant de la donnée. Cela permet d'identifier de manière unique chaque partie de données sans avoir les données réelles.

Lors de chaque événement envoyé à MixPanel, les propriétés suivantes sont également envoyées :

  • workey-client : le nom du client (champ "Licensed To" de workey-license.xml), c'est la seule donnée en clair concernant le client.

  • workey-version : Version de Workey utilisée pour cet événement ("6.11.4", par exemple)

  • workey-env : Valeur (en clair) de la propriété système "com.clog.workey.analytics.mixpanel.env", si elle est présente. Cela permet de filtrer certaines installations particulières, si besoin

Propriétés Workey

  • com.clog.workey.analytics.mixpanel.enable : Activation/désactivation de l'envoi d'événements vers MixPanel ("true" ou "false", "false" par défaut)

  • com.clog.workey.analytics.mixpanel.token : Identifiant de l'environnement MixPanel utilisé ("1c1358cdd54edfb2341e98682f7956e2": production (par défaut), "d714004bdc15c44bffa9313eea27f60f": test)

  • com.clog.workey.analytics.mixpanel.env : Propriété système alimentant la propriété MixPanel "workey-env" (voi ci-dessus)


Workey Mail Checker

Utilitaire de création de document Workey par vérification de boîte mail (POP ou IMAP)

Installation

  • Dézipper le fichier workey-checkmail-1.0.0.zip dans un répertoire

  • Configurer le fichier de propriété mailProcess.properties (voir section Configuration)

  • Lancer la commande bin/workey-checkmail

Configuration

Usage


Workey Selenium Tester

Cet article présente l'installation, la configuration et l'utilisation de la plateforme Workey d'automatisation des tests "workey-selenium-tester".

Installation

  • Récupérer la dernière version de workey-selenium-tester auprès de votre interlocuteur Efalia.

  • Dézipper l'archive (ex. workey-selenium-tester-1.5.1.zip) dans un répertoire de votre système.

  • Si besoin, importer le fichier des utilisateurs de tests resources\ldif\test-users.ldif dans le LDAP (les tests de validation s'attendent à trouver certains de ces utilisateurs).

  • Éditer si besoin les fichiers admin-rest.properties et validation-selenium.properties

Scripts Groovy

Les scripts et WKY de validation Workey se trouvent dans le répertoire tests/validation. Le script tests/validation/000-setup.groovy est particulier car c'est lui qui déploie les WKY, créé les unités organisationnelles et effectue les assignations des acteurs à leur rôles. Il prend ses informations des fichiers tests/validation/000-assignments.json et tests/validation/000-organizational_units.xml

Plusieurs scripts Groovy ont été développés pour automatiser la création de formulaires, ordres et demandes dans SIRA. Ils se trouvent dans le répertoire groovy/. Les scripts utilisés pour tester le processus de blocage-v2 se trouvent dans le répertoire test/blocage-v2.

Les scripts Groovy présents dans le répertoire test/validation/ sont numérotés en essayant de respecter la convention arbitraire :

  • 000: Administration (spécial)

  • 001 à 599 : Fonctionnalités de base de Workey

  • 600 à 899 : Fonctions spéciales / modules / etc.

  • 900 à 999 : Connecteurs

Dans l'idéal, à chaque script Groovy doit correspondre un projet Workey associé avec le même nom (seule l'extension change).

Dans les cartons…

Il faudrait faire en sorte (avec une sorte de fichier Manifest) que le script Groovy puisse déployer lui-même le processus et faire les affectations avant de se lancer.

Lancement

Les options de workey-selenium-tester:

Pour exécuter un script Groovy:

Pour exécuter tous les tests contenus dans un fichier contenant un fichier .groovy par ligne :

Une fois tous les scripts exécutés, les statistiques de réussite et d'échec sont affichées. Si des erreurs sont survenues, la liste des scripts problématiques est enregistrées dans le fichier "failed-scripts.list".

Dans PowerShell, pour purger les processus des navigateurs robots :

Dans les cartons…

Prévoir un GUI pour faciliter le lancement des tests et pouvoir enregistrer le résultat des tests de manière synthétique (CSV, XML ou JSON).

Compilation

  • .\gradlew.bat installZip

  • .\build\install\workey-selenium-tester\bin\workey-selenium-tester.bat .\tests\blocage-v2\test00-treeview.groovy

ou bien,

  • .\gradlew.bat distZip

Écriture de tests Workey Selenium

Configuration

Fichier de Propriétés

Le constructeur du robot Selenium prend en paramètre un chemin vers un fichier de propriétés. Les différentes propriétés possibles sont les suivantes :

  • selenium.driver.host : URL de connexion vers le serveur Workey

  • selenium.driver.type : Type de navigateur à utiliser: "chrome" (par défaut), "firefox" ou "edge". Le driver Chrome est celui qui est privilégié.

  • selenium.driver.timeout : Temps d'attente en seconde lors de la recherche d'éléments.

Propriétés spécifiques Chrome

  • selenium.driver.chrome.profile : Réutilise le profil Chrome au lieu d'en créer un nouveau à chaque exécution. Cela permet notamment de réutiliser des extensions (valeur "true"/"false", défaut à "false").

  • selenium.driver.chrome.headless : Lance Chrome sans interface graphiqe (valeur "true"/"false", défaut à "false").

  • selenium.driver.chrome.allow-notifications : Autorise les notifications à s'afficher (valeur "true"/"false", défaut à "false").

  • selenium.driver.chrome.maximized : Lance Chrome avec la fenêtre maximisée (valeur "true"/"false", défaut à "false").

  • selenium.driver.chrome.disable-gpu : Lance Chrome sans accélération graphique, permet parfois de corriger des bugs visuels (valeur "true"/"false", défaut à "false").

  • selenium.driver.chrome.disable-infobars : Désactive l'affichage d'une barre indiquant que Chrome est lancé en mode automatique (valeur "true"/"false", défaut à "false").

Propriétés avancées

  • selenium.driver.skip-pause : Ignore les pauses manuelles. Utile lorsque les tests doivent être complètement automatiques (valeur "true"/"false", défaut à "false").

  • screenshot.dir : Répertoire où seront enregistré les copies d'écran (par défaut "output")

  • selenium.proxy : Créé un proxy permettant d'enregistrer les communications au format HAR avec les méthodes runner.newHar(harFile) et runner.saveHar() (valeur "true"/"false", défaut à "false").

  • selenium.driver.path : Chemin d'accès aux drivers des navigateurs (par défaut "drivers")

  • test.language : Code du langage utilisé pour les données créées par JFairy (par défaut "fr")

  • runner.type : Type de robot à utiliser (valeur "WORKEY_5", "WORKEY_6" ou "WORKEY_7")

Déploiement et initialisation des processus

Le script "validation/000-setup.groovy" est un script spécial qui permet de définir les gestionnaires de workflow et de processus, de déployer automatiquement des fichiers WKY, de créer des unités organisationnelles et d'affecter des acteurs à des rôles et à des unités.

Il prend ces informations à partir du fichier "admin-rest.properties" dans lequel est défini un chemin vers un fichier JSON (voir par exemple, "tests/validation/000-assignments.json")

Dans les cartons…

Cette partie va vraisemblablement être modifiée pour être un peu plus flexible.

Script Groovy

Le "Runner" Workey

L'application dispose de plusieurs robots spécialisés dans différentes versions de Workey. Ils peuvent être forcés avec l'option "--type" de workey-selenium-tester.

  • com.workey.selenium.SeleniumScriptRunner : Workey 5 / JBoss

  • com.workey.selenium.SiraScriptRunner : Workey 5 / JBoss / Fonctions spéciales SIRA (Gencods, création des formulaires, etc.)

  • com.workey.selenium.Workey6ScriptRunner : Workey 6 / Tomcat

  • com.workey.selenium.WorkeyStoreScriptRunner : Workey 7 – nouvelle interface/ Tomcat

Principales propriétés

  • runner : le "robot" Workey, couche de haut niveau qui sait se connecter à l'application, ouvrir des vues, créer des document, remplir des formulaires, etc

  • runner.driver : le moteur Selenium, pour effectuer des actions de bas niveau qui ne seraient pas proposé par le runner.

  • runner.logger : instance de logger

  • runner.fairy : Générateur de données factices mais vraisemblables (nom de personne, adresses, société, mail, etc). Pour plus d'informations: JFairy.

  • runner.textProducer : Générateur de texte aléatoire

  • runner.properties : Propriétés chargées lors de l'exécution du script

Principales méthodes Workey

  • runner.getCredentials("XXX") : récupère le login/mot de passe à partir des propriétés systèmes "XXX.login" et "XXX.password". Si ces propriétés n'existent pas, le login "XXX" est utilisé, avec le mot de passe "test".

  • runner.workeyLogin(Credentials) : Connexion à l'application.

  • runner.workeyLogout() : Déconnexion

  • runner.openView(viewName) : Ouverture d'une vue (par son libellé en v6 et v7, par son nom interne en v5).

  • runner.openDocumentFromView(documentIdentifier) : Ouverture d'un document depuis une vue. Le paramètre doit être de préférence une chaîne de caractère permettant d'identifier sans ambigüité le document à ouvrir.

  • runner.createNewDocument(documentLabel) : Création d'un nouveau document, en indiquant le libellé avec lequel il apparaît dans le menu de création.

  • runner.setFieldValue(fieldName, value): Change la valeur d'un champ.

  • runner.setFieldValue(fieldName, value, index): Si le champ est multivalué, ou s'il fait partie d'une table dynamique, change la valeur du champ à l'index indiqué (commence à 0)

  • runner.getFieldValue(fieldName): Récupère la valeur du champ.

  • runner.getFieldValue(fieldName, index): Récupère la valeur du champ à l'index indiqué si le champ est multivalué, ou s'il fait partie d'une table dynamique (commence à 0)

Méthodes utilitaires annexes

  • runner.waitForField(fieldName): Le script attend que le champ soit visible dans le document.

  • runner.randomId(prefix) : Génère une chaîne de caractère aléatoire du type "prefix-ABC-DEF-GHI". Cela permet notamment de retrouver facilement des documents testés si cette valeur est utilisée dans le sujet du document.

  • runner.close() : Ferme la fenêtre active du navigateur.

  • runner.quit() : Quitte le navigateur

  • runner.newTab() : Création d'un nouvel onglet

  • runner.switchTab(): Bascule cyclique d'un onglet à l'autre

  • runner.switchToFrame(frame): Sélectionne le <frame> HTML courante. La plupart des méthodes de WorkeyScriptRunner se chargent de basculer d'une frame à l'autre si besoin.

  • runner.expectAlert(message) : Si une alerte JS est émise, cette fonction permet de la valider et continuer le test.

  • runner.pause(message) : Met le script en pause en affichant un message. L'utilisateur doit appuyer sur Entrée pour continuer le test. Cela permet de donner le temps à l'utilisateur d'effectuer des actions non testable (ouverture et vérification d'un fichier externe, par exemple)

  • runner.pause(temps_ms) : Marque une pause dans le traitement du script. Utile pour être sûr que certains traitements aient le temps de s'effectuer (JS, etc).

  • runner.screenshot(file): Prend une capture d'écran de la fenêtre courante du navigateur et l'enregistre dans un fichier.

Tests JUnit

Les tests se font avec la classe org.junit.Assert

  • Assert.assertTrue

  • Assert.assertFalse

  • Assert.assertEquals

  • Assert.assertNotNull

Pour vérifier qu'un objet est visible dans le navigateur:

Expressions XPath

Pour tester une expression XPath dans Chrome, avec la console:

Exemple de script


Mis à jour