Blackbaud RENXT インポート (プレビュー)
Blackbaud Raiser の Edge NXT は、非営利団体およびソーシャルグッド コミュニティ全体に特化して構築された、クラウドベースの包括的な資金調達および寄付者管理ソフトウェア ソリューションです。 インポート コネクタを使用して、インポート ジョブを管理および実行します。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | Regions |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate（パワーオートメート） | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| Name | Blackbaud のサポート |
| URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| コネクタ メタデータ | |
|---|---|
| 発行元 | Blackbaud, Inc. |
| Web サイト | 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 内でインポート ジョブを管理するための操作を提供します。
詳細については、 ドキュメントを参照してください。
Prerequisites
このコネクタを使用するには、1 つ以上の Blackbaud 環境にアクセスできる Blackbaud ID アカウントが必要です。
さらに、このコネクタが Blackbaud 環境にアクセスできるようにするには、組織の管理者がシステム内で管理者レベルのアクションを実行する必要もあります。 これらの前提条件の詳細については、 初期セットアップ ドキュメントを参照してください。
資格情報を取得する方法
組織の管理者から組織の Raiser の Edge NXT 環境への招待が送信され、環境内でユーザー アカウントのアクセス許可が構成されます。 このコネクタを使用するために追加の資格情報は必要ありません。
既知の問題と制限事項
コネクタはユーザー アカウントのコンテキストで動作するため、環境内のユーザーのアクセス許可の対象となります。
アクション
| インポート ジョブ ファイルのアップロード URI を取得する |
保留中のインポート ジョブの新しいファイル アップロード URI を返します。 |
| インポート ジョブを一覧表示する |
インポート ジョブを一覧表示します。 |
| インポート ジョブを作成する |
ファイルのアップロード後に開始されるインポート ジョブを作成します。 |
| インポート ジョブを削除する |
インポート ジョブを削除します。 |
| インポート ジョブを取得する |
特定のインポート ジョブの詳細を返します。 |
| インポート ジョブを更新する |
インポート ジョブに関する詳細を更新します。 |
| インポート ジョブを開始する |
指定したインポートを実行するバックグラウンド ジョブを開始します。 |
| インポート ジョブ例外ファイルのダウンロード URI を取得する |
インポート ジョブの例外ファイルのダウンロード URI を返します。 |
インポート ジョブ ファイルのアップロード URI を取得する
保留中のインポート ジョブの新しいファイル アップロード URI を返します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
job_id | True | string |
インポート ジョブのシステム レコード ID。 |
返品
ファイルのアップロード情報
インポート ジョブを一覧表示する
インポート ジョブを一覧表示します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
地位
|
status | string |
ジョブを状態でフィルター処理します。 |
|
|
Limit
|
limit | integer |
返すレコードの数を表します。 既定値は 100 です。 最大値は 10000 です。 |
|
|
継続トークン
|
continuation_token | string |
結果の次のページを取得する継続トークン。 |
返品
ジョブのインポート
インポート ジョブを作成する
ファイルのアップロード後に開始されるインポート ジョブを作成します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル名
|
file_name | True | string |
インポートするファイルの名前。 |
|
ヘッダー行
|
header_row | string |
CSV ファイルをインポートするときに使用するヘッダー行。 |
返品
作成された構成の同意
インポート ジョブを削除する
インポート ジョブを削除します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インポート ジョブ ID
|
job_id | True | string |
削除するインポート ジョブのシステム レコード ID。 |
インポート ジョブを取得する
特定のインポート ジョブの詳細を返します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
job_id | True | string |
インポート ジョブのシステム レコード ID。 |
返品
インポートジョブ
- Body
- ImportApi.ImportJob
インポート ジョブを更新する
インポート ジョブに関する詳細を更新します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インポート ジョブ ID
|
job_id | True | string |
更新するインポート ジョブのシステム レコード ID。 |
|
ファイル名
|
file_name | string |
インポートするファイルの名前。 |
インポート ジョブを開始する
指定したインポートを実行するバックグラウンド ジョブを開始します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
job_id | True | string |
開始するインポート ジョブの ID。 |
返品
レポート ジョブの開始
インポート ジョブ例外ファイルのダウンロード URI を取得する
インポート ジョブの例外ファイルのダウンロード URI を返します。
パラメーター
| Name | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
job_id | True | string |
インポート ジョブのシステム レコード ID。 |
返品
ファイルのダウンロード情報
定義
ImportApi.CreateImportJobResponse
作成された構成の同意
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
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
フィールド マッピング
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
source フィールド
|
source_field | string |
ソース フィールドの名前。 |
|
ターゲット フィールド
|
target_field | string |
ターゲット フィールドの名前。 |
ImportApi.ImportJobFileUploadInfo
ファイルのアップロード情報
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
ファイル アップロード URI
|
file_upload_uri | string |
インポートするファイルをアップロードするための URI。 |
ImportApi.ImportJob
インポートジョブ
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
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 | string |
インポート ジョブのステータス。 |
|
ID で追加
|
added_by | string |
インポート ジョブを作成したユーザー。 |
|
作成日
|
date_added | date-time |
インポート ジョブが作成された日付。 |
|
更新日
|
date_modified | date-time |
インポート ジョブが最後に変更された日付。 |
ImportApi.ImportJobExceptionFileDownloadInfo
ファイルのダウンロード情報
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
ファイルダウンロード URI
|
file_download_uri | string |
例外ファイルをダウンロードするための URI。 |
ImportApi.ImportJobSummary
インポートジョブ
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
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 | string |
インポート ジョブのステータス。 |
|
ID で追加
|
added_by | string |
インポート ジョブを作成したユーザー。 |
|
作成日
|
date_added | date-time |
インポート ジョブが作成された日付。 |
|
更新日
|
date_modified | date-time |
インポート ジョブが最後に変更された日付。 |
ImportApi.ImportJobSummaryCollection
ジョブのインポート
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
数える
|
count | integer |
フィルターに一致するジョブの合計数。 |
|
Limit
|
limit | integer |
返される要求されたレコード数。 |
|
継続トークン
|
continuation_token | string |
結果の次のページを取得する継続トークン。 |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
応答に含まれる項目のセット。 |
ImportApi.MappingValidationMessage
マッピング検証メッセージ
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
レコード マッピング
|
record_mapping | string |
検証エラー メッセージに関連付けられているレコード マッピング。 |
|
ターゲット フィールド
|
target_field | string |
検証エラー メッセージに関連付けられているターゲット フィールド。 |
|
メッセージ型 (message type)
|
message_type | string |
検証メッセージの型。 |
|
メッセージ
|
message | string |
検証メッセージ。 |
|
ファイル フィールド
|
file_fields | array of string |
検証エラー メッセージに関連付けられているファイル フィールド。 |
ImportApi.StartImportJobResponse
レポート ジョブの開始
| Name | パス | 型 | 説明 |
|---|---|---|---|
|
地位
|
status | string |
インポート ジョブのステータス。 |