UFT

Note

Ce plugin est disponible uniquement dans la version Ultimate de Squash.

Ce plugin fournit des fonctions qui gèrent les tests UFT. Il a été validé avec UFT 15.0.2 et devrait fonctionner avec toute version récente d'UFT.

Warning

La version actuelle de Squash ne supporte que "GUI Testing". "API Testing" et "BPT Testing" ne sont pas encore disponibles.

Il peut être utilisé directement dans un workflow, ou indirectement via des générateurs (comme ceux donnant accès aux gestionnaires de cas de tests).

Une installation UFT fonctionnelle doit être disponible dans les environnements d'exécution ciblés.

Note

This plugin is available only in the Ultimate version of Squash.

This plugin provides functions that handle UFT tests. It has been validated with UFT 15.0.2 and should work with any recent version of UFT.

Les fonctions ont un préfixe de catégorie uft.

Fonctions

uft/uft@v1

Permet d'exécuter un répertoire de test UFT.

Si la fonction est utilisée plus d'une fois dans un job, c'est à l'appelant de s'assurer qu'aucun résultat de test précédent ne persiste avant de lancer une nouvelle exécution de test.

Les paramètres de test sont facultatif mais s'ils sont utilisés, ils doivent être déclarés dans l'exécution de test.

Entrants

La fonction a les entrants suivants :

• datasource (obligatoire)

  Le répertoire de test à utiliser.

• test_parameters (facultatif)

  Les paramètres externes à utiliser.

Rapports

La fonction génère les rapports suivants :

• uft-results.xml

  Fichier XML des résultats d'exécution.

  Ce fichier a le content-type application/vnd.opentestfactory.uft-report+xml.

• uft-report.tar

  Une archive TAR.
  Contient tous les fichiers présents dans le répertoire de résultats Res1.

Exemple

- uses: uft/uft@v1
  with:
    datasource: uftSolution/uftTestFolder
    test_parameters:
      param1: value
      param2: value

uft/execute@v1

Une fonction 'execute' destinée à être utilisée par les générateurs.

Format de la référence de test

Le format de la référence de test utilisé par uft/execute@v1 est le suivant :

• {testfolder}

Avec :

• {testfolder}: Le chemin du répertoire de tests à exécuter.

Entrants

La fonction a les entrants suivants :

• test (obligatoire)

  La référence de test.

Rapports

La fonction génère les rapports suivants :

• uft-results.xml

  Fichier XML des résultats d'exécution.

  Ce fichier a le content-type application/vnd.opentestfactory.uft-report+xml.

• uft-report.tar

  Une archive TAR.
  Contient tous les fichiers présents dans le répertoire de résultats Res1.

Exemple

- uses: uft/execute@v1
  with:
    test: uftSolution/uftTestFolder

uft/params@v1

Une fonction params destinée à être utilisée par les générateurs.

Entrants

La fonction a les entrants suivants :

• data (obligatoire)

  Les données à utiliser pour les tests automatisés.

• format (obligatoire)

  Le format à utiliser pour les données des tests automatisés.

Exemple

- uses: uft/params@v1
  with:
    data:
      global:
        key1: value1
        key2: value2
      test:
        key1: value3
        key3: value4
    format: format

La valeur du format doit être SQUASHTM_FORMAT (tm.squashtest.org/params@v1).

data peut avoir 2 clés :

• global pour les paramètres globaux.
• test pour les paramètres de test.

Utilisé via l'inception

Pour plus d'information sur ce qu'est l'inception, merci de consulter "Inception".

Préchargez l'environnement d'exécution avec à minima les données du rapport d'exécution de tests.

Exemple

my_workflow.yaml

metadata:
  name: UFT Inception
resources:
  files:
  - report1
jobs:
  my_specific_job:
    runs-on: inception
    steps:
    - uses: actions/prepare-inception@v1
      with:
        uft-results.xml: ${{ resources.files.report1 }}
    - uses: uft/execute@v1
      with:
        test: uftSolution/uftTestFolder

Vous pouvez utiliser la commande suivante pour lancer l'exécution :

BashCMDPowerShell

opentf-ctl \
    run workflow my_workflow.yaml \
    -f report1=output_1.xml

opentf-ctl ^
    run workflow my_workflow.yaml ^
    -f report1=output_1.xml

opentf-ctl `
    run workflow my_workflow.yaml `
    -f report1=output_1.xml

Configuration

Des hooks peuvent être définis pour les fonctions fournies. Cela peut être fait dans les définitions du workflow ou directement au niveau de l'orchestrateur afin qu'ils s'appliquent à tous les workflows.

La configuration au niveau de l'orchestrateur se fait en passant la variable d'environnement UFT_PROVIDER_HOOKS ou en ajoutant le hook dans le fichier de configuration /app/conf/uft.yaml.

Pour plus d'informations, merci de consulter la documentation de l'OpenTestFactory.