WorkSpan
WorkSpan は、パートナーとの収益を計画、実行、促進するためのコラボレーション プラットフォームです。 WorkSpan でパートナー プログラムとパートナー イニシアチブを管理し、内部アプリケーションやパートナー アプリケーションとシームレスに接続します。 CRM、パートナー センター、コラボレーション ツール、生産性ツールを WorkSpan に統合できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (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) |
| お問い合わせ | |
|---|---|
| 名前 | WorkSpan API のサポート |
| URL | https://support.workspan.com |
| api-team@workspan.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | WorkSpan |
| Web サイト | https://www.workspan.com |
| カテゴリ | マーケティング;売上と CRM |
| プライバシー ポリシー | https://www.workspan.com/privacy-policy |
WorkSpan は、パートナーとつながり、パートナー プログラムを管理するためのコラボレーション プラットフォームです。 WorkSpan は、世界をリードするテクノロジ企業の一部のパートナー プログラムを成功に導きます。 人気のあるお好みのアプリケーションを WorkSpan エコシステム クラウドと結び付けて、パートナー エコシステムの力で販売機会の価値を高めます。 WorkSpan Connector を使用すると、Dynamics 365 CRM や Salesforce CRM などの多数のビジネス アプリケーションとシームレスに接続することで、エコシステムとパートナーの動きを強化し、加速させることができます。 ユーザーは、Premier CRM アプリケーションのデータを WorkSpan と同期できます。 ユーザーは、Microsoft Teams、Slack、OneDrive などのコラボレーションアプリケーションや生産性アプリケーションと接続することもできます。 ユーザーは、割り当てられたタスク、オブジェクトに対するコメント、オブジェクトのメンバーシップ関連の発生など、WorkSpan のさまざまなコラボレーション関連イベントの通知を受け取ることができます。 WorkSpan コネクタは、生産性を向上させ、アプリケーション間でデータの整合性を維持し、ビジネス アプリケーション ユーザーにタイムリーなデータと価値を提供します。 その結果、コネクタを使用する組織では、コスト削減、収益の増加、合理化された&加速された販売プロセス、および強化されたレポートが発生します。
[前提条件]
組織は WorkSpan に登録されている会社である必要があります
資格情報を取得する方法
コネクタを使用するには、ユーザーを認証する必要があります。 WorkSpan は、WorkSpan で構成されたアプリケーション ユーザーのコネクタと WorkSpan のデータへのアクセスを提供します。 詳細な手順については、 https://support.workspan.com
既知の問題と制限事項
既知の問題はありません
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| 環境: サンドボックスまたは運用環境 | 文字列 | サンドボックス環境または運用環境 | 正しい |
| アプリケーション ユーザー ID | 文字列 | WorkSpan アプリケーション ユーザーの ID | 正しい |
| アプリケーション ユーザー シークレット | securestring | アプリケーション ユーザー シークレット | 正しい |
| WorkSpan アプリのホスト名。 例: /app.workspan.com を demo.workspan.com する | 文字列 | ホスト名の入力 (https なし) の例: demo.workspan.com/app.workspan.com | 正しい |
| 注記 | 文字列 | 接続に関する注意事項 | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
|
Work |
外部アプリケーションのプライマリ一意識別子を取得する |
|
Work |
WorkSpanObject に監査情報を追加する |
| データの一括読み込み (本文のデータ) |
入力データを要求本文として統合にアップロードします。 使用できる形式は .csv と .json |
| データの一括読み込み (添付ファイル) |
入力ファイルを統合にアップロードします。 使用できる形式は、.xlsx、.json、.csv |
| レポート データの読み取り |
レポート データの読み取り |
| レポートの一覧を取得する |
レポートを一覧表示する |
| 一括読み込み操作の状態を取得する |
一括読み込み操作の状態を取得する |
| 一括読み込み機会 (本文のデータ) |
入力データを要求本文として統合にアップロードします。 使用できる形式は .csv と .json |
| 営業案件の一括読み込み (添付ファイル) |
入力ファイルを統合にアップロードします。 使用できる形式は、.xlsx、.json、.csv |
|
外部 ID を Work |
WorkSpan オブジェクトを外部アプリケーションのプライマリ一意識別子で更新する |
WorkSpan ID の外部 ID を取得する
外部アプリケーションのプライマリ一意識別子を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan オブジェクトのオブジェクト ID (長い ID)
|
object_id | True | string |
WorkSpan オブジェクトのオブジェクト ID (長い ID) |
戻り値
WorkSpan オブジェクトに監査情報を追加する
WorkSpanObject に監査情報を追加する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
field_name
|
field_name | True | string |
WorkSpan の監査フィールドのフィールド名。 |
|
integration_id
|
integration_id | string |
関連する統合の統合 ID (長い ID) |
|
|
external_id
|
external_id | string |
外部システムからの ID (例:CRM Id) |
|
|
status_code
|
status_code | True | string |
監査要求の状態を表すコード。 |
|
メッセージ
|
message | True | string |
監査ログに記録するための追加情報 |
|
WorkSpan オブジェクト ID (長い ID)
|
object_id | True | string |
統合状態で更新される WorkSpan オブジェクトのオブジェクト ID (長い ID) |
戻り値
- Body
- audit_response
データの一括読み込み (本文のデータ)
入力データを要求本文として統合にアップロードします。 使用できる形式は .csv と .json
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan で構成された統合の選択
|
integration_id | True | string |
WorkSpan で構成された CRM 相互運用の統合 ID |
|
データのコンテンツ タイプ。 使用できる形式は .csv と .json
|
data_format | string |
データの形式。 使用できる形式は csv と json です |
|
|
列区切り記号 (content_typeが csv の場合に使用されます)
|
column_delimiter | string |
列区切り記号 (content_typeが csv の場合に使用されます) |
|
|
データのコンテンツ タイプ。 text/csv または application/json。
|
Content-Type | string |
データのコンテンツ タイプ。 text/csv または application/json。 |
|
|
アップロードするデータ
|
bulkload_request |
コンテンツ タイプ 'CSV' の場合: データ行を csv として指定します。 最初の行は列ヘッダーになります。 コンテンツ タイプ 'JSON' の場合、データ形式は配列です: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ] |
戻り値
- Body
- bulkload_response
データの一括読み込み (添付ファイル)
入力ファイルを統合にアップロードします。 使用できる形式は、.xlsx、.json、.csv
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan で構成された統合の選択
|
integration_id | True | string |
WorkSpan で構成されている CRM 相互運用の統合 ID |
|
データの書式設定。 使用できる形式は .csv .xlsx と .json
|
data_format | string |
データの書式設定。 使用できる形式は .csv .xlsx と .json |
|
|
アップロードするファイル
|
file | True | file |
アップロードするファイル |
戻り値
- Body
- bulkload_response
レポート データの読み取り
レポート データの読み取り
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レポート ID
|
reportId | True | integer |
レポート ID |
|
colId
|
colId | string | ||
|
打ち消す
|
negate | boolean | ||
|
オープ
|
op | string | ||
|
型
|
type | string | ||
|
オープ
|
op | string | ||
|
数値
|
number | True | integer | |
|
size
|
size | True | integer |
戻り値
- Body
- ReportDataResponse
レポートの一覧を取得する
レポートを一覧表示する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
数値
|
number | integer |
数値 |
|
|
size
|
size | integer |
size |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string |
id |
|
名前
|
name | string |
名前 |
一括読み込み操作の状態を取得する
一括読み込み操作の状態を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
統合 ID
|
integration_id | True | string |
統合 ID |
|
実行 ID (返された一括読み込みステップ)
|
execution_id | True | string |
一括 API から返される統合実行の実行 ID |
|
エラーがある場合は、応答にエラーを含める
|
include_errors | boolean |
エラーがある場合は、応答にエラーを含める |
|
|
応答で返されるエラーの最大数
|
max_errors | number |
応答で返されるエラーの最大数 |
戻り値
一括読み込み機会 (本文のデータ)
入力データを要求本文として統合にアップロードします。 使用できる形式は .csv と .json
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan で構成された統合の選択
|
integration_id | True | string |
WorkSpan で構成された CRM 相互運用の統合 ID |
|
データのコンテンツ タイプ。 使用できる形式は .csv と .json
|
content_type | string |
データのコンテンツ タイプ。 使用できる形式は .csv と .json |
|
|
列区切り記号 (content_typeが csv の場合に使用されます)
|
column_delimiter | string |
列区切り記号 (content_typeが csv の場合に使用されます) |
|
|
データのコンテンツ タイプ。 text/csv または application/json。
|
Content-Type | string |
データのコンテンツ タイプ。 text/csv または application/json。 |
|
|
アップロードするデータ
|
bulkload_opportunity_request |
コンテンツ タイプ 'CSV' の場合: データ行を csv として指定します。 最初の行は列ヘッダーになります。 コンテンツ タイプ 'JSON' の場合、データ形式は配列です: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ] |
戻り値
営業案件の一括読み込み (添付ファイル)
入力ファイルを統合にアップロードします。 使用できる形式は、.xlsx、.json、.csv
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan で構成された統合の選択
|
integration_id | True | string |
WorkSpan で構成されている CRM 相互運用の統合 ID |
|
データのコンテンツ タイプ。 使用できる形式は .csv .xlsx と .json
|
content_type | string |
データのコンテンツ タイプ。 使用できる形式は .csv .xlsx と .json |
|
|
Excel ファイルにはヘッダー行がありますか?
|
has_header_row | boolean |
Excel ファイルにはヘッダー行がありますか? |
|
|
アップロードするファイル
|
file | True | file |
アップロードするファイル |
戻り値
外部 ID を WorkSpan ID に接続する
WorkSpan オブジェクトを外部アプリケーションのプライマリ一意識別子で更新する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
WorkSpan オブジェクトのオブジェクト ID (長い ID)
|
object_id | True | string |
WorkSpan オブジェクトのオブジェクト ID (長い ID) |
|
field_name
|
field_name | string |
WorkSpan の外部 ID のフィールド名。 空の場合は、外部 ID フィールドの既定のフィールド名が使用されます。 既定のフィールド名: 営業案件オブジェクト: 'sales_details.crm_opportunity_id';Accound オブジェクト: 'account_info.external_account_id' |
|
|
external_id
|
external_id | True | string |
外部システムからの ID (CRM など) |
戻り値
- Body
- external_id_response
トリガー
|
Work |
このトリガーは、WorkSpan ユーザーが Microsoft パートナー センターに営業案件を提出するように求められたときに発生します。 |
|
Work |
パートナーの影響力の可視性を高めるために、営業案件の作成や更新など、さまざまなオブジェクト イベントをサブスクライブする |
|
Work |
メンバーシップ、タスク、コメントの作成や更新など、さまざまなコラボレーション イベントをサブスクライブして、社内およびパートナー ネットワークとのコミュニケーションを促進および強化します。 |
WorkSpan から Microsoft パートナー センターに紹介を送信する
このトリガーは、WorkSpan ユーザーが Microsoft パートナー センターに営業案件を提出するように求められたときに発生します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
イベント サブスクライバーの名前 |
|
WorkSpan で構成された統合の選択
|
integration_id | True | string |
戻り値
WorkSpan オブジェクト イベントのサブスクライブ
パートナーの影響力の可視性を高めるために、営業案件の作成や更新など、さまざまなオブジェクト イベントをサブスクライブする
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト イベントのサブスクライブ
|
event | True | array of string | |
|
名前
|
name | True | string |
イベント サブスクライバーの名前 |
|
WorkSpan で構成された統合の選択
|
integration_id | True | string | |
|
object_ids
|
object_ids | array of string | ||
|
フィルターの例: (["closed"、"won"、"lost" ]) AND (sales_details.partner = "P1")
|
filters | string |
イベントのフィルター |
戻り値
WorkSpan コラボレーション イベントのサブスクライブ
メンバーシップ、タスク、コメントの作成や更新など、さまざまなコラボレーション イベントをサブスクライブして、社内およびパートナー ネットワークとのコミュニケーションを促進および強化します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イベント名
|
event | True | string | |
|
サブスクライバー名
|
name | True | string |
Webhook に割り当てられた名前 |
|
WorkSpan オブジェクト ID
|
object_ids | array of string |
Webhook が登録されているオブジェクト ID |
|
|
フィルターの例: (["closed"、"won"、"lost" ]) AND (sales_details.partner = "P1")
|
filters | string |
イベントのフィルター |
戻り値
定義
bulkload_opportunity_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
integration_id
|
integration_id | string |
統合 ID |
|
execution_id
|
execution_id | string |
実行 ID |
|
作成日時
|
created_at | date-time |
作成時間 |
bulkload_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
integration_id
|
integration_id | string |
統合 ID |
|
execution_id
|
execution_id | string |
実行 ID |
|
data_format
|
data_format | string |
データ形式 |
|
作成日時
|
created_at | date-time |
作成時間 |
bulkload_status_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
integration_id
|
integration_id | string |
統合 ID |
|
execution_id
|
execution_id | string |
実行 ID |
|
状態
|
status | string |
実行の状態 |
|
succcess_count
|
succcess_count | number |
正常に処理されたレコードの数 |
|
error_count
|
error_count | number |
エラーが発生したレコードの数 |
|
input_count
|
input_count | number |
受信したレコードの数 |
|
skip_count
|
skip_count | number |
スキップされたレコードの数 |
|
started_at
|
started_at | date-time |
実行開始のタイムスタンプ |
|
完了日時
|
completed_at | date-time |
実行の完了のタイムスタンプ |
|
include_errors
|
include_errors | boolean |
ある場合に応答でエラーが返されるかどうかを示すフラグ |
|
エラー
|
errors | array of object | |
|
メッセージ
|
errors.message | string |
エラーメッセージ |
|
id
|
errors.id | string |
失敗したレコードの ID |
|
data_row
|
errors.data_row | string |
失敗したデータ行 |
external_id_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
external_id
|
external_id | string |
外部システムからの ID (CRM など) |
|
object_id
|
object_id | string |
WorkSpan オブジェクト ID (長い ID) |
|
field_name
|
field_name | string |
外部システムからのexternal_idが格納されている WorkSpan フィールド名 |
get_external_id_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
object_id
|
object_id | string |
WorkSpan オブジェクトのオブジェクト ID (長い ID) |
|
external_ids
|
external_ids | array of object | |
|
field_name
|
external_ids.field_name | string |
外部システムからのexternal_idが格納されている WorkSpan フィールド名 |
|
external_id
|
external_ids.external_id | string |
外部システムからの ID (CRM など) |
audit_response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
object_id
|
object_id | string |
更新された WorkSpan オブジェクト ID (長い ID) |
|
field_name
|
field_name | string |
更新された WorkSpan フィールドの名前 |
|
status_code
|
status_code | string |
更新プログラムの状態 |
ReportDataResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
endOfList
|
endOfList | boolean | |
|
results
|
results | array of | |
|
バージョン
|
version | integer |