> ## 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.

# Erstellen einer Service-REST-Methode

> Erstellen Sie eine Pega-Service-REST-POST-Methode zum Exportieren von Dateien in einen Case: Erstellen Sie das Service-Paket, fügen Sie die Rolle PegaAPI hinzu und definieren Sie Antwortbedingungen.

Zunächst müssen Sie ein Service-Paket erstellen:

1. Klicken Sie links auf die Registerkarte **Records**, erweitern Sie **Integration Resources**, klicken Sie mit der rechten Maustaste auf **Service Package** und wählen Sie im Kontextmenü den Befehl **Create** aus.

2. Geben Sie im Formular **Create Service Package** im Feld **Service Package Name** *customapi* ein. Tragen Sie im Feld **Short description** eine Beschreibung für das Paket ein und klicken Sie auf **Create and open**.

3. Geben Sie im Formular **Edit Service Package** im Feld **Service access group** eine Zugriffsgruppe an (das Format der Gruppe ist *\<Application\_name>:\<Access group>*).
   **Hinweis:** Um die Liste der verfügbaren Zugriffsgruppen anzuzeigen, klicken Sie links auf die Registerkarte **Records** und navigieren Sie zu **Security → Access Group**.

4. Klicken Sie auf **Save**.

Als Nächstes müssen Sie der Zugriffsgruppe eine neue Rolle hinzufügen, damit Benutzer auf die Web-API zugreifen können:

1. Öffnen Sie die neu erstellte Zugriffsgruppe, indem Sie auf **Records → Security → Access Group → ABBYYFC:Administrators/ABBYYFC:Users** klicken.
2. Fügen Sie im Feld **Available roles** die Rolle *PegaRULES:PegaAPI* hinzu.

Jetzt müssen Sie einen neuen Service erstellen:

1. Klicken Sie links auf die Registerkarte **Records**, erweitern Sie **Integration-Services**, klicken Sie mit der rechten Maustaste auf **Service REST** und wählen Sie im Kontextmenü den Befehl **Create** aus.
2. Geben Sie im sich öffnenden Formular Folgendes an:
   * Service-Name: *files*
   * Service-Paketname: *customapi*
   * URI-Vorlage: *cases/\{id}/files/\{name}*
   * Service-Version: *v2*
3. Klicken Sie auf **Create and open**.
4. Klicken Sie auf die Registerkarte **Service** und geben Sie im Feld **Pega class** *Pega-API-CaseManagement* ein. Geben Sie im Abschnitt **URL path parameters** in der Spalte **Map to Key** für den Parameter **Id** *Param.CaseId* ein. Geben Sie dann für den Parameter **name** *Param.FileName* ein.
5. Klicken Sie auf die Registerkarte **Methods**. Erweitern Sie die POST-Methode und geben Sie auf der Registerkarte **Request** für die Felder **Nachrichtendaten** Folgendes an:
   * Description: *Request Data*
   * Zuordnen zu: *Clipboard*
   * Schlüssel zuordnen: *Param.Request*
6. <a id="response" />Klicken Sie auf die Registerkarte **Response** und erstellen Sie drei Antwortbedingungen:

<table width="100%">
  <thead>
    <tr>
      <th>
        <p>
          <strong>Was verarbeiten</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Parameterwerte</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Header-Felder</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Nachrichtendaten</strong>
        </p>
      </th>
    </tr>
  </thead>

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

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

          <li>
            When-Name: <em>pxIsInternalError</em>
          </li>

          <li>
            Content-Type: <em>application/json</em>
          </li>

          <li>
            Statuscode: <em>Param.StatusCode</em>
          </li>
        </ul>
      </td>

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

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

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

          <li>
            When-Name: <em>pxIsErrorResponse</em>
          </li>

          <li>
            Content-Type: <em>application/json</em>
          </li>

          <li>
            Statuscode: <em>Param.StatusCode</em>
          </li>
        </ul>
      </td>

      <td> </td>

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

          <li>
            Zuordnen aus: <em>Clipboard</em>
          </li>

          <li>
            Zuordnungsschlüssel: <em>Param.Response</em>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>Erfolgsantwort</p>
      </td>

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

          <li>
            Content-Type: <em>application/json</em>
          </li>

          <li>
            Statuscode: <em>Param.StatusCode</em>
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            Name: <em>location</em>: Zuordnen aus: <em>Clipboard</em>; Zuordnungsschlüssel: <em>Param.Location</em>
          </li>

          <li>
            Name: <em>etag</em>; Zuordnen aus: <em>Clipboard</em>; Zuordnungsschlüssel: <em>Param.eTag</em>
          </li>
        </ul>
      </td>

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

          <li>
            Zuordnen aus: <em>Clipboard</em>
          </li>

          <li>
            Zuordnungsschlüssel: <em>Param.Response</em>
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<Warning>
  Stellen Sie sicher, dass die URL der Service-Methode wie folgt lautet: *[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);.* Andernfalls gibt der Connector einen Fehler zurück,
  wenn der Benutzer versucht, eine Datei nach Pega zu exportieren.
</Warning>