CobbleStone - Contract Insight(미리 보기)
시스템 간의 원활한 상호 작용을 위해 Contract Insight API에 연결하여 계약 관리 프로세스를 개선합니다. 연결된 기능에는 다음이 포함됩니다. - 새 레코드 만들기 - 기존 레코드를 업데이트합니다. - 지정된 엔터티에 대한 레코드 목록을 끌어온 경우 - 모든 메타데이터, 제한 사항 및 플래그를 가져옵니다. - 편집 가능, 업데이트 가능 또는 볼 수 있는 레코드 목록을 끌어온 다음
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | CobbleStone Software |
| URL | https://www.cobblestonesoftware.com |
| 전자 메일 | AppDev@cobblestonesystems.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 코블스톤 소프트웨어 |
| 웹 사이트 | https://www.cobblestonesoftware.com |
| 개인 정보 취급 방침 | https://www.cobblestonesoftware.com/company/privacy-policy |
| 카테고리 | 비즈니스 관리; 판매 및 CRM |
조약돌
엔터티에 대한 Contract Insight 소프트웨어(추가, 삽입, 업데이트) 및 스키마 정보에 대한 기본 작업을 허용합니다.
퍼블리셔: 코블스톤 소프트웨어
필수 조건
CobbleStone Software(Contact Insight)에 대한 기존 라이선스가 필요합니다.
지원되는 작업
가져오기
특정 조건, 태그별 순서, 태그별 그룹화 및 레코드 수를 사용하여 지정된 엔터티에 대한 레코드 목록을 끌어옵니다. 참고: 끌어올 레코드 수에는 제한이 없지만 사용자는 더 큰 결과가 처리 속도가 느려지는 것을 고려해야 합니다.
추가
지정된 엔터티에 레코드(호출당 하나의 레코드로 제한됨)를 추가합니다. 응답은 시스템에서 생성된 ID입니다.
Update
특정 조건을 가진 지정된 엔터티/영역에 대한 레코드를 업데이트하고 업데이트 요청이 성공했는지 여부에 관계없이 워크플로를 실행하는 플래그로 TriggerWorkflow를 업데이트합니다. 업데이트할 수 있는 최대 레코드 수는 호출당 500개입니다.
Schema
테이블의 열, 데이터 형식 및 모든 제한 사항 또는 플래그(NULL, 길이, 기본 키 등)를 나열합니다.
엔터티 목록
이 인터페이스를 통해 편집, 업데이트 또는 보거나 쿼리할 수 있는지 여부를 나타내는 이름 목록과 플래그가 지정된 속성 3개를 반환합니다.
자격 증명 가져오기
권한 부여(OAUTH 2.0)
- CobbleStone Software는 액세스를 위한 두 가지 권한 부여 방법을 제공합니다.
자격 증명은 CobbleStone Software 시스템을 통해 설정/생성할 수 있습니다.
시작하기
CobbleStone Software 시스템을 통해 API 클라이언트 자격 증명을 만들려면 다음 단계를 사용합니다.
CobbleStone Software 시스템 내에서 시스템 관리자는 다음 페이지로 이동하여 자격 증명을 설정/구성할 수 있습니다.
- SaaS 클라이언트의 경우: https://yourCompanyName.cobblestone.software/core/MyAPI.aspx
- 배포된 클라이언트의 경우(일반적으로): https://yourCompanyName/core/MyAPI.aspx
(참고: 이 항목은 "내" 상위 메뉴 항목 아래에 있으며 "내 API 클라이언트"를 선택합니다.)
이렇게 하면 시스템 관리자가 커넥터에 사용할 OAuth 2.0 자격 증명(클라이언트 ID 및 클라이언트 암호)을 만들 수 있습니다.
CobbleStone 소프트웨어 시스템에 로그인하는 것에서:
시작하려면 CobbleStone Software를 열고 내 > API 클라이언트로 이동합니다...
API 클라이언트 추가를 클릭하여 새 API 클라이언트 항목을 만들고 고유한 이름을 지정합니다. 이름은 내부일 뿐이며 그 목적에 의미 있는 모든 것이 될 수 있습니다. 다른 API 키를 사용하여 작고 관리 가능하며 목적이 있는 작업으로 구성하는 것이 좋습니다.
이렇게 하면 키가 생성되고 관리자 직원만 페이지에 액세스할 수 있습니다. 이 키는 키를 생성한 사람에게 바인딩되며, 키를 볼 수 있는 유일한 사람입니다. 키를 공유할 수 있지만 로그인한 사용자만 볼 수 있습니다.
이 시점에서 API 클라이언트 항목 설정을 완료했습니다. 이 클라이언트 ID 및 클라이언트 보안은 커넥터가 CobbleStone Software 시스템과 통신하는 데 사용됩니다.
알려진 문제 및 제한 사항
현재 커넥터는 이진 파일 보내기 또는 받기를 지원하지 않습니다.
"업데이트" 엔드포인트는 적중 횟수당 최대 500개의 영향을 받는 행으로 제한됩니다. 500개 이상의 레코드를 업데이트해야 하는 경우 여러 횟수로 처리해야 합니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 클라이언트 ID - CobbleStone ClientId | 문자열 | 클라이언트 ID를 입력하세요. | 진실 |
| 클라이언트 암호 - CobbleStone ClientSecret | 시큐어스트링 (보안 문자열) | 클라이언트 암호를 입력하세요. | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| API에서 작업할 수 있는 엔터티의 끌어오기 목록 |
편집, 업데이트 또는 보기/쿼리할 수 있는지 여부를 나타내는 이름 목록과 플래그가 지정된 속성 3개를 반환합니다. |
| 사용 가능한 데이터베이스 뷰 목록 검색 |
해당 클라이언트의 사용 가능한 데이터베이스 뷰 목록 검색에는 데이터를 쿼리할 수 있는 권한이 있으며, 데이터베이스 뷰 상자를 동적으로 자동으로 채우는 데 내부적으로 사용합니다. |
| 삽입 용도에 사용할 수 있는 엔터티 목록 검색 |
해당 클라이언트의 사용 가능한 엔터티 목록 검색에는 데이터를 추가할 수 있는 권한이 있으며, 목록 상자를 동적으로 자동 채우는 데 내부적으로 사용합니다. |
| 선택 용도에 사용할 수 있는 엔터티 목록 검색 |
해당 클라이언트의 사용 가능한 엔터티 목록 검색에는 데이터를 쿼리할 수 있는 권한이 있으며, 목록 상자를 동적으로 자동 채우기 위해 내부적으로 사용합니다. |
| 업데이트 용도에 사용할 수 있는 엔터티 목록 검색 |
해당 클라이언트의 사용 가능한 엔터티 목록 검색에는 데이터를 업데이트할 수 있는 권한이 있으며, 목록 상자를 동적으로 자동 채우는 데 내부 사용 |
| 지정된 엔터티에 대한 레코드 끌어오기 목록 |
특정 조건, 태그별 순서, 태그별 그룹화 및 레코드 수를 사용하여 지정된 엔터티에 대한 레코드 목록을 끌어옵니다. 참고: 끌어올 레코드 수에는 제한이 없지만 사용자는 더 큰 결과가 처리 속도가 느려지는 것을 고려해야 합니다. |
| 지정된 엔터티에 대한 레코드 업데이트 |
특정 조건을 가진 지정된 엔터티/영역에 대한 레코드를 업데이트하고 업데이트 요청이 성공했는지 여부에 관계없이 워크플로를 실행하는 플래그로 TriggerWorkflow를 업데이트합니다. 업데이트할 수 있는 최대 레코드 수는 호출당 500개입니다. |
| 지정된 엔터티에 대한 새 레코드 만들기 |
지정된 엔터티에 레코드(호출당 하나의 레코드로 제한됨)를 추가합니다. 응답은 시스템에서 생성된 ID입니다. |
| 특정 데이터베이스 뷰 실행 |
특정 데이터베이스 뷰를 실행합니다(호출당 하나의 레코드로 제한됨). 응답은 상태가 됩니다. |
| 특정 데이터베이스 뷰의 모든 열에 대한 메타데이터 끌어오기 |
데이터베이스 뷰에서 열, 데이터 형식 및 모든 제한 사항 또는 플래그(NULL, 길이, 기본 키 등)를 나열합니다. |
| 특정 엔터티의 모든 열에 대한 메타데이터 끌어오기 |
테이블의 열, 데이터 형식 및 모든 제한 사항 또는 플래그(NULL, 길이, 기본 키 등)를 나열합니다. |
API에서 작업할 수 있는 엔터티의 끌어오기 목록
사용 가능한 데이터베이스 뷰 목록 검색
해당 클라이언트의 사용 가능한 데이터베이스 뷰 목록 검색에는 데이터를 쿼리할 수 있는 권한이 있으며, 데이터베이스 뷰 상자를 동적으로 자동으로 채우는 데 내부적으로 사용합니다.
반환
데이터베이스 뷰에 대한 쿼리 응답
삽입 용도에 사용할 수 있는 엔터티 목록 검색
해당 클라이언트의 사용 가능한 엔터티 목록 검색에는 데이터를 추가할 수 있는 권한이 있으며, 목록 상자를 동적으로 자동 채우는 데 내부적으로 사용합니다.
반환
엔터티 목록
선택 용도에 사용할 수 있는 엔터티 목록 검색
해당 클라이언트의 사용 가능한 엔터티 목록 검색에는 데이터를 쿼리할 수 있는 권한이 있으며, 목록 상자를 동적으로 자동 채우기 위해 내부적으로 사용합니다.
반환
엔터티 목록
업데이트 용도에 사용할 수 있는 엔터티 목록 검색
해당 클라이언트의 사용 가능한 엔터티 목록 검색에는 데이터를 업데이트할 수 있는 권한이 있으며, 목록 상자를 동적으로 자동 채우는 데 내부 사용
반환
엔터티 목록
지정된 엔터티에 대한 레코드 끌어오기 목록
특정 조건, 태그별 순서, 태그별 그룹화 및 레코드 수를 사용하여 지정된 엔터티에 대한 레코드 목록을 끌어옵니다. 참고: 끌어올 레코드 수에는 제한이 없지만 사용자는 더 큰 결과가 처리 속도가 느려지는 것을 고려해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
엔터티 이름
|
entityName | True | string |
데이터를 쿼리할 테이블 이름입니다. |
|
특성
|
Attribute | string | ||
|
Alias
|
Alias | string | ||
|
Condition
|
Condition | string | ||
|
분야
|
Field | string | ||
|
아이디
|
ID | string | ||
|
Input
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Condition
|
Condition | string | ||
|
분야
|
Field | string | ||
|
아이디
|
ID | string | ||
|
Input
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
유형
|
Type | string | ||
|
가치
|
Value | 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개입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
엔터티 이름
|
entityName | True | string |
레코드를 업데이트할 테이블 이름입니다. |
|
Condition
|
Condition | string | ||
|
분야
|
Field | string | ||
|
아이디
|
Id | string | ||
|
Input
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Condition
|
Condition | string | ||
|
분야
|
Field | string | ||
|
아이디
|
ID | string | ||
|
Input
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
유형
|
Type | string | ||
|
가치
|
Value | string | ||
|
유형
|
Type | string | ||
|
가치
|
Value | string | ||
|
이름
|
Name | string | ||
|
가치
|
Value | string | ||
|
TriggerWorkflow
|
TriggerWorkflow | boolean |
반환
지정된 엔터티에 대한 새 레코드 만들기
지정된 엔터티에 레코드(호출당 하나의 레코드로 제한됨)를 추가합니다. 응답은 시스템에서 생성된 ID입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
엔터티 이름
|
entityName | True | string |
레코드를 추가할 테이블 이름입니다. |
|
이름
|
Name | string | ||
|
가치
|
Value | string |
반환
특정 데이터베이스 뷰 실행
특정 데이터베이스 뷰를 실행합니다(호출당 하나의 레코드로 제한됨). 응답은 상태가 됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
데이터베이스 뷰 이름
|
databaseViewName | True | string |
실행할 데이터베이스 뷰의 이름입니다. |
|
특성
|
Attribute | string | ||
|
Alias
|
Alias | string | ||
|
Condition
|
Condition | string | ||
|
분야
|
Field | string | ||
|
아이디
|
ID | string | ||
|
Input
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Condition
|
Condition | string | ||
|
분야
|
Field | string | ||
|
아이디
|
ID | string | ||
|
Input
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
유형
|
Type | string | ||
|
가치
|
Value | string | ||
|
Fields
|
Fields | array of string | ||
|
방향
|
Direction | string | ||
|
GroupByTag
|
GroupByTag | array of string | ||
|
StartIndex
|
StartIndex | integer |
시작할 인덱스, 기본값 = 0 |
|
|
Length
|
Length | integer |
StartIndex부터 시작하는 행 수, 1000을 제외할 수 없음, 기본값 = 100 |
반환
테이블의 열, 데이터 형식 및 제한 사항 또는 플래그(NULL, 길이, 기본 키 등) 목록
특정 데이터베이스 뷰의 모든 열에 대한 메타데이터 끌어오기
데이터베이스 뷰에서 열, 데이터 형식 및 모든 제한 사항 또는 플래그(NULL, 길이, 기본 키 등)를 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
엔터티 이름
|
databaseViewName | True | string |
스키마를 검색할 데이터베이스 뷰의 이름입니다. |
반환
테이블의 열, 데이터 형식 및 제한 사항 또는 플래그(NULL, 길이, 기본 키 등) 목록
특정 엔터티의 모든 열에 대한 메타데이터 끌어오기
테이블의 열, 데이터 형식 및 모든 제한 사항 또는 플래그(NULL, 길이, 기본 키 등)를 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
엔터티 이름
|
entityName | True | string |
스키마를 검색할 테이블의 이름입니다. |
반환
테이블의 열, 데이터 형식 및 제한 사항 또는 플래그(NULL, 길이, 기본 키 등) 목록
정의
APIEntityListResponse
엔터티 목록
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
APIEntity |
각 엔터티 정의 |
APIEntity
각 엔터티 정의
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
엔티티네임
|
EntityName | string |
데이터베이스에 있는 엔터티 이름 |
|
EntityNameDisplay
|
EntityNameDisplay | string |
엔터티 표시 이름 |
|
AllowAdd
|
AllowAdd | boolean |
새 레코드를 추가할 수 있는지를 나타냅니다. |
|
AllowEdit
|
AllowEdit | boolean |
레코드를 편집할 수 있는지를 나타냅니다. |
|
AllowView
|
AllowView | boolean |
레코드를 볼 수 있는지를 나타냅니다. |
|
EntityNameForAPI
|
EntityNameForAPI | string |
CSS API에 사용되는 엔터티 이름 |
APISchemaResponse
테이블의 열, 데이터 형식 및 제한 사항 또는 플래그(NULL, 길이, 기본 키 등) 목록
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
APISchema |
APISchema
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
Name | string | |
|
IsPrimaryKey
|
IsPrimaryKey | boolean | |
|
IsIdentity
|
IsIdentity | boolean | |
|
IsNullable
|
IsNullable | boolean | |
|
DBType
|
DBType | string | |
|
최대 길이
|
MaxLength | integer | |
|
DataPrecision
|
DataPrecision | integer | |
|
DataScale
|
DataScale | integer | |
|
HasDefaultValue
|
HasDefaultValue | boolean | |
|
IsComputedColumn
|
IsComputedColumn | boolean | |
|
IsPassword
|
IsPassword | boolean |
APIAddRequestTuple
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
Name | string | |
|
가치
|
Value | string |
APIUpdateResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
TotalAffected
|
TotalAffected | integer | |
|
TotalFailed
|
TotalFailed | integer | |
|
Message
|
Message | string |
APIAddRequest
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
튜플
|
Tuples | array of APIAddRequestTuple |
APIQueryResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
object |
APIViewListResponse
데이터베이스 뷰에 대한 쿼리 응답
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
object |