Zum Hauptinhalt springen
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. Klicken Sie auf die Registerkarte Response und erstellen Sie drei Antwortbedingungen:

  • Bedingung: When
  • When-Name: pxIsInternalError
  • Content-Type: application/json
  • Statuscode: Param.StatusCode
  

  • Bedingung: When
  • When-Name: pxIsErrorResponse
  • Content-Type: application/json
  • Statuscode: Param.StatusCode
 
  • Description: Response
  • Zuordnen aus: Clipboard
  • Zuordnungsschlüssel: Param.Response

Erfolgsantwort

  • Bedingung: Default
  • Content-Type: application/json
  • Statuscode: Param.StatusCode
  • Name: location: Zuordnen aus: Clipboard; Zuordnungsschlüssel: Param.Location
  • Name: etag; Zuordnen aus: Clipboard; Zuordnungsschlüssel: Param.eTag
  • Description: Response
  • Zuordnen aus: Clipboard
  • Zuordnungsschlüssel: Param.Response
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;. Andernfalls gibt der Connector einen Fehler zurück, wenn der Benutzer versucht, eine Datei nach Pega zu exportieren.