Sammlungswerte ändern
Architect enthält Funktionen, mit denen Sie die Werte von Sammlungen ändern können. Dieser Ausdruck erstellt beispielsweise eine Integer-Sammlung mit den ganzen Zahlen 3 und 4 und fügt ihr dann mit einer AddItem-Funktion die Zahl 5 hinzu:
AddItem(MakeList(3,4), 5)
Das Ergebnis dieses Ausdrucks ist eine ganzzahlige Sammlung mit drei Elementen in der folgenden Reihenfolge: 3, 4, 5.
In der folgenden Tabelle sind Funktionen aufgeführt, mit denen Sie einen Sammlungswert ändern können. Weitere Informationen finden Sie unter Hilfe zu Access Expression.
| Methode | Beschreibung |
|---|---|
| AddItem | Diese Funktion fügt Elemente zu einer Sammlung hinzu. |
| AddItemAt | Fügt bei einem bestimmten Index einen neuen Elementwert zu einer Sammlung hinzu. |
| RemoveDups | Mit dieser Funktion werden doppelte Werte aus einer Sammlung entfernt. |
| Element entfernen | Entfernt ein oder mehrere Elemente aus einer Sammlung entsprechend dem Wert. |
| Element entfernen | Entfernt ein Element aus einer Sammlung bei einem bestimmten Index. |
| ReplaceItemFirst | Ersetzt das erste Vorkommnis eines Wertes in einer Sammlung durch einen neuen Wert und gibt den resultierenden Sammlungswert zurück. |
| ErsetzenEintrag | Diese Funktion entfernt ein oder mehrere Elemente in einer Sammlung und ersetzt die Elemente durch einen neuen Wert. |
| ReplaceItemAt | Diese Funktion entfernt ein Element in einer Sammlung mit einem bestimmten Index und ersetzt es durch einen neuen Wert. |
Beispiele
Eine gängige Methode zur Änderung eines Sammlungswerts ist die Aktion Daten aktualisieren. In diesen Beispielen wird beschrieben, wie Elemente zu einer Sammlung hinzugefügt oder aus ihr entfernt werden können.
Fügt ein Element zu einer Sammlung hinzu.
In diesem Beispiel wird eine String-Auflistungsvariable namens Task.IntegerColl verwendet. Ziel ist es, die bestehende Ausgabe 3, 4, 5 um 6 zu ergänzen.
- Fügen Sie eine Aktion Daten aktualisieren zum Aufgabeneditor hinzu
- Fügen Sie eine Integer-Auflistung Aktualisierungsanweisung hinzu, die dem Variablentyp Task.myIntegerColl entspricht
- Geben Sie in das Feld Variablenname 1 Task.myIntegerCollein
- Geben Sie in das Feld Zuzuweisender Wert 1 AddItem(Task.myIntegerColl, 6)ein
Die resultierende Ausgabe ist 3, 4, 5, 6. Sie können auch ein Element an den Anfang einer Sammlung setzen. In Anlehnung an das vorherige Beispiel ergibt AddItemAt(Task.myIntegerColl, 0, 7) die Werte 7, 3, 4, 5, 6
Ein Element aus einer Sammlung entfernen
In diesem Beispiel wird eine String-Auflistungsvariable namens Task.myStringColl verwendet. Ziel ist es, alle NOT_SET-Zeichenfolgenwerte zu entfernen.
- Fügen Sie eine Aktion Daten aktualisieren zum Aufgabeneditor hinzu
- Fügen Sie eine String Collection Aktualisierungsanweisung hinzu, die dem Variablentyp Task.myStringColl entspricht
- Geben Sie in das Feld Variablenname 1 Task.myStringCollein
- Wechseln Sie im Feld Zuzuweisender Wert 1 zum Ausdruckseditor und geben Sie RemoveItem(Task.myStringColl, ToString(NOT_SET)) oder RemoveItem(Task.myStringColl, NOT_SET)ein
Beachten Sie, dass in diesen Beispielen das Ergebnis des Funktionsaufrufs in dem zuzuweisenden Wert verwendet wird und der resultierende Wert dann wieder der Variablen zugewiesen wird. Durch diesen Vorgang wird der Wert der Variablen aktualisiert. Geben Sie den aktuellen Sammelwert der Variablen an, indem Sie die Variable im Ausdruck verwenden. Nach der Auswertung weist das System das Ergebnis des Ausdrucks wieder dem Variablenwert zu.
