> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Création d'étapes d'activité

> Créez les étapes et sous-étapes de l’activité Pega CaptureData qui ouvrent la pièce jointe du dossier, appellent la bibliothèque FlexiCapture et appliquent le JSON Data Transform.

Ensuite, vous devez créer des étapes pour l'activité *CaptureData*.

1. Dans l’onglet **Steps**, créez une nouvelle étape et, pour celle-ci : dans le champ **Method**, sélectionnez *Obj-Open-By-Handle* ; dans le champ **Step page**, sélectionnez *Case* ; et dans le champ **InstanceHandle**, saisissez *Param.CaseId.*

   <Frame>
     <img src="https://mintcdn.com/abbyy/KEmWsO92hkr7eybZ/images/flexi-capture/connectors/Pega14.png?fit=max&auto=format&n=KEmWsO92hkr7eybZ&q=85&s=8f9c23823b681e11eb48bb627892d81a" alt="Capture d’écran de la première étape dans Pega configurée avec la méthode Obj-Open-By-Handle, la Step page Case et un InstanceHandle de Param.CaseId." width="846" height="337" data-path="images/flexi-capture/connectors/Pega14.png" />
   </Frame>

2. Créez une deuxième étape et, pour cette étape : dans le champ **Method**, sélectionnez *Call RemoveFromPageList;* dans le champ **PageListProperty**, saisissez *LineItems;* dans le champ **Index**, saisissez **1** (c.-à-d. l’indice d’une chaîne vide que Pega crée par défaut) ; et dans le champ **FinishingActivity**, saisissez *""* (c.-à-d. une chaîne vide).

   <Frame>
     <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega33.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=2fb4d2776952b454e5dfcb8872e50550" alt="Capture d’écran de la deuxième étape dans Pega configurée avec la méthode Call RemoveFromPageList, une valeur PageListProperty de LineItems, un Index de 1 et une valeur FinishingActivity définie sur une chaîne vide." width="876" height="343" data-path="images/flexi-capture/connectors/Pega33.png" />
   </Frame>

3. Créez une troisième étape et, pour cette étape : dans le champ **Method**, sélectionnez *Property-Set;* dans le champ **PropertiesName**, sélectionnez *Local.Index;* et dans le champ **PropertiesValue**, saisissez *0*.

   <Frame>
     <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega34.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=9bd9550759490690c97f60079cd4a988" alt="Capture d’écran de la troisième étape dans Pega configurée avec la méthode Property-Set, une valeur PropertiesName de Local.Index et une valeur PropertiesValue de 0." width="799" height="195" data-path="images/flexi-capture/connectors/Pega34.png" />
   </Frame>

4. Créez une quatrième étape permettant de récupérer les identifiants et les informations des fichiers. Pour cette étape, sélectionnez *Property-Set* dans le champ **Method** et créez les Parameters suivants : *Local.LinkedRefTo* et *Local.Id*.

| **PropertiesName** | **PropertiesValue**                          |
| ------------------ | -------------------------------------------- |
| Local.LinkedRefTo  | Case.pyAttachments(\<CURRENT>).pxLinkedRefTo |
| Local.Id           | Case.pyAttachments(\<CURRENT>).pzInsKey      |

<Frame>
  <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega35.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=8855dcf0a50a0906a2552e0f5434ba47" alt="Capture d’écran de l’étape 4 dans Pega utilisant la méthode Property-Set, avec Local.LinkedRefTo défini sur le pxLinkedRefTo de l’élément actuel de Case.pyAttachments et Local.Id défini sur son pzInsKey." width="790" height="234" data-path="images/flexi-capture/connectors/Pega35.png" />
</Frame>

5. Ajoutez la boucle suivante à l’étape 4 : *Pour chaque élément dans la liste de valeurs – Case.pyAttachments*.

   <Frame>
     <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega37.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=51ce6eb8937776a26a12df269e93f59c" alt="Capture d’écran de la boîte de dialogue Loop dans Pega pour l’étape 4, avec Repeat défini sur For each element in value list et Value List Property défini sur Case.pyAttachments." width="683" height="167" data-path="images/flexi-capture/connectors/Pega37.png" />
   </Frame>

6. Ajoutez une condition *When* à l’étape 4 et définissez-la sur *Local.Index==0.* Ainsi, l’activité ne traitera que la première pièce jointe.

| **When**       | **si la condition est vraie** | **si faux**     |
| -------------- | ----------------------------- | --------------- |
| Local.Index==0 | Continuer les When            | Ignorer l’étape |

<Frame>
  <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega36.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=07829e1732fb7911fb68ea8f0f0c6ae9" alt="Capture d’écran de la boîte de dialogue des conditions When dans Pega pour l’étape 4, avec la condition Local.Index==0 définie sur Continue Whens si la condition est vraie et Skip Step si faux." width="1235" height="239" data-path="images/flexi-capture/connectors/Pega36.png" />
</Frame>

7. Créez six sous-étapes liées à l’étape 4 (pour créer une sous-étape, créez une nouvelle étape et faites-la glisser dans l’étape 4).
   * Pour la première sous-étape : dans le champ **Method**, sélectionnez *Obj-Open-By-Handle* ; dans le champ **Step page**, sélectionnez *Attachment* ; et dans le champ **InstanceHandle**, saisissez *Local.LinkedRefTo.*

     <Frame>
       <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega17.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=96060119e04b381fbc468ddd471d03d6" alt="Capture d’écran de la première sous-étape dans Pega, configurée avec la méthode Obj-Open-By-Handle, la Step page Attachment et un InstanceHandle défini sur Local.LinkedRefTo." width="819" height="295" data-path="images/flexi-capture/connectors/Pega17.png" />
     </Frame>

* Pour la deuxième sous-étape : dans le champ **Method**, sélectionnez *Obj-Open-By-Handle* ; dans le champ **Step page**, sélectionnez *AttachmentInfo* ; et dans le champ **InstanceHandle**, saisissez *Local.Id*.

  <Frame>
    <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega18.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=242c6c760945d9d537e92ee1a77cd4ef" alt="Capture d’écran de la deuxième sous-étape dans Pega, configurée avec la méthode Obj-Open-By-Handle, la Step page AttachmentInfo et un InstanceHandle défini sur Local.Id." width="807" height="298" data-path="images/flexi-capture/connectors/Pega18.png" />
  </Frame>

* Pour la troisième sous-étape, sélectionnez *Property-Set* dans le champ **Method** et créez le paramètre suivant pour cette méthode : *Param.jsonData – @FlexiCaptureLlibrary.CaptureData(AttachmentInfo.pyMemo, Attachment.pyAttachStream)* (après le caractère « @ », indiquez le nom de la bibliothèque décrite dans la section [Installation](/fr/flexi-capture/connectors/pega/pega-installation-2#java) ; après le point, indiquez le nom de la fonction). Créez également un paramètre nommé *Param.executionMode – DESERIALIZE*.

  <Frame>
    <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega38.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=5296633093d04dab79186538c9e9b76e" alt="Capture d’écran de la troisième sous-étape dans Pega, configurée avec la méthode Property-Set, un paramètre Param.jsonData défini sur @FlexiCaptureLibrary.CaptureData(AttachmentInfo.pyMemo, Attachment.pyAttachStream) et un paramètre Param.executionMode défini sur DESERIALIZE." width="961" height="234" data-path="images/flexi-capture/connectors/Pega38.png" />
  </Frame>

Ensuite, cliquez sur le bouton **Jump** et ajoutez un paramètre *StepStatusFail* pour gérer les erreurs.

| **When**       | **if true**                 | **true param** | **if false**                | **false param** | **On exception, jump to later step label** |
| -------------- | --------------------------- | -------------- | --------------------------- | --------------- | ------------------------------------------ |
| StepStatusFail | passer à l’étape ultérieure | ERR            | passer à l’étape ultérieure | OK              | ERR                                        |

<Frame>
  <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega43.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=b5579f529c06ef5e1c794851c28b0263" alt="Capture d’écran des conditions Jump pour la troisième sous-étape dans Pega, avec une condition StepStatusFail qui passe à l’étape ultérieure ERR si elle est vraie et à OK si elle est fausse, et avec ERR comme étiquette en cas d’exception." width="1087" height="301" data-path="images/flexi-capture/connectors/Pega43.png" />
</Frame>

Cliquez sur **Submit**.

* Pour la quatrième sous-étape, sélectionnez *Page-Set-Messages* dans le champ **Method** et indiquez le paramètre suivant pour cette méthode : *Message – @getWorstMessageName(tools).* Marquez cette sous-étape comme *ERR*. Ensuite, vous devez empêcher l’activité d’exécuter les étapes suivantes si une erreur se produit. Pour cela, cliquez sur le bouton **Jump** et ajoutez les paramètres suivants :

| **When** | **if true**                 | **true param** | **if false**                | **false param** |
| -------- | --------------------------- | -------------- | --------------------------- | --------------- |
| true     | passer à l’étape ultérieure | INC            | passer à l’étape ultérieure | INC             |

<Frame>
  <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega44.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=d65e842c078517c37bb182739faaf577" alt="Capture d’écran des conditions Jump pour la quatrième sous-étape dans Pega, avec une valeur When définie sur true qui passe à l’étape ultérieure INC pour les branches if true et if false." width="1310" height="289" data-path="images/flexi-capture/connectors/Pega44.png" />
</Frame>

* Pour la cinquième sous-étape, sélectionnez *Apply-DataTransform* dans le champ **Method** et indiquez le paramètre suivant pour cette méthode : *DataTransform – JsonToInvoiceFields*. Marquez cette sous-étape comme *OK* et sélectionnez l’option *PassParameterPage*.

  <Frame>
    <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega45.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=f52ea07c13e90049d7d0d1d3c1d197ba" alt="Capture d’écran de la cinquième sous-étape dans Pega, configurée avec la méthode Apply-DataTransform, le data transform JsonToInvoiceFields, l’option PassParameterPage activée et l’étiquette OK." width="794" height="198" data-path="images/flexi-capture/connectors/Pega45.png" />
  </Frame>

* Pour la sixième sous-étape, sélectionnez *Property-Set* dans le champ **Method**, créez un paramètre *Local.Index* pour cette méthode et définissez ce paramètre sur *Local.Index+ 1*. Marquez cette sous-étape comme *INC*.

<Frame>
  <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega46.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=2bae6c75024b5b9f9e80c297992e684b" alt="Capture d’écran de la sixième sous-étape dans Pega, configurée avec la méthode Property-Set, un paramètre Local.Index défini sur Local.Index+ 1 et libellée INC." width="785" height="197" data-path="images/flexi-capture/connectors/Pega46.png" />
</Frame>

À ce stade, votre liste d’étapes et de sous-étapes devrait se présenter comme suit :

<Frame>
  <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega47.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=9547fe2851d7b36676a451d705461027" alt="Capture d’écran de l’onglet Steps dans Pega montrant l’activité CaptureData complète : quatre étapes principales (Obj-Open-By-Handle, Call RemoveFromPageList, Property-Set, Property-Set) avec six sous-étapes sous l’étape 4, libellées ERR, OK et INC." width="1113" height="443" data-path="images/flexi-capture/connectors/Pega47.png" />
</Frame>

8. Cliquez sur **Save**.

9. Ouvrez les propriétés de l’élément **Utility**, sélectionnez *CaptureData* dans le champ **Rule**, puis définissez le paramètre **CaseId** sur *.pzInsKey.*

   <Frame>
     <img src="https://mintcdn.com/abbyy/Xgx3EG8BZs5YQjIJ/images/flexi-capture/connectors/Pega41.png?fit=max&auto=format&n=Xgx3EG8BZs5YQjIJ&q=85&s=dbfd50f514831ecb8c7949d5b6581b85" alt="Capture d’écran des propriétés de l’élément Utility dans Pega, avec CaptureData sélectionné dans le champ Rule et le paramètre CaseId défini sur .pzInsKey." width="584" height="509" data-path="images/flexi-capture/connectors/Pega41.png" />
   </Frame>

10. Enregistrez vos modifications.
