PlanGrid - オブジェクトアクション
Workatoでは、PlanGrid内のオブジェクトを作成、更新、アップロード、または取得できます。 Workatoでは、プロジェクト、タスク、フィールドレポート、シート、ドキュメントなどをオブジェクトとして分類します。 現在、PlanGridオブジェクトの長いリストに対応しています。 Workatoでオブジェクトを参照するアクションを使用する場合、操作するオブジェクトを指定できます。
操作するオブジェクトを指定すると、選択したオブジェクトとアクションのタイプに基づいて入力フィールドが動的に生成されます。
オブジェクトアクションの入力フィールド
アクションフィールドを使用すると、使用可能なオブジェクトのリストから選択できます。 たとえば、Create objectアクションを使用する場合、Projectオブジェクトを選択でき、そのステップにはPlanGridでプロジェクトを作成するために必要で使用可能な入力が入力されます。 以前のステップのデータピルを使用して、ワークフローのデータに基づいてオブジェクトを作成できます。
必須フィールドは常にレシピ設定に表示されます。 エラーを防ぐため、忘れずに入力してください。
オブジェクトアクションの出力フィールド
各オブジェクトアクションは、PlanGrid内の単一オブジェクトに対してアクションを実行します。 このアクションはPlanGridからすべてのオブジェクト関連情報を返し、その情報をレシピ内の後続ステップで使用できます。
対応オブジェクト
- プロジェクトの作成、取得、更新
- ドキュメントの取得、アップロード
- フィールドレポートの取得
- 写真の取得、更新、アップロード
- RFIの作成、取得、更新
- RFIステータスの取得
- シートの取得
- シートパケットの作成、取得
- シートバージョンの作成、アップロード
- スナップショットの取得
- タスクの作成、取得、更新
- タスクリストの作成、取得、更新
- ユーザーの作成、取得
- ロールの取得
プロジェクト
Workatoでは、PlanGridコネクターを使用してプロジェクトの作成、詳細の取得、または更新を行えます。 オブジェクトタイプprojectを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。 これには、作成または更新アクションでプロジェクトを説明するための入力フィールドのリストから、詳細取得アクションでプロジェクトIDを指定する単一の入力フィールドまで含まれます。
以下では、Workatoにおけるプロジェクトのオブジェクト表現について説明します。
プロジェクトの表現
| フィールド名 | 説明 |
|---|---|
| プロジェクトID | プロジェクトのID。 |
| プロジェクト名 | PlanGrid内のプロジェクト名 |
| プロジェクトコード | PlanGridでプロジェクトに割り当てられたカスタムコード(存在する場合)。 |
| 組織ID | PlanGridでプロジェクトが属する組織のID(存在する場合)。 |
| プロジェクトタイプ | プロジェクトタイプ。指定可能な値: general、manufacturing、power、water-sewer-waste、industrial-petroleum、transportation、hazardous-waste、telecom、education-k-12、education-higher、gov-federal、gov-state-local、またはother。 |
| プロジェクトステータス | PlanGridで設定されているプロジェクトの現在のステータス。 |
| プロジェクト所有者 | PlanGridで指定されているプロジェクトの所有者。 |
| プロジェクト開始日 | PlanGridで設定されているプロジェクト開始日。 |
| プロジェクト終了日 | PlanGridで設定されているプロジェクト終了日。 |
| 住所行1 | PlanGridで設定されている住所情報。 |
| 住所行2 | PlanGridで設定されている住所情報。 |
| 町または市区町村 | PlanGridで設定されている住所情報。 |
| 州、都道府県、または地域 | PlanGridで設定されている住所情報。 |
| 郵便番号 | PlanGridで設定されている住所情報。 |
| 国 | PlanGridで設定されている住所情報。 |
| 緯度 | PlanGridで設定されている住所情報。 |
| 経度 | PlanGridで設定されている住所情報。 |
| 更新日時 | PlanGridでプロジェクトが最後に更新された時刻のタイムスタンプ。 |
ドキュメント
Workatoでは、PlanGridコネクターを使用してドキュメントの詳細取得またはアップロードを行えます。 オブジェクトタイプdocumentを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。 これには、アップロードアクションでドキュメントを説明するための入力フィールドのリストから、詳細取得アクションでドキュメントIDを指定する単一の入力フィールドまで含まれます。
以下では、Workatoにおけるドキュメントのオブジェクト表現について説明します。
ドキュメントの表現
| フィールド名 | 説明 | |
|---|---|---|
| ドキュメントID | ドキュメントのID。 | |
| プロジェクトID | プロジェクトのID。 | |
| ドキュメント名 | PlanGrid内のドキュメント名。 | |
| フォルダ | ファイルが含まれていたPlanGridドキュメント内のフォルダパス。 | |
| URL | ファイルをダウンロードするためのURL。 | |
| 作成日時 | PlanGridでファイルが作成された時刻のタイムスタンプ。 | |
| 作成者 | UID | ファイルを作成したユーザーのID。 |
| URL | PlanGrid内のユーザープロファイルへのURL | |
| メール | ファイルを作成したユーザーのメールアドレス。 | |
| 削除済み | ファイルが削除されているかどうかを示します。 | |
| 更新日時 | PlanGridでファイルが最後に更新された時刻のタイムスタンプ。 | |
フィールドレポート
Workatoでは、PlanGridコネクターを使用してフィールドレポートの詳細を取得できます。 オブジェクトタイプfield reportを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。 フィールドレポート取得アクションでは、入力はフィールドレポートIDを指定する単一の入力フィールドのみです。
以下では、Workatoにおけるフィールドレポートのオブジェクト表現について説明します。
フィールドレポートの表現
| フィールド名 | 説明 | ||
|---|---|---|---|
| フィールドレポートID | フィールドレポートのID。 | ||
| プロジェクトID | プロジェクトのID。 | ||
| タイトル | PlanGrid内のフィールドレポートのタイトル。 | ||
| 説明 | PlanGrid内のフィールドレポートの説明。 | ||
| URL | PlanGrid内のフィールドレポートにアクセスするためのURL。 | ||
| レポート日 | PlanGridでレポートが作成された時刻のタイムスタンプ。 | ||
| Status | フィールドレポートのステータス。値はdraft、submitted、archived、またはdeletedです。 | ||
| フィールドレポートタイプ | 名前 | フィールドレポートテンプレートの名前。 | |
| Status | フィールドレポートテンプレートのステータス。activeまたはarchivedを指定できます。 | ||
| UID | フィールドレポートテンプレートのID。 | ||
| PDF URL | フィールドレポートのPDFバージョンにアクセスするためのURL(レポートがもともとPlanGrid内のPDFであった場合にのみ存在します。ネイティブの日次レポートでは使用できません)。 | ||
| PDFフォーム値: | 名前 | PDFフォームフィールドの名前。 | |
| 値 | フォームフィールド名に対応する値。 | ||
| リストサイズ | フィールドレポートから使用可能なフォームフィールド値の数。 | ||
| 日次レポート値 | 作業ログエントリ: | 職種 | 作業を実施した職種。 |
| 期間 | 作業ログエントリの作業合計数(ミリ秒)。 | ||
| 人数 | 作業ログエントリの作業者数。 | ||
| 説明 | 実施した作業の説明。 | ||
| 削除済み | 作業ログエントリが削除されているかどうか。 | ||
| リストサイズ | “作業ログエントリ”リスト内のエントリ数。 | ||
| 資材エントリ | 単位 | 指定された数量の測定単位。 | |
| 数量 | 使用された資材の数量。 | ||
| 項目 | 使用された資材項目の具体的な説明。 | ||
| 説明 | 使用された資材の説明(上記の“item”にすべての詳細が含まれる場合は空白の場合があります)。 | ||
| 削除済み | 資材エントリが削除されているかどうか。 | ||
| リストサイズ | “資材エントリ”リスト内のエントリ数。 | ||
| 機器エントリ: | 期間 | すべての機器が使用された合計時間(ミリ秒)。 | |
| 数量 | 使用された機器の台数。 | ||
| 項目 | 使用された機器項目の具体的な説明。 | ||
| 説明 | 使用された機器の説明(上記の“item”にすべての詳細が含まれる場合は空白の場合があります)。 | ||
| 削除済み | 機器エントリが削除されているかどうか。 | ||
| リストサイズ | “機器エントリ”リスト内のエントリ数。 | ||
| リストサイズ | “日次レポート値”リスト内のエントリ数。 | ||
| ドキュメント | 合計数 | フィールドレポートに関連付けられているドキュメントの合計数。 | |
| URL | PlanGrid内でフィールドレポートに関連付けられているドキュメントにアクセスするためのURL。 | ||
| 写真 | 合計数 | フィールドレポートに関連付けられている写真の合計数。 | |
| URL | PlanGrid内でフィールドレポートに関連付けられている写真にアクセスするためのURL。 | ||
| スナップショット | 合計数 | フィールドレポートに関連付けられているスナップショットの合計数。 | |
| URL | PlanGrid内でフィールドレポートに関連付けられているスナップショットにアクセスするためのURL。 | ||
| 作成者 | UID | ユーザーのID。 | |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 | ||
| メール | PlanGrid内のユーザーのメールアドレス。 | ||
| 更新日時 | PlanGridでレポートが最後に更新された時刻のタイムスタンプ。 | ||
| 天気 | 湿度 | 1日の湿度を示すパーセント値。 | |
| 降水量累積 | 1日を通して累積した降水量。 “precipitation_accumulation_unit”で指定された単位。 | ||
| 降水量累積単位 | 累積降水量の単位。 | ||
| 速度単位 | 風速測定の単位。 | ||
| 概要キー | 天気の説明(例: Partly Cloudy)。 | ||
| 最高気温 | 日中の最高気温。 | ||
| 最低気温 | 日中の最低気温。 | ||
| 気温単位 | 気温測定の単位。 | ||
| 風向 | 風の方向。 | ||
| 突風 | 1日を通して観測された最大風速。 | ||
| 風速 | 1日を通して観測された平均風速。 | ||
写真
Workatoでは、PlanGridコネクターを使用して写真の詳細取得、更新、またはアップロードを行えます。 オブジェクトタイプphotoを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。 これには、アップロードおよび更新アクションで写真を説明するための入力フィールドのリストから、詳細取得アクションで写真IDを指定する単一の入力フィールドまで含まれます。
以下では、Workatoにおける写真のオブジェクト表現について説明します。
写真の表現
| フィールド名 | 説明 | |
|---|---|---|
| 写真ID | 写真のID。 | |
| プロジェクトID | プロジェクトのID。 | |
| タイトル | PlanGrid内の写真のタイトル。 | |
| URL | PlanGridから写真をダウンロードするためのURL。 | |
| 作成日時 | PlanGridでファイルが作成された時刻のタイムスタンプ。 | |
| 作成者 | UID | ファイルを作成したユーザーのID。 |
| URL | PlanGrid内のユーザープロファイルへのURL | |
| メール | ファイルを作成したユーザーのメールアドレス。 | |
| 削除済み | ファイルが削除されているかどうかを示します。 | |
RFI
Workatoでは、PlanGridコネクターを使用してRFIの作成、詳細の取得、または更新を行えます。 これに加えて、RFIのステータスも取得できます。 オブジェクトタイプRFIまたはRFI statusを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。 これには、作成および更新アクションでRFIを説明するための入力フィールドのリストから、詳細取得アクションでRFI IDを指定する単一の入力フィールドまで含まれます。
以下では、WorkatoにおけるRFIのオブジェクト表現について説明します。
RFIの表現
| フィールド名 | 説明 | |
|---|---|---|
| RFI ID | RFIのID。 | |
| プロジェクト | プロジェクトのID。 | |
| RFI番号 | プロジェクト内のRFI番号。 | |
| Status | UID | RFIの現在のステータスのID。 |
| ラベル | RFIの現在のステータスのラベル(例: draft、answeredなど) | |
| 色 | PlanGrid内のRFIのカラーコード。 | |
| ロック済み | RFIがロックされているか、まだ編集可能かを示します。 | |
| タイトル | PlanGrid内のRFIのタイトル。 | |
| 質問 | PlanGrid内のRFIで尋ねられた質問。 | |
| 回答 | PlanGrid内のRFIに対して提供された回答。 | |
| 送信日時 | PlanGridでRFIがReviewerに送信された時刻のタイムスタンプ。 | |
| 期限日時 | PlanGridでRFIの期限となっている時刻のタイムスタンプ。 | |
| 割り当て先 | UID | ユーザーのID。 |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 | |
| メール | PlanGrid内のユーザーのメールアドレス。 | |
| リストサイズ | このRFIが割り当てられている、このリスト内のユーザー数。 | |
| 更新日時 | PlanGridでRFIが最後に更新された時刻のタイムスタンプ。 | |
| 更新者 | UID | ユーザーのID。 |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 | |
| メール | PlanGrid内のユーザーのメールアドレス。 | |
| 作成日時 | PlanGridでRFIが作成された時刻のタイムスタンプ。 | |
| 作成者 | UID | ユーザーのID。 |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 | |
| メール | PlanGrid内のユーザーのメールアドレス。 | |
| 写真 | 合計数 | RFIに関連付けられている写真の合計数。 |
| URL | PlanGrid内でRFIに関連付けられている写真にアクセスするためのURL。 | |
| 添付ファイル | 合計数 | RFIに関連付けられている添付ファイルの合計数。 |
| URL | PlanGrid内でRFIに関連付けられている添付ファイルにアクセスするためのURL。 | |
| スナップショット | 合計数 | RFIに関連付けられているスナップショットの合計数。 |
| URL | PlanGrid内でRFIに関連付けられているスナップショットにアクセスするためのURL。 | |
| コメント | 合計数 | RFIに関連付けられているコメントの合計数。 |
| URL | PlanGrid内でRFIに関連付けられているコメントにアクセスするためのURL。 | |
シート
Workatoでは、PlanGridコネクターを使用してシートの詳細を取得できます。 これに加えて、シートパケットとシートバージョンの作成、シートパケット全体の詳細取得、または新しいシートバージョンのアップロードも行えます。 オブジェクトタイプSheet、Sheet packet、Sheet versionを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。
以下では、Workatoにおけるシートのオブジェクト表現について説明します。
シートの表現
| フィールド名 | 説明 | |
|---|---|---|
| シートID | シートの一意識別子(UID)。空白になることはありません。 | |
| プロジェクトID | シートを含むプロジェクトのID。 | |
| 名前 | PlanGrid内のシート名。 | |
| バージョン名 | PlanGridでシートが属するバージョンセットの名前。 | |
| 説明 | シートの説明。 | |
| タグ | PlanGridでシートに関連付けられているタグのリスト。 | |
| 公開者 | UID | ユーザーのID。 |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 | |
| メール | PlanGrid内のユーザーのメールアドレス。 | |
| 公開日時 | PlanGridでシートが公開された時刻のタイムスタンプ。 | |
| 削除済み | このシートがPlanGridで削除されているかどうかを示します。 | |
| アップロード済みファイル名 | このシートが含まれていたアップロード済みファイルの名前。 空白になることはありません。 | |
スナップショット
Workatoでは、PlanGridコネクターを使用してスナップショットの詳細を取得できます。 オブジェクトタイプsnapshotを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。 スナップショット取得アクションでは、入力はスナップショットIDを指定する単一の入力フィールドのみです。
以下では、Workatoにおけるスナップショットのオブジェクト表現について説明します。
スナップショットの表現
| フィールド名 | 説明 |
|---|---|
| スナップショットID | ファイルの一意識別子(UID)。空白になることはありません。 |
| プロジェクトID | ファイルを含むプロジェクトのID。 |
| タイトル | PlanGrid内のスナップショットの名前。 |
| URL | PlanGrid内のスナップショットにアクセスするためのURL。 |
| 作成日時 | PlanGridでスナップショットが作成された時刻のタイムスタンプ。 |
| 作成者 | PlanGridでスナップショットを作成したユーザーへの参照。 |
| UID | ユーザーのID。 |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 |
| メール | PlanGrid内のユーザーのメールアドレス。 |
| シート | このスナップショットの取得元シートに関する情報を含むオブジェクト。 |
| UID | シートのID。 |
| URL | PlanGrid内のシートにアクセスするためのURL。 |
| 削除済み | このスナップショットがPlanGridで削除されているかどうかを示します。 |
タスク
Workatoでは、PlanGridコネクターを使用してPlanGrid内のタスクの作成、更新、または詳細取得を行えます。 これに加えて、PlanGrid内のタスクリスト全体の作成、更新、または詳細取得も行えます。 オブジェクトタイプTaskまたはTask listを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。
以下では、Workatoにおけるタスクのオブジェクト表現について説明します。
タスクの表現
| フィールド名 | 説明 | ||
|---|---|---|---|
| タスクID | タスクの一意識別子(UID)。空白になることはありません。 | ||
| プロジェクトID | タスクを含むプロジェクトのID。 | ||
| 番号 | PlanGridで指定されているタスク番号(このプロジェクト固有)。 | ||
| タイトル | タスクのタイトル。 | ||
| Status | タスクの現在のステータス。 指定可能な値は"open"、"in_review"、"pending"、"closed"です。 | ||
| タイプ | タスクのタイプを示します。 指定可能な値はissue、planned_work、otherです。 | ||
| 担当者 | UID | ユーザーのID。 | |
| タイプ | 割り当てられたユーザーのタイプ | ||
| リストサイズ | 割り当てられたユーザー数 | ||
| ウォッチャー | UID | ユーザーのID。 | |
| タイプ | 割り当てられたユーザーのタイプ | ||
| リストサイズ | 割り当てられたユーザー数 | ||
| 場所 | PlanGridで指定されているタスクの場所。 | ||
| 開始日 | PlanGridでタスクの開始として設定されている時刻のタイムスタンプ。 | ||
| 期限日時 | PlanGridでタスクの期限となっている時刻のタイムスタンプ。 | ||
| クローズ日時 | PlanGridでタスクがクローズされた時刻のタイムスタンプ。 タスクがクローズされた後にのみ使用できます。 | ||
| スタンプ | PlanGridで選択されたタスクスタンプ。 | ||
| タスクリスト | タスクリストID | タスクリストのID。 | |
| URL | PlanGrid内のタスクリストにアクセスするためのURL。 | ||
| 説明 | タスクの説明。 | ||
| コストへの影響 | このタスクの結果としてプロジェクトに与えるコストへの影響を示す数値。 | ||
| コストへの影響あり | タスクにコストへの影響があるかどうかを示します。 | ||
| 通貨コード | コストへの影響の通貨。 | ||
| スケジュールへの影響 | このタスクがプロジェクトスケジュールに影響している時間(秒)。 | ||
| スケジュールへの影響あり | タスクにスケジュールへの影響があるかどうかを示します。 | ||
| 現在の注釈 | UID | PlanGrid内の注釈のID | |
| 色 | PlanGridで注釈に割り当てられた色。 | ||
| スタンプ | PlanGridで注釈に割り当てられたスタンプ(存在する場合) | ||
| 表示設定 | 注釈の表示レベル。 “user”または“master”のいずれかです。 Userは、ワークスペースメンバー(または元ワークスペースメンバー)が注釈をプロジェクトに公開していないことを示します。 空白になることはありません。 | ||
| 削除済み | 注釈がPlanGridで削除されているかどうかを示します。 | ||
| シート | UID | シートのID。 | |
| URL | PlanGrid内のシートにアクセスするためのURL。 | ||
| コメント | 合計数 | タスク上のコメントの合計数。 | |
| URL | PlanGrid内のタスク上のコメントにアクセスするためのURL。 | ||
| 写真 | 合計数 | タスクに関連付けられている写真の合計数。 | |
| URL | PlanGrid内のタスク上の写真にアクセスするためのURL。 | ||
| 削除済み | このタスクがPlanGridで削除されているかどうかを示します。 | ||
| 作成日時 | タスクがPlanGridで作成された時刻のタイムスタンプ。 | ||
| 作成者 | UID | ユーザーのID。 | |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 | ||
| メール | PlanGrid内のユーザーのメールアドレス。 | ||
| 更新日時 | PlanGridでタスクが最後に更新された時刻のタイムスタンプ。 | ||
| 更新者 | UID | ユーザーのID。 | |
| URL | PlanGrid内のユーザープロファイルにアクセスするためのURL。 | ||
| メール | PlanGrid内のユーザーのメールアドレス。 | ||
ユーザー
Workatoでは、PlanGridコネクターを使用してPlanGrid内のユーザーの作成または詳細取得を行えます。 オブジェクトタイプuserを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。
以下では、Workatoにおけるユーザーのオブジェクト表現について説明します。
ユーザーの表現
| フィールド名 | 説明 |
|---|---|
| メール | PlanGrid内のユーザーのメールアドレス |
| プロジェクトID | ユーザーが属するプロジェクトのID。 |
| ロールID | このプロジェクトでユーザーに割り当てるロールのID |
| 名 | ユーザーの名 |
| 姓 | ユーザーの姓 |
| 言語 | ユーザーの母語 |
ロール
Workatoでは、PlanGridコネクターを使用してPlanGrid内のロールの詳細を取得できます。 オブジェクトタイプroleを選択すると、選択したアクションタイプに基づいてフィールドが動的に生成されます。
以下では、Workatoにおけるロールのオブジェクト表現について説明します。
ロールの表現
| フィールド名 | 説明 |
|---|---|
| UID | ロールのID |
| ロール | プロジェクト内のロール |
| プロジェクトID | プロジェクトのID |
Last updated: