Blackbaud RENXT 쿼리(미리 보기)
Blackbaud Raiser's Edge NXT는 비영리 단체와 전체 사회적 선의의 커뮤니티를 위해 특별히 구축된 포괄적인 클라우드 기반 모금 및 기부자 관리 소프트웨어 솔루션입니다. 쿼리 커넥터를 사용하여 쿼리를 관리하고 실행합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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) |
| 연락처 | |
|---|---|
| 이름 | Blackbaud 지원 |
| URL | https://www.blackbaud.com/support |
| 전자 메일 | skyapi@blackbaud.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 블랙보. Inc.(주) |
| 웹 사이트 | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| 개인 정보 보호 정책 | https://www.blackbaud.com/privacy-shield |
| 카테고리 | 판매 및 CRM; 생산력 |
Raiser's Edge NXT 는 비영리 단체와 전체 사회적 선의의 커뮤니티를 위해 특별히 구축된 포괄적인 클라우드 기반 모금 및 기부자 관리 소프트웨어 솔루션입니다.
이 커넥터는 Blackbaud의 SKY API를 기반으로 하며 Raiser의 Edge NXT 내에 있는 쿼리 및 관련 엔터티를 관리하는 데 도움이 되는 작업을 제공합니다.
자세한 내용은 설명서를 참조하세요.
필수 조건
이 커넥터를 사용하려면 하나 이상의 Blackbaud 환경에 액세스할 수 있는 Blackbaud ID 계정이 있어야 합니다.
또한 조직의 관리자는 이 커넥터가 Blackbaud 환경에 액세스할 수 있도록 시스템 내에서 관리자 수준 작업을 수행해야 합니다. 이러한 필수 구성 요소에 대한 자세한 내용은 초기 설치 설명서에서 확인할 수 있습니다.
자격 증명을 가져오는 방법
조직의 관리자는 조직의 Raiser Edge NXT 환경에 초대를 보내고 환경 내에서 사용자 계정 권한을 구성합니다. 이 커넥터를 사용하려면 추가 자격 증명이 필요하지 않습니다.
알려진 문제 및 제한 사항
커넥터는 사용자 계정의 컨텍스트에서 작동하므로 환경 내에서 사용자 권한이 적용됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 임시 쿼리 작업 시작 |
백그라운드 작업을 시작하여 지정된 임시 쿼리 정의를 실행합니다. |
| 정적 쿼리 새로 고침 작업 시작 |
백그라운드 작업을 시작하여 지정된 정적 쿼리에 저장된 키를 새로 고칩니다. |
| 쿼리 나열 |
쿼리 목록을 반환합니다. |
| 쿼리 작업 상태 가져오기 |
백그라운드 쿼리 실행 작업에 대한 정보를 반환합니다. |
| 쿼리 작업 시작 |
백그라운드 작업을 시작하여 지정된 쿼리를 실행합니다. |
임시 쿼리 작업 시작
백그라운드 작업을 시작하여 지정된 임시 쿼리 정의를 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
쿼리 정의
|
query | True | object |
쿼리 정의의 JSON 표현입니다. |
|
출력 형식
|
output_format | string |
쿼리 결과 파일의 출력 형식을 나타냅니다. |
|
|
서식 모드
|
formatting_mode | string |
쿼리 결과에 서식을 적용할지 여부와 방법을 나타냅니다. |
|
|
Filename
|
results_file_name | string |
파일 확장명 없이 다운로드할 파일의 이름입니다. |
반환
쿼리 작업 시작
정적 쿼리 새로 고침 작업 시작
백그라운드 작업을 시작하여 지정된 정적 쿼리에 저장된 키를 새로 고칩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
유형
|
v_query_type_id | True | integer |
특정 쿼리 형식의 쿼리 집합을 필터링합니다. |
|
Query
|
id | True | integer |
실행할 쿼리입니다. |
반환
쿼리 작업 시작
쿼리 나열
쿼리 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
유형
|
query_type_id | integer |
특정 쿼리 형식의 쿼리 집합을 필터링합니다. |
|
|
카테고리
|
category | integer |
쿼리 집합을 특정 범주의 쿼리 집합으로 필터링합니다. |
|
|
포맷
|
query_format | string |
특정 형식의 쿼리 집합을 필터링합니다. |
|
|
텍스트 검색
|
search_text | string |
결과를 필터링할 이름 필드 검색 텍스트입니다. |
|
|
즐겨찾기만?
|
my_fav_queries_only | boolean |
즐겨 찾는 쿼리만 포함하시겠습니까? |
|
|
내 쿼리만?
|
my_queries_only | boolean |
만든 쿼리만 포함하시겠습니까? |
|
|
병합된 쿼리만?
|
merged_queries_only | boolean |
병합된 쿼리만 포함하시겠습니까? |
|
|
목록 쿼리를 제외하시겠습니까?
|
list_queries | string |
쿼리 목록 쿼리를 제외하시겠습니까? |
|
|
열 정렬
|
sort_column | string |
지정된 열을 기준으로 결과를 정렬합니다. |
|
|
내림차순?
|
sort_descending | boolean |
결과를 내림차순으로 정렬하시겠습니까? |
|
|
추가된 이후
|
date_added | date-time |
지정된 날짜(예: '2020-09-18T04:13:56Z')에서 만든 쿼리로 결과를 필터링합니다. |
|
|
ID로 추가됨
|
added_by | string |
지정된 사용자 ID로 추가된 쿼리로 결과를 필터링합니다. |
|
|
한계
|
limit | integer |
반환할 레코드 수를 나타냅니다. 기본값은 50입니다. 최대값은 200입니다. |
|
|
상쇄
|
offset | integer |
건너뛸 레코드 수를 나타냅니다. 페이지 매김과 함께 사용합니다. |
반환
Queries
쿼리 작업 상태 가져오기
백그라운드 쿼리 실행 작업에 대한 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
직무 ID
|
job_id | True | string |
쿼리 실행 작업의 시스템 레코드 ID입니다. |
|
결과 URL을 포함하시겠습니까?
|
include_read_url | string |
쿼리 결과 파일에 URL을 포함하시겠습니까? |
|
|
콘텐츠 처리
|
content_disposition | string |
쿼리 결과를 보는 방법을 나타냅니다. |
반환
쿼리 실행 작업
쿼리 작업 시작
백그라운드 작업을 시작하여 지정된 쿼리를 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
유형
|
v_query_type_id | True | integer |
특정 쿼리 형식의 쿼리 집합을 필터링합니다. |
|
Query
|
id | True | integer |
실행할 쿼리입니다. |
|
출력 형식
|
output_format | string |
쿼리 결과 파일의 출력 형식을 나타냅니다. |
|
|
서식 모드
|
formatting_mode | string |
쿼리 결과에 서식을 적용할지 여부와 방법을 나타냅니다. |
|
|
SQL 생성 모드
|
sql_generation_mode | string |
쿼리 선택 필드를 처리하는 방법을 나타냅니다. '쿼리'를 선택하면 출력에 쿼리에 대해 정의된 선택 필드와 QRECID가 포함됩니다. '내보내기'를 선택하면 출력에 쿼리에 대해 정의된 선택 필드만 포함됩니다. '보고서'를 선택하면 출력에 QRECID만 포함됩니다. |
|
|
정적 쿼리를 사용하시겠습니까?
|
use_static_query_id_set | boolean |
정적 쿼리를 레코드 원본으로 사용하시겠습니까(그렇지 않은 경우 쿼리가 동적으로 실행됨)? |
|
|
Filename
|
results_file_name | string |
파일 확장명 없이 다운로드할 파일의 이름입니다. |
반환
쿼리 작업 시작
정의
QueryApi.ExecuteQueryResponse
쿼리 작업 시작
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
직무 ID
|
id | string |
쿼리 작업 식별자입니다. |
|
상태
|
status | string |
결과 쿼리 작업 상태입니다. '보류 중' - 작업이 큐에 대기되었지만 아직 실행이 시작되지 않았습니다. '실행 중' - 작업이 실행 중입니다. '완료됨' - 작업이 성공적으로 완료되었습니다. '실패' - 작업이 실패했습니다. '취소' - 작업 취소가 요청되었습니다(하지만 여전히 성공적으로 완료할 수 있음). '취소됨' - 작업이 취소되었습니다. '제한됨' - 작업이 제한되었으며 공간을 사용할 수 있을 때 실행됩니다. |
|
Message
|
message | string |
응답과 연결된 메시지입니다. |
QueryApi.QueryExecutionJob
쿼리 실행 작업
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
직무 ID
|
id | string |
쿼리 작업 식별자입니다. |
|
상태
|
status | string |
결과 쿼리 작업 상태입니다. '보류 중' - 작업이 큐에 대기되었지만 아직 실행이 시작되지 않았습니다. '실행 중' - 작업이 실행 중입니다. '완료됨' - 작업이 성공적으로 완료되었습니다. '실패' - 작업이 실패했습니다. '취소' - 작업 취소가 요청되었습니다(하지만 여전히 성공적으로 완료할 수 있음). '취소됨' - 작업이 취소되었습니다. '제한됨' - 작업이 제한되었으며 공간을 사용할 수 있을 때 실행됩니다. |
|
행 수
|
row_count | integer |
쿼리의 레코드 수입니다. |
|
쿼리 결과 URI
|
sas_uri | string |
쿼리 결과에 액세스하기 위한 URI입니다. 이 URI는 쿼리 결과에 액세스하기 위한 보안 자격 증명으로 처리되어야 합니다. 값은 중요한 것으로 간주되며 URI는 15분 후에 만료됩니다. |
QueryApi.QuerySummary
Query
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | integer |
쿼리의 시스템 레코드 ID입니다. |
|
이름
|
name | string |
쿼리의 고유 이름입니다. |
|
Description
|
description | string |
쿼리에 대한 설명입니다. |
|
유형
|
type | string |
쿼리의 형식입니다. |
|
형식 ID
|
type_id | integer |
쿼리 형식의 시스템 레코드 ID입니다. |
|
카테고리
|
category | string |
쿼리의 범주입니다. |
|
범주 ID
|
category_id | integer |
쿼리 범주의 시스템 레코드 ID입니다. |
|
포맷
|
format | string |
쿼리 형식입니다. |
|
지원되는 보기
|
view_supported | boolean |
쿼리를 볼 수 있나요? |
|
편집이 지원되는가요?
|
edit_supported | boolean |
쿼리를 편집할 수 있나요? |
|
즐겨찾기인가요?
|
favorite | boolean |
쿼리가 즐겨찾기인가요? |
|
묻기 필드가 있나요?
|
has_ask_fields | boolean |
쿼리에 ask 연산자가 있는 필터 필드가 포함됩니까? |
|
쿼리로 생성하시겠습니까?
|
created_by_query | boolean |
쿼리 모듈 내에서 쿼리가 만들어졌나요? |
|
지원되는 실행 모드
|
supported_execution_modes | string |
지원되는 실행 모드입니다. |
|
수정할 수 있나요?
|
can_modify | boolean |
사용자가 쿼리를 수정할 수 있나요? |
|
실행할 수 있나요?
|
can_execute | boolean |
사용자가 쿼리를 실행할 수 있나요? |
|
다른 사용자가 수정할 수 있나요?
|
others_can_modify | boolean |
다른 사용자가 쿼리를 수정할 수 있나요? |
|
다른 사용자는 실행할 수 있나요?
|
others_can_execute | boolean |
다른 사용자가 쿼리를 실행할 수 있나요? |
|
쿼리 목록인가요?
|
query_list | boolean |
쿼리가 쿼리 목록 쿼리인가요? |
|
중복 항목을 표시하지 않습니다.
|
suppress_duplicates | boolean |
쿼리 결과에 중복 항목이 표시되지 않는가요? |
|
쿼리 이름에서 선택
|
select_from_query_name | string |
쿼리의 기본 선택으로 사용되는 쿼리의 이름입니다. |
|
쿼리 ID에서 선택
|
select_from_query_id | integer |
쿼리의 기본 선택으로 사용되는 쿼리의 시스템 레코드 ID입니다. |
|
마지막 실행
|
date_last_run | date-time |
쿼리가 마지막으로 실행된 날짜입니다. |
|
레코드 수
|
num_records | integer |
쿼리가 마지막으로 실행된 시간을 찾은 레코드 수입니다. |
|
경과된 시간
|
elapsed_ms | integer |
쿼리가 마지막으로 실행된 경과 시간(밀리초)입니다. |
|
만든 날짜
|
date_added | date-time |
쿼리를 만든 날짜입니다. |
|
만든 사람:
|
added_by | string |
쿼리를 만든 사용자의 이름입니다. |
|
변경된 날짜
|
date_changed | date-time |
쿼리가 마지막으로 변경된 날짜입니다. |
|
변경한 내용
|
last_changed_by | string |
쿼리를 마지막으로 변경한 사용자의 이름입니다. |
QueryApi.QuerySummaryCollection
Queries
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
queries
|
queries | array of QueryApi.QuerySummary |
응답에 포함된 항목 집합입니다. |