View a markdown version of this page

Automatisierungsparameter - AWS App Studio
Vorteile von AutomatisierungsparameternSzenarien und AnwendungsfälleDefinieren von AutomatisierungsparametertypenKonfiguration dynamischer Werte, die an Automatisierungsparameter übergeben werdenGeben Sie Sicherheit einValidierungBewährte Methoden für Automatisierungsparameter

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Automatisierungsparameter

Automatisierungsparameter sind eine leistungsstarke Funktion in App Studio, mit der flexible und wiederverwendbare Automatisierungen erstellt werden können, indem dynamische Werte aus verschiedenen Quellen wie der Benutzeroberfläche, anderen Automatisierungen oder Datenaktionen übergeben werden. Sie dienen als Platzhalter, die bei der Ausführung der Automatisierung durch tatsächliche Werte ersetzt werden, sodass Sie dieselbe Automatisierung jedes Mal mit unterschiedlichen Eingaben verwenden können.

Innerhalb einer Automatisierung haben Parameter eindeutige Namen, und Sie können auf den Wert eines Parameters verweisen, indem Sie die Variable params gefolgt vom Namen des Parameters verwenden, zum Beispiel. {{params.customerId}}

Dieser Artikel bietet ein tiefes Verständnis der Automatisierungsparameter, einschließlich ihrer grundlegenden Konzepte, Verwendung und bewährten Methoden.

Vorteile von Automatisierungsparametern

Automatisierungsparameter bieten mehrere Vorteile, darunter die folgende Liste:

  1. Wiederverwendbarkeit: Mithilfe von Parametern können Sie wiederverwendbare Automatisierungen erstellen, die mit unterschiedlichen Eingabewerten angepasst werden können, sodass Sie dieselbe Automatisierungslogik mit unterschiedlichen Eingaben wiederverwenden können.

  2. Flexibilität: Anstatt Werte in einer Automatisierung fest zu codieren, können Sie Parameter definieren und bei Bedarf unterschiedliche Werte angeben, wodurch Ihre Automatisierungen dynamischer und anpassungsfähiger werden.

  3. Trennung von Belangen: Parameter helfen dabei, die Automatisierungslogik von den verwendeten spezifischen Werten zu trennen, was die Organisation und Wartbarkeit des Codes fördert.

  4. Validierung: Jeder Parameter hat einen Datentyp, z. B. eine Zeichenfolge, eine Zahl oder einen booleschen Wert, der zur Laufzeit validiert wird. Dadurch wird sichergestellt, dass Anfragen mit falschen Datentypen abgelehnt werden, ohne dass ein benutzerdefinierter Validierungscode erforderlich ist.

  5. Optionale und erforderliche Parameter: Sie können Automatisierungsparameter als optional oder erforderlich festlegen. Erforderliche Parameter müssen bei der Ausführung der Automatisierung angegeben werden, während optionale Parameter Standardwerte haben oder weggelassen werden können. Diese Flexibilität ermöglicht es Ihnen, vielseitigere Automatisierungen zu erstellen, die auf der Grundlage der bereitgestellten Parameter unterschiedliche Szenarien bewältigen können.

Szenarien und Anwendungsfälle

Szenario: Produktdetails abrufen

Stellen Sie sich vor, Sie haben eine Automatisierung, die Produktdetails auf der Grundlage einer Produkt-ID aus einer Datenbank abruft. Diese Automatisierung könnte einen Parameter namens productId haben.

Der productId Parameter fungiert als Platzhalter, den Sie beim Ausführen der Automatisierung mit dem tatsächlichen Produkt-ID-Wert ausfüllen können. Anstatt eine bestimmte Produkt-ID fest in die Automatisierung einzufügen, können Sie den productId Parameter definieren und bei jeder Ausführung der Automatisierung unterschiedliche Produkt-ID-Werte übergeben.

Sie könnten diese Automatisierung von der Datenquelle einer Komponente aus aufrufen und dabei die ID des ausgewählten Produkts als productId Parameter unter Verwendung der Syntax mit doppelten geschweiften Klammern übergeben:. {{ui.productsTable.selectedRow.id}} Auf diese Weise ruft die Automatisierung, wenn ein Benutzer ein Produkt aus einer Tabelle (ui.productsTable) auswählt, die Details für das ausgewählte Produkt ab, indem sie die ID der ausgewählten Zeile als productId Parameter übergibt.

Alternativ könnten Sie diese Automatisierung von einer anderen Automatisierung aus aufrufen, die eine Liste von Produkten durchläuft und die Details für jedes Produkt abruft, indem Sie die ID des Produkts als Parameter übergeben. productId In diesem Szenario würde der productId Parameterwert in jeder Iteration der {{product.id}} Schleife dynamisch aus dem Ausdruck bereitgestellt.

Mithilfe des productId Parameters und der Syntax mit doppelten geschweiften Klammern können Sie diese Automatisierung flexibler und wiederverwendbarer gestalten. Anstatt separate Automatisierungen für jedes Produkt zu erstellen, können Sie eine einzige Automatisierung verwenden, die Details für jedes Produkt abrufen kann, indem Sie einfach die entsprechende Produkt-ID als Parameterwert aus verschiedenen Quellen angeben, z. B. aus UI-Komponenten oder anderen Automatisierungen.

Szenario: Umgang mit optionalen Parametern mit Fallback-Werten

Stellen wir uns ein Szenario vor, in dem Sie eine „Task“ -Entität mit einer erforderlichen Spalte „Besitzer“ haben, aber Sie möchten, dass dieses Feld in der Automatisierung optional ist und Sie einen Fallback-Wert angeben möchten, wenn der Eigentümer nicht ausgewählt wird.

  1. Erstellen Sie eine Automatisierung mit einem ParameterOwner, der dem Owner Feld der Task Entität zugeordnet ist.

  2. Da das Owner Feld in der Entität erforderlich ist, wird der Owner Parameter mit der erforderlichen Einstellung synchronisiert.

  3. Um den Owner Parameter in der Automatisierung optional zu machen, schalten Sie die required Einstellung für diesen Parameter aus.

  4. In Ihrer Automatisierungslogik können Sie einen Ausdruck wie {{params.Owner || currentUser.userId}} verwenden. Dieser Ausdruck prüft, ob der Owner Parameter bereitgestellt wird. Wenn er nicht angegeben wird, wird auf die ID des aktuellen Benutzers als Eigentümer zurückgegriffen.

  5. Auf diese Weise weist die Automatisierung automatisch den aktuellen Benutzer als Eigentümer für die Aufgabe zu, wenn der Benutzer in einem Formular oder einer Komponente keinen Eigentümer auswählt.

Indem Sie die required Einstellung für den Owner Parameter umschalten und einen Fallback-Ausdruck verwenden, können Sie ihn von der Anforderung an das Entitätsfeld entkoppeln, ihn in der Automatisierung optional machen und einen Standardwert angeben, wenn der Parameter nicht bereitgestellt wird.

Definieren von Automatisierungsparametertypen

Indem Sie Parametertypen verwenden, um Datentypen zu spezifizieren und Anforderungen festzulegen, können Sie die Eingaben für Ihre Automatisierungen steuern. Auf diese Weise können Sie sicherstellen, dass Ihre Automatisierungen zuverlässig mit den erwarteten Eingaben ausgeführt werden.

Synchronisieren von Typen aus einer Entität

Die dynamische Synchronisation von Parametertypen und Anforderungen aus Entitätsfelddefinitionen optimiert die Erstellung von Automatisierungen, die mit Entitätsdaten interagieren, und stellt sicher, dass der Parameter immer den neuesten Entitätsfeldtyp und die neuesten Anforderungen widerspiegelt.

Das folgende Verfahren beschreibt allgemeine Schritte zum Synchronisieren von Parametertypen aus einer Entität:

  1. Erstellen Sie eine Entität mit typisierten Feldern (z. B. Boolean, Number usw.) und markieren Sie die Felder nach Bedarf.

  2. Erstellen Sie eine neue Automatisierung.

  3. Fügen Sie der Automatisierung Parameter hinzu, und wählen Sie bei der Auswahl des Typs das Entitätsfeld aus, mit dem Sie synchronisieren möchten. Der Datentyp und die erforderliche Einstellung werden automatisch aus dem zugewiesenen Entitätsfeld synchronisiert

  4. Bei Bedarf können Sie die Einstellung „erforderlich“ überschreiben, indem Sie sie on/off für jeden Parameter umschalten. Das bedeutet, dass der erforderliche Status nicht mit dem Entitätsfeld synchronisiert wird, ansonsten aber synchronisiert bleibt.

Manuelles Definieren von Typen

Sie können Parametertypen auch manuell definieren, ohne sie von einer Entität aus zu synchronisieren

Durch die Definition benutzerdefinierter Parametertypen können Sie Automatisierungen erstellen, die bestimmte Eingabetypen akzeptieren und optionale oder erforderliche Parameter nach Bedarf verarbeiten, ohne sich auf Entitätsfeldzuordnungen verlassen zu müssen.

  1. Erstellen Sie eine Entität mit typisierten Feldern (z. B. Boolean, Number usw.) und markieren Sie Felder nach Bedarf.

  2. Erstellen Sie eine neue Automatisierung.

  3. Fügen Sie der Automatisierung Parameter hinzu, und wählen Sie bei der Auswahl des Typs den gewünschten Typ aus.

Konfiguration dynamischer Werte, die an Automatisierungsparameter übergeben werden

Sobald Sie Parameter für eine Automatisierung definiert haben, können Sie ihnen beim Aufrufen der Automatisierung Werte übergeben. Sie können Parameterwerte auf zwei Arten übergeben:

  1. Komponenten-Trigger: Wenn Sie die Automatisierung von einem Komponententrigger aus aufrufen, z. B. durch Klicken auf eine Schaltfläche, können Sie JavaScript Ausdrücke verwenden, um Werte aus dem Komponentenkontext zu übergeben. Wenn Sie beispielsweise ein Texteingabefeld benannt habenemailInput, können Sie dessen Wert mit dem folgenden Ausdruck an den E-Mail-Parameter übergeben:ui.emailInput.value.

  2. Andere Automatisierungen: Wenn Sie die Automatisierung von einer anderen Automatisierung aus aufrufen, können Sie JavaScript Ausdrücke verwenden, um Werte aus dem Automatisierungskontext zu übergeben. Sie können beispielsweise den Wert eines anderen Parameters oder das Ergebnis eines vorherigen Aktionsschritts übergeben.

Geben Sie Sicherheit ein

Indem Sie Parameter mit bestimmten Datentypen wie String, Number oder Boolean definieren, können Sie sicherstellen, dass die an Ihre Automatisierung übergebenen Werte vom erwarteten Typ sind.

Anmerkung

In App Studio handelt es sich bei Datum (en) um ISO-Zeichenfolgendaten, und diese werden ebenfalls validiert.

Diese Typsicherheit hilft dabei, Typinkongruenzen zu vermeiden, die zu Fehlern oder unerwartetem Verhalten in Ihrer Automatisierungslogik führen können. Wenn Sie beispielsweise einen Parameter als a definierenNumber, können Sie sicher sein, dass jeder an diesen Parameter übergebene Wert eine Zahl ist, und Sie müssen innerhalb Ihrer Automatisierung keine zusätzlichen Typprüfungen oder Konvertierungen durchführen.

Validierung

Sie können Ihren Parametern Validierungsregeln hinzufügen, um sicherzustellen, dass die an Ihre Automatisierung übergebenen Werte bestimmte Kriterien erfüllen.

App Studio bietet zwar keine integrierten Validierungseinstellungen für Parameter, aber Sie können benutzerdefinierte Validierungen implementieren, indem Sie Ihrer Automatisierung eine JavaScript Aktion hinzufügen, die einen Fehler auslöst, wenn bestimmte Einschränkungen verletzt werden.

Für Entitätsfelder wird eine Teilmenge von Validierungsregeln, z. B. minimum/maximum Werte, unterstützt. Diese werden jedoch nicht auf Automatisierungsebene validiert, sondern nur auf der Datenebene, wenn Create/Update/Delete Datensatzaktionen ausgeführt werden.

Bewährte Methoden für Automatisierungsparameter

Um sicherzustellen, dass Ihre Automatisierungsparameter gut konzipiert, wartbar und benutzerfreundlich sind, folgen Sie diesen bewährten Methoden:

  1. Verwenden Sie beschreibende Parameternamen: Wählen Sie Parameternamen, die den Zweck oder Kontext des Parameters klar beschreiben.

  2. Geben Sie Parameterbeschreibungen an: Nutzen Sie das Feld Beschreibung, wenn Sie Parameter definieren, um deren Zweck, Einschränkungen und Erwartungen zu erläutern. Diese Beschreibungen werden in den JSDoc-Kommentaren angezeigt, wenn auf den Parameter verwiesen wird, sowie in allen Benutzeroberflächen, auf denen Benutzer beim Aufrufen der Automatisierung Werte für die Parameter angeben müssen.

  3. Verwenden Sie geeignete Datentypen: Berücksichtigen Sie den Datentyp jedes Parameters sorgfältig auf der Grundlage der erwarteten Eingabewerte, z. B.: Zeichenfolge, Zahl, Boolean, Object.

  4. Parameterwerte validieren: Implementieren Sie in Ihrer Automatisierung entsprechende Validierungsprüfungen, um sicherzustellen, dass die Parameterwerte bestimmte Anforderungen erfüllen, bevor Sie mit weiteren Aktionen fortfahren.

  5. Verwenden Sie Fallback- oder Standardwerte: App Studio unterstützt derzeit zwar nicht das Festlegen von Standardwerten für Parameter, Sie können jedoch Ausweichwerte oder Standardwerte implementieren, wenn Sie die Parameter in Ihrer Automatisierungslogik verwenden. Sie können beispielsweise einen Ausdruck wie verwenden, {{ params.param1 || "default value" }} um einen Standardwert bereitzustellen, wenn der param1 Parameter nicht bereitgestellt wird oder einen falschen Wert hat.

  6. Halten Sie die Parameterkonsistenz aufrecht: Wenn Sie mehrere Automatisierungen haben, für die ähnliche Parameter erforderlich sind, versuchen Sie, die Einheitlichkeit der Parameternamen und Datentypen in diesen Automatisierungen aufrechtzuerhalten.

  7. Verwendung von Dokumentparametern: Sorgen Sie für eine klare Dokumentation für Ihre Automatisierungen, einschließlich Beschreibungen der einzelnen Parameter, ihres Zwecks, erwarteter Werte und aller relevanten Beispiele oder Randfälle.

  8. Regelmäßige Überprüfung und Refaktorierung: Überprüfen Sie Ihre Automatisierungen und ihre Parameter regelmäßig. Refaktorieren oder konsolidieren Sie die Parameter nach Bedarf, um die Übersichtlichkeit, Wartbarkeit und Wiederverwendbarkeit zu verbessern.

  9. Begrenzen Sie die Anzahl der Parameter: Parameter bieten zwar Flexibilität, aber zu viele Parameter können eine Automatisierung komplex und schwierig zu verwenden machen. Versuchen Sie, ein Gleichgewicht zwischen Flexibilität und Einfachheit zu finden, indem Sie die Anzahl der Parameter auf das Notwendige beschränken.

  10. Erwägen Sie die Gruppierung von Parametern: Wenn Sie mehrere verwandte Parameter definieren, sollten Sie erwägen, sie zu einem einzigen Object Parameter zu gruppieren.

  11. Separate Bedenken: Vermeiden Sie es, einen einzelnen Parameter für mehrere Zwecke zu verwenden oder Werte, die nichts miteinander zu tun haben, zu einem einzigen Parameter zu kombinieren. Jeder Parameter sollte ein bestimmtes Anliegen oder ein bestimmtes Datenelement repräsentieren.

  12. Verwenden Sie Parameter-Aliase: Wenn Sie Parameter mit langen oder komplexen Namen haben, sollten Sie zur besseren Lesbarkeit und Wartbarkeit die Verwendung von Aliasen oder Kurzversionen in der Automatisierungslogik in Betracht ziehen.

Indem Sie diese bewährten Methoden befolgen, können Sie sicherstellen, dass Ihre Automatisierungsparameter gut konzipiert, wartbar und einfach zu verwenden sind, was letztendlich die Gesamtqualität und Effizienz Ihrer Automatisierungen verbessert.