CobbleStone 契約の分析情報 (プレビュー)
Cobblestone - Contract 分析情報コネクタを使用すると、契約管理ソフトウェアと多くの一般的なウェブサービスやデータサービスとの接続が可能です。 基本的なアウト オブ ボックス (OOB) エンドポイントを使用すると、スキーマ テーブル名と、それらを検索、編集、および更新できるかどうかを確認できます。 テーブル名のエンティティ情報を引き出し、顧客レコードのデータを照会、追加、更新することができます。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | CobbleStone チーム |
| [URL] | https://www.cobblestonesoftware.com |
| メール | mefriebis@cobblestonesystems.com |
| Connector Metadata | |
|---|---|
| 発行者 | Cobblestone Software |
| Web サイト | https://www.cobblestonesoftware.com |
| プライバシー ポリシー | https://www.cobblestonesoftware.com/company/privacy-policy |
| カテゴリー | ビジネス管理、営業、CRM |
CobbleStone
Contract Insight の基本操作 (追加、挿入、更新)、およびエンティティのスキーマ情報を許可します。
公開元: CobbleStone Software
前提条件
CobbleStone Software (取引先担当者の分析情報) の既存のライセンスが必要です。
サポートされている操作
入手
特定の基準、タグによる順序、タグによるグループ化、レコード数を使用して、特定のエンティティのレコードのリストを取得します。 注: 取得するレコードの数に制限はありませんが、ユーザーは結果が大きくなると処理が遅くなることを考慮する必要があります。
の追加
指定されたエンティティにレコード (呼び出しごとに 1 つのレコードに制限) を追加します。 システムで生成された ID が応答されます。
更新する
更新リクエストが成功したかどうかにかかわらず、ワークフローを実行するためのフラグとして、特定の基準と TriggerWorkflow を使用して、指定されたエンティティ/エリアのレコードを更新します。 更新できるレコードの最大数は、呼び出しごとに 500 です。
Schema
テーブル内の列、データ型、および制限またはフラグ (NULL、長さ、主キーなど) を一覧表示します。
エンティティの一覧
名前のリストと、このインターフェイスを通じて編集、更新、または表示/クエリできるかどうかを示す 3 つのフラグ付きプロパティを返します。
資格情報の取得
認証 (OAUTH 2.0)
- CobbleStone Software は、次の 2 つのアクセス認証方法を提供します。
資格情報は、CobbleStone ソフトウェア システムを通して設定/生成できます。
はじめに
CobbleStone ソフトウェア システムを通して API クライアント資格情報を作成するには、次の手順を実行します。
CobbleStone ソフトウェア システム内で、システム管理者は次のページに移動して、資格情報の設定/構成ができます。
- SaaS クライアントの場合: https://yourCompanyName.cobblestone.software/core/MyAPI.aspx
- 展開されたクライアントの場合 (通常): https://yourCompanyName/core/MyAPI.aspx
(注意: これは「自分」トップ メニュー項目の下にあり、「自分の API クライアント」を選択します)
これにより、システム管理者は、コネクタで使用する OAuth 2.0 の資格情報 (クライアント ID とクライアント シークレット) を作成することができます。
CobbleStone ソフトウェア システムへのログインから:
まず、CobbleStone ソフトウェア を開き、自分 > 自分の API クライアントの下に移動します。
API クライアントの追加をクリックして、新しい API クライアント エントリを作成し、一意の名前を付けます。 この名前は内部のものであり、目的を示すものであれば何でもかまいません。 別の API キーを使用して、物事を小さく、管理しやすく、目的のあるタスクに整理することをお勧めします。
これによりキーが生成され、管理者ペルソナのみがページにアクセスできるようになります。 キーを生成した人がバインドされ、それを表示できる唯一のユーザーになります。 キーを共有することはできますが、ログインしているユーザーだけが表示できます。
この時点で、API クライアント エントリの設定が完了しました。 この Client ID と Client Securet は、コネクタが CobbleStone ソフトウェア システムと通信するために使用されます。
既知の問題と制限事項
現時点では、コネクタはバイナリ ファイルの送受信をサポートしていません。
エンドポイントの「更新」は、ヒットごとに最大 500 行まで影響を受けるように制限されています。 500 を超えるレコードを更新する必要がある場合は、複数のヒットで処理する必要があります。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| クライアント ID - お使いの CobbleStone ClientId | string | クライアント ID を入力してください。 | True |
| クライアント シークレット - お使いの CobbleStone ClientSecret | securestring | クライアント シークレットを入力してください。 | True |
| 認証 URL | string | 認証 URL を入力してください。 | True |
| トークン URL | string | トークン URL を入力してください。 | True |
| URL の更新 | string | 更新 URL を入力してください。 | True |
| スコープ | string | スコープを入力してください。 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| API が使用できるエンティティのプル リスト |
名前と、編集、更新、閲覧/照会が可能かどうかを示す 3 つのフラグ付きプロパティのリストを返します。 |
| 指定されたエンティティの新規レコードを作成する |
指定されたエンティティにレコード (呼び出しごとに 1 つのレコードに制限) を追加します。 システムで生成された ID が応答されます。 |
| 特定のエンティティのすべての列に関するメタデータを取得します |
テーブル内の列、データ型、および制限またはフラグ (NULL、長さ、主キーなど) を一覧表示します。 |
| 特定のエンティティのレコードのリストを引き出す |
特定の基準、タグによる順序、タグによるグループ化、レコード数を使用して、特定のエンティティのレコードのリストを取得します。 注: 取得するレコードの数に制限はありませんが、ユーザーは結果が大きくなると処理が遅くなることを考慮する必要があります。 |
| 特定のエンティティのレコードを更新する |
更新リクエストが成功したかどうかにかかわらず、ワークフローを実行するためのフラグとして、特定の基準と TriggerWorkflow を使用して、指定されたエンティティ/エリアのレコードを更新します。 更新できるレコードの最大数は、呼び出しごとに 500 です。 |
API が使用できるエンティティのプル リスト
指定されたエンティティの新規レコードを作成する
指定されたエンティティにレコード (呼び出しごとに 1 つのレコードに制限) を追加します。 システムで生成された ID が応答されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エンティティ名
|
entityName | True | string |
レコードを追加するテーブル名。 |
|
件名
|
Name | string | ||
|
価値
|
Value | object |
戻り値
- Body
- APIAddRequest
特定のエンティティのすべての列に関するメタデータを取得します
テーブル内の列、データ型、および制限またはフラグ (NULL、長さ、主キーなど) を一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エンティティ名
|
entityName | True | string |
スキーマを取得するテーブルの名前。 |
戻り値
テーブル内の列、データ型、および制限またはフラグ (NULL、長さ、主キーなど) を一覧表示する
- アイテム
- APISchemaResponse
特定のエンティティのレコードのリストを引き出す
特定の基準、タグによる順序、タグによるグループ化、レコード数を使用して、特定のエンティティのレコードのリストを取得します。 注: 取得するレコードの数に制限はありませんが、ユーザーは結果が大きくなると処理が遅くなることを考慮する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エンティティ名
|
entityName | True | string |
データをクエリするテーブル名。 |
|
Attribute
|
Attribute | string | ||
|
Alias
|
Alias | string | ||
|
句
|
Clause | string | ||
|
Fields
|
Fields | array of string | ||
|
指示
|
Direction | string | ||
|
GroupByTag
|
GroupByTag | array of string | ||
|
StartIndex
|
StartIndex | integer |
開始するインデックス。既定 = 0 |
|
|
Length
|
Length | integer |
StartIndex から始まる行カウント。1000 を超えることはできません。既定 = 100 |
戻り値
- アイテム
- APIQueryResponse
特定のエンティティのレコードを更新する
更新リクエストが成功したかどうかにかかわらず、ワークフローを実行するためのフラグとして、特定の基準と TriggerWorkflow を使用して、指定されたエンティティ/エリアのレコードを更新します。 更新できるレコードの最大数は、呼び出しごとに 500 です。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エンティティ名
|
entityName | True | string |
レコードを更新するテーブル名。 |
|
句
|
Clause | string | ||
|
件名
|
Name | string | ||
|
価値
|
Value | object | ||
|
TriggerWorkflow
|
TriggerWorkflow | boolean |
戻り値
- Body
- APIUpdateResponse
トリガー
| 作成、更新されたレコードのスケジュールされたトリガー |
作成された (新規) レコードと、一定時間以降に更新されたレコードの両方を表示するスケジュールされたトリガー。 |
| 特定の日時以降に更新されたレコードを表示するスケジュールされたトリガー |
更新されたすべてのレコードを日付と日付でクエリします。時間フィールドを現在の日付と比較 &特定の間隔での時間 (と等しい、またはそれ以上)。 |
| 特定の間隔で作成された (新しい) レコードを照会するスケジュールされたトリガー |
新しく作成されたすべてのレコードを日付と日付でクエリします。時間フィールドを現在の日付と比較 &特定の間隔での時間 (と等しい、またはそれ以上)。 |
作成、更新されたレコードのスケジュールされたトリガー
作成された (新規) レコードと、一定時間以降に更新されたレコードの両方を表示するスケジュールされたトリガー。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
entityName | True | string |
更新されたレコードをプルするテーブル名。 |
|
Attribute
|
Attribute | string | ||
|
Alias
|
Alias | string | ||
|
句
|
Clause | string | ||
|
Fields
|
Fields | array of string | ||
|
指示
|
Direction | string | ||
|
GroupByTag
|
GroupByTag | array of string | ||
|
StartIndex
|
StartIndex | integer |
開始するインデックス。既定 = 0 |
|
|
Length
|
Length | integer |
StartIndex から始まる行カウント。1000 を超えることはできません。既定 = 100 |
戻り値
- 返答
- object
特定の日時以降に更新されたレコードを表示するスケジュールされたトリガー
更新されたすべてのレコードを日付と日付でクエリします。時間フィールドを現在の日付と比較 &特定の間隔での時間 (と等しい、またはそれ以上)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エンティティ名
|
entityName | True | string |
更新されたレコードをプルするテーブル名。 |
|
Attribute
|
Attribute | string | ||
|
Alias
|
Alias | string | ||
|
句
|
Clause | string | ||
|
Fields
|
Fields | array of string | ||
|
指示
|
Direction | string | ||
|
GroupByTag
|
GroupByTag | array of string | ||
|
StartIndex
|
StartIndex | integer |
開始するインデックス。既定 = 0 |
|
|
Length
|
Length | integer |
StartIndex から始まる行カウント。1000 を超えることはできません。既定 = 100 |
戻り値
- 返答
- object
特定の間隔で作成された (新しい) レコードを照会するスケジュールされたトリガー
新しく作成されたすべてのレコードを日付と日付でクエリします。時間フィールドを現在の日付と比較 &特定の間隔での時間 (と等しい、またはそれ以上)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エンティティ名
|
entityName | True | string |
新規レコードをプルするテーブル名。 |
|
Attribute
|
Attribute | string | ||
|
Alias
|
Alias | string | ||
|
句
|
Clause | string | ||
|
Fields
|
Fields | array of string | ||
|
指示
|
Direction | string | ||
|
GroupByTag
|
GroupByTag | array of string | ||
|
StartIndex
|
StartIndex | integer |
開始するインデックス。既定 = 0 |
|
|
Length
|
Length | integer |
StartIndex から始まる行カウント。1000 を超えることはできません。既定 = 100 |
戻り値
- 返答
- object
定義
APIEntityListResponse
エンティティの一覧
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アイテム
|
APIEntity |
それぞれのエンティティの定義 |
APIEntity
それぞれのエンティティの定義
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
EntityName
|
EntityName | string |
データベースにあるエンティティ名 |
|
EntityNameDisplay
|
EntityNameDisplay | string |
エンティティの表示名 |
|
AllowAdd
|
AllowAdd | boolean |
新しいレコードを追加できるかどうかを示します |
|
AllowEdit
|
AllowEdit | boolean |
レコードの編集が許可されているかどうかを示します |
|
AllowView
|
AllowView | boolean |
レコードの表示が許可されているかどうかを示します |
|
EntityNameForAPI
|
EntityNameForAPI | string |
CSS APIで使用されるエンティティ名 |
APISchemaResponse
テーブル内の列、データ型、および制限またはフラグ (NULL、長さ、主キーなど) を一覧表示する
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アイテム
|
APISchema |
APISchema
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
Name | string | |
|
IsPrimaryKey
|
IsPrimaryKey | boolean | |
|
IsIdentity
|
IsIdentity | boolean | |
|
IsNullable
|
IsNullable | boolean | |
|
DBType
|
DBType | string | |
|
MaxLength
|
MaxLength | integer | |
|
DataPrecision
|
DataPrecision | integer | |
|
DataScale
|
DataScale | integer | |
|
HasDefaultValue
|
HasDefaultValue | boolean | |
|
IsComputedColumn
|
IsComputedColumn | boolean | |
|
IsPassword
|
IsPassword | boolean |
APIAddRequestTuple
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
Name | string | |
|
価値
|
Value | object |
APIUpdateResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
TotalAffected
|
TotalAffected | integer | |
|
TotalFailed
|
TotalFailed | integer | |
|
Message
|
Message | string |
APIAddRequest
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Tuples
|
Tuples | array of APIAddRequestTuple |
APIQueryResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アイテム
|
object |
オブジェクト
’オブジェクト’ という種類です。