USM Content
Bridge ユーティリティ: JavaScript
Bridge の JavaScript ユーティリティには、次のモジュールが 1 つだけ含まれています: Run Script (スクリプトの実行)。 このモジュールを使って、JavaScript 機能を記述し、記述した機能を作動させます。
JavaScript ユーティリティを設定する
- Bridge にログインします。
- [Integrations (統合)] ページに移動します。
- [JavaScript] を探して選択します。
Run Script (スクリプトの実行) モジュール
このモジュールには次のフィールドが含まれており、すべてのフィールドでデータ参照を使用できます:
- Script Name (スクリプト名): 実行するスクリプトの名前。
- Script Parameters (スクリプトのパラメーター): スクリプトが実行の際に要求するパラメーターをキー: 値オブジェクトのマップとして表します。
- Key (キー): スクリプトで表示されるパラメーター名。
- Value (値): スクリプトが実行中に使用するキーに割り当てられた値。
許容されるスクリプト パラメーターの数は無制限で、動的に追加されます。
実行したいスクリプトを設定するには:
- モジュールの上部にあるギアアイコンを選択します。
- 「Scripts (スクリプト)」セクションを展開します。
- [Scripts に追加] を選択します。
- スクリプト名 と スクリプト本文 フィールドに入力します。
- [保存] を選択します。
Bridge が 「Run Script (スクリプトの実行)」 モジュールを実行すると、次の情報が [Run Log (実行ログ)] ペインで利用できるようになります:
- Data
- result (結果): JavaScript アウトプット
- State (状態): モジュールが機能したかどうかを示すセクション
- コード: モジュールが Smartsheet から取り込む成功/エラー コード
- メッセージ: モジュールが Smartsheet から取り込む、システムによって生成されたメッセージ。 たとえば、モジュールが値を見つけられない場合、表示されるメッセージは 見つかりませんです。
- ステータス: モジュールが Smartsheet から取り込むステータス。 遭遇する可能性のあるステータス ラベルは 成功 と 失敗です。
例
例 1: ハロー ワールド
- スクリプト本文が次のようなスクリプトを作成します: return “Hello” + a。
応答を生成するには、すべてのスクリプトで「return」と入力する必要があります。
- モジュールに、値 world を持つパラメーター a を追加します。
- ワークフローを実行:
モジュール ビルダーの「キー」が「スクリプト本文」フィールドのパラメーターに一致していることを確認します。
値は相互交換可能なインプットです。たとえば、初期のモジュール応答のアウトプットから取り込むこともできます。
スクリプト名は文字列入力に対して引用符を必要としませんが、スクリプト本文は必要です。そうでない場合、エラーメッセージが表示されます。
例 2: 基本的な操作
2 つの文字列を連結するには:
- スクリプト本文を使用してスクリプトを作成します: return a + b。
- モジュールに、値 3 と 2, を持つパラメーター a と b を追加します。
- ワークフローを実行:
このメソッドは 2 つの値を連結しますが、加算はしません。
Bridge を通じて設定された変数は文字列として扱われます。
数値を合計するには:
- スクリプト本文フィールドを使用してスクリプトを作成します: return Number(a) + Number(b)。
- ワークフローを実行:
以下の例と同じパラメータを使用すると、今回は結果が5になります。
例 3: 配列を繰り返す
この例では、リストシートモジュールを持つワークフローがあります。ワークフローが実行されると、実行ログには以下の出力が提供され、データは配列 [100]としてマークされます。これは、フィールドが配列であることを意味します。
実行ログから情報を取得するには、ワークフローを実行する必要があります。
- データの隣にある三点リーダーを選択し、次にデータ参照をコピーを選択します。
- ワークフローに新しいスクリプトを実行モジュールを追加します。
- 新しいJavaScriptスクリプトを作成します。この例では、getFirstElementOfListSheetsと名付け、スクリプト本体は return listSheets[0].です。これは、データ配列の最初の要素を返します。
角括弧内の数字は、返される配列要素を定義します。0は最初を返し、1は2番目を返し、以下同様です。
JavaScriptモジュールで:
- getFirstElementOfListSheetsをスクリプト名として設定します。
- キー #1というスクリプトパラメータを追加し、listSheetsと呼びます。
- ステップ1でコピーしたデータ参照を値 #1に貼り付けます。
ワークフローを実行すると、実行ログには以下の出力が提供されます。
以下の項目結果は、配列の最初の要素の一部です。
製品/機能の制限
6 MB ペイロード リクエストおよびレスポンスのみ処理できます。
これは今後のアップグレードで変更になる場合があります。
- スクリプト作成時のスクリプト検証はありません。スクリプトに誤りがある場合は、開発者が責任を持ってスクリプト実行時に返される問題やエラーのデバッグ/修正を行います。
- Smartsheet チームはスクリプトのバージョンおよび履歴の追跡や管理は行っていません。
- Bridge は、事象ベースのワークフローや固定スケジュールに基づくワークフローに適しています。これは、コネクタが提供する一方向または双方向の同期の機能に替わるものではありません。設計上、Bridge は順序の保証はしません。また、あるシステムまたはその他のシステムで行われた変更に関するステータス情報の保持も行いません。このため、コネクタのような設定は信頼性が低いため推奨しません。