Vorschau

Erstellen von Aktionsdefinitionen

Um die Aktionseingabefelder an die Apps-Felder zu binden, benötigen Sie eine Aktionsdefinition.

1. Vorbereiten der Aktionsdefinition

Bevor Sie die Aktionsdefinition zum Action Center hinzufügen, müssen Sie ein JSON-Schema dafür erstellen. Die Datei muss dem JSON-Schemastandard entsprechen. Sie können auch das Beispielschema herunterladen, bearbeiten und eine geänderte Version davon hochladen.

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": "Sample Definition",
       "Description": "Sample Definition Description"

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 Genehmigen oder Ablehnen entsprechen.

   "AllowedActions": [
           "Start On-boarding",
           "Request more details"
       ],

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": {
               "employee_id": {
                   "type": "string",
                   "description": "The unique identifier of the employee."
               },
               "first_name": {
                   "type": "string",
                   "description": "The first name of the employee."
               },
               "last_name": {
                   "type": "string",
                   "description": "The last name of the employee."
               },
               "email": {
                   "type": "string",
                   "format": "email",
                   "description": "The email address of the employee."
               },
               "address": {
                   "type": "object",
                   "properties": {
                       "street": {
                           "type": "string",
                           "description": "The street address of the employee."
                       },
                       "city": {
                           "type": "string",
                           "description": "The city where the employee resides."
                       },
                       "state": {
                           "type": "string",
                           "description": "The state where the employee resides."
                       },
                       "zip_code": {
                           "type": "string",
                           "description": "The zip code of the employee's address."
                       },
                       "country": {
                           "type": "string",
                           "description": "The country where the employee resides."
                       }
                   },
                   "required": [
                       "street",
                       "city",
                       "state",
                       "zip_code",
                       "country"
                   ],
                   "description": "The address of the employee."
               },
               "hire_date": {
                   "type": "string",
                   "format": "date",
                   "description": "The date the employee was hired in the format YYYY-MM-DD."
               },
               "salary": {
                   "type": "number",
                   "minimum": 0,
                   "description": "The salary of the employee."
               }
           }

   Wenn Sie verschachtelte Objekte wie address gemäß diesem Beispiel haben, definieren Sie sie in ähnlicher Weise innerhalb des properties -Objekts und geben Sie ihren Typ und ihre Eigenschaften an.
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.

   "required": [
               "employee_id",
               "first_name",
               "last_name",
               "email",
               "address",
               "salary",
               "hire_date"
           ]

7. Schließen Sie das JSON-Objekt, indem Sie eine schließende geschweifte Klammer hinzufügen.

2. Hochladen der Aktionsdefinition in das Action Center

Nachdem Sie das JSON-Schema der Aktionsdefinition erstellt haben, können Sie es im Action Center hochladen.

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.

Ergebnis: Jetzt können Sie die Aktionsdefinition als Steuerelement zu Ihrer Aktions-App in App Studio hinzufügen.