PlanGrid オブジェクトトリガー
PlanGrid トリガーは、PlanGrid プロジェクトを一定の間隔でポーリングし、PlanGrid 内の新規または更新されたオブジェクトに基づいてレシピをトリガーします。このトリガーは、前回のポーリング以後に最近作成または更新されたオブジェクトがあるかどうか、一定の間隔で PlanGrid をポーリングします。Workato は、新しく作成または更新されたオブジェクトを検出すると、そのオブジェクトがトリガーの条件を満たしているかどうかを確認し (該当する場合)、検出したオブジェクトごとに新規ジョブを実行します。
トリガーの条件
トリガーの条件は、Workato のフィルターのような役割を果たします。Workato でトリガーの条件を有効にすると、ワークフローをトリガーするイベントを選択的に指定できます。条件は、ステータスなどのオブジェクトの属性に対して設定できます。たとえば、送信されたフィールドレポートのみがワークフローをトリガーし、アーカイブされたフィールドレポートやドラフトのフィールドレポートは無視するように指定できます。
オブジェクトトリガーの入力項目
トリガーは Workato で簡単に設定でき、ほとんどの場合、必須の入力項目は PlanGrid プロジェクトのみです。レシピを初めて開始するとき、過去にさかのぼってイベントを取得できるように、Workato がイベントを取得する最後の時刻を設定することもできます。
オブジェクトトリガーの出力項目
新規オブジェクトまたは新規/更新されたオブジェクトのそれぞれが別々の実行をトリガーし、その出力データピルをレシピ内の後続のステップで使用できます。
サポートされているオブジェクト
Project (プロジェクト)
新規または更新されたプロジェクトが PlanGrid で検出されると起動します。このトリガーは、レシピの開始以降に作成/更新されたプロジェクトを処理します。
| 項目名 | 説明 |
|---|
| Object type | Project に設定する必要があります。 |
出力項目
| 項目名 | 説明 |
|---|
| Project ID | プロジェクトの ID。 |
| Project Name | PlanGrid でのプロジェクトの名前。 |
| Project Code | PlanGrid でプロジェクトに割り当てられたカスタムコード (該当する場合)。 |
| Organization ID | PlanGrid でプロジェクトが属する組織の ID (該当する場合)。 |
| Project Type | プロジェクトのタイプ。general、manufacturing、power、water-sewer-waste、industrial-petroleum、transportation、hazardous-waste、telecom、education-k-12、education-higher、gov-federal、gov-state-local、other のいずれかになります。 |
| Project Status | PlanGrid で設定されたプロジェクトの現在のステータス。 |
| Project Owner | PlanGrid で指定されたプロジェクトの所有者。 |
| Project Start Date | PlanGrid で設定されたプロジェクトの開始日。 |
| Project End Date | PlanGrid で設定されたプロジェクトの終了日。 |
| Street line 1 | PlanGrid で設定された住所の情報。 |
| Street line 2 | PlanGrid で設定された住所の情報。 |
| Town or city | PlanGrid で設定された住所の情報。 |
| State, province, or region | PlanGrid で設定された住所の情報。 |
| Zip or postal code | PlanGrid で設定された住所の情報。 |
| Country | PlanGrid で設定された住所の情報。 |
| Latitude | PlanGrid で設定された住所の情報。 |
| Longitude | PlanGrid で設定された住所の情報。 |
| Updated at | PlanGrid でプロジェクトが最後に更新されたときのタイムスタンプ。 |
Annotation (注釈)
新規または更新された注釈が PlanGrid プロジェクト内のシートに追加されると起動します。このトリガーは、レシピの開始以降に作成/更新された注釈を処理します。
| 項目名 | 説明 |
|---|
| Object type | Annotation に設定する必要があります。 |
| Project | 新規または更新された注釈について監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| Annotation ID | 注釈の ID。 |
| Project ID | ファイルを含むプロジェクトの ID。 |
| Color | PlanGrid で注釈に割り当てられた色。 |
| Stamp | PlanGrid で注釈に割り当てられたスタンプ (該当する場合)。 |
| Visibility | 注釈の可視性レベル。「user」または「master」のどちらかになります。user は、チームメンバー (または元チームメンバー) が注釈をプロジェクトに対して公開していないことを示します。空白になることはありません。 |
| Deleted | この注釈が削除されているかどうかを示します。 |
| Sheet | UID | 注釈が配置されているシートの ID。 |
| URL | 注釈が配置されている PlanGrid のシートにアクセスするための URL。 |
Document (ドキュメント)
新規または更新されたドキュメントが PlanGrid プロジェクトに追加されると起動します。このトリガーは、レシピの開始以降に作成/更新されたドキュメントを処理します。
| 項目名 | 説明 |
|---|
| Object type | Document に設定する必要があります。 |
| Project | 新規または更新されたドキュメントについて監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| Document ID | ドキュメントの ID。 |
| Project ID | プロジェクトの ID。 |
| Document Name | PlanGrid でのドキュメントの名前。 |
| Folder | ファイルが格納された PlanGrid ドキュメント内のフォルダーパス。 |
| URL | ファイルをダウンロードするための URL。 |
| Created at | PlanGrid でファイルが作成されたときのタイムスタンプ。 |
| Created by | UID | ファイルを作成したユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | ファイルを作成したユーザーのメールアドレス。 |
| Deleted | このファイルが削除されているかどうかを示します。 |
| Updated at | PlanGrid でファイルが最後に更新されたときのタイムスタンプ。 |
Field report (フィールドレポート)
新規または更新されたフィールドレポートが PlanGrid プロジェクト内で作成されると起動します。このトリガーは、レシピの開始以降に作成/更新されたフィールドレポートを処理します。
| 項目名 | 説明 |
|---|
| Object type | Field report に設定する必要があります。 |
| Project | 新規または更新されたフィールドレポートについて監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| Field Report ID | フィールドレポートの ID。 |
| Project ID | プロジェクトの ID。 |
| Title | PlanGrid でのフィールドレポートのタイトル。 |
| Description | PlanGrid でのフィールドレポートの説明。 |
| URL | PlanGrid のフィールドレポートにアクセスするための URL。 |
| Report Date | PlanGrid でレポートが作成されたときのタイムスタンプ。 |
| Status | フィールドレポートのステータス。値は draft、submitted、archived、deleted のいずれかになります。 |
| Field report type | Name | フィールドレポートテンプレートの名前。 |
| Status | フィールドレポートテンプレートのステータス。active または archived のいずれかになります。 |
| UID | フィールドレポートテンプレートの ID。 |
| PDF URL | フィールドレポートの PDF バージョンにアクセスするための URL (PlanGrid での元のレポートが PDF だった場合にのみ存在し、ネイティブの日次レポートの場合は利用できません)。 |
| PDF Form Values: | Name | PDF フォームフィールドの名前。 |
| Value | フォームフィールド名に対応する値。 |
| List size | フィールドレポートから取得可能なフォームフィールド値の数。 |
| Daily Report values | Work log entries: | Trade | 作業を実施した業者。 |
| Timespan | 作業ログエントリに対する作業の合計数 (ミリ秒)。 |
| Headcount | 作業ログエントリに対する作業者の数。 |
| Description | 実施した作業の説明。 |
| Deleted | 作業ログエントリが削除されているかどうか。 |
| List size | 「Work log entries」リストのエントリ数。 |
| Material entries | Unit | 指定された数量の測定単位。 |
| Quantity | 使用された資材の数量。 |
| Item | 使用された資材項目の具体的な説明。 |
| Description | 使用された資材の説明 (前出の「Item」にすべての詳細が含まれていれば空白になる場合があります)。 |
| Deleted | 資材エントリが削除されているかどうか。 |
| List size | 「Material entries」リストのエントリ数。 |
| Equipment entries: | Timespan | すべての機器が使用された合計時間 (ミリ秒)。 |
| Quantity | 使用された機器の数量。 |
| Item | 使用された機器項目の具体的な説明。 |
| Description | 使用された機器の説明 (前出の「Item」にすべての詳細が含まれていれば空白になる場合があります)。 |
| Deleted | 機器エントリが削除されているかどうか。 |
| List size | 「Equipment entries」リストのエントリ数。 |
| List size | 「Daily Report Values」リストのエントリ数。 |
| Documents | Total count | フィールドレポートに関連付けられたドキュメントの合計数。 |
| URL | PlanGrid のフィールドレポートに関連付けられたドキュメントにアクセスするための URL。 |
| Photos | Total count | フィールドレポートに関連付けられた写真の合計数。 |
| URL | PlanGrid のフィールドレポートに関連付けられた写真にアクセスするための URL。 |
| Snapshots | Total count | フィールドレポートに関連付けられたスナップショットの合計数。 |
| URL | PlanGrid のフィールドレポートに関連付けられたスナップショットにアクセスするための URL。 |
| Created by | UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |
| Updated at | PlanGrid でレポートが最後に更新されたときのタイムスタンプ。 |
| Weather | Humidity | 1日間の湿度を示すパーセント値。 |
| Precipitation accumulation | 1日間の累積降水量。単位は「precipitation_accumulation_unit」で指定されます。 |
| Precipitation accumulation unit | 累積降水量の単位。 |
| Speed unit | 風速の測定単位。 |
| Summary key | 天気の説明 (晴れ時々曇り、など)。 |
| Temperature max | 1日間の最高気温。 |
| Temperature min | 1日間の最低気温。 |
| Temperature unit | 気温の測定単位。 |
| Wind bearing | 風向き。 |
| Wind gust | 1日間に観測された最大風速。 |
| Wind speed | 1日間に観測された平均風速。 |
Photo (写真)
新規または更新された写真が PlanGrid プロジェクトに追加されると起動します。このトリガーは、レシピの開始以降に作成/更新された写真を処理します。
| 項目名 | 説明 |
|---|
| Object type | Photo に設定する必要があります。 |
| Project | 新規または更新された写真について監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| Photo ID | 写真の ID。 |
| Project ID | プロジェクトの ID。 |
| Title | PlanGrid での写真のタイトル。 |
| URL | PlanGrid から写真をダウンロードするための URL。 |
| Created at | PlanGrid でファイルが作成されたときのタイムスタンプ。 |
| Created by | UID | ファイルを作成したユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | ファイルを作成したユーザーのメールアドレス。 |
| Deleted | このファイルが削除されているかどうかを示します。 |
RFI
新規または更新された RFI が PlanGrid プロジェクトに追加されると起動します。このトリガーは、レシピの開始以降に作成/更新された RFI を処理します。
| 項目名 | 説明 |
|---|
| Object type | RFI に設定する必要があります。 |
| Project | 新規または更新された RFI について監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| RFI ID | RFI の ID。 |
| Project | プロジェクトの ID。 |
| RFI Number | プロジェクト内の RFI の数。 |
| Status | UID | RFI の現在のステータスの ID。 |
| Label | RFI の現在のステータスのラベル (draft、answered など)。 |
| Color | PlanGrid での RFI の色分け。 |
| Locked | RFI がロックされているか、まだ編集可能かを示します。 |
| Title | PlanGrid での RFI のタイトル。 |
| Question | PlanGrid の RFI で行われた質問。 |
| Answer | PlanGrid の RFI に対して与えられた回答。 |
| Sent at | PlanGrid でレビュー担当者に RFI が送信されたときのタイムスタンプ。 |
| Due at | PlanGrid で RFI の期限に設定されている日時のタイムスタンプ。 |
| Assigned to | UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |
| List size | この RFI が割り当てられている、このリスト内のユーザーの数。 |
| Updated at | PlanGrid で RFI が最後に更新されたときのタイムスタンプ。 |
| Updated by | UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |
| Created at | PlanGrid で RFI が作成されたときのタイムスタンプ。 |
| Created by | UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |
| Photos | Total count | RFI に関連付けられた写真の合計数。 |
| URL | PlanGrid の RFI に関連付けられた写真にアクセスするための URL。 |
| Attachments | Total count | RFI に関連付けられた添付ファイルの合計数。 |
| URL | PlanGrid の RFI に関連付けられた添付ファイルにアクセスするための URL。 |
| Snapshots | Total count | RFI に関連付けられたスナップショットの合計数。 |
| URL | PlanGrid の RFI に関連付けられたスナップショットにアクセスするための URL。 |
| Comments | Total count | RFI に関連付けられたコメントの合計数。 |
| URL | PlanGrid の RFI に関連付けられたコメントにアクセスするための URL。 |
Sheet (シート)
新規または更新されたシートが PlanGrid プロジェクトに追加されると起動します。このトリガーは、レシピの開始以降に作成/更新されたシートを処理します。
| 項目名 | 説明 |
|---|
| Object type | Sheet に設定する必要があります。 |
| Project | 新規または更新されたシートについて監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| Sheet ID | シートの一意の識別子 (UID) で、空白になることはありません。 |
| Project ID | シートを含むプロジェクトの ID。 |
| Name | PlanGrid でのシートの名前。 |
| Version Name | PlanGrid でシートが属しているバージョンセットの名前。 |
| Description | シートの説明。 |
| Tags | PlanGrid でシートに関連付けられているタグのリスト。 |
| Published by | UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |
| Published at | PlanGrid でシートが公開されたときのタイムスタンプ。 |
| Deleted | PlanGrid でこのシートが削除されているかどうかを示します。 |
| Uploaded file name | このシートが含まれていたアップロードファイルの名前。空白になることはありません。 |
Snapshot (スナップショット)
新規または更新されたスナップショットが PlanGrid プロジェクトに追加されると起動します。このトリガーは、レシピの開始以降に作成/更新されたスナップショットを処理します。
| 項目名 | 説明 |
|---|
| Object type | Snapshot に設定する必要があります。 |
| Project | 新規または更新されたスナップショットについて監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| Snapshot ID | ファイルの一意の識別子 (UID) で、空白になることはありません。 |
| Project ID | ファイルを含むプロジェクトの ID。 |
| Title | PlanGrid でのスナップショットの名前。 |
| URL | PlanGrid のスナップショットにアクセスするための URL。 |
| Created at | PlanGrid でスナップショットが作成されたときのタイムスタンプ。 |
| Created by | PlanGrid でスナップショットを作成したユーザーの参照。 |
| UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |
| Sheet | このスナップショットの作成元のシートに関する情報を含むオブジェクト。 |
| UID | シートの ID。 |
| URL | PlanGrid のシートにアクセスするための URL。 |
| Deleted | PlanGrid でこのスナップショットが削除されているかどうかを示します。 |
Task (タスク)
新規または更新されたタスクが PlanGrid プロジェクトに追加されると起動します。このトリガーは、レシピの開始以降に作成/更新されたタスクを処理します。
| 項目名 | 説明 |
|---|
| Object type | Task に設定する必要があります。 |
| Project | 新規または更新されたタスクについて監視する対象プロジェクト。ドロップダウンリストから選択するか、プロジェクト ID を入力します。 |
出力項目
| 項目名 | 説明 |
|---|
| Task ID | タスクの一意の識別子 (UID) で、空白になることはありません。 |
| Project ID | タスクを含むプロジェクトの ID。 |
| Number | PlanGrid で固有のタスク番号 (このプロジェクトに固有)。 |
| Title | タスクのタイトル。 |
| Status | タスクの現在のステータス。「open」、「in_review」、「pending」、「closed」のいずれかになります。 |
| Type | タスクのタイプを示します。issue、planned_work、other のいずれかになります。 |
| Assignees | UID | ユーザーの ID。 |
| Type | 割り当てられたユーザーのタイプ。 |
| List size | 割り当てられたユーザーの数。 |
| Watchers | UID | ユーザーの ID。 |
| Type | 割り当てられたユーザーのタイプ。 |
| List size | 割り当てられたユーザーの数。 |
| Location | PlanGrid で固有のタスクの場所。 |
| Start date | PlanGrid でタスクを開始するように設定されている日時のタイムスタンプ。 |
| Due at | PlanGrid でタスクの期限に設定されている日時のタイムスタンプ。 |
| Closed at | PlanGrid でタスクがクローズされたときのタイムスタンプ。タスクがクローズされた後にのみ取得可能になります。 |
| Stamp | PlanGrid で選択されたタスクスタンプ。 |
| Task List | Task list ID | タスクリストの ID。 |
| URL | PlanGrid のタスクリストにアクセスするための URL。 |
| Description | タスクの説明。 |
| Cost impact | このタスクの結果としてプロジェクトに生じるコスト面での影響を示す数値。 |
| Has cost impact | タスクがコスト面で影響を及ぼすかどうかを示します。 |
| Currency code | 「Cost impact」の通貨。 |
| Schedule impact | このタスクがプロジェクトのスケジュールに影響を及ぼす時間 (秒)。 |
| Has schedule impact | タスクがスケジュール面で影響を及ぼすかどうかを示します。 |
| Current annotation | UID | PlanGrid での注釈の ID。 |
| Color | PlanGrid で注釈に割り当てられた色。 |
| Stamp | PlanGrid で注釈に割り当てられたスタンプ (該当する場合)。 |
| Visibility | 注釈の可視性レベル。「user」または「master」のどちらかになります。user は、チームメンバー (または元チームメンバー) が注釈をプロジェクトに対して公開していないことを示します。空白になることはありません。 |
| Deleted | PlanGrid で注釈が削除されているかどうかを示します。 |
| Sheet | UID | シートの ID。 |
| URL | PlanGrid のシートにアクセスするための URL。 |
| Comments | Total count | タスクに関するコメントの合計数。 |
| URL | PlanGrid のタスクに関するコメントにアクセスするための URL。 |
| Photos | Total count | タスクに関連付けられた写真の合計数。 |
| URL | PlanGrid のタスクに関する写真にアクセスするための URL。 |
| Deleted | PlanGrid でこのタスクが削除されているかどうかを示します。 |
| Created at | PlanGrid でタスクが作成されたときのタイムスタンプ。 |
| Created by | UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |
| Updated at | PlanGrid でタスクが最後に更新されたときのタイムスタンプ。 |
| Updated by | UID | ユーザーの ID。 |
| URL | PlanGrid のユーザーのプロファイルにアクセスするための URL。 |
| Email | PlanGrid のユーザーのメールアドレス。 |