PREVIEW

Arbeiten mit App-Aufgaben

Dieses Tutorial führt Sie durch den Prozess der Erstellung einer App-Aufgabe, der die folgenden Phasen umfasst:

• Erstellen einer Aktionsdefinition und Hochladen im Action Center.
• Entwickeln einer Aktions-App innerhalb von Apps und Einrichten von Feldern für jede in der Aktionsdefinition definierte Eigenschaft.
• Veröffentlichen der App und Erstellen eines Workflows in Studio Web oder Studio Desktop mithilfe der Aktivität App-Aufgabe erstellen ( Create App Task ).

1. Erstellen und laden Sie die Aktionsdefinition hoch

Um Aktionsfelder mit einer App zu verknüpfen, müssen Sie ein JSON-Schema erstellen, das als Aktionsdefinition bezeichnet wird. Diese Definition umschreibt die erforderlichen Aktionsfelder und gibt die zulässigen Aktionen an, die beim Abschließen der Aktion verfügbar sind.

1. Bereiten Sie die Aktionsdefinition vor:
   1. Fügen Sie zunächst eine offene geschweifte Klammer hinzu, um den Anfang des JSON-Objekts anzugeben.
   2. Definieren Sie im JSON-Objekt die Eigenschaften Name und Description zusammen mit ihren Werten als Strings.

      "Name": "Validate Document",
          "Description": "Validate and approve invoice",

   3. Fügen Sie eine Allowed Actions -Eigenschaft als Array von Strings hinzu, um die zulässigen Aktionen anzugeben, die Sie am Ende der Aktion ausführen können. Die Werte müssen Abschließen oder Ablehnen entsprechen.

      "AllowedActions": [
              "Yes",
              "No"
          ],

   4. Fügen Sie eine Schema -Eigenschaft hinzu und weisen Sie sie einem Objekt zu, das dem JSON-Schemastandard entspricht: http://json-schema.org/draft-07/schema#.

      "Schema": {
              "$schema": "http://json-schema.org/draft-07/schema#",
              "type": "object",

   5. Definieren Sie im properties -Objekt jede Eigenschaft, die Sie in das Schema aufnehmen möchten. Geben Sie für jede Eigenschaft type und description an.
      Jede Eigenschaft in Schema entspricht den Eingabefeldern, die Sie in der App-Aktion hinzufügen.

      "properties": {
                  "Description": {
                      "type": "string",
                      "direction": "in",
                      "description": "Validation message"
                  },
                  "invoice_document": {
                      "type": "string",
                      "direction": "in",
                      "description": "Document file."
                  },
                  "Comments": {
                      "type": "string",
                      "direction": "inout",
                      "description": "Approval or rejection comments"
                  }
              }

      Hinweis: Wenn die Eigenschaft direction nicht definiert ist, ist der Standardwert dafür inout (In/Out).
   6. Wenn bestimmte Eigenschaften erforderlich sind, fügen Sie ein required -Array ein, in dem Sie die Eigenschaften auflisten, die Sie in der Aktion als erforderlich markieren möchten.
   7. Schließen Sie das JSON-Objekt, indem Sie eine schließende geschweifte Klammer hinzufügen.
2. Laden Sie die Aktionsdefinition in das Action Center hoch:
   1. Öffnen Sie Action Center, navigieren Sie zu Administratoreinstellungen und wählen Sie Mandant aus.
   2. Wählen Sie auf der Registerkarte Aktionsdefinitionen die Option Aktionsdefinition hinzufügen aus.
   3. Wählen Sie Aktionsdefinitionsbeispiel herunterladen aus, um ein JSON-Beispielschema herunterzuladen, das Ihnen bei der Vorbereitung der Aktionsdefinition hilft.
   4. Wählen Sie Aus Datei importieren aus, und wählen Sie die JSON-Datei aus, die Sie zuvor vorbereitet haben.
   5. Geben Sie einen geeigneten Namen und eine Beschreibung für die Aktionsdefinition ein und wählen Sie dann Erstellen aus.

2. Erstellen Sie die Aktions-App

Apps, die mit einer Integration für Aktionen erstellt wurden, sind für die Verwendung in Workflows mit langer Ausführungszeit konzipiert. Endbenutzer können auf diese Apps nur durch Interaktion mit den generierten Aktionen zugreifen.

1. Öffnen Sie Apps innerhalb der Organisation, in der Sie die Aktionsdefinitionen hochgeladen haben.
2. Erstellen Sie eine neue App von Grund auf, oder wählen Sie eine vorgefertigte Vorlage aus, die Ihren Anforderungen entspricht.
3. Wählen Sie neben Steuerelement hinzufügen die Option Hinzufügen aus und dann Aktion aus.
   Mit diesem Schritt können Sie die Aktionsdefinition für diese App angeben. In diesem Beispiel verwenden wir die Aktionsdefinition Validate Document .
4. Wählen Sie den Mandanten aus, in den Sie zuvor die Aktionsdefinition hochgeladen haben, und wählen Sie Weiter aus.
5. Wählen Sie auf der linken Seite des Dialogfelds Aktion hinzufügen die Aktionsdefinition aus, die Sie erstellt haben, und klicken Sie auf Hinzufügen.
   
   

   

   
   

   Weitere Informationen zur Verwendung von Aktionsdefinitionen mit Ihren Aktions-Apps finden Sie unter Referenzieren einer Aktionsdefinition in Ihrer App .

6. Jetzt können Sie Steuerelemente zu Ihrer App hinzufügen.
   Stellen Sie sicher, dass die Namen der App-Steuerelemente genau mit den Namen übereinstimmen, die im JSON-Schema der Aktionsdefinition verwendet werden. Wenn Sie beispielsweise ein Dokumentanzeige-Steuerelement einschließen, um die Eigenschaft invoice_document aus der Aktionsdefinition anzuzeigen, benennen Sie das Steuerelement invoice_document.
   Die Eingabe- oder Ausgabeparameter einer Aktion können an ein beliebiges App-Steuerelement gebunden werden, indem die folgende Syntax verwendet wird: Actions.<referenced_action_name>.<action_parameter_name>
   1. Erstellen Sie eine leere Seite, und fügen Sie ein Layout hinzu.
   2. Fügen Sie im Layout einen Container hinzu, in dem Sie Textfelder und Bildsteuerelemente hinzufügen können, um den Kundennamen und das Logo des Unternehmens anzuzeigen, das das Dokument validiert.
   3. Fügen Sie im Layout einen Container hinzu, in dem Sie das Steuerelement Dokumentanzeige platzieren.
   4. Erstellen Sie eine Variable mit dem Namen var_invoice_file und fügen Sie sie als Quelle des Dokumentanzeige -Steuerelements hinzu.
   5. Fügen Sie einen weiteren Container innerhalb des Layouts hinzu, in dem Sie links einen Textbereich hinzufügen können. Als Standardtexttyp im folgenden Ausdruck: Actions.Validate_Document.Comments.
   6. Fügen Sie zwei Schaltflächensteuerelemente hinzu, die für den Abschluss der Aktion verantwortlich sind, und konfigurieren Sie eine Regel zum Übermitteln der Aktion, die dem in der Aktionsdefinition angegebenen Allowed Actions entspricht:
      1. Gehen Sie zu Ereignisse und wählen Sie Regel erstellen aus.
      2. Wählen Sie im Dropdownlistenmenü die Option Einreichungsaktion aus.
      3. Wählen Sie unter Aktionsergebnis die zulässige Aktion aus, die die Schaltfläche beim Klicken auslösen soll: Yes oder No.

      Rufen Sie Regel: Aktion einreichen auf, um mehr über diese spezielle Regel zu erfahren.

7. Richten Sie eine Verknüpfung zu einem Speicher-Bucket ein, in den Sie das Dokument hochladen, bevor Sie es als Teil der Aktion weiterleiten.
8. Veröffentlichen Sie die App, damit sie in Ihren Studio-Workflows verwendet werden kann.

   Weitere Informationen zum Veröffentlichen einer Aktions-App finden Sie unter Veröffentlichen einer Aktions-App.

Hinweis: Wenn Sie die Aktion, die Sie für Ihre App verwenden, ersetzen möchten, finden Sie weitere Informationen unter Ersetzen einer Aktion.

3. Erstellen Sie eine App-Aufgabe innerhalb eines Workflows

Erstellen Sie einen Workflow in Studio Web oder Studio Desktop, um ein Rechnungsdokument von einem Google Drive-Konto herunterzuladen. Laden Sie das heruntergeladene Dokument in den Speicher-Bucket hoch, der an Ihre Aktions-App gebunden ist. Fügen Sie als Nächstes eine Benutzeraktion/App-Aktion- Aktivität hinzu, um das spezifische Dokument für die Genehmigung oder Ablehnung durch den Benutzer anzuzeigen. Weisen Sie die Aufgabe einem Benutzer zu, warten Sie auf den Abschluss der Aktion, und setzen Sie den Workflow fort. Protokollieren Sie eine Meldung, in der die Validierungsentscheidung des Benutzers für das Dokument beschrieben wird.

1. Erstellen Sie ein neues Projekt in Studio.
2. Fügen Sie eine Aktivität Download File hinzu.
   1. Stellen Sie eine Verbindung mit Google Drive innerhalb der Aktivität her.
   2. Geben Sie im Feld Herunterzuladende Datei den Namen der Datei an, die Sie herunterladen möchten.
   3. Erstellen Sie im Abschnitt Ausgabe eine Variable, um die heruntergeladene Datei zu speichern.
      Benennen Sie die Variable in diesem Beispiel downloadFile.
3. Fügen Sie eine Aktivität Upload Storage File hinzu, um die Datei in den Speicher-Bucket hochzuladen, der Ihrer Aktions-App zugeordnet ist.
   1. Wählen Sie unter Orchestrator-Ordnerpfad und Speicher-Bucket-Name den Orchestrator-Ordnerpfad und den Speicher-Bucket aus, in den Sie die Datei hochladen möchten.
   2. Geben Sie im Feld Datei die Variable ein, in der Sie die heruntergeladene Datei gespeichert haben.
      Geben Sie in diesem Beispiel downloadFile ein.
   3. Geben Sie im Feld Uploadziel/Pfad den Ausdruck downloadFile.FullName.toString ein, um die Datei im Speicher-Bucket zu speichern.
      Tipp: Sie können diesen Ausdruck in einer Variablen speichern.
   
   

   

   
   
4. Fügen Sie eine Aktivität Create App Task hinzu, um die Aktion zu erstellen.
   1. Legen Sie den Titel und die Priorität entsprechend fest.
   2. Wählen Sie für Apps die Aktions-App aus, die zuvor im Tutorial erstellt wurde.
   3. Füllen Sie die generierten Felder mit den entsprechenden Variablen aus.
   4. Erstellen Sie im Abschnitt Ausgabe eine UserActionData -Variable, um die Daten im Zusammenhang mit der generierten Aktion zu speichern.
      Benennen Sie die Variable in diesem Beispiel als taskID.
5. Fügen Sie eine Aktivität Assign Tasks hinzu , um die Aufgabe einem Benutzer innerhalb der Organisation zuzuweisen.
   1. Geben Sie im Feld Aufgaben-ID einen Ausdruck ein, der die Aufgaben-ID aus der Ausgabevariable abruft, die in Schritt 4, Unterschritt d, erstellt wurde.
      Geben Sie in diesem Beispiel den folgenden Ausdruck ein: taskID.Id.Value.
   2. Geben Sie im Feld Benutzername oder E-Mail den Benutzernamen oder die E-Mail-Adresse des Benutzers ein, dem Sie diese Aktion zuweisen möchten.
   
   

   

   
   
6. Fügen Sie eine Wait For App Task And Resume -Aktivität hinzu, um zu warten, bis der Benutzer die Aktion abschließt, und setzen Sie dann den Workflow fort.
   1. Geben Sie im Feld Erstellte App-Aufgabe die bei Schritt 4, Unterschritt d, erstellte Ausgabevariable ein.
   2. Erstellen Sie im Feld Durchgeführte Aktion eine Variable (Beispiel: userActionTaken), um den Aktionstyp zu speichern, den der Benutzer zum Abschließen der Aufgabe ausgeführt hat.
7. Fügen Sie eine Log Message -Aktivität hinzu, um den Aktionstyp auszugeben, den der Benutzer zum Abschließen der Aufgabe ausgeführt hat. Verwenden Sie einen Ausdruck wie z. B. "The action that user used to complete the Validate Invoice action was " + userActionTaken.ToString
   
   

   

   
   

Workflow-Beispiel

Um die Schritte auszuführen und das Tutorial selbst auszuprobieren, laden Sie das Studio Desktop-Beispielprojekt hier herunter. Um es in Studio Web zu öffnen, speichern Sie das Projekt in der Cloud und suchen Sie dann in Studio Web nach dem Projekt, um es dort zu öffnen.