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 プラン

新規:標準

または

現在:仕事以上

Adobe Workfront Fusion ライセンス**

現在:Workfront Fusion ライセンス要件なし

または

従来のバージョン:作業の自動化と統合のためのWorkfront Fusion

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Google スプレッドシートモジュールを使用するには、Google アカウントが必要です。

Google Sheets API 情報

Google シートコネクタでは、以下を使用します。

ベース URL
https://sheets.googleapis.com/v4
API バージョン
v4
API タグ
v2.5.7

Google Sheets モジュールとそのフィールド

Google Forms モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Google Sheets」フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。

マップ切り替え

トリガー

行を監視

スプレッドシートに新しく追加された行から値を取得します。

モジュールは、以前に入力されていない新しい行のみを取得します。 上書きされた行はトリガーで処理されません。

IMPORTANT
ワークシートに空白行が含まれる場合、空白行が処理された後の行はありません。
Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
監視するシートが含まれているスプレッドシートを選択します。
Sheet
新しい行を監視するシートを選択します。
Table contains headers

スプレッドシートにヘッダー行が含まれるかどうかを選択します。

  • Yes

    モジュールは、出力データとしてヘッダー行を取得しません。

    出力内の変数名は、ヘッダーによって呼び出されます。

  • No

    また、このモジュールは、最初のテーブル行を取得します。

    出力内の変数名は、A、B、C、D などと呼ばれます。

Row with headers
ヘッダー行の範囲を入力します。例:A1:F1
First table row
テーブルの最初の行の範囲を入力します。例:A1:F1
Value render option
  • Formatted value

    値が計算され、セルの書式に従って返信内で書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信内の形式は設定されません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3 で普及しているように、「シリアル番号」形式で倍精度浮動小数点数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。小数部分(小数点の右側)は、時間を日の端数として数えます。例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。1900年2 月1日午後 3 時は 33.625 となります。1900 年が閏年ではないことが正しく処理されます。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存)の文字列として出力されます。

Limit
Workfront Fusion が 1 つの実行サイクルで動作する結果の最大数を設定します。

アクション

行を追加

このモジュールは、シートに行を追加します。

Google Sheets モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Google Sheets」フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。

マップ切り替え

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Mode

スプレッドシートとシートを手動で選択するか、マッピングを行うかを選択します。

注意:手動マッピングは、例えば、Workfront Fusion のシナリオで新しいスプレッドシートを作成し、新しく作成したスプレッドシートにデータをシナリオで直接追加する場合に便利です。

Spreadsheet
Google スプレッドシートを選択します。
Sheet
行を追加するシートを選択します。
Column Range
使用する列の範囲を選択します。
Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

  • Yes

    モジュールは、出力データとしてヘッダー行を取得しません。

    出力内の変数名は、ヘッダーによって呼び出されます。

  • No

    また、このモジュールは、最初のテーブル行を取得します。

    出力内の変数名は、A、B、C、D などと呼ばれます。

Values
追加する行の目的のセルを入力またはマッピングします。
Value input option
  • User entered

    値は、ユーザーが UI に入力したかのように解析されます。数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。

  • Raw

    ユーザーが入力した値は解析されず、入力した値が保存されます。

Insert data option

新しいデータが入力されるときの既存のデータの変更方法を指定します。

  • Insert rows

    行が新しいデータ用に挿入されます。

  • Overwrite

    新しいデータは、書き込まれたエリアの既存のデータを上書きします。シートの末尾にデータを追加すると、新しい行または列が挿入され、データを書き込むことができます。

シートを追加

選択したスプレッドシートにシートを新規作成します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
シートを追加する Google スプレッドシートを選択します。
Properties
  • Title

    新しいシートの名前を入力します。

  • Index

    シートの位置を入力します。デフォルトは 0 です(シートが最初に配置されます)。

セルのクリア

指定したセルから値を削除します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
セルをクリアするシートを含む Google スプレッドシートを選択します。
Sheet
セルをクリアするシートを選択します。
Cell
消去するセルの ID を入力またはマップします。 例:A5

行のクリア

指定した行から値を削除します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
行をクリアするシートを含む Google スプレッドシートを選択します。
Sheet
データをクリアするシートを選択します。
Row number
データをクリアする行の数を入力します。例: 23

スプレッドシートの作成

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Title
新しいスプレッドシートの名前を入力します。
Locale

スプレッドシートのロケールを次のいずれかの形式で入力します。

  • ISO 639-1 言語コード(例: en
  • ISO 639-2 言語コード(例:haw(639-1 コードが存在しない場合)
  • ISO 言語コードと国コードの組み合わせ(例: en_US
Recalculation interval

揮発性関数が再計算されるまでの待機時間:

  • On change

    揮発性関数は、変更のたびに更新されます。

  • On change and every minute

    揮発性関数は、変化のたびおよび 1 分ごとに更新されます。

  • On change and hourly

    揮発性関数は、変更のたびおよび 1 時間ごとに更新されます。

Time zone
スプレッドシートのタイムゾーンを選択します。
Number format

スプレッドシート内のすべてのセルのデフォルトの形式を選択します。

Text:テキストの書式設定。例: 1000. 12

Number:数値の書式設定。例: 1,000.12

Percent:割合の書式設定。例: 10. 12%

Currency:通貨の書式設定。例: $1,000.12

Date:日付の書式設定。例: 9/26/2008

Time:時間の形式設定。例: 3:59:00 PM

Date time:日付と時刻の書式設定。例:9/26/08 15:59:00

Scientific:科学的な数値の書式設定。 例: 1. 01E+03

Sheets
スプレッドシートに追加する各シートに対して、Add item をクリックし シートのタイトルとシートのインデックスを入力またはマップします。 インデックス 0 は最初のシートを表します。

行を削除

指定した行を削除します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
行をクリアするシートを含む Google スプレッドシートを選択します。
スプレッドシート
行を削除するシートを選択します。
行番号
削除する行の数を入力します。例: 23

シートを削除

特定のシートを削除します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
削除するシートを選択します。

セルを取得

選択したセルから値を取得します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
データを取得するセルを含むシートを選択します。
Cell
データの取得元のセルの ID を入力します。例: A6
Value render option
  • Formatted value

    値が計算され、セルの書式に従って返信内で書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信内の形式は設定されません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3 で普及しているように、「シリアル番号」形式で倍精度浮動小数点数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。小数部分(小数点の右側)は、時間を日の端数として数えます。例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。1900年2 月1日午後 3 時は 33.625 となります。1900 年が閏年ではないことが正しく処理されます。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存)の文字列として出力されます。

API 呼び出しを実行

このアクションモジュールでは、カスタム API 呼び出しを実行できます。

Connection
Google Sheets アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本的な手順を参照してください。
URL
https://sheets.googleapis.com/v4/ への相対パスを入力します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。
Headers
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。例えば、{"Content-type":"application/json"}。Workfront Fusion は認証ヘッダーを追加します。
Query String
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

セルを更新

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
セルを更新するシートを選択します。
Cell
更新するセルの ID を入力します。例: A5
Value
セルの新しい値を入力します。
Value input option
  • User entered

    値は、ユーザーが UI に入力したかのように解析されます。数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。

  • Raw

    ユーザーが入力した値は解析されず、入力した値が保存されます。

行の更新

このモジュールでは、選択した行のセルの内容を変更できます。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Mode

スプレッドシートとシートを手動で選択するか、マッピングを行うかを選択します。

メモ:手動マッピングは、新しいスプレッドシートが Workfront Fusion シナリオで作成され、新しく作成されたスプレッドシートにデータをシナリオ内で直接追加する場合などに役立ちます。

Spreadsheet
Google スプレッドシートを選択します。
Sheet
行を更新するシートを選択します。
Row number
更新する行の数を入力します。
Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

  • Yes

    モジュールは、出力データとしてヘッダー行を取得しません。

    出力内の変数名は、ヘッダーによって呼び出されます。

  • No

    また、このモジュールは、最初のテーブル行を取得します。

    出力内の変数名は、A、B、C、D などと呼ばれます。

Values
変更(更新)する行の目的のセルに値を入力またはマッピングします。
Value input option
  • User entered

    値は、ユーザーが UI に入力したかのように解析されます。数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。

  • Raw

    ユーザーが入力した値は解析されず、入力した値が保存されます。

検索

範囲の値を取得

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
範囲の内容を取得するシートを選択します。
Range
取得する範囲を入力します。例:A1:D25
Table contains headers
シートにヘッダー行がある場合は、このチェックボックスをオンにする
Row with headers
テーブルヘッダーの範囲を入力します。例:A1:F1このフィールドを空のままにすると、Workfront Fusion は、指定された範囲の最初の行をヘッダーとして扱います。
Value render option
  • Formatted value

    値が計算され、セルの書式に従って返信内で書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信内の形式は設定されません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3 で普及しているように、「シリアル番号」形式で倍精度浮動小数点数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。小数部分(小数点の右側)は、時間を日の端数として数えます。例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。1900年2 月1日午後 3 時は 33.625 となります。1900 年が閏年ではないことが正しく処理されます。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存)の文字列として出力されます。

シートをリスト

このモジュールは、スプレッドシート内のすべてのシートのリストを返します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
リストするシートが含まれている Google スプレッドシートを選択します。

行を検索

フィルターオプションを使用して行を検索します。

Connection
Google Sheets アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本的な手順を参照してください。
Spreadsheet
Google スプレッドシートを選択します。
Sheet
行を検索するシートを選択します。
Table contains headers
スプレッドシートにヘッダー行を含めるかどうかを選択します。Yes オプションが選択されている場合、出力データと出力内の変数名がヘッダーによって呼び出されるので、モジュールはヘッダー行を取得しません。No オプションが選択されている場合、モジュールはまた、出力内の最初のテーブル行と変数名を取得し、その後 A、B、C、D などと呼ばれます。
Column range
操作する列の範囲を選択します。例: A-F
Filter

行の検索に使用するフィルターを設定します。

Sort order
昇順と降順のどちらで並べ替えるかを選択します。
Order by
並べ替える列を選択します。
Value render option
  • Formatted value

    値が計算され、セルの書式に従って返信内で書式設定されます。 書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"$1.23" を返します。

  • Unformatted value

    値は計算されますが、返信内の形式は設定されません。 例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

  • Formula

    値は計算されません。 返信には数式が含まれます。例えば、A11.23A2=A1 で通貨の形式に設定されている場合、A2"=A1" を返します。

Date and time render option
  • Serial number

    日付、時刻、日時、期間のフィールドは、Lotus 1-2-3 で普及しているように、「シリアル番号」形式で倍精度浮動小数点数として出力されます。 値の整数部分(小数点の左側)は、1899年12月30日からの日数を数えます。小数部分(小数点の右側)は、時間を日の端数として数えます。例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。1900年2 月1日午後 3 時は 33.625 となります。1900 年が閏年ではないことが正しく処理されます。

  • Formatted string

    日付、時刻、日時、期間のフィールドは、指定された数値形式(スプレッドシートのロケールに依存)の文字列として出力されます。

Maximum number of returned rows
Workfront Fusion が 1 つの実行サイクルで返す最大行数を設定します。

行の検索(詳細)

指定された条件に一致する結果を返します。

Connection
Google Sheets アカウントをWorkfront Fusion に接続する手順については、 接続の作成 – 基本手順を参照してください。
Spreadsheet
検索するシートを含む Google スプレッドシートを選択します。
Sheet
検索する行を含むシートを選択します。
Query

Google Charts Query Language を使用します。例: select * where B = "John"

Google Charts Query Language について詳しくは、Google ドキュメントの クエリー関数リファレンスを参照してください。

使用の制限

エラー 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 を参照してください。

シートへのシナリオを実行するためのボタンの追加

  1. Workfront Fusion で、シナリオに Webhook/Custom Webhook モジュールを挿入して設定します。 手順については、Webhook を参照してください。

  2. Web フックの URL をコピーします。

  3. シナリオを実行します。

  4. Google Sheet のメインメニューバーから​ 挿入図面… を選択します。

  5. ​ 図面 ​ ウィンドウで、ウィンドウの上部付近にある テキスト ボックス アイコン テキスト ボックス をクリックします。

  6. ボタンをデザインし、右上隅にある「保存して閉じる」ボタンをクリックします。

  7. ボタンはワークシートに配置されます。 ボタンの右上隅にある 3 つの縦並びのドットをクリックします。

  8. メニューから「スクリプトを割り当て.」を選択します。

  9. スクリプト(関数)の名前(例:runScenario)を入力して、「OK」をクリックします。

  10. メインメニューバーから​ ツールスクリプトエディター ​を選択します。

  11. 次のコードを挿入します。

    • 関数の名前は、手順 9 で指定した名前に対応している必要があります。

    • この URL を、手順 2 でコピーした web フックの URL に置き換えます。

      code language-none
      function runScenario() {
      UrlFetchApp.fetch("<webhook you copied>");
      }
      
  12. Ctrl + S を押してスクリプトファイルを保存し、プロジェクト名を入力して「OK」をクリックします。

  13. Google Sheets に戻って、新しいボタンをクリックします。

  14. スクリプトに必要な認証を付与します。

  15. Workfront Fusion で、シナリオが正常に実行されたことを確認します。

スプレッドシートでの日付の保存

書式設定を行わずにスプレッドシートに日付値を格納すると、その値は ISO 8601 形式のテキストとしてスプレッドシートに表示されます。 ただし、こ Google Sheets テキストを理解できない日付を扱う数式または関数(例:数式 =A1+10)では、次のエラーが表示されます。

エラー

日付を理解 Google Sheets やすくするには、formatDate 関数を使用して書式設定します。 2 番目の引数として関数に渡される正しい形式は、スプレッドシートのロケール設定によって異なります。

この関数の詳細については、「日付と時刻の関数」の「formatDate (date; format; [timezone])」を参照しください。

正しい形式を判断するには、次の手順を実行します。

  1. Google Sheets で、メインメニューから File > Spreadsheet settings を選択し、ロケールを確認して設定します。

  2. 適切なロケールを確認または設定したら、メインメニューから 形式 > 数値 を選択して、対応する日時の形式を決定します。 形式は、日付と時刻メニュー項目の横に表示されます。

  3. formatDate () ​ 関数に渡すべき正しい形式を作成するには、 日付と時刻のフォーマット用トークンのリストを参照してください。

recommendation-more-help

例:

MM/DD/YYYY HH:mm:ss 形式の場合(米国ロケール用):

ロケールの時間式

Google Sheets 関数の活用

Google Sheets の組み込み関数を使用するには、この関数を利用します。 詳細については、「関数を使用して項目をマップする」の「 使用 Google Sheets 関数」を参照してください。

Google Sheets が数値を日付に変更できないようにする

テキストとして使用している数値の文字列が Google ワークシートの日付として解釈される場合は、数値をプレーンテキストとして事前に書式設定して、これを防ぐことができます。 例えば、1-2019 と入力した場合、テキストとして解釈する必要があるので、Googleでは日付として解釈する場合があります。

  1. Google Sheets で、数値を含む列またはセルをハイライト表示します。
  2. 形式数字プレインテキスト ​をクリックします。

Workfront Fusion のもう 1 つの回避策は、数字の前にアポストロフィ(')を入力することです(例:「1-2019」や「1/47」)。 Workfront Fusion からデータを送信した後、セルにアポストロフィが表示されない。

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3