다음을 통해 공유


Blackbaud Raisers Edge NXT 상호 작용

Blackbaud Raiser's Edge NXT는 비영리 단체와 전체 사회적 선의의 커뮤니티를 위해 특별히 구축된 포괄적인 클라우드 기반 모금 및 기부자 관리 소프트웨어 솔루션입니다. Interactions 커넥터를 사용하여 구성 작업을 관리합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 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
커넥터 메타데이터
게시자 Blackbaud, 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
작업 ID
action_id True string

가져올 작업의 시스템 레코드 ID입니다.

반환

조치

구성 요소 작업 나열

구성 요소에 대한 작업을 나열합니다.

매개 변수

Name 필수 형식 Description
구성 요소 ID
constituent_id True string

구성 요소의 시스템 레코드 ID입니다.

반환

활동

구성 요소 작업 만들기

새 구성 요소를 만듭니다.

매개 변수

Name 필수 형식 Description
구성 요소 ID
constituent_id True string

작업과 연결된 구성 요소의 시스템 레코드 ID입니다.

날짜
date True date-time

작업 날짜(예: '2020-09-18T04:13:56Z')

카테고리
category True string

구성 요소 상호 작용의 채널 또는 의도입니다.

유형
type string

범주를 보완하기 위한 작업에 대한 추가 설명입니다.

요약
summary string

레코드의 맨 위에 표시되는 작업에 대한 간단한 설명입니다. 문자 제한: 255.

비고
description string

작업 요약을 자세히 설명하는 자세한 설명입니다.

완료?
completed boolean

작업이 완료되었는지 여부 시스템이 사용자 지정 작업 상태를 사용하도록 구성된 경우 이 값은 작업 상태 값을 기반으로 합니다.

완료됨
completed_date date-time

작업이 완료된 날짜(예: '2020-09-18T04:13:56Z')

상태
status string

작업 상태입니다.

방향
direction string

동작의 방향입니다.

위치
location string

작업의 위치입니다.

기회 ID
opportunity_id string

작업과 연결된 기회의 시스템 레코드 ID입니다.

결과
outcome string

작업의 결과입니다.

Priority
priority string

작업의 우선 순위입니다.

시작 시간
start_time string

작업의 시작 시간입니다. HH:mm 형식으로 24시간을 사용합니다.

종료 시간
end_time string

작업의 종료 시간입니다. HH:mm 형식으로 24시간을 사용합니다.

작성자
author string

작업의 요약 및 설명 작성자입니다. 제공되지 않으면 사용자의 계정에 따라 기본 집합이 설정됩니다. 문자 제한: 50.

모금 행사
fundraisers array of string

작업과 관련된 모금 행사의 시스템 레코드 ID 집합입니다.

반환

만든 작업

구성 요소 작업 업데이트

구성 요소를 업데이트합니다.

매개 변수

Name 필수 형식 Description
작업 ID
action_id True string

업데이트할 작업의 시스템 레코드 ID입니다.

날짜
date date-time

작업 날짜(예: '2020-09-18T04:13:56Z')

카테고리
category string

구성 요소 상호 작용의 채널 또는 의도입니다.

유형
type string

범주를 보완하기 위한 작업에 대한 추가 설명입니다.

요약
summary string

레코드의 맨 위에 표시되는 작업에 대한 간단한 설명입니다. 문자 제한: 255.

비고
description string

작업 요약을 자세히 설명하는 자세한 설명입니다.

완료?
completed boolean

작업이 완료되었는지 여부 시스템이 사용자 지정 작업 상태를 사용하도록 구성된 경우 이 값은 작업 상태 값을 기반으로 합니다.

완료됨
completed_date date-time

작업이 완료된 날짜(예: '2020-09-18T04:13:56Z')

상태
status string

작업 상태입니다.

방향
direction string

동작의 방향입니다.

위치
location string

작업의 위치입니다.

기회 ID
opportunity_id string

작업과 연결된 기회의 시스템 레코드 ID입니다.

결과
outcome string

작업의 결과입니다.

Priority
priority string

작업의 우선 순위입니다.

시작 시간
start_time string

작업의 시작 시간입니다. HH:mm 형식으로 24시간을 사용합니다.

종료 시간
end_time string

작업의 종료 시간입니다. HH:mm 형식으로 24시간을 사용합니다.

모금 행사
fundraisers array of string

작업과 관련된 모금 행사의 시스템 레코드 ID 집합입니다.

작업 나열

작업 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
List
list_id string

지정된 목록에 포함된 작업 집합을 필터링하는 데 사용되는 목록 식별자를 정의합니다. 이 값을 설정하면 지정된 다른 필터가 무시됩니다.

계산된 상태
computed_status string

계산된 작업 상태에 따라 결과에 대한 필터를 나타냅니다. 사용 가능한 값은 Open, Completed 또는 PastDue입니다.

상태
status_code string

결과를 필터링하는 작업 상태 코드를 나타냅니다(시스템이 작업 상태 코드를 사용하도록 구성된 경우에만 적용 가능). 예를 들어 "Pending"은 상태가 "Pending"인 작업을 반환합니다.

한계
limit integer

반환할 레코드 수를 나타냅니다. 기본값은 500입니다. 최대값은 5000입니다.

상쇄
offset integer

건너뛸 레코드 수를 나타냅니다. 페이지 매김과 함께 사용합니다.

추가된 이후
date_added date-time

지정된 날짜(예: '2020-09-18T04:13:56Z')에 생성된 작업으로 결과를 필터링합니다.

수정된 날짜 또는 이후
last_modified date-time

지정된 날짜(예: '2020-09-18T04:13:56Z')에 수정된 작업으로 결과를 필터링합니다.

반환

활동

작업 사용자 정의 필드 나열

작업에 대한 사용자 지정 필드를 나열합니다.

매개 변수

Name 필수 형식 Description
작업 ID
action_id True string

작업의 시스템 레코드 ID입니다.

반환

사용자 지정 필드

작업 사용자 정의 필드 만들기

새 작업 사용자 정의 필드를 만듭니다.

매개 변수

Name 필수 형식 Description
body
body True dynamic

만들 사용자 지정 필드를 나타내는 개체입니다.

반환

만든 작업 사용자 정의 필드

작업 사용자 정의 필드 업데이트

작업 사용자 정의 필드를 업데이트합니다.

매개 변수

Name 필수 형식 Description
사용자 지정 필드 ID
custom_field_id True string

업데이트할 사용자 지정 필드의 시스템 레코드 ID입니다.

body
body True dynamic

업데이트할 사용자 지정 필드의 속성을 나타내는 개체입니다.

작업 첨부 파일 나열

작업에 대한 첨부 파일을 나열합니다.

매개 변수

Name 필수 형식 Description
작업 ID
action_id True string

작업의 시스템 레코드 ID입니다.

반환

Attachments

작업 첨부 파일 만들기

새 작업 첨부 파일을 만듭니다.

매개 변수

Name 필수 형식 Description
작업 ID
parent_id True string

첨부 파일과 연결된 작업의 시스템 레코드 ID입니다.

유형
type True string

첨부 파일 형식입니다. 실제 첨부 파일은 로컬 또는 네트워크에 저장된 이미지, PDF 또는 Word 문서와 같은 업로드된 파일입니다. 시스템에 저장되고 관리됩니다. 링크 첨부 파일은 온라인 또는 클라우드 스토리지 계정에 있는 이미지, 블로그 게시물 또는 YouTube 비디오와 같은 파일에 대한 링크입니다. 외부에 저장되고 관리됩니다.

이름
name string

첨부 파일의 이름입니다. 문자 제한: 150.

날짜
date date-time

첨부 파일의 날짜(예: '2020-09-18T04:13:56Z') 이 필드는 기본적으로 현재 날짜 및 시간(제공되지 않은 경우)으로 설정됩니다.

URL
url string

첨부 파일의 URL입니다. 이는 링크 첨부 파일에 필요하며 실제 첨부 파일에는 적용되지 않습니다.

파일 이름
file_name string

파일 이름입니다. 문자 제한: 36. 실제 첨부 파일의 경우에만 해당합니다.

파일 ID
file_id string

파일의 식별자입니다. 문자 제한: 36. 실제 첨부 파일의 경우에만 해당합니다.

썸네일 ID
thumbnail_id string

썸네일의 식별자입니다. 문자 제한: 36. 실제 첨부 파일의 경우에만 해당합니다.

태그들
tags array of string

첨부 파일과 연결된 태그입니다.

반환

작업 첨부 파일 만들기

작업 첨부 파일 업데이트

작업 첨부 파일을 업데이트합니다.

매개 변수

Name 필수 형식 Description
첨부 파일 ID
attachment_id True string

업데이트할 첨부 파일의 시스템 레코드 ID입니다.

이름
name string

첨부 파일의 이름입니다. 문자 제한: 150.

날짜
date date-time

첨부 파일의 날짜(예: '2020-09-18T04:13:56Z')

URL
url string

첨부 파일의 URL입니다. 이는 링크 첨부 파일에 필요하며 실제 첨부 파일에는 적용되지 않습니다.

태그들
tags array of string

첨부 파일과 연결된 태그입니다.

정의

ConstituentApi.ActionAttachmentRead

Attachment

Name 경로 형식 Description
아이디
id string

첨부 파일의 시스템 레코드 ID입니다.

작업 ID
parent_id string

첨부 파일과 연결된 작업의 시스템 레코드 ID입니다.

유형
type string

첨부 파일 형식입니다. 실제 첨부 파일은 로컬 또는 네트워크에 저장된 이미지, PDF 또는 Word 문서와 같은 업로드된 파일입니다. 시스템에 저장되고 관리됩니다. 링크 첨부 파일은 온라인 또는 클라우드 스토리지 계정에 있는 이미지, 블로그 게시물 또는 YouTube 비디오와 같은 파일에 대한 링크입니다. 외부에 저장되고 관리됩니다.

이름
name string

첨부 파일의 이름입니다. 문자 제한: 150.

날짜
date date-time

첨부 파일의 날짜입니다.

URL
url string

첨부 파일의 URL입니다. 이는 링크 첨부 파일에 필요하며 실제 첨부 파일에는 적용되지 않습니다.

파일 이름
file_name string

파일 이름입니다. 문자 제한: 36. 실제 첨부 파일의 경우에만 해당합니다.

파일 ID
file_id string

파일의 식별자입니다. 문자 제한: 36. 실제 첨부 파일의 경우에만 해당합니다.

썸네일 ID
thumbnail_id string

썸네일의 식별자입니다. 문자 제한: 36. 실제 첨부 파일의 경우에만 해당합니다.

썸네일 URL
thumbnail_url string

썸네일의 URL입니다. 이미지만 있는 실제 첨부 파일의 경우 액세스를 60분으로 제한하는 시간 제한 서명을 포함합니다.

콘텐츠 형식
content_type string

콘텐츠 형식입니다. 실제 첨부 파일의 경우에만 해당합니다.

파일 크기
file_size integer

파일 크기(바이트)입니다. 실제 첨부 파일의 경우에만 해당합니다.

태그들
tags array of string

첨부 파일과 연결된 태그입니다.

ConstituentApi.ActionCustomFieldRead

사용자 지정 필드

Name 경로 형식 Description
아이디
id string

사용자 지정 필드의 시스템 레코드 ID입니다.

작업 ID
parent_id string

사용자 지정 필드와 연결된 작업의 시스템 레코드 ID입니다.

카테고리
category string

사용자 지정 필드 범주입니다.

유형
type string

사용자 지정 필드가 나타내는 데이터의 형식입니다.

가치
value

사용자 지정 필드의 값입니다.

텍스트 값
text_value string

사용자 지정 필드의 텍스트 값입니다.

숫자 값
number_value integer

사용자 정의 필드의 숫자 값입니다.

날짜 값
date_value date

사용자 지정 필드의 날짜 값입니다.

통화 값
currency_value double

사용자 지정 필드의 통화 값입니다.

부울 값
boolean_value boolean

사용자 지정 필드의 부울 값입니다.

테이블 항목 값
codetableentry_value string

사용자 지정 필드의 테이블 항목 값입니다.

구성 요소 ID 값
constituentid_value string

사용자 지정 필드의 구성 요소 ID 값입니다.

fuzzydate_value.d integer

유사 날짜의 날짜입니다.

개월
fuzzydate_value.m integer

유사 항목 날짜의 월입니다.

fuzzydate_value.y integer

유사 날짜의 연도입니다.

날짜
date date

사용자 지정 필드의 날짜입니다.

주석
comment string

사용자 지정 필드에 대한 주석입니다. 문자 제한: 50.

추가된 날짜
date_added date-time

사용자 지정 필드를 만든 날짜입니다.

수정된 날짜
date_modified date-time

사용자 지정 필드가 마지막으로 수정된 날짜입니다.

ConstituentApi.ActionRead

조치

Name 경로 형식 Description
아이디
id string

작업의 시스템 레코드 ID입니다.

구성 요소 ID
constituent_id string

작업과 연결된 구성 요소의 시스템 레코드 ID입니다.

카테고리
category string

구성 요소 상호 작용의 채널 또는 의도입니다.

완료?
completed boolean

작업이 완료되었는지 여부 시스템이 사용자 지정 작업 상태를 사용하도록 구성된 경우 이 값은 작업 상태 값을 기반으로 합니다.

완료됨
completed_date date-time

작업이 완료된 날짜입니다.

날짜
date date-time

작업 날짜입니다.

비고
description string

작업 요약을 자세히 설명하는 자세한 설명입니다.

방향
direction string

동작의 방향입니다.

모금 행사
fundraisers array of string

작업과 관련된 모금 행사의 시스템 레코드 ID 집합입니다.

위치
location string

작업의 위치입니다.

기회 ID
opportunity_id string

작업과 연결된 기회의 시스템 레코드 ID입니다.

결과
outcome string

작업의 결과입니다.

Priority
priority string

작업의 우선 순위입니다.

시작 시간
start_time string

작업의 시작 시간입니다. HH:mm 형식으로 24시간을 사용합니다.

종료 시간
end_time string

작업의 종료 시간입니다. HH:mm 형식으로 24시간을 사용합니다.

상태
status string

작업 상태입니다.

상태 코드
status_code string

작업 상태 코드입니다. 이 속성은 시스템이 사용자 지정 작업 상태를 사용하도록 구성된 경우에만 반환됩니다.

계산된 상태
computed_status string

계산된 작업 상태입니다. 시스템이 사용자 지정 작업 상태를 사용하도록 구성되지 않은 경우 이 필드는 완료된 날짜 속성과 날짜 속성을 기반으로 상태를 계산합니다. 그렇지 않은 경우 필드는 작업의 날짜 속성 및 작업의 작업 상태 속성이 완료된 것으로 구성되었는지 여부에 따라 상태를 계산합니다.

요약
summary string

레코드의 맨 위에 표시되는 작업에 대한 간단한 설명입니다. 문자 제한: 255.

유형
type string

범주를 보완하기 위한 작업에 대한 추가 설명입니다.

추가된 날짜
date_added date-time

작업이 만들어진 날짜입니다.

수정된 날짜
date_modified date-time

작업이 마지막으로 수정된 날짜입니다.

ConstituentApi.ApiCollectionOfActionAttachmentRead

Attachments

Name 경로 형식 Description
수량
count integer

요청 매개 변수를 적용한 후 컬렉션으로 검색할 수 있는 항목 수입니다. 제한 및 오프셋 매개 변수는 개수에 영향을 미치지 않지만 페이징을 용이하게 하기 위해 값 결과 집합의 항목 수에 영향을 줄 수 있습니다.

value
value array of ConstituentApi.ActionAttachmentRead

응답에 포함된 항목 집합입니다. 컬렉션에 있는 항목의 하위 집합일 수 있습니다.

ConstituentApi.ApiCollectionOfActionCustomFieldRead

사용자 지정 필드

Name 경로 형식 Description
수량
count integer

요청 매개 변수를 적용한 후 컬렉션으로 검색할 수 있는 항목 수입니다. 제한 및 오프셋 매개 변수는 개수에 영향을 미치지 않지만 페이징을 용이하게 하기 위해 값 결과 집합의 항목 수에 영향을 줄 수 있습니다.

value
value array of ConstituentApi.ActionCustomFieldRead

응답에 포함된 항목 집합입니다. 컬렉션에 있는 항목의 하위 집합일 수 있습니다.

ConstituentApi.ApiCollectionOfActionRead

활동

Name 경로 형식 Description
수량
count integer

요청 매개 변수를 적용한 후 컬렉션으로 검색할 수 있는 항목 수입니다. 제한 및 오프셋 매개 변수는 개수에 영향을 미치지 않지만 페이징을 용이하게 하기 위해 값 결과 집합의 항목 수에 영향을 줄 수 있습니다.

value
value array of ConstituentApi.ActionRead

응답에 포함된 항목 집합입니다. 컬렉션에 있는 항목의 하위 집합일 수 있습니다.

ConstituentApi.CreatedAction

만든 작업

Name 경로 형식 Description
아이디
id string

새로 만든 작업의 ID입니다.

ConstituentApi.CreatedActionAttachment

작업 첨부 파일 만들기

Name 경로 형식 Description
아이디
id string

새로 만든 작업 첨부 파일의 ID입니다.

ConstituentApi.CreatedActionCustomField

만든 작업 사용자 정의 필드

Name 경로 형식 Description
아이디
id string

새로 만든 작업 사용자 정의 필드의 ID입니다.