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

ブリッジユーティリティ: ユーティリティ関数

ブリッジのユーティリティ関数には、データストレージモジュールなどが含まれています。

ご利用可能なユーザー

プラン:

  • Bridge by Smartsheet

ユーティリティ関数は、データ操作、ストレージ、外部システムとの相互作用を可能にすることで、ワークフローの自動化を強化します。 

ユーティリティ関数モジュール 

エンティティを追加 

このモジュールは、ワークフローに新しいレコードを作成します。例えば、ステータス値が配列内またはその外で返される場合、通常は両方を参照する必要があります。代わりに、エンティティを追加に2つの参照を追加し、ワークフロー全体で状態の出力を使用します。

  1. 左側のナビゲーションパネルのエンティティを追加モジュールを見つけてください。
  2. 新しい状態をワークフローにドラッグし、名前を付けます。例: ステータス。状態は、返されたステータスを使用する必要があるすべてのモジュールよりも上位にある必要があります。
  3. ワークフローが参照する値を取得するモジュールの下に、エンティティを追加モジュールをドラッグします。次のフィールドに入力します。
  • 状態名: 追加した状態の名前です。
  • エンティティの値: 状態を設定する値の参照先で、{{||}} で表します。これで、空ではない参照を使用して状態の値が設定されます。
  • エンティティ名: 設定するエンティティの名前です。

ステータスを参照する必要がある後続のモジュールでは、作成した状態の出力を代わりに使用します。状態を選択し、状態パネルの出力の下にある値をコピーすることで見つけることができます。

データを保存する

ユーザー、ワークフロー実行、またはグローバルにスコープされたデータを保存および取得します。データを保存する際には、次の 3 つの値を指定します。

  • 保存場所: データを保存する場所。有効なオプションは、ユーザー、リクエスト(特定のワークフロー実行に関連付けられたデータ)、またはグローバル(すべてのワークフローでアクセス可能なデータ)です。
  • [Name of DataStore (DataStore の名前)]11>: データを保存するキーを指定します。
  • [Data To Store (保存するデータ)]12>: 保存するデータを指定します。

キーと値のペアだけを保存する場合は、鍵管理機能をご利用ください。[Data Storage (データ保存)]13>は、主に JSON オブジェクトの保存を目的としています。

データを取得

ワークフロー内で以前に保存されたデータにアクセスします。データを取得する際には、次の 2 つの値を指定します:

  • [Storage location (保存場所)]14>: データを保存する場所を指定します。有効なオプションは、user (ユーザー)、request(リクエスト)、global (グローバル) です。
  • [Name of DataStore (DataStore の名前)]16>: データを保存するキーを指定します。

データを削除

ワークフローのデータストレージから保存されたデータを削除します。データを削除する際には、次の 2 つの値を指定します:

  • [Storage location (保存場所)]17>: データを削除する場所を指定します。有効なオプションは、user (ユーザー)、request(リクエスト)、global (グローバル) です。
  • [Name of DataStore (DataStore の名前)]19>: データを削除するキーを指定します。

データをチェックする

このモジュールは、ワークフロー内に接続を作成します。特定のデータがワークフローのデータストレージ内に存在するかを確認し、存在するかどうかに応じてパスにリダイレクトします。データをチェックする際には、次の値を指定します:

  • [Name (名前)]20>: 状態の名前です。
  • [Storage Location (保存場所)]21>: データを保存する場所を指定します。有効なオプションは、ユーザー、リクエスト、グローバルです。
  • [Name of DataStore (DataStore の名前)]22>: 配下にデータを保存するキーを指定します。

遅延

ワークフローの実行に一時停止を導入します。Delayモジュールでは、次のフィールドのいずれかを入力する必要があります:

  • Delay: Bridge がワークフローの次のステップを実行するまでの待ち時間を指定します (秒)。
  • String: Bridge が長さに応じて遅延を計算する文字列です。

遅延を秒単位で指定するか、テキストを参照させることができ、Bridge は文字列の長さに基づいて遅延を自動的に計算します。

また、両方のオプションを空白のままにして、Bridge に 0 秒から 60 秒の間でランダムな遅延を選択させることもできます。

遅延は最大 60 秒です。より長い時間または文字列が指定された場合、遅延は 60 秒になります。