> ## 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’une méthode de service REST

> Créez une méthode POST du service REST Pega pour exporter des fichiers vers un dossier : créez le package de service, ajoutez le rôle PegaAPI et définissez les conditions de réponse.

Tout d’abord, vous devez créer un package de service :

1. Cliquez sur l’onglet **Records** à gauche, développez **Integration Resources**, cliquez avec le bouton droit sur **Service Package**, puis sélectionnez la commande **Create** dans le menu contextuel.

2. Dans le formulaire **Create Service Package**, saisissez *customapi* dans le champ **Service Package Name**. Saisissez une description du package dans le champ **Short description**, puis cliquez sur **Create and open**.

3. Dans le formulaire **Edit Service Package**, indiquez un groupe d’accès dans le champ **Service access group** (le format du groupe est *\<Application\_name>:\<Access group>*).
   **Remarque :** Pour afficher la liste des groupes d’accès disponibles, cliquez sur l’onglet **Records** à gauche et accédez à **Security → Access Group**.

4. Cliquez sur **Save**.

Ensuite, vous devez ajouter un nouveau rôle au groupe d’accès pour permettre aux utilisateurs d’accéder à la Web API :

1. Accédez au groupe d’accès nouvellement créé en cliquant sur **Records → Security → Access Group → ABBYYFC:Administrators/ABBYYFC:Users**.
2. Dans le champ **Available roles**, ajoutez le rôle *PegaRULES:PegaAPI*.

Vous devez maintenant créer un nouveau service :

1. Cliquez sur l’onglet **Records** à gauche, développez **Integration-Services**, cliquez avec le bouton droit sur **Service REST**, puis sélectionnez la commande **Create** dans le menu contextuel.
2. Dans le formulaire qui s’ouvre, indiquez les éléments suivants :
   * Nom du service : *files*
   * Nom du package de service : *customapi*
   * Modèle d’URI : *cases/\{id}/files/\{name}*
   * Version du service : *v2*
3. Cliquez sur **Create and open**.
4. Cliquez sur l’onglet **Service** et saisissez *Pega-API-CaseManagement* dans le champ **Pega class**. Dans la section **URL path parameters**, saisissez *Param.CaseId* dans la colonne **Map to Key** pour le paramètre **Id**. Saisissez ensuite *Param.FileName* pour le paramètre **name**.
5. Cliquez sur l’onglet **Methods**. Développez la méthode POST et, dans l’onglet **Request**, indiquez les éléments suivants pour les champs **donnée du message** :
   * Description : *Request Data*
   * Map to : *Clipboard*
   * Map to key : *Param.Request*
6. <a id="response" />Cliquez sur l’onglet **Response** et créez trois conditions de réponse :

<table width="100%">
  <thead>
    <tr>
      <th>
        <p>
          <strong>Élément à traiter</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Valeurs des paramètres</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Champs d’en-tête</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Données du message</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>pxIsInternalError</strong>
        </p>
      </td>

      <td>
        <ul>
          <li>
            Condition : <em>When</em>
          </li>

          <li>
            Nom de When : <em>pxIsInternalError</em>
          </li>

          <li>
            Type de contenu : <em>application/json</em>
          </li>

          <li>
            Code de statut : <em>Param.StatusCode</em>
          </li>
        </ul>
      </td>

      <td> </td>
      <td> </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>pxIsErrorResponse</strong>
        </p>
      </td>

      <td>
        <ul>
          <li>
            Condition : <em>When</em>
          </li>

          <li>
            Nom de When : <em>pxIsErrorResponse</em>
          </li>

          <li>
            Type de contenu : <em>application/json</em>
          </li>

          <li>
            Code de statut : <em>Param.StatusCode</em>
          </li>
        </ul>
      </td>

      <td> </td>

      <td>
        <ul>
          <li>
            Description : <em>Response</em>
          </li>

          <li>
            Mappage depuis : <em>Clipboard</em>
          </li>

          <li>
            Mappage depuis la clé : <em>Param.Response</em>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>Réponse en cas de succès</p>
      </td>

      <td>
        <ul>
          <li>
            Condition : <em>Default</em>
          </li>

          <li>
            Type de contenu : <em>application/json</em>
          </li>

          <li>
            Code de statut : <em>Param.StatusCode</em>
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            Name: <em>location</em>: Mappage depuis : <em>Clipboard</em>; Mappage depuis la clé : <em>Param.Location</em>
          </li>

          <li>
            Name: <em>etag</em>; Mappage depuis : <em>Clipboard</em>; Mappage depuis la clé : <em>Param.eTag</em>
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            Description : <em>Response</em>
          </li>

          <li>
            Mappage depuis : <em>Clipboard</em>
          </li>

          <li>
            Mappage depuis la clé : <em>Param.Response</em>
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<Warning>
  Assurez-vous que l’URL de la méthode de service est la suivante : *[https://Server\&#95;Name/prweb/PRRestService/customapi/v2/cases/\&#123;id\&#125;/files/\&#123;name\&#125](https://Server\&#95;Name/prweb/PRRestService/customapi/v2/cases/\&#123;id\&#125;/files/\&#123;name\&#125);.* Sinon, le Connector renverra
  une erreur lorsque l’utilisateur tentera d’exporter un fichier vers Pega.
</Warning>