Blackbaud FENXT 쿼리(미리 보기)

Blackbaud Financial 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)
파워 오토메이트	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-financial-edge-nxt
개인 정보 보호 정책	https://www.blackbaud.com/privacy-shield
카테고리	판매 및 CRM; 생산력

Financial Edge NXT 는 비영리 단체를 위해 특별히 빌드된 포괄적인 클라우드 기반 회계 소프트웨어 솔루션입니다.

이 커넥터는 Blackbaud의 SKY API를 기반으로 하며, The Financial Edge NXT 내에 있는 쿼리 및 관련 엔터티를 관리하는 데 도움이 되는 작업을 제공합니다.

자세한 내용은 설명서를 참조하세요.

필수 조건

이 커넥터를 사용하려면 하나 이상의 Blackbaud 환경에 액세스할 수 있는 Blackbaud ID 계정이 있어야 합니다.

또한 조직의 관리자는 이 커넥터가 Blackbaud 환경에 액세스할 수 있도록 시스템 내에서 관리자 수준 작업을 수행해야 합니다. 이러한 필수 구성 요소에 대한 자세한 내용은 초기 설치 설명서에서 확인할 수 있습니다.

자격 증명을 가져오는 방법

조직의 관리자는 조직의 Financial Edge NXT 환경에 초대를 보내고 환경 내에서 사용자 계정 권한을 구성합니다. 이 커넥터를 사용하려면 추가 자격 증명이 필요하지 않습니다.

알려진 문제 및 제한 사항

커넥터는 사용자 계정의 컨텍스트에서 작동하므로 환경 내에서 사용자 권한이 적용됩니다.

제한 한도

속성	호출	갱신 기간
연결당 API 호출	100	60초

actions

임시 쿼리 작업 시작	백그라운드 작업을 시작하여 지정된 임시 쿼리 정의를 실행합니다.
정적 쿼리 새로 고침 작업 시작	백그라운드 작업을 시작하여 지정된 정적 쿼리에 저장된 키를 새로 고칩니다.
쿼리 나열	쿼리 목록을 반환합니다.
쿼리 나열(v2)	쿼리 목록을 반환합니다.
쿼리 삭제	쿼리를 삭제합니다.
쿼리 실행 작업 취소	쿼리 실행 작업의 상태를 취소로 업데이트합니다.
쿼리 작업 상태 가져오기	백그라운드 쿼리 실행 작업에 대한 정보를 반환합니다.
쿼리 작업 시작	백그라운드 작업을 시작하여 지정된 쿼리를 실행합니다.

임시 쿼리 작업 시작

작업 ID:

StartAdHocQueryExecutionJob

백그라운드 작업을 시작하여 지정된 임시 쿼리 정의를 실행합니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
쿼리 정의	query	True	object	쿼리 정의의 JSON 표현입니다.
출력 형식	output_format		string	쿼리 결과 파일의 출력 형식을 나타냅니다.
서식 모드	formatting_mode		string	쿼리 결과에 서식을 적용할지 여부와 방법을 나타냅니다.
Filename	results_file_name		string	선택 사항 - 파일 확장명 없이 다운로드할 파일의 이름입니다. 제공되지 않으면 쿼리 이름을 기반으로 파일 이름이 생성됩니다.
표준 시간대 오프셋	time_zone_offset_in_minutes		integer	분 단위로 표현된 표준 시간대 오프셋입니다.
긴 설명을 사용하시겠습니까?	display_code_table_long_description		boolean	간단한 설명 대신 긴 설명으로 코드 테이블 항목을 표시하시겠습니까?

반품

쿼리 작업 시작

몸

QueryApi.ExecuteQueryResponse

정적 쿼리 새로 고침 작업 시작

작업 ID:

StartRefreshStaticQueryExecutionJob

백그라운드 작업을 시작하여 지정된 정적 쿼리에 저장된 키를 새로 고칩니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
유형	v_query_type_id	True	integer	특정 쿼리 형식의 쿼리 집합을 필터링합니다.
Query	id	True	integer	실행할 쿼리입니다.
표준 시간대 오프셋	time_zone_offset_in_minutes		integer	분 단위로 표현된 표준 시간대 오프셋입니다.
긴 설명을 사용하시겠습니까?	display_code_table_long_description		boolean	간단한 설명 대신 긴 설명으로 코드 테이블 항목을 표시하시겠습니까?
operator	operator	True	string	필터 필드 연산자입니다.
values	filter_values		array of	필터의 값입니다(필터 연산자는 필요한 값 수를 결정합니다).

반품

쿼리 작업 시작

몸

QueryApi.ExecuteQueryResponse

쿼리 나열

작업 ID:

ListQueries

쿼리 목록을 반환합니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
유형	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	병합된 쿼리만 포함하시겠습니까?
열 정렬	sort_column		string	지정된 열을 기준으로 결과를 정렬합니다.
에 추가됨	date_added		date-time	결과를 지정된 날짜에 만든 쿼리로 필터링합니다(예: '2020-09-18T04:13:56Z').
ID로 추가됨	added_by		string	지정된 사용자 ID로 추가된 쿼리로 결과를 필터링합니다.
내림차순?	sort_descending		boolean	결과를 내림차순으로 정렬하시겠습니까?
한계	limit		integer	반환할 레코드 수를 나타냅니다. 기본값은 50입니다. 최대값은 200입니다.
상쇄	offset		integer	건너뛸 레코드 수를 나타냅니다. 페이지 매김과 함께 사용합니다.

반품

Queries

몸

QueryApi.QuerySummaryCollection

쿼리 나열(v2)

작업 ID:

ListQueriesV2

쿼리 목록을 반환합니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
유형	query_type_ids		integer	특정 쿼리 형식의 쿼리 집합을 필터링합니다.
카테고리	category		integer	쿼리 집합을 특정 범주의 쿼리 집합으로 필터링합니다.
포맷	query_format		string	특정 형식의 쿼리 집합을 필터링합니다.
결과 레이아웃	result_layout		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입니다.
연속 토큰	continuation_token		string	결과를 통해 페이징하기 위한 연속 토큰입니다.

반품

Queries

몸

QueryApi.QuerySummaryV2Collection

쿼리 삭제

작업 ID:

DeleteQuery

쿼리를 삭제합니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
쿼리 ID	query_id	True	integer	삭제할 쿼리의 시스템 레코드 ID입니다.

쿼리 실행 작업 취소

작업 ID:

CancelJob

쿼리 실행 작업의 상태를 취소로 업데이트합니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
직무 ID	job_id	True	string	취소할 쿼리 실행 작업의 시스템 레코드 ID입니다.

반품

쿼리 작업 시작

몸

QueryApi.ExecuteQueryResponse

쿼리 작업 상태 가져오기

작업 ID:

GetQueryJobStatus

백그라운드 쿼리 실행 작업에 대한 정보를 반환합니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
직무 ID	job_id	True	string	쿼리 실행 작업의 시스템 레코드 ID입니다.
결과 URL을 포함하시겠습니까?	include_read_url		string	쿼리 결과 파일에 URL을 포함하시겠습니까?
콘텐츠 처리	content_disposition		string	쿼리 결과를 보는 방법을 나타냅니다.

반품

쿼리 실행 작업

몸

QueryApi.QueryExecutionJob

쿼리 작업 시작

작업 ID:

StartQueryExecutionJob

백그라운드 작업을 시작하여 지정된 쿼리를 실행합니다.

매개 변수

속성	키	필수	형식	Description
모듈	module	True	string	요청에 대한 Financial Edge NXT 모듈입니다.
유형	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	선택 사항 - 파일 확장명 없이 다운로드할 파일의 이름입니다. 제공되지 않으면 쿼리 이름을 기반으로 파일 이름이 생성됩니다.
표준 시간대 오프셋	time_zone_offset_in_minutes		integer	분 단위로 표현된 표준 시간대 오프셋입니다.
긴 설명을 사용하시겠습니까?	display_code_table_long_description		boolean	간단한 설명 대신 긴 설명으로 코드 테이블 항목을 표시하시겠습니까?
operator	operator	True	string	필터 필드 연산자입니다.
values	filter_values		array of	필터의 값입니다(필터 연산자는 필요한 값 수를 결정합니다).

반품

쿼리 작업 시작

몸

QueryApi.ExecuteQueryResponse

정의

QueryApi.ExecuteQueryResponse

쿼리 작업 시작

속성	경로	형식	Description
직무 ID	id	string	쿼리 작업 식별자입니다.
상태	status	string	결과 쿼리 작업 상태입니다. '보류 중' - 작업이 큐에 대기되었지만 아직 실행이 시작되지 않았습니다. '실행 중' - 작업이 실행 중입니다. '완료됨' - 작업이 성공적으로 완료되었습니다. '실패' - 작업이 실패했습니다. '취소' - 작업 취소가 요청되었습니다(하지만 여전히 성공적으로 완료할 수 있음). '취소됨' - 작업이 취소되었습니다. '제한됨' - 작업이 제한되었으며 공간을 사용할 수 있을 때 실행됩니다.
Message	message	string	응답과 연결된 메시지입니다.

QueryApi.QueryExecutionJob

쿼리 실행 작업

속성	경로	형식	Description
직무 ID	id	string	쿼리 작업 식별자입니다.
상태	status	string	결과 쿼리 작업 상태입니다. '보류 중' - 작업이 큐에 대기되었지만 아직 실행이 시작되지 않았습니다. '실행 중' - 작업이 실행 중입니다. '완료됨' - 작업이 성공적으로 완료되었습니다. '실패' - 작업이 실패했습니다. '취소' - 작업 취소가 요청되었습니다(하지만 여전히 성공적으로 완료할 수 있음). '취소됨' - 작업이 취소되었습니다. '제한됨' - 작업이 제한되었으며 공간을 사용할 수 있을 때 실행됩니다.
행 수	row_count	integer	쿼리의 레코드 수입니다.
쿼리 결과 URI	sas_uri	string	쿼리 결과에 액세스하기 위한 URI입니다. 이 URI는 쿼리 결과에 액세스하기 위한 보안 자격 증명으로 처리되어야 합니다. 값은 중요한 것으로 간주되며 URI는 15분 후에 만료됩니다.

QueryApi.QuerySummary

Query

속성	경로	형식	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	다른 사용자가 쿼리를 실행할 수 있나요?
중복 항목을 표시하지 않습니다.	suppress_duplicates	boolean	쿼리 결과에 중복 항목이 표시되지 않는가요?
형	output_limit.type	string	출력 제한 형식입니다.
value	output_limit.limit	integer	저장할 행의 수 또는 백분율입니다(지정된 출력 제한 형식에 따라 다름).
결과 레이아웃	result_layout	string
쿼리 이름에서 선택	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

속성	경로	형식	Description
queries	queries	array of QueryApi.QuerySummary	응답에 포함된 항목 집합입니다.
쿼리 유형이 있나요?	any_query_types	boolean	사용자가 쿼리 형식에 액세스할 수 있나요?
개수	count	integer	제한/오프셋 이전 컬렉션의 총 항목 수입니다.
한계	limit	integer	목록 요청의 제한입니다.
상쇄	offset	integer	목록 요청의 오프셋입니다.

QueryApi.QuerySummaryV2Collection

Queries

속성	경로	형식	Description
queries	queries	array of QueryApi.QuerySummary	응답에 포함된 항목 집합입니다.
쿼리 유형이 있나요?	any_query_types	boolean	사용자가 쿼리 형식에 액세스할 수 있나요?
한계	limit	integer	목록 요청의 제한입니다.
연속 토큰	continuation_token	string	목록 요청에 대한 연속 토큰입니다.