次の方法で共有


Fulcrum (プレビュー)

Fulcrum は、GIS エキスパートと GIS 以外のチーム メンバーの両方が地理空間データを簡単にキャプチャして共有できるようにする、フィールドファーストのソリューションです。 このコネクタを使用すると、フィールド データ、写真、ビデオなどを管理するための Fulcrum との統合が可能になります。

このコネクタは、次の製品とリージョンで使用できます。

Service クラス リージョン
Copilot Studio Premium 次を除くすべてのPower Automateリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - 中国リージョンAzure
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべてのPower Appsリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate Premium 次を除くすべてのPower Automateリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 Fulcrum のサポート
URL https://www.fulcrumapp.com/support
Email support@fulcrumapp.com
コネクタ メタデータ
発行者 Spatial Networks, Inc.
Website https://www.fulcrumapp.com
プライバシー ポリシー https://www.fulcrumapp.com/privacy
カテゴリ 生産性;データ

Fulcrum

Fulcrum は、GIS エキスパートと GIS 以外のチーム メンバーの両方が地理空間データを簡単にキャプチャして共有できるようにする、フィールドファーストのソリューションです。 このコネクタを使用すると、フィールド データ、写真、ビデオなどを管理するための Fulcrum との統合が可能になります。

発行者

Fulcrum

[前提条件]

  • API アクセスが有効になっているアクティブな Fulcrum サブスクリプション

サポートされている操作

トリガー (条件や動作を引き起こすもの)

Fulcrum イベントが発生した場合

Fulcrum リソースが作成、更新、または削除されたときにトリガーされます。 レコード、フォーム、選択肢リスト、分類セットのイベントをサポートします。 Fulcrum 組織で Webhook を構成して、監視するイベントを指定します。

アクション

添付ファイルのメタデータの一覧を取得する

添付ファイルの一覧を取得します。

添付ファイルを取得する

1 つの添付ファイルのメタデータを取得します。

オーディオ メタデータの一覧を取得する

オーディオ ファイルの一覧のメタデータを取得します。

オーディオの元のファイルを取得する

元のオーディオ ファイルをダウンロードします。

写真のメタデータの一覧を取得する

写真の一覧のメタデータを取得します。

写真の元のファイルを取得する

元の写真ファイルをダウンロードします。

写真のメタデータを取得する

1 枚の写真のメタデータを取得します。

クエリ POST 要求を行う

HTTP POST を使用してクエリ API 要求を実行します。 組織のデータに対してクエリを実行するための SQL のようなクエリを提供します。

レコードの一覧を取得する

フォーム、プロジェクト、変更セット、境界ボックス、日付範囲などのディメンションでフィルター処理できるレコードの一覧を組織から取得します。

レコードを作成する

指定したフォーム値、場所情報、および関連するメタデータを使用して、指定したフォームに新しいレコードを作成します。

レコードの削除

組織からレコードを削除します。

レコードの取得

特定のレコードに関する詳細情報を ID で取得します。 これには、すべてのフォーム フィールド値、場所データ、タイムスタンプ、および関連するメタデータが含まれます。

レコードを部分的に更新する

レコード オブジェクト全体を必要とせずに、既存のレコードの特定のフィールドを更新します。 要求本文に含まれるフィールドのみが変更されますが、他のすべてのフィールドは変更されません。 これは、個々のフィールド値またはメタデータを更新する場合に便利です。

レコードを更新する

指定されたレコード オブジェクトを使用してレコードを更新します。 レコード オブジェクトは、レコードの完全な表現である必要があります。 含まれていないフィールドは null と見なされます。

レコードの履歴を取得する

レコードの完全なバージョン履歴を取得します。

レポートを作成する

必要に応じて、レポート テンプレートを使用して、特定のレコードの新しいレポートを生成します。

レポート ファイルを取得する

生成された PDF レポート ファイルをダウンロードします。

署名メタデータの一覧を取得する

署名の一覧のメタデータを取得します。

署名メタデータを取得する

1 つの署名のメタデータを取得します。

署名元のファイルを取得する

元の署名ファイルをダウンロードします。

スケッチ メタデータの一覧を取得する

スケッチの一覧のメタデータを取得します。

スケッチ元のファイルを取得する

元のスケッチ ファイルをダウンロードします。

スケッチ メタデータを取得する

1 つのスケッチのメタデータを取得します。

ビデオ メタデータの一覧を取得する

ビデオの一覧のメタデータを取得します。

ビデオの元のファイルを取得する

元のビデオ ファイルをダウンロードします。

資格情報の取得

Fulcrum コネクタを使用するには、Fulcrum API トークンが必要です。

  1. で Fulcrum アカウントにログインします。 https://web.fulcrumapp.com
  2. [設定] > API に移動します
  3. 新しい API トークンを生成するか、既存の API トークンを使用する
  4. トークンをコピーし、接続の作成時に使用する

はじめに

新しい接続を作成し、プロンプトが表示されたら Fulcrum API トークンを入力します。

カスタム ホスト URL

既定では、コネクタは api.fulcrumapp.com で実稼働 Fulcrum API を使用します。 他のリージョンでは、接続の作成時に別のホスト URL を指定できます。

リージョン エンドポイント:

  • United States (既定値): api.fulcrumapp.com
  • カナダ: api.fulcrumapp-ca.com
  • オーストラリア: api.fulcrumapp-au.com
  • ヨーロッパ: api.fulcrumapp-eu.com

形式: プロトコルまたはパスのないホスト名のみを入力します。 コネクタでは、HTTPS と正しい API パスが自動的に使用されます。

トラブルシューティング:

  • カスタム ホストにネットワークからアクセスできることを確認する
  • ホスト名が正しいことを確認する (入力ミスなし)
  • 指定したホストに対して API トークンが有効であることを確認する

既知の問題と制限事項

  • 料金制限は、Fulcrum プランに基づいて適用されます

デプロイ手順

これらの手順を使用して、このコネクタを Microsoft Power Automate および Power Apps のカスタム コネクタとしてデプロイしてください。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前 タイプ 説明 必須
API トークン securestring 認証用の Fulcrum API トークン 正しい
ホスト URL 文字列 Fulcrum インスタンスの API ホスト

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

オーディオ メタデータの一覧を取得する

オーディオ ファイルの一覧のメタデータを取得します。

オーディオの元のファイルを取得する

元のオーディオ ファイルをダウンロードします。

クエリ POST 要求を行う

HTTP POST を使用してクエリ API 要求を実行します。 組織のデータに対してクエリを実行するための SQL のようなクエリを提供します。

スケッチ メタデータの一覧を取得する

スケッチの一覧のメタデータを取得します。

スケッチ メタデータを取得する

1 つのスケッチのメタデータを取得します。

スケッチ元のファイルを取得する

元のスケッチ ファイルをダウンロードします。

ビデオ メタデータの一覧を取得する

ビデオの一覧のメタデータを取得します。

ビデオの元のファイルを取得する

元のビデオ ファイルをダウンロードします。

レコードの一覧を取得する

フォーム、プロジェクト、変更セット、境界ボックス、日付範囲などのディメンションでフィルター処理できるレコードの一覧を組織から取得します。

レコードの削除

組織からレコードを削除します。

レコードの取得

特定のレコードに関する詳細情報を ID で取得します。 これには、すべてのフォーム フィールド値、場所データ、タイムスタンプ、および関連するメタデータが含まれます。

レコードの履歴を取得する

レコードの完全なバージョン履歴を取得します。

レコードを作成する

指定したフォーム値、場所情報、および関連するメタデータを使用して、指定したフォームに新しいレコードを作成します。

レコードを更新する

指定されたレコード オブジェクトを使用してレコードを更新します。 レコード オブジェクトは、レコードの完全な表現である必要があります。 含まれていないフィールドは null と見なされます。

レコードを部分的に更新する

レコード オブジェクト全体を必要とせずに、既存のレコードの特定のフィールドを更新します。 要求本文に含まれるフィールドのみが変更されますが、他のすべてのフィールドは変更されません。 これは、個々のフィールド値またはメタデータを更新する場合に便利です。

レポート ファイルを取得する

生成された PDF レポート ファイルをダウンロードします。

レポートを作成する

必要に応じて、レポート テンプレートを使用して、特定のレコードの新しいレポートを生成します。

写真のメタデータの一覧を取得する

写真の一覧のメタデータを取得します。

写真のメタデータを取得する

1 枚の写真のメタデータを取得します。

写真の元のファイルを取得する

元の写真ファイルをダウンロードします。

添付ファイルのメタデータの一覧を取得する

添付ファイルの一覧を取得します。

添付ファイルを取得する

1 つの添付ファイルのメタデータを取得します。

署名メタデータの一覧を取得する

署名の一覧のメタデータを取得します。

署名メタデータを取得する

1 つの署名のメタデータを取得します。

署名元のファイルを取得する

元の署名ファイルをダウンロードします。

オーディオ メタデータの一覧を取得する

オーディオ ファイルの一覧のメタデータを取得します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id string

オーディオ ファイルが関連付けられているレコードの ID。

フォーム ID
form_id string

オーディオ ファイルが関連付けられているフォームの ID。 これを空白のままにすると、すべてのオーディオ ファイルに対してクエリが実行されます。

最新の最初
newest_first boolean

存在する場合、オーディオ ファイルは日付updated_at並べ替えられます。

処理済
processed boolean

完全に処理されたオーディオ ファイルをフィルター処理します。

保管済み
stored boolean

完全に保存されたオーディオ ファイルをフィルター処理します。

アップロード
uploaded boolean

完全にアップロードされたオーディオ ファイルをフィルター処理します。

ページ
page integer

要求されたページ番号。

ページごと
per_page integer

ページごとに返される項目の数。

戻り値

オーディオの元のファイルを取得する

元のオーディオ ファイルをダウンロードします。

パラメーター

名前 キー 必須 説明
オーディオ ID
audio_id True string

オーディオ ファイルの一意識別子。

戻り値

response
binary

クエリ POST 要求を行う

HTTP POST を使用してクエリ API 要求を実行します。 組織のデータに対してクエリを実行するための SQL のようなクエリを提供します。

パラメーター

名前 キー 必須 説明
ページ
page integer

要求されたページ番号。

ページごと
per_page integer

ページごとに返される項目の数。

format
format string

応答形式

q
q True string

実行する SQL クエリ

テーブル名
table_name string

クエリを実行するテーブルの名前

スケッチ メタデータの一覧を取得する

スケッチの一覧のメタデータを取得します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id string

スケッチが関連付けられているレコードの ID。

フォーム ID
form_id string

スケッチが関連付けられているフォームの ID。 この空白のままにすると、すべてのスケッチに対してクエリが実行されます。

最新の最初
newest_first boolean

存在する場合、スケッチは日付updated_at並べ替えられます。

処理済
processed boolean

スケッチは完全に処理されました。

保管済み
stored boolean

スケッチは完全に保存されています。

アップロード
uploaded boolean

スケッチが完全にアップロードされました。

ページ
page integer

要求されたページ番号

ページごと
per_page integer

1 ページあたりのアイテム数

戻り値

スケッチ メタデータを取得する

1 つのスケッチのメタデータを取得します。

パラメーター

名前 キー 必須 説明
スケッチ ID
sketch_id True string

スケッチ ID

戻り値

スケッチ元のファイルを取得する

元のスケッチ ファイルをダウンロードします。

パラメーター

名前 キー 必須 説明
スケッチ ID
sketch_id True string

スケッチ ID

戻り値

response
binary

ビデオ メタデータの一覧を取得する

ビデオの一覧のメタデータを取得します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id string

ビデオが関連付けられているレコードの ID。

フォーム ID
form_id string

ビデオが関連付けられているフォームの ID。 これを空白のままにすると、すべてのビデオに対してクエリが実行されます。

最新の最初
newest_first boolean

存在する場合、ビデオはupdated_at日付で並べ替えられます。

処理済
processed boolean

完全に処理されたビデオをフィルター処理します。

保管済み
stored boolean

完全に保存されたビデオをフィルター処理します。

アップロード
uploaded boolean

完全にアップロードされたビデオをフィルター処理します。

ページ
page integer

要求されたページ番号。

ページごと
per_page integer

ページごとに返される項目の数。

戻り値

ビデオの元のファイルを取得する

元のビデオ ファイルをダウンロードします。

パラメーター

名前 キー 必須 説明
ビデオ ID
video_id True string

ビデオの一意識別子。

戻り値

response
binary

レコードの一覧を取得する

フォーム、プロジェクト、変更セット、境界ボックス、日付範囲などのディメンションでフィルター処理できるレコードの一覧を組織から取得します。

パラメーター

名前 キー 必須 説明
最新の最初
newest_first boolean

存在する場合、レコードは日付updated_at並べ替えられます。

境界ボックス
bounding_box string

要求されたレコードの境界ボックス。 形式は、lat、long、lat、long (下、左、上、右) にする必要があります。

Changeset Id
changeset_id string

レコードに関連付けられている変更セットの ID。

フォーム ID
form_id string

レコードが関連付けられているフォームの ID。 この値を空白のままにすると、すべてのレコードに対してクエリが実行されます。

プロジェクト ID
project_id string

レコードが関連付けられているプロジェクトの ID。 この値を空白のままにすると、すべてのレコードに対してクエリが実行されます。

以前に作成されたクライアント
client_created_before date-time

指定された時刻より前にクライアント (デバイス) によって作成されたレコードのみを返します。

以降に作成されたクライアント
client_created_since date-time

指定された時刻より後にクライアント (デバイス) によって作成されたレコードのみを返します。

以前に更新されたクライアント
client_updated_before date-time

指定された時刻より前にクライアント (デバイス) によって更新されたレコードのみを返します。

以降に更新されたクライアント
client_updated_since date-time

指定された時刻より後にクライアント (デバイス) によって更新されたレコードのみを返します。

以前に作成済み
created_before date-time

指定された時刻より前に (サーバー上で) 作成されたレコードのみを返します。

作成以降
created_since date-time

指定された時刻より後に (サーバー上で) 作成されたレコードのみを返します。

更新前
updated_before date-time

指定された時刻より前に (サーバー上で) 更新されたレコードのみを返します。

以降の更新
updated_since date-time

指定された時刻より後に (サーバー上で) 更新されたレコードのみを返します。

ページ
page integer

要求されたページ番号

ページごと
per_page integer

1 ページあたりのアイテム数

戻り値

レコードの削除

組織からレコードを削除します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id True string

削除するレコードの一意識別子。

X Skipworkflows
X-SkipWorkflows boolean

すべてのアプリ ワークフローをスキップします

X Skipwebhooks
X-SkipWebhooks boolean

すべてのアプリ Webhook をスキップします

戻り値

レコードの取得

特定のレコードに関する詳細情報を ID で取得します。 これには、すべてのフォーム フィールド値、場所データ、タイムスタンプ、および関連するメタデータが含まれます。

パラメーター

名前 キー 必須 説明
レコード ID
record_id True string

取得するレコードの一意識別子。

戻り値

レコードの履歴を取得する

レコードの完全なバージョン履歴を取得します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id True string

履歴を取得するレコードの一意識別子。

戻り値

レコードを作成する

指定したフォーム値、場所情報、および関連するメタデータを使用して、指定したフォームに新しいレコードを作成します。

パラメーター

名前 キー 必須 説明
コンテンツ タイプ
Content-Type string

コンテンツ タイプ

X Skipworkflows
X-SkipWorkflows boolean

すべてのアプリ ワークフローをスキップします

X Skipwebhooks
X-SkipWebhooks boolean

すべてのアプリ Webhook をスキップします

assigned_to_id
assigned_to_id string

このレコードに割り当てられているユーザーの ID

form_id
form_id True string

このレコードが属するフォームの ID

form_values
form_values object

フィールド キーでキーが設定されたフィールド値

coordinates
coordinates True

ジオメトリの座標。 形式は種類によって異なります。Point は [経度、緯度] を使用し、LineString は位置の配列を使用し、Polygon は線形リングの配列 (最初は外部、残りは穴)、Multi* 型はそれぞれの座標構造の配列を使用します。

type True string

GeoJSON geometry type

緯度
latitude number

緯度座標

経度
longitude number

経度座標

project_id
project_id string

プロジェクトの ID

状態
status string

レコードの状態

戻り値

レコードを更新する

指定されたレコード オブジェクトを使用してレコードを更新します。 レコード オブジェクトは、レコードの完全な表現である必要があります。 含まれていないフィールドは null と見なされます。

パラメーター

名前 キー 必須 説明
コンテンツ タイプ
Content-Type string

コンテンツ タイプ

レコード ID
record_id True string

レコード ID

X Skipworkflows
X-SkipWorkflows boolean

すべてのアプリ ワークフローをスキップします

X Skipwebhooks
X-SkipWebhooks boolean

すべてのアプリ Webhook をスキップします

assigned_to_id
assigned_to_id string

このレコードに割り当てられているユーザーの ID

form_id
form_id True string

このレコードが属するフォームの ID

form_values
form_values object

フィールド キーでキーが設定されたフィールド値

coordinates
coordinates True

ジオメトリの座標。 形式は種類によって異なります。Point は [経度、緯度] を使用し、LineString は位置の配列を使用し、Polygon は線形リングの配列 (最初は外部、残りは穴)、Multi* 型はそれぞれの座標構造の配列を使用します。

type True string

GeoJSON geometry type

緯度
latitude number

緯度座標

経度
longitude number

経度座標

project_id
project_id string

プロジェクトの ID

状態
status string

レコードの状態

レコードを部分的に更新する

レコード オブジェクト全体を必要とせずに、既存のレコードの特定のフィールドを更新します。 要求本文に含まれるフィールドのみが変更されますが、他のすべてのフィールドは変更されません。 これは、個々のフィールド値またはメタデータを更新する場合に便利です。

パラメーター

名前 キー 必須 説明
コンテンツ タイプ
Content-Type string

コンテンツ タイプ

レコード ID
record_id True string

レコード ID

X Skipworkflows
X-SkipWorkflows boolean

すべてのアプリ ワークフローをスキップします

X Skipwebhooks
X-SkipWebhooks boolean

すべてのアプリ Webhook をスキップします

assigned_to_id
assigned_to_id string

このレコードに割り当てられているユーザーの ID

form_values
form_values object

フィールド キーでキーが設定されたフィールド値

coordinates
coordinates True

ジオメトリの座標。 形式は種類によって異なります。Point は [経度、緯度] を使用し、LineString は位置の配列を使用し、Polygon は線形リングの配列 (最初は外部、残りは穴)、Multi* 型はそれぞれの座標構造の配列を使用します。

type True string

GeoJSON geometry type

緯度
latitude number

緯度座標

経度
longitude number

経度座標

project_id
project_id string

プロジェクトの ID

状態
status string

レコードの状態

戻り値

レポート ファイルを取得する

生成された PDF レポート ファイルをダウンロードします。

パラメーター

名前 キー 必須 説明
レポート ID
report_id True uuid

レポートの一意識別子。

戻り値

response
binary

レポートを作成する

必要に応じて、レポート テンプレートを使用して、特定のレコードの新しいレポートを生成します。

パラメーター

名前 キー 必須 説明
record_id
record_id True uuid

レポートを生成するレコードの ID

template_id
template_id uuid

使用するレポート テンプレートの ID (省略可能)

戻り値

写真のメタデータの一覧を取得する

写真の一覧のメタデータを取得します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id string

写真が関連付けられているレコードの ID。

フォーム ID
form_id string

写真が関連付けられているフォームの ID。 空白のままにすると、すべての写真に対してクエリが実行されます。

最新の最初
newest_first boolean

存在する場合、写真は日付updated_at順に並べ替えられます。

処理済
processed boolean

完全に処理された写真をフィルター処理します。

保管済み
stored boolean

完全に保存された写真をフィルター処理します。

アップロード
uploaded boolean

完全にアップロードされた写真をフィルター処理します。

ページ
page integer

要求されたページ番号。

ページごと
per_page integer

ページごとに返される項目の数。

戻り値

写真のメタデータを取得する

1 枚の写真のメタデータを取得します。

パラメーター

名前 キー 必須 説明
写真 ID
photo_id True string

写真の一意識別子。

戻り値

写真の元のファイルを取得する

元の写真ファイルをダウンロードします。

パラメーター

名前 キー 必須 説明
写真 ID
photo_id True string

写真の一意識別子。

戻り値

response
binary

添付ファイルのメタデータの一覧を取得する

添付ファイルの一覧を取得します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id string

添付ファイルが関連付けられているレコードの ID。 これは、レコードの添付ファイルを一覧表示するときに必要です。

フォーム ID
form_id string

添付ファイルが関連付けられているフォームの ID。 このパラメーターを使用すると、フォーム内のすべての参照ファイルを取得できます。フォーム内のすべてのレコード添付ファイルを取得することはできません

所有者の種類
owner_type string

クエリを実行する添付ファイルの種類。 formまたはrecordである必要があります。

並べ替え
sort string

結果を並べ替えるフィールド。

並べ替えの方向
sort_direction string

並べ替えの方向 (asc、desc)。 既定値は asc です。

戻り値

添付ファイルを取得する

1 つの添付ファイルのメタデータを取得します。

パラメーター

名前 キー 必須 説明
添付ファイル ID
attachment_id True string

添付ファイルの一意識別子。

戻り値

Body
Attachment

署名メタデータの一覧を取得する

署名の一覧のメタデータを取得します。

パラメーター

名前 キー 必須 説明
レコード ID
record_id string

写真が関連付けられているレコードの ID。

フォーム ID
form_id string

写真が関連付けられているフォームの ID。 空白のままにすると、すべての写真に対してクエリが実行されます。

最新の最初
newest_first boolean

存在する場合、写真は日付updated_at順に並べ替えられます。

処理済
processed boolean

完全に処理された署名をフィルター処理します。

保管済み
stored boolean

完全に格納されている署名をフィルター処理します。

アップロード
uploaded boolean

完全にアップロードされた署名をフィルター処理します。

ページ
page integer

要求されたページ番号。

ページごと
per_page integer

ページごとに返される項目の数。

戻り値

署名メタデータを取得する

1 つの署名のメタデータを取得します。

パラメーター

名前 キー 必須 説明
署名 ID
signature_id True string

署名の一意識別子。

戻り値

署名元のファイルを取得する

元の署名ファイルをダウンロードします。

パラメーター

名前 キー 必須 説明
署名 ID
signature_id True string

署名の一意識別子。

戻り値

response
binary

トリガー

Fulcrum イベントが発生した場合

Fulcrum リソースが作成、更新、または削除されたときにトリガーされます。 レコード、フォーム、選択肢リスト、分類セットのイベントをサポートします。 Fulcrum 組織で Webhook を構成して、監視するイベントを指定します。

Fulcrum イベントが発生した場合

Fulcrum リソースが作成、更新、または削除されたときにトリガーされます。 レコード、フォーム、選択肢リスト、分類セットのイベントをサポートします。 Fulcrum 組織で Webhook を構成して、監視するイベントを指定します。

パラメーター

名前 キー 必須 説明
コンテンツ タイプ
Content-Type string

コンテンツ タイプ

活動中
active boolean

Webhook が有効になっているかどうか

Webhook 名
name True string

Webhook の表示名

run_for_bulk_actions
run_for_bulk_actions boolean

Webhook が一括レコード アクションに対して実行されるかどうか

戻り値

Fulcrum からの Webhook イベント ペイロード

定義

添付ファイル

名前 パス 説明
attached_to_id
attached_to_id string

この添付ファイルがアタッチされているリソースの ID

attached_to_type
attached_to_type string

この添付ファイルがアタッチされているリソースの種類

complete
complete boolean

添付ファイルのアップロードが完了したかどうか

file_size
file_size integer

添付ファイルのサイズ (バイト単位)

id
id string

添付ファイルの一意識別子

名前
name string

添付ファイルのファイル名

owners
owners array of object

添付ファイルの所有者参照の一覧

id
owners.id string

所有者の ID

owners.type string

所有者の種類 ("レコード" や "フォーム" など)

状態
status string

添付ファイルの状態

uploaded_at
uploaded_at date-time

添付ファイルがアップロードされたときのタイムスタンプ

url
url uri

添付ファイルにアクセスするための URL

AttachmentsResponse

名前 パス 説明
attachments
attachments array of Attachment
トータル
total integer

返された添付ファイルの合計数

total_count
total_count integer

使用可能な添付ファイルの合計数

オーディオ

名前 パス 説明
access_key
access_key string

オーディオ リソースの一意識別子

content_type
content_type string

オーディオ ファイルの MIME の種類

作成日時
created_at date-time

オーディオが作成されたときのタイムスタンプ

created_by
created_by string

オーディオを作成したユーザーの表示名

created_by_id
created_by_id string

オーディオを作成したユーザーの ID

deleted_at
deleted_at date-time

オーディオが削除されたときのタイムスタンプ

file_size
file_size integer

オーディオ ファイルのサイズ (バイト単位)

form_id
form_id string

関連付けられているフォームの ID

中間
medium uri

オーディオの中バージョンへの URL (処理されている場合)

メタデータ
metadata object

オーディオ メタデータ (期間、形式の詳細など)

original
original uri

元のオーディオ ファイルの URL (保存されている場合)

処理済
processed boolean

オーディオが処理されたかどうか

record_id
record_id string

関連付けられているレコードの ID

小さい
small uri

オーディオの小さいバージョンへの URL (処理されている場合)

状態
status string

オーディオの処理状態

格納
stored boolean

オーディオが保存されているかどうか

トラック
track uri

オーディオ トラックにアクセスするための URL (使用可能な場合)

updated_at
updated_at date-time

オーディオが最後に更新されたときのタイムスタンプ

updated_by
updated_by string

オーディオを最後に更新したユーザーの表示名

updated_by_id
updated_by_id string

オーディオを最後に更新したユーザーの ID

アップロード
uploaded boolean

オーディオがアップロードされたかどうか

url
url uri

オーディオ リソースにアクセスするための URL

AudiosResponse

名前 パス 説明
audio
audio array of Audio
current_page
current_page integer
per_page
per_page integer
total_count
total_count integer
total_pages
total_pages integer

AuditLocation

作成時または更新時にキャプチャされた場所メタデータ。

名前 パス 説明
高度
altitude double

メートル単位の高度。

horizontal_accuracy
horizontal_accuracy double

水平方向の精度 (メートル単位)。

緯度
latitude double

緯度座標。

経度
longitude double

経度座標。

ジオメトリ

名前 パス 説明
coordinates
coordinates

ジオメトリの座標。 形式は種類によって異なります。Point は [経度、緯度] を使用し、LineString は位置の配列を使用し、Polygon は線形リングの配列 (最初は外部、残りは穴)、Multi* 型はそれぞれの座標構造の配列を使用します。

type string

GeoJSON geometry type

写真

名前 パス 説明
access_key
access_key string

写真の一意識別子

content_type
content_type string

写真の MIME の種類

作成日時
created_at date-time

写真が作成されたとき

created_by
created_by string

写真を作成したユーザーの表示名

created_by_id
created_by_id string

写真を作成したユーザーの ID

deleted_at
deleted_at date-time

写真が削除されたとき

exif
exif object

写真からの EXIF メタデータ

file_size
file_size integer

写真ファイルのサイズ (バイト単位)

form_id
form_id string

関連付けられているフォームの ID

large uri

大きなバージョンの写真への URL

緯度
latitude double

写真が撮影された緯度座標

経度
longitude double

写真が撮影された経度座標

original
original uri

写真の元のバージョンへの URL

処理済
processed boolean

写真が処理されたかどうか

record_id
record_id string

関連付けられているレコードの ID

格納
stored boolean

写真が保存されているかどうか

サムネイル
thumbnail uri

写真のサムネイル バージョンへの URL

updated_at
updated_at date-time

写真が最後に更新されたとき

updated_by
updated_by string

写真を最後に更新したユーザーの表示名

updated_by_id
updated_by_id string

写真を最後に更新したユーザーの ID

アップロード
uploaded boolean

写真がアップロードされたかどうか

url
url uri

この写真リソースの API URL

PhotosResponse

名前 パス 説明
current_page
current_page integer
per_page
per_page integer
photos
photos array of Photo
total_count
total_count integer
total_pages
total_pages integer

Record

名前 パス 説明
高度
altitude number
assigned_to
assigned_to string
assigned_to_id
assigned_to_id string
client_created_at
client_created_at date-time
client_updated_at
client_updated_at date-time
コース
course number
作成日時
created_at date-time
created_by
created_by string
created_by_id
created_by_id string
created_duration
created_duration number
created_location
created_location AuditLocation

作成時または更新時にキャプチャされた場所メタデータ。

edited_duration
edited_duration number
form_id
form_id string
form_values
form_values object

フィールド キーでキーを設定するフィールド値 - フィールドの種類に応じて、文字列、オブジェクト、または配列を指定できます

geometry
geometry Geometry
horizontal_accuracy
horizontal_accuracy number
id
id string
緯度
latitude number
経度
longitude number
project_id
project_id string
record_series_id
record_series_id string
speed
speed number
状態
status string
system_status
system_status string
updated_at
updated_at date-time
updated_by
updated_by string
updated_by_id
updated_by_id string
updated_duration
updated_duration number
updated_location
updated_location AuditLocation

作成時または更新時にキャプチャされた場所メタデータ。

バージョン
version integer
vertical_accuracy
vertical_accuracy number

RecordHistoryItem

名前 パス 説明
高度
altitude double

場所の高度をメートル単位で記録する

assigned_to
assigned_to string

割り当てられたユーザーの表示名

assigned_to_id
assigned_to_id string

割り当てられたユーザーの ID

changeset_id
changeset_id string

Changeset ID

client_created_at
client_created_at date-time

クライアント側の作成タイムスタンプ

client_updated_at
client_updated_at date-time

クライアント側の更新タイムスタンプ

コース
course double

コース/見出し (度単位)

作成日時
created_at date-time

レコード作成のタイムスタンプ

created_by
created_by string

レコードを作成したユーザーの表示名

created_by_id
created_by_id string

レコードを作成したユーザーの ID

created_duration
created_duration integer

レコードの作成期間 (秒単位)

created_location
created_location AuditLocation

作成時または更新時にキャプチャされた場所メタデータ。

edited_duration
edited_duration integer

合計編集時間 (秒)

form_id
form_id string

フォーム ID

form_values
form_values object

フォーム フィールドの値 (処理済み)

form_version
form_version integer

レコードの作成/更新時のフォーム バージョン

coordinates
geometry.coordinates array of number
geometry.type string
history_change_type
history_change_type string

変更の種類 (c=create、u=update、d=delete)

history_changed_by
history_changed_by string

この変更を行ったユーザーの表示名

history_changed_by_id
history_changed_by_id string

この変更を行ったユーザーの ID

history_created_at
history_created_at date-time

この履歴エントリが作成されたときのタイムスタンプ

history_id
history_id string

履歴エントリ ID

horizontal_accuracy
horizontal_accuracy double

メートル単位の水平精度

id
id string

レコード ID

緯度
latitude double

レコードの場所の緯度

経度
longitude double

レコードの場所の経度

project_id
project_id string

プロジェクト ID

record_key
record_key string

省略可能なレコード キー

record_sequence
record_sequence integer

省略可能なレコード シーケンス番号

シーケンス
sequence integer

シーケンス番号 (シーケンスベースの改ページ位置を使用する場合)

speed
speed double

レコード作成時の速度 (m/秒)

状態
status string

レコードの状態

updated_at
updated_at date-time

最後の更新タイムスタンプを記録する

updated_by
updated_by string

レコードを最後に更新したユーザーの表示名

updated_by_id
updated_by_id string

レコードを最後に更新したユーザーの ID

updated_duration
updated_duration integer

レコードの更新期間 (秒単位)

updated_location
updated_location AuditLocation

作成時または更新時にキャプチャされた場所メタデータ。

バージョン
version integer

レコードのバージョン番号

vertical_accuracy
vertical_accuracy double

メートルの縦の正確さ

RecordHistoryResponse

名前 パス 説明
current_page
current_page integer

現在のページ番号 (改ページを使用する場合)

next_sequence
next_sequence integer

次のシーケンス番号 (シーケンス ベースの改ページ位置を使用する場合)

per_page
per_page integer

ページあたりのレコード数 (改ページを使用する場合)

records array of RecordHistoryItem
total_count
total_count integer

レコードの合計数 (改ページ位置を使用する場合)

total_pages
total_pages integer

ページの合計数 (改ページを使用する場合)

RecordsResponse

名前 パス 説明
current_page
current_page integer
per_page
per_page integer
records array of Record
total_count
total_count integer
total_pages
total_pages integer

ReportResponse

名前 パス 説明
完了日時
report.completed_at date-time

レポート生成が完了したときのタイムスタンプ

作成日時
report.created_at date-time

レポートが作成されたときのタイムスタンプ

失敗時点
report.failed_at date-time

レポートの生成に失敗したときのタイムスタンプ (成功した場合は null)

id
report.id uuid

レポートの一意識別子

record_id
report.record_id uuid

レポートが生成されたレコードの ID

started_at
report.started_at date-time

レポート生成の開始時のタイムスタンプ

状態
report.state string

レポートの状態

template_id
report.template_id uuid

レポートの生成に使用するテンプレートの ID

updated_at
report.updated_at date-time

レポートが最後に更新されたときのタイムスタンプ

url
report.url uri

生成されたレポートをダウンロードする URL

署名

名前 パス 説明
access_key
access_key string

署名の一意識別子

content_type
content_type string

署名ファイルの MIME の種類

作成日時
created_at date-time

署名が作成されたときのタイムスタンプ

created_by
created_by string

署名を作成したユーザーの表示名

created_by_id
created_by_id string

署名を作成したユーザーの ID

deleted_at
deleted_at date-time

署名が削除されたときのタイムスタンプ

file_size
file_size integer

署名ファイルのサイズ (バイト単位)

form_id
form_id string

関連付けられているフォームの ID

large uri

署名の大きなバージョンへの URL

original
original uri

元の署名ファイルの URL

処理済
processed boolean

署名が処理されたかどうか

record_id
record_id string

関連付けられているレコードの ID

格納
stored boolean

署名が保存されているかどうか

サムネイル
thumbnail uri

署名のサムネイル バージョンへの URL

updated_at
updated_at date-time

署名が最後に更新されたときのタイムスタンプ

updated_by
updated_by string

署名を最後に更新したユーザーの表示名

updated_by_id
updated_by_id string

署名を最後に更新したユーザーの ID

アップロード
uploaded boolean

署名がアップロードされたかどうか

url
url uri

この署名を取得する API URL

SignaturesResponse

名前 パス 説明
current_page
current_page integer
per_page
per_page integer
署名
signatures array of Signature
total_count
total_count integer
total_pages
total_pages integer

SinglePhotoResponse

名前 パス 説明
photo
photo Photo

SingleRecordResponse

名前 パス 説明
レコード
record Record

SingleSignatureResponse

名前 パス 説明
シグネチャ
signature Signature

SingleSketchResponse

名前 パス 説明
スケッチ
sketch Sketch

概要

名前 パス 説明
access_key
access_key string

スケッチの一意識別子

content_type
content_type string

スケッチ ファイルの MIME の種類

作成日時
created_at date-time

スケッチが作成されたときのタイムスタンプ

created_by
created_by string

スケッチを作成したユーザーの表示名

created_by_id
created_by_id string

スケッチを作成したユーザーの ID

exif
exif object

スケッチからの EXIF メタデータ

file_size
file_size integer

スケッチ ファイルのサイズ (バイト単位)

form_id
form_id string

関連付けられているフォームの ID

large uri

大きなバージョンのスケッチへの URL

中間
medium uri

スケッチの中バージョンへの URL

original
original uri

スケッチの元のバージョンへの URL

処理済
processed boolean

スケッチが処理されたかどうか

record_id
record_id string

関連付けられているレコードの ID

小さい
small uri

スケッチの小さいバージョンへの URL

格納
stored boolean

スケッチが保存されているかどうか

サムネイル
thumbnail uri

スケッチのサムネイル バージョンへの URL

updated_at
updated_at date-time

スケッチが最後に更新されたときのタイムスタンプ

updated_by
updated_by string

スケッチを最後に更新したユーザーの表示名

updated_by_id
updated_by_id string

スケッチを最後に更新したユーザーの ID

アップロード
uploaded boolean

スケッチがアップロードされたかどうか

url
url uri

このスケッチ リソースにアクセスするための API URL

SketchsResponse

名前 パス 説明
current_page
current_page integer
per_page
per_page integer
スケッチ
sketches array of Sketch
total_count
total_count integer
total_pages
total_pages integer

Video

名前 パス 説明
access_key
access_key string

ビデオの一意識別子

content_type
content_type string

ビデオ ファイルの MIME の種類

作成日時
created_at date-time

ビデオが作成されたときのタイムスタンプ

created_by
created_by string

ビデオを作成したユーザーの表示名

created_by_id
created_by_id string

ビデオを作成したユーザーの ID

deleted_at
deleted_at date-time

ビデオが削除されたときのタイムスタンプ

file_size
file_size integer

ビデオ ファイルのサイズ (バイト単位)

form_id
form_id string

関連付けられているフォームの ID

中間
medium uri

ビデオの中バージョンへの URL

メタデータ
metadata object

ビデオに関する追加のメタデータ

original
original uri

元のビデオ ファイルへの URL

処理済
processed boolean

ビデオが処理されたかどうか

record_id
record_id string

関連付けられているレコードの ID

小さい
small uri

小さいバージョンのビデオへの URL

状態
status string

ビデオの処理状態

格納
stored boolean

ビデオが保存されているかどうか

thumbnail_huge
thumbnail_huge uri

巨大なサムネイル画像への URL

thumbnail_huge_square
thumbnail_huge_square uri

巨大な正方形のサムネイル画像への URL

thumbnail_large
thumbnail_large uri

大きなサムネイル画像への URL

thumbnail_large_square
thumbnail_large_square uri

大きな正方形のサムネイル画像への URL

thumbnail_medium
thumbnail_medium uri

中のサムネイル画像への URL

thumbnail_medium_square
thumbnail_medium_square uri

中四角形のサムネイル画像への URL

thumbnail_small
thumbnail_small uri

小さいサムネイル画像への URL

thumbnail_small_square
thumbnail_small_square uri

小さな正方形のサムネイル画像への URL

トラック
track uri

JSON 形式のビデオ トラック データの URL (使用可能な場合)

updated_at
updated_at date-time

ビデオが最後に更新されたときのタイムスタンプ

updated_by
updated_by string

ビデオを最後に更新したユーザーの表示名

updated_by_id
updated_by_id string

ビデオを最後に更新したユーザーの ID

アップロード
uploaded boolean

ビデオがアップロードされたかどうか

url
url uri

このビデオ リソースにアクセスするための API URL

VideosResponse

名前 パス 説明
current_page
current_page integer
per_page
per_page integer
total_count
total_count integer
total_pages
total_pages integer
videos
videos array of Video

FulcrumWebhookPayload

Fulcrum からの Webhook イベント ペイロード

名前 パス 説明
イベント ID
id string

イベントの一意識別子

イベントの種類
type string

イベントの種類 (record.create、record.update、record.delete、form.create、form.update、form.delete、choice_list.create、choice_list.update、choice_list.delete、classification_set.create、classification_set.update、classification_set.delete など)

所有者 ID
owner_id string

この Webhook を所有する組織の ID

イベント データ
data object

イベントに関連付けられているレコードまたはリソース データ

Created At
created_at date-time

イベントが発生したときのタイムスタンプ

binary

これは基本的なデータ型 'バイナリ' です。