Google Sheets モジュール
Adobe Workfront Fusion のシナリオでは、Google Sheets を使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりすることができます。
Google Sheets アカウントを Workfront Fusion に接続する手順について詳しくは、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください
アクセス要件
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront パッケージ |
任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| Adobe Workfront Fusion ライセンス |
オペレーションベース:Workfront Fusion ライセンス要件なし コネクターベース(レガシー):Workfront Fusion for Work Automation および Integration |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
Google スプレッドシートモジュールを使用するには、Google アカウントが必要です。
Google Sheets APIの情報
Google Sheets コネクタでは、次の機能が使用されます。
Google Sheets モジュールとそのフィールド
Google Forms モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。 これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Google Sheets」フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。
トリガー
行を監視
スプレッドシートに新しく追加された行から値を取得します。
モジュールは、以前に入力されていない新しい行のみを取得します。 トリガーは、上書きされた行を処理しません。
アクション
行を追加
このモジュールは、シートに行を追加します。
Google Sheets モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。 これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Google Sheets」フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。
シートを追加
選択したスプレッドシートにシートを新規作成します。
セルのクリア
指定したセルから値を削除します。
行のクリア
指定した行から値を削除します。
スプレッドシートの作成
行を削除
指定した行を削除します。
シートを削除
特定のシートを削除します。
セルを取得
選択したセルから値を取得します。
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
ここで、「E」は列、「is null」は条件です。 Googleのクエリ言語を使用して、より高度なクエリを作成できます。 詳しくは、Google ドキュメントのGoogle Query Langを参照してください。
シートへのシナリオを実行するためのボタンの追加
-
Workfront Fusionで、Webhook > カスタム webhook モジュールをシナリオに挿入して設定します。 手順については、Webhookを参照してください。
-
Web フックの URL をコピーします。
-
シナリオを実行します。
-
Google Sheet のメインメニューバーから挿入/図面… を選択します。
-
描画 ウィンドウで、ウィンドウの上部付近にあるテキストボックス アイコン
をクリックします。
-
ボタンをデザインし、右上隅にある「保存して閉じる」ボタンをクリックします。
-
ボタンはワークシートに配置されます。 ボタンの右上隅にある 3 つの縦並びのドットをクリックします。
-
メニューから「スクリプトを割り当て….」を選択します。
-
スクリプト(関数)の名前(例:
runScenario)を入力して、「OK」をクリックします。 -
メインメニューバーからツール/スクリプトエディターを選択します。
-
次のコードを挿入します。
-
関数の名前は、手順 9 で指定した名前に対応している必要があります。
-
この URL を、手順 2 でコピーした web フックの URL に置き換えます。
code language-none function runScenario() { UrlFetchApp.fetch("<webhook you copied>"); }
-
-
Ctrl + S を押してスクリプトファイルを保存し、プロジェクト名を入力して「OK」をクリックします。
-
Google Sheets に戻って、新しいボタンをクリックします。
-
スクリプトに必要な認証を付与します。
-
Workfront Fusionで、シナリオが正常に実行されたことを確認します。
スプレッドシートでの日付の保存
書式なしでスプレッドシートに日付値を保存すると、スプレッドシートにISO 8601形式のテキストとして表示されます。 ただし、このテキストを理解しない日付で動作するGoogle Sheetsの数式または関数(例:数式=A1+10)には、次のエラーが表示されます。
Google Sheetsが日付を理解できるように、formatDate関数でフォーマットします。 2 番目の引数として関数に渡される正しい形式は、スプレッドシートのロケール設定によって異なります。
この関数について詳しくは、日付と時刻の関数の記事「formatDate (date; format; [timezone]) 」を参照してください。
正しい形式を判断するには、次の手順を実行します。
-
Google シートで、メインメニューからファイル > スプレッドシートの設定を選択して、ロケールを確認および設定します。
-
適切なロケールを検証または設定したら、メインメニューから形式 > 番号を選択して、対応する日付と時刻の形式を決定します。 形式は、日付と時刻メニュー項目の横に表示されます。
-
formatDate () 関数に渡す必要がある正しい形式を作成するには、日付と時刻の書式設定🔗の トークンのリストを参照してください。
例:
MM/DD/YYYY HH:mm:ss形式(米国ロケールの場合):
Google Sheets 関数の活用
Google Sheetsの組み込み関数を使用するには、それを利用します。 詳しくは、「関数を使用してアイテムをマッピングする Google Sheets 関数」を参照してください。
Google Sheetsが数値を日付に変更できないようにする
テキストとして使用している数値の文字列がGoogle ワークシートの日付として解釈されている場合は、数値をプレーンテキストとして事前にフォーマットして、これを防ぐことができます。 例えば、「1-2019」と入力してテキストとして入力すると、Googleはそれを日付として解釈する場合があります。
- Google Sheets で、数値を含む列またはセルをハイライト表示します。
- 形式/数字/プレインテキストをクリックします。
Workfront Fusionのもう1つの回避策は、数字の前にアポストロフィ(')を入力することです(例:「1-2019」または「1/47」)。 Workfront Fusionからデータを送信した後、セルにアポストロフィが表示されません。