Smartsheet Bridge-Dienstprogramme: Array Management (Array-Management)

Wenn Sie auf eine externe API zugreifen, sind die Daten häufig nicht so gefiltert oder strukturiert, wie Sie sie verwenden möchten. Sie müssen womöglich Daten hinzufügen, entfernen, sortieren oder bearbeiten. Mit Array Management-Funktionen (Array-Management) können Sie die Daten an Ihre Bedürfnisse anpassen – ohne eigenen Code schreiben oder den Backend-Service ändern zu müssen.

Add Object To Array

Ermöglicht Ihnen, einem Array einen zusätzlichen Datensatz hinzuzufügen. Zur Verwendung des Dienstprogramms Add Object To Array (Objekt zu Array hinzufügen) müssen Sie die folgenden Felder ausfüllen:

• Array: Verweis auf das vorhandene Array
• Object (Objekt): Objekt, das Sie dem Array hinzufügen möchten:
  • Key #1 (Schlüssel 1): das Label des hinzuzufügenden Objekts
  • Value #1 (Wert 1): der Wert des hinzuzufügenden Objekts

Dieses Dienstprogramm kann nicht verwendet werden, um einer Liste in einem Array einfach nur Einträge hinzuzufügen.

Delete From Array

Ermöglicht Ihnen, einen bestimmten Datensatz aus einem Array zu löschen. Zur Verwendung des Dienstprogramms Delete From Array (Aus Array löschen) müssen Sie die folgenden Felder ausfüllen:

• Array: Verweis auf das vorhandene Array
• Entry (Eintrag): das zu entfernende Objekt bzw. der zu entfernende Eintrag; der erste Eintrag ist 1

Für die anderen Array-Dienstprogramme ist der erste Eintrag 0.

Extract Field From Array

Zum Extrahieren eines bestimmten Feldes aus dem Array, entweder als Array oder als CSV. Zur Verwendung des Dienstprogramms Extract Field From Array (Feld aus Array extrahieren) müssen Sie die folgenden Felder ausfüllen:

• Array: Verweis auf das vorhandene Array
• Key (Schlüssel): der Name des zu extrahierenden Feldes
• Output (Ausgabe): das Format der Ausgabe

In der folgenden Abbildung sehen Sie links das Array, aus dem extrahiert wird, und rechts das Ergebnis der Extrahierung des Feldtyps (zurückgegeben als Array).

Brandfolder Image

Offset Array

Ermöglicht Ihnen, einen Satz von Daten aus dem Array abzurufen, die absichtlich um ein gewisses Maß versetzt sind. Das ist sehr nützlich, wenn die für den Datenzugriff verwendete API die Paginierung von Daten nicht unterstützt. Zur Verwendung des Dienstprogramms Offset Array (Versatz-Array) müssen Sie die folgenden Felder ausfüllen:

• Array: Verweis auf das vorhandene Array
• Trim Size (Zielgröße): die Größe des resultierenden Arrays
• Offset (Versatz): Eintrag, ab dem im referenzierten Array gestartet werden soll

Wenn z. B. das ursprüngliche Array 10 Einträge hat, die Zielgröße auf 4 und der Versatz auf 3 gesetzt ist, besteht das resultierende Array aus den Einträgen 3 bis 6 aus dem ursprünglichen Array.

Pick From Array

Ermöglicht Ihnen, einen zufälligen Eintrag aus dem Array abzurufen, um ihn an anderer Stelle zu verwenden. Zur Verwendung des Dienstprogramms Pick From Array (Aus Array auswählen) müssen Sie die folgenden Felder ausfüllen:

• Array: Verweis auf das Array, aus dem ein Eintrag ausgewählt werden soll

Size/Length

Gibt die Größe (Anzahl der Einträge) eines Arrays zurück. Zur Verwendung des Dienstprogramms Pick From Array (Aus Array auswählen) müssen Sie die folgenden Felder ausfüllen:

• Data (Daten): Verweis auf das Array, dessen Länge zurückgegeben werden soll

Sort Object Array

Ermöglicht Ihnen, das Array nach dem Wert eines beliebigen Feldes in der Objektstruktur eines Arrays zu sortieren. Zur Verwendung des Dienstprogramms Sort Object Array (Objekt-Array sortieren) müssen Sie die folgenden Felder ausfüllen:

• Array: Verweis auf das zu sortierende Array
• Sort Field (Sortierfeld): Objekt, nach dem sortiert werden soll
• Sort Order (Sortierreihenfolge): Option zum Sortieren der Ergebnisse in aufsteigender oder absteigender Reihenfolge

In der Abbildung unten sehen Sie links das zu sortierende Array und rechts das Ergebnis-Array mit aufsteigender Sortierreihenfolge.

Brandfolder Image

Trim Array

Ermöglicht Ihnen, das Array auf eine bestimmte Anzahl von Elementen zu reduzieren. Zur Verwendung des Dienstprogramms Trim Array (Array zuschneiden) müssen Sie die folgenden Felder ausfüllen:

• Array: Verweis auf das zuzuschneidende Array
• Trim Size (Zielgröße): Größe/Länge (Anzahl der Einträge) des resultierenden Arrays