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 ソフトウェア システムを通して設定/生成できます。

はじめに

CobbleStone ソフトウェア システムを通して API クライアント資格情報を作成するには、次の手順を実行します。

CobbleStone ソフトウェア システム内で、システム管理者は次のページに移動して、資格情報の設定/構成ができます。

(注意: これは「自分」トップ メニュー項目の下にあり、「自分の API クライアント」を選択します)

これにより、システム管理者は、コネクタで使用する OAuth 2.0 の資格情報 (クライアント ID とクライアント シークレット) を作成することができます。

CobbleStone ソフトウェア システムへのログインから:

まず、CobbleStone ソフトウェア を開き、自分 > 自分の API クライアントの下に移動します。

image1

API クライアントの追加をクリックして、新しい API クライアント エントリを作成し、一意の名前を付けます。 この名前は内部のものであり、目的を示すものであれば何でもかまいません。 別の API キーを使用して、物事を小さく、管理しやすく、目的のあるタスクに整理することをお勧めします。

image2

これによりキーが生成され、管理者ペルソナのみがページにアクセスできるようになります。 キーを生成した人がバインドされ、それを表示できる唯一のユーザーになります。 キーを共有することはできますが、ログインしているユーザーだけが表示できます。

image3

この時点で、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 が使用できるエンティティのプル リスト

名前と、編集、更新、閲覧/照会が可能かどうかを示す 3 つのフラグ付きプロパティのリストを返します。

戻り値

エンティティの一覧

アイテム
APIEntityListResponse

指定されたエンティティの新規レコードを作成する

指定されたエンティティにレコード (呼び出しごとに 1 つのレコードに制限) を追加します。 システムで生成された ID が応答されます。

パラメーター

名前 キー 必須 説明
エンティティ名
entityName True string

レコードを追加するテーブル名。

件名
Name string
価値
Value object

戻り値

特定のエンティティのすべての列に関するメタデータを取得します

テーブル内の列、データ型、および制限またはフラグ (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

戻り値

トリガー

作成、更新されたレコードのスケジュールされたトリガー

作成された (新規) レコードと、一定時間以降に更新されたレコードの両方を表示するスケジュールされたトリガー。

特定の日時以降に更新されたレコードを表示するスケジュールされたトリガー

更新されたすべてのレコードを日付と日付でクエリします。時間フィールドを現在の日付と比較 &特定の間隔での時間 (と等しい、またはそれ以上)。

特定の間隔で作成された (新しい) レコードを照会するスケジュールされたトリガー

新しく作成されたすべてのレコードを日付と日付でクエリします。時間フィールドを現在の日付と比較 &特定の間隔での時間 (と等しい、またはそれ以上)。

作成、更新されたレコードのスケジュールされたトリガー

作成された (新規) レコードと、一定時間以降に更新されたレコードの両方を表示するスケジュールされたトリガー。

パラメーター

名前 キー 必須 説明
テーブル名
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

オブジェクト

’オブジェクト’ という種類です。