このページの一部は機械翻訳されている場合があります。

Bridge ユーティリティ: 配列管理

カスタマイズされたデータ操作のための配列管理

ご利用可能なユーザー

プラン:

  • Bridge by Smartsheet

外部APIにアクセスする際、データはしばしばフィルタリングまたは構造化する必要があります。データの追加、削除、並べ替え、操作が必要な場合もあります。配列管理機能を使用すれば、コードを自作したりバックエンドサービスを修正したりしなくても、データをニーズに合わせてカスタマイズできます。

配列管理モジュール

以下の説明では、太字の単語はモジュール内のフィールドを示します。

モジュール内のフィールドについて疑問がある場合は、フィールドの横にある疑問符にカーソルを合わせると、そのフィールドの機能についての簡単な説明が表示されます。

[Add Object To Array (配列にオブジェクトを追加)]

新しいオブジェクトを既存の配列に追加することができます。これは、ワークフローの実行中に配列を動的に構築または変更する際に特に便利です。

追加する配列はオブジェクトの配列として構造化されていることを確認してください。このモジュールはオブジェクトの配列用であり、単純なリストや値の配列には適していません。

[Delete From Array (配列から削除)]

指定されたエントリ配列から削除します。エントリは、削除すべきオブジェクトまたはエントリを定義します。最初のエントリは1、2番目は2、以降は順次続きます.

他の配列ユーティリティの場合、最初のエントリは0,、2番目は2、などとなります。

[Extract Field From Array (配列からフィールドを抽出)]

特定のキー配列から抽出し、出力として配列またはCSVを使用します。複雑なデータ構造から簡略化されたリストを作成する際にこのモジュールを使用します。ドロップダウンオプションの生成や、さらなる処理のためのデータの準備などに役立ちます。

入力したキーが選択した配列に含まれるキーと一致することを確認してください。

[Offset Array (配列をオフセット)]

指定されたオフセットから始まる既存の配列のデータのサブセットを取得します。結果の配列のサイズであるトリムサイズを選択する必要があります。

たとえば、元の配列に10のエントリがあり、トリムサイズが4、オフセットが3に設定されている場合、結果の配列は元の配列の3から6のエントリで構成されます。 

オフセットはゼロベースであり、オフセット0は配列の最初の要素を指します。

[Pick From Array (配列から選択)]

他で使用するために配列からランダムなエントリを取得できます。 

[Size/Length (サイズ/長さ)]

定義されたデータのエントリ数を返します。このモジュールは、ワークフロー内での反復や条件付きロジックのためにデータセットのサイズを評価する必要がある場合に便利です。

[Sort Object Array (オブジェクト配列を並べ替え)]

配列のオブジェクト構造内のフィールドの値により配列を並べ替えることができます。ソートフィールドを指定する必要があります。これは、ソートするオブジェクトを定義し、ソート順を指定します。これは昇順または降順です。

 ネストされたオブジェクトを含む配列を扱う際に、モジュールに制限があることに注意してください。そのような場合、ソートが期待通りに機能しないことがあります。

[Trim Array (配列をトリミング)]

配列 を特定の項目数に減らすことができます。トリムサイズを指定する必要があります。これは、結果の配列のサイズです。

モジュールは配列の先頭からアイテムを保持します。特定のアイテムが必要な場合は、事前に配列をソートすることを検討してください。