Zum Hauptinhalt springen
So erstellen Sie eine neue Aktivität:
  1. Geben Sie in der POST-Anforderung des Service im Feld Activity name einen Namen für Ihre neue Aktivität ein (z. B. UploadFileToCase).
  2. Klicken Sie auf Create and open, um die neue Aktivität zu konfigurieren.
  3. Fügen Sie auf der Registerkarte Security die folgenden Klassen hinzu, auf die von der Methode und der Aktivität zugegriffen wird: Pega-API-CaseManagement und Work-.
  4. Deklarieren Sie auf der Registerkarte Pages & Classes die Klassen, die von der Aktivität verwendet werden:
    • AttachmentPage vom Typ Data-WorkAttach-File
    • pyWorkPage vom Typ Work-
In Pega entspricht eine Seite einem Klassenobjekt.
  1. Fügen Sie auf der Registerkarte Parameters die Parameter hinzu, die von der Aktivität verwendet werden.
    • Parameter:
      • FileStream vom Typ String – Dieser Parameter enthält den Inhalt der Datei in Base64.
    • Lokale Variablen:
      • IsConverted vom Typ Boolean – Diese logische Variable enthält das Ergebnis der Ausführung der Methode, die das JSON-Objekt in der POST-Anforderung in globale Variablen von myStepPage umwandelt.
  2. Erstellen Sie auf der Registerkarte Steps neue Schritte für Methoden, die Objekte laden und den Case mit seiner Datei verknüpfen.
    • So laden Sie das JSON-Objekt aus der POST-Anforderung in die Aktivitätsparameter:
      • Geben Sie im Feld Method diesen Methodennamen ein: Property-Set
      • Geben Sie im Feld Step page .createCaseRequest ein
      • Konvertieren Sie das Ergebnis der Methode @(Pega-RULES:Page).pxConvertStringToPage(tools, myStepPage, Param.Request,“json”) in die Variable Local.IsConverted. Der Wert ist true, wenn das JSON-Objekt aus der POST-Anforderung erfolgreich in das Objekt myStepPage konvertiert wird. Andernfalls ist der Wert false.
      • Sobald das Objekt myStepPage befüllt wurde, befüllen Sie die Aktivitätsvariablen: Param.FileStream = .FileStream. Um neue Eigenschaften zu myStepPage hinzuzufügen, klicken Sie rechts auf das Zielsymbol und dann im Formular Create Property auf Create and open.
    • So rufen Sie das Objekt ab, das den Case anhand seiner ID enthält:
      • Geben Sie im Feld Method pxGetCase: Call pxGetCase ein, um die Aktivität aufzurufen.
      • Geben Sie im Feld Step page den Namen des Objekts ein, in dem das Ergebnis pyWorkPage gespeichert wird. Geben Sie im Parameter WorkObjectId Param.CaseId ein (d. h. die Case-ID).
    • So erstellen Sie ein neues leeres Objekt mit dem Namen AttachmentPage, das auf der Registerkarte Pages & Classes deklariert wurde:
      • Geben Sie im Feld Method Page-New ein.
      • Geben Sie im Feld Step page AttachmentPage ein.
      • Lassen Sie die Methodenparameter leer.
    • Für die Parameter des Objekts AttachmentPage:
      • Der Parameter .pxAttachName muss mit dem Wert aus Param.FileName befüllt werden, der Parameter .pxAttachStream muss mit dem Wert aus Param.FileStream befüllt werden, der Parameter .pxAttachKey muss mit dem Wert aus @getCurrentTimeStampUnique() befüllt werden, und der Parameter .pxRefObjectKey muss mit dem Wert aus pyWorkPage.pzInsKey befüllt werden.
      • Geben Sie im Feld Method Property-Set ein.
      • Geben Sie im Feld Step page AttachmentPage ein.
    • Verwenden Sie die Methode Odj-Save, um das Objekt AttachmenetPage zu speichern.
    • Verwenden Sie die Methode Link-Objects, um das Objekt pyWorkPage (d. h. den Case, den wir mit pxGetCase: Call pxGetCase abgerufen haben) mit dem Objekt AttachmentPage zu verknüpfen. Geben Sie im Parameter LinkToPage AttachmentPage ein; im Parameter LinkClass Link-Attachment; und im Parameter LinkMemo Param.FileName.
    • Verwenden Sie die Methode Commit, um die Änderungen in die Datenbank zu übernehmen.
    • Falls erforderlich, schreiben Sie in Param.Response das Objekt pyWorkPage – @(Pega-RULES:Page).pxConvertPageToString(tools, pyWorkPage, “json”), das in der Antwort des Service empfangen wurde.