Blackbaud RENXT Import （Preview）
Blackbaud Raiser 的 Edge NXT 是一款全面的基於雲的籌款和捐助者管理軟件解決方案，專為非營利組織和整個社會公益社區構建。 使用 Import 連接器來管理和執行匯入工作。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| Copilot Studio | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 聯絡方式 | |
|---|---|
| Name | Blackbaud 支持 |
| URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Blackbaud， Inc. |
| 網站 | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| 隱私權原則 | https://www.blackbaud.com/privacy-shield |
| 類別 | 銷售和客戶關係管理;生產力 |
Raiser 的 Edge NXT 是一款全面的基於雲的籌款和捐助者管理軟件解決方案，專為非營利組織和整個社會公益社區構建。
此連接器建立在 Blackbaud 的 SKY API 之上，並提供操作協助管理 The Raiser's Edge NXT 內的匯入工作。
如需詳細資訊，請檢視 文件。
Prerequisites
若要使用此連接器，您必須擁有 Blackbaud ID 帳戶，才能存取一或多個 Blackbaud 環境。
此外，您組織的管理員還必須在系統內執行管理員層級動作，才能讓此連接器存取您的 Blackbaud 環境。 有關這些先決條件的詳細資訊，請參閱 初始設定 文件。
如何取得憑證？
您組織的管理員將向您發送組織的 Raiser's Edge NXT 環境的邀請，並在環境中配置您的用戶帳戶權限。 使用此連接器不需要其他認證。
已知問題和限制
連接器將在您的使用者帳戶的內容中運作，因此將受限於您在環境中的使用者權限。
動作
| 刪除匯入工作 |
刪除一個匯入工作。 |
| 匯入工作列表 |
清單上有進口工作。 |
| 取得匯入工作例外檔案下載 URI |
回傳匯入作業例外檔案的下載 URI。 |
| 取得匯入工作檔案並上傳 URI |
回傳一個新檔案上傳 URI，用於一個待處理的匯入作業。 |
| 建立匯入工作 |
建立一個匯入工作，檔案上傳後會再啟動。 |
| 找進口工作 |
回傳特定進口作業的詳細資料。 |
| 更新匯入工作 |
更新匯入工作的細節。 |
| 開始進口工作 |
啟動背景工作來執行指定的匯入。 |
刪除匯入工作
刪除一個匯入工作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
匯入工作ID
|
job_id | True | string |
系統記錄 ID 是匯入作業要刪除的。 |
匯入工作列表
清單上有進口工作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Status
|
status | string |
依狀態篩選職缺。 |
|
|
Limit
|
limit | integer |
代表要傳回的記錄數目。 預設值為 100。 最大值為 10000。 |
|
|
接續權杖
|
continuation_token | string |
繼續代幣以取得下一頁的結果。 |
傳回
進口工作
取得匯入工作例外檔案下載 URI
回傳匯入作業例外檔案的下載 URI。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
作業識別碼
|
job_id | True | string |
系統記錄的匯入作業ID。 |
傳回
檔案下載資訊
取得匯入工作檔案並上傳 URI
回傳一個新檔案上傳 URI，用於一個待處理的匯入作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
作業識別碼
|
job_id | True | string |
系統記錄的匯入作業ID。 |
傳回
檔案上傳資訊
建立匯入工作
建立一個匯入工作，檔案上傳後會再啟動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案名稱
|
file_name | True | string |
要匯入的檔案名稱。 |
|
標題列
|
header_row | string |
匯入 CSV 檔案時使用的標頭列。 |
傳回
創建的選民同意
找進口工作
回傳特定進口作業的詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
作業識別碼
|
job_id | True | string |
系統記錄的匯入作業ID。 |
傳回
匯入作業
更新匯入工作
更新匯入工作的細節。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
匯入工作ID
|
job_id | True | string |
要更新的匯入作業的系統記錄 ID。 |
|
檔案名稱
|
file_name | string |
要匯入的檔案名稱。 |
開始進口工作
啟動背景工作來執行指定的匯入。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
作業識別碼
|
job_id | True | string |
一開始要輸入進口工作的 ID。 |
傳回
已啟動報告工作
定義
ImportApi.CreateImportJobResponse
創建的選民同意
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
新建立的匯入任務的 ID。 |
|
檔案上傳 URI
|
file_upload_uri | string |
上傳檔案匯入的 URI。 |
|
欄位對應
|
field_mappings | array of ImportApi.FieldMapping |
對於 CSV 匯入，欄位會從標頭列對應到目標欄位。 |
|
映射驗證訊息
|
mapping_validation_messages | array of ImportApi.MappingValidationMessage |
來自已建立作業標頭列的映射驗證訊息。 只適用於 CSV 匯入。 |
ImportApi.FieldMapping
欄位對應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
來源場
|
source_field | string |
來源欄位的名稱。 |
|
目標場
|
target_field | string |
目標欄位名稱。 |
ImportApi.ImportJobFileUploadInfo
檔案上傳資訊
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
檔案上傳 URI
|
file_upload_uri | string |
上傳檔案匯入的 URI。 |
ImportApi.ImportJob
匯入作業
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
匯入工作識別碼。 |
|
檔案名稱
|
file_name | string |
匯入檔案的名稱。 |
|
約會開始
|
start_date | date-time |
匯入作業開始的日期。 |
|
完成日期
|
end_date | date-time |
進口工作完成的日期。 |
|
執行持續時間
|
run_duration | integer |
匯入作業的持續時間以秒計。 |
|
排序
|
sequence | integer |
匯入作業的序號。 |
|
已處理的數據列
|
rows_processed | integer |
匯入作業處理的列數。 |
|
已承諾的行數
|
rows_committed | integer |
匯入作業所提交的列數。 |
|
排數被拒絕
|
rows_rejected | integer |
進口作業拒絕的列數。 |
|
例外狀況計數
|
exception_count | integer |
匯入作業遇到的例外數量。 |
|
故障訊息
|
failure_message | string |
匯入作業的失敗訊息。 |
|
Status
|
status | string |
匯入工作狀態。 |
|
按 ID 添加
|
added_by | string |
就是建立匯入工作的使用者。 |
|
建立日期
|
date_added | date-time |
匯入工作建立的日期。 |
|
修改日期
|
date_modified | date-time |
匯入作業最後修改的日期。 |
ImportApi.ImportJobExceptionFileDownloadInfo
檔案下載資訊
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
檔案下載 URI
|
file_download_uri | string |
用來下載例外檔案的 URI。 |
ImportApi.ImportJobSummary
匯入作業
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
匯入工作識別碼。 |
|
檔案名稱
|
file_name | string |
匯入檔案的名稱。 |
|
約會開始
|
start_date | date-time |
匯入作業開始的日期。 |
|
完成日期
|
end_date | date-time |
進口工作完成的日期。 |
|
執行持續時間
|
run_duration | integer |
匯入作業的持續時間以秒計。 |
|
排序
|
sequence | integer |
匯入作業的序號。 |
|
已處理的數據列
|
rows_processed | integer |
匯入作業處理的列數。 |
|
已承諾的行數
|
rows_committed | integer |
匯入作業所提交的列數。 |
|
排數被拒絕
|
rows_rejected | integer |
進口作業拒絕的列數。 |
|
例外狀況計數
|
exception_count | integer |
匯入作業遇到的例外數量。 |
|
故障訊息
|
failure_message | string |
匯入作業的失敗訊息。 |
|
Status
|
status | string |
匯入工作狀態。 |
|
按 ID 添加
|
added_by | string |
就是建立匯入工作的使用者。 |
|
建立日期
|
date_added | date-time |
匯入工作建立的日期。 |
|
修改日期
|
date_modified | date-time |
匯入作業最後修改的日期。 |
ImportApi.ImportJobSummaryCollection（匯入Api.ImportJobSummaryCollection）
進口工作
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
計數
|
count | integer |
與篩選器匹配的總工作數。 |
|
Limit
|
limit | integer |
請求回傳的紀錄數量。 |
|
接續權杖
|
continuation_token | string |
繼續代幣以取得下一頁的結果。 |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
回應中包含的專案集。 |
ImportApi.MappingValidationMessage
映射驗證訊息
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
記錄映射
|
record_mapping | string |
與驗證錯誤訊息相關的記錄映射。 |
|
目標場
|
target_field | string |
與驗證錯誤訊息相關的目標欄位。 |
|
訊息類型
|
message_type | string |
驗證訊息的類型。 |
|
訊息
|
message | string |
驗證訊息。 |
|
檔案欄位
|
file_fields | array of string |
與驗證錯誤訊息相關的檔案欄位。 |
ImportApi.StartImportJobResponse
已啟動報告工作
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Status
|
status | string |
匯入工作狀態。 |