Skip to main content
Die Service-REST-Methode empfängt die exportierten Dateien in einem Pega-Case. Die Einrichtung besteht aus drei Teilen: einem Service-Paket, einer Zugriffsrolle und dem Service selbst.

​
Ein Servicepaket erstellen

1

Ein neues Servicepaket anlegen

Klicken Sie links auf den Tab Records, klappen Sie Integration Resources auf, klicken Sie mit der rechten Maustaste auf Service Package und wählen Sie im Kontextmenü den Befehl Erstellen.
2

Das Paket benennen

Geben Sie im Formular Create Service Package im Feld Service Package Name den Wert customapi ein. Tragen Sie im Feld Short description eine Beschreibung für das Paket ein und klicken Sie anschließend auf Erstellen und öffnen.
3

Die Zugriffsgruppe angeben

Geben Sie im Formular Edit Service Package im Feld Service access group eine Zugriffsgruppe an. Das Format der Gruppe lautet <Application_name>:<Access group>.Um die Liste der verfügbaren Zugriffsgruppen anzuzeigen, klicken Sie links auf den Tab Records und navigieren Sie zu Security → Access Group.
4

Das Paket speichern

Klicken Sie auf Save.

​
Hinzufügen der Web-API-Rolle zur Zugriffsgruppe

Durch das Hinzufügen dieser Rolle können Benutzer auf die Web-API zugreifen.
1

Zugriffsgruppe öffnen

Klicken Sie auf Records → Security → Access Group → ABBYYFC:Administrators/ABBYYFC:Users.
2

Rolle hinzufügen

Fügen Sie im Feld Available roles die Rolle PegaRULES:PegaAPI hinzu.

​
Service erstellen

1

Neuen Service REST anlegen

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 Erstellen.
2

Details des Service angeben

Geben Sie im geöffneten Formular die folgenden Werte an und klicken Sie anschließend auf Create and open.
3

URL-Pfadparameter zuordnen

Klicken Sie auf die Registerkarte Service und geben Sie im Feld Pega class den Wert Pega-API-CaseManagement ein.Geben Sie im Abschnitt URL path parameters in der Spalte Map to Key für den Parameter Id den Wert Param.CaseId ein und für den Parameter name den Wert Param.FileName.
4

POST-Anfrage konfigurieren

Klicken Sie auf die Registerkarte Methods. Erweitern Sie die POST-Methode und geben Sie auf der Registerkarte Request die folgenden Werte für die Felder unter Nachrichtendaten an:
5

Antwortbedingungen erstellen

Klicken Sie auf die Registerkarte Response und erstellen Sie die drei Bedingungen, die unter Antwortbedingungen beschrieben sind.

​
Antwortbedingungen

Erstellen Sie auf der Registerkarte Response die folgenden drei Bedingungen.

​
pxIsInternalError

Parameterwerte:
  • Bedingung: When
  • When-Name: pxIsInternalError
  • Content-Type: application/json
  • Statuscode: Param.StatusCode
Diese Bedingung legt keine Header-Felder und keine Nachrichtendaten fest.

​
pxIsErrorResponse

Parameterwerte:
  • Bedingung: When
  • When-Name: pxIsErrorResponse
  • Content-Type: application/json
  • Statuscode: Param.StatusCode
Nachrichtendaten:
  • Beschreibung: Response
  • Map from: Clipboard
  • Map from key: Param.Response
Diese Bedingung legt keine Header-Felder fest.

​
Erfolgsantwort

Parameterwerte:
  • Bedingung: Default
  • Content-Type: application/json
  • Statuscode: Param.StatusCode
Header-Felder:
  • Name location, mit Map from auf Clipboard und Map from key auf Param.Location gesetzt
  • Name etag, mit Map from auf Clipboard und Map from key auf Param.eTag gesetzt
Nachrichtendaten:
  • Beschreibung: Response
  • Map from: Clipboard
  • Map from key: Param.Response

​
URL der Service-Methode

Die URL der Service-Methode muss exakt wie folgt lauten:
Andernfalls gibt der Connector einen Fehler zurück, wenn der Benutzer versucht, eine Datei nach Pega zu exportieren.