Google Sheets モジュール
Adobe Workfront Fusion のシナリオでは、Google Sheets を使用するワークフローを自動化したり、複数のサードパーティアプリケーションやサービスに接続したりできます。
Google Sheets アカウントを Workfront Fusion に接続する方法については、 Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
Google スプレッドシートモジュールを使用するには、Google アカウントが必要です。
Google Sheets API 情報
Google シートコネクタでは、以下を使用します。
トリガー
行を監視
スプレッドシートに新規追加されたすべての行から値を取得します。
このモジュールは、以前に入力されたことのない新しい行のみを取得します。このトリガーは、上書きされた行を処理しません。
アクション
行を追加
このモジュールは、シートに行を追加します。
Google Sheetsモジュールを設定すると、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Google Sheets フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion のモジュール間での情報のマッピングを参照してください。
行の更新
このモジュールでは、選択した行のセルの内容を変更できます。
行のクリア
指定した行から値を削除します。
行を削除
指定した行を削除します。
セルを取得
選択したセルから値を取得します。
セルを更新
セルのクリア
指定したセルから値を削除します。
シートを追加
選択したスプレッドシートにシートを新規作成します。
スプレッドシートの作成
シートを削除
特定のシートを削除します。
API 呼び出し
このアクションモジュールでは、カスタム API 呼び出しを実行できます。
検索
行を検索
フィルターオプションを使用して行を検索します。
行の検索(詳細)
指定された条件に一致する結果を返します。
範囲の値を取得
シートをリスト
このモジュールは、スプレッドシート内のすべてのシートのリストを返します。
使用の制限
エラー 429: RESOURCE_EXHAUSTED
が発生した場合、API のレート制限を超えています。
Google Sheets API には、1 プロジェクトあたり 100 秒あたり 500 個のリクエストと、1 ユーザーあたり 100 秒あたり 100 個のリクエストという制限があります。読み取りと書き込みの制限は、別々に追跡されます。1 日の使用制限はありません。
詳しくは、developers.google.com/sheets/api/limits を参照してください。
ヒントとテクニック
Google Sheet から空のセルを取得する方法
行の検索(詳細) モジュールとこの式を使用して、空の列を取得します。
select * where E is null
シートへのシナリオを実行するためのボタンの追加
-
Workfront Fusion で、シナリオに Web フック/カスタム Web フック モジュール/トリガーを挿入し、構成します(Web フック を参照)。
-
Web フックの URL をコピーします。
-
シナリオを実行します。
-
Google Sheet のメインメニューバーから 挿入/図面… を選択します。
-
図面ウィンドウで、ウィンドウの上部近くにある テキストボックス アイコン をクリックします。
-
ボタンをデザインし、右上隅にある「保存して閉じる」ボタンをクリックします。
-
ワークシートにボタンが配置されます。ボタンの右上隅にある 3 つの縦並びのドットをクリックします。
-
メニューから「スクリプトを割り当て.」を選択します。
-
スクリプト(関数)の名前(例:
runScenario
)を入力して、「OK」をクリックします。 -
メインメニューバーから ツール/スクリプトエディター を選択します。
-
次のコードを挿入します。
-
関数の名前は、手順 9 で指定した名前に対応している必要があります。
-
この URL を、手順 2 でコピーした web フックの URL に置き換えます。
function runScenario() {
UrlFetchApp.fetch ("<webhook you copied>");
}
-
-
Ctrl + S を押してスクリプトファイルを保存し、プロジェクト名を入力して「OK」をクリックします。
-
Google Sheets に戻って、新しいボタンをクリックします。
-
スクリプトに必要な認証を付与します。
-
Workfront Fusion で、シナリオが正常に実行されたことを確認します。
スプレッドシートでの日付の保存
日付の値を書式設定なしでスプレッドシートに保存した場合、ISO 8601 形式のテキストとしてスプレッドシートに表示されます。ただし、このテキストを理解しない日付に対応する Google Sheets 数式または関数(例:数式 =A1+10
) を呼び出すと、次のエラーが表示されます。
Google Sheets が日付を理解できるようにするには、formatDate (date; format; [timezone]) 関数を使用して書式設定します。2 番目の引数として関数に渡される正しい形式は、スプレッドシートのロケール設定によって異なります。
正しい形式を判断するには、次の手順を実行します。
-
メインメニューバーから ファイル/スプレッドシート 設定を選択して、ロケールを確認または設定します。
-
適切なロケールを検証/設定したら、メイン メニューから 形式/数値 を選択して、対応する日付と時刻の形式を決定します。形式は、日付と時刻メニュー項目の横に表示されます。
-
formatDate() 関数に渡す正しい形式を作成するには、 Adobe Workfront Fusion🔗 の日付と時刻の形式について トークンのリストを参照してください。
例:米国ロケールの MM/DD/YYYY HH:mm:ss
形式の使用:
Google Sheets 関数の活用
ビルトイン関数がないが Google Sheets にある場合は、それを利用できます。詳しくは、 Adobe Workfront Fusion🔗 での関数の使用による マップ項目での Google Sheets 関数の使用を参照してください。
Google Sheets による数から日付への変更の阻止
Google ワークシートでは、テキストとして使用している数字の文字列が日付として解釈されている場合があります。例えば、テキストとして使用するために「1-2019」と入力すると、Google がこれを日付として解釈します。これを防ぐために、数値をプレーンテキストとして書式設定することができます。
- Google Sheets で、数値を含む列またはセルをハイライト表示します。
- 形式/数字/プレインテキスト をクリックします。
Workfront Fusion での別の回避策は、数値の前にアポストロフィ(')を入力することです(例:'1-2019 または '1/47)。Workfront Fusion からデータが送信された後、セルにはアポストロフィが表示されません。