Blackbaud RENXT Sorgusu (Önizleme)
Blackbaud Raiser'ın Edge NXT'i, özellikle kar amacı gütmeyen kuruluşlar ve tüm sosyal fayda topluluğu için oluşturulmuş kapsamlı bir bulut tabanlı bağış toplama ve bağış yönetimi yazılımı çözümüdür. Sorguları yönetmek ve yürütmek için Sorgu bağlayıcısını kullanın.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| İsim | Blackbaud Desteği |
| URL | https://www.blackbaud.com/support |
| E-posta | skyapi@blackbaud.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Karabaud. Inc |
| Web sitesi | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Gizlilik ilkesi | https://www.blackbaud.com/privacy-shield |
| Kategoriler | Satış ve CRM; Verimli -lik |
Raiser Edge NXT , kar amacı gütmeyen kuruluşlar ve sosyal fayda topluluğunun tamamı için özel olarak oluşturulmuş kapsamlı bir bulut tabanlı bağış toplama ve bağış yönetimi yazılımı çözümüdür.
Bu bağlayıcı Blackbaud'un SKY API'sinin üzerine kurulmuştur ve Raiser'ın Edge NXT'sinde bulunan sorguları ve ilgili varlıkları yönetmeye yardımcı olacak işlemler sağlar.
Daha fazla bilgi için lütfen belgeleri görüntüleyin.
Önkoşullar
Bu bağlayıcıyı kullanmak için bir veya daha fazla Blackbaud ortamına erişimi olan bir Blackbaud ID hesabınız olmalıdır.
Buna ek olarak, kuruluşunuzun yöneticisinin bu bağlayıcının Blackbaud ortamınıza erişmesini sağlamak için sistem içinde yönetici düzeyinde bir eylem gerçekleştirmesi de gerekir. Bu önkoşullar hakkında daha fazla bilgiyi ilk kurulum belgelerinde bulabilirsiniz.
Kimlik bilgileri nasıl alınıyor?
Kuruluşunuzun yöneticisi size kuruluşun Raiser'ın Edge NXT ortamına bir davet gönderir ve ortamda kullanıcı hesabı izinlerinizi yapılandıracaktır. Bu bağlayıcıyı kullanmak için ek kimlik bilgileri gerekmez.
Bilinen sorunlar ve sınırlamalar
Bağlayıcı, kullanıcı hesabınız bağlamında çalışır ve bu nedenle ortamdaki kullanıcı izinlerinize tabi olur.
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Geçici sorgu işi başlatma |
Belirtilen geçici sorgu tanımını yürütmek için bir arka plan işi başlatır. |
| Sorgu işi başlatma |
Belirtilen sorguyu yürütmek için bir arka plan işi başlatır. |
| Sorgu işi durumunu alma |
Arka plan sorgusu yürütme işi hakkında bilgi döndürür. |
| Sorguları listeleme |
Sorguların listesini döndürür. |
| Statik sorgu işini yenilemeyi başlatma |
Belirtilen statik sorgunun kaydedilmiş anahtarlarını yenilemek için bir arka plan işi başlatır. |
Geçici sorgu işi başlatma
Belirtilen geçici sorgu tanımını yürütmek için bir arka plan işi başlatır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Sorgu tanımı
|
query | True | object |
Sorgu tanımının JSON gösterimi. |
|
Çıkış biçimi
|
output_format | string |
Sorgu sonuçları dosyasının çıkış biçimini gösterir. |
|
|
Biçimlendirme modu
|
formatting_mode | string |
Biçimlendirmenin sorgu sonuçlarına uygulanıp uygulanmayacağını ve nasıl uygulanacağını gösterir. |
|
|
Filename
|
results_file_name | string |
dosya uzantısı olmadan indirilecek dosyanın adı. |
Döndürülenler
Sorgu işi başlatıldı
Sorgu işi başlatma
Belirtilen sorguyu yürütmek için bir arka plan işi başlatır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Türü
|
v_query_type_id | True | integer |
Sorgu kümesini belirli bir sorgu türüne sahip sorgulara göre filtreleyin. |
|
Query
|
id | True | integer |
Yürütülecek sorgu. |
|
Çıkış biçimi
|
output_format | string |
Sorgu sonuçları dosyasının çıkış biçimini gösterir. |
|
|
Biçimlendirme modu
|
formatting_mode | string |
Biçimlendirmenin sorgu sonuçlarına uygulanıp uygulanmayacağını ve nasıl uygulanacağını gösterir. |
|
|
SQL oluşturma modu
|
sql_generation_mode | string |
Sorgu seçme alanlarının nasıl işleneceğini gösterir. 'Sorgu' seçildiğinde çıkış, sorgu için tanımlanan seçme alanlarını ve QRECID'yi içerir. 'Dışarı Aktar' seçildiğinde çıkış, YALNIZCA sorgu için tanımlanan seçme alanlarını içerir. 'Rapor' seçildiğinde çıkışTA YALNIZCA QRECID bulunur. |
|
|
Statik sorgu kullanılasın mı?
|
use_static_query_id_set | boolean |
Statik sorgu kayıtların kaynağı olarak kullanılsın mı (değilse, sorgu dinamik olarak yürütülür)? |
|
|
Filename
|
results_file_name | string |
dosya uzantısı olmadan indirilecek dosyanın adı. |
Döndürülenler
Sorgu işi başlatıldı
Sorgu işi durumunu alma
Arka plan sorgusu yürütme işi hakkında bilgi döndürür.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
İş Kimliği
|
job_id | True | string |
Sorgu yürütme işinin sistem kayıt kimliği. |
|
Sonuç URL'si eklensin mi?
|
include_read_url | string |
Sorgu sonuçları dosyasının URL'si eklensin mi? |
|
|
İçerik değerlendirmesi
|
content_disposition | string |
Sorgu sonuçlarının nasıl görüntülendiğini gösterir. |
Döndürülenler
Sorgu yürütme işi
Sorguları listeleme
Sorguların listesini döndürür.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Türü
|
query_type_id | integer |
Sorgu kümesini belirli bir sorgu türüne sahip sorgulara göre filtreleyin. |
|
|
Kategori
|
category | integer |
Sorgu kümesini belirli bir kategoriye sahip sorgulara göre filtreleyin. |
|
|
Biçim
|
query_format | string |
Sorgu kümesini belirli bir biçime sahip sorgulara göre filtreleyin. |
|
|
Arama metni
|
search_text | string |
Sonuçları filtrelemek için ad alanı arama metni. |
|
|
Yalnızca sık kullanılanlar mı?
|
my_fav_queries_only | boolean |
Yalnızca sık kullanılan sorgular dahil mi? |
|
|
Yalnızca sorgularım mı?
|
my_queries_only | boolean |
Yalnızca oluşturduğum sorgular eklensin mi? |
|
|
Yalnızca birleştirilmiş sorgular mı var?
|
merged_queries_only | boolean |
Yalnızca birleştirilmiş sorgular eklensin mi? |
|
|
Liste sorguları dışlanmalı mı?
|
list_queries | string |
Sorgu Listesi sorguları dışlanmalı mı? |
|
|
Sütunu sıralama
|
sort_column | string |
Sonuçları belirtilen sütuna göre sıralayın. |
|
|
Azalan düzende sıralama mı?
|
sort_descending | boolean |
Sonuçlar azalan düzende sıralansın mı? |
|
|
Tarihinde veya sonrasında eklendi
|
date_added | date-time |
Sonuçları belirtilen tarihte veya sonrasında oluşturulan sorgulara göre filtreleyin (örneğin: '2020-09-18T04:13:56Z'). |
|
|
Kimliğine göre eklendi
|
added_by | string |
Sonuçları belirtilen kullanıcı kimliği tarafından eklenen sorgulara göre filtreleyin. |
|
|
Sınır
|
limit | integer |
Döndürülecek kayıt sayısını temsil eder. Varsayılan 50'dir. Maksimum değer 200'dür. |
|
|
Ofset baskı
|
offset | integer |
Atlana kayıt sayısını temsil eder. Sayfalandırma ile kullanmak için. |
Döndürülenler
Queries
Statik sorgu işini yenilemeyi başlatma
Belirtilen statik sorgunun kaydedilmiş anahtarlarını yenilemek için bir arka plan işi başlatır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Türü
|
v_query_type_id | True | integer |
Sorgu kümesini belirli bir sorgu türüne sahip sorgulara göre filtreleyin. |
|
Query
|
id | True | integer |
Yürütülecek sorgu. |
Döndürülenler
Sorgu işi başlatıldı
Tanımlar
QueryApi.ExecuteQueryResponse
Sorgu işi başlatıldı
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İş Kimliği
|
id | string |
Sorgu işi tanımlayıcısı. |
|
Statü
|
status | string |
Sonuçta elde edilen sorgu işi durumu. 'Beklemede' - iş kuyruğa alındı ancak henüz çalışmaya başlamadı. 'Çalışıyor' - iş çalışıyor. 'Tamamlandı' - iş başarıyla tamamlandı. 'Başarısız' - iş başarısız oldu. 'İptal' - iş iptali istendi (ancak yine de başarıyla tamamlanabilir). 'İptal edildi' - iş iptal edildi. 'Kısıtlandı' - iş kısıtlandı ve alan kullanılabilir olduğunda çalıştırılacak. |
|
Message
|
message | string |
Yanıtla ilişkilendirilmiş bir ileti. |
QueryApi.QueryExecutionJob
Sorgu yürütme işi
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İş Kimliği
|
id | string |
Sorgu işi tanımlayıcısı. |
|
Statü
|
status | string |
Sonuçta elde edilen sorgu işi durumu. 'Beklemede' - iş kuyruğa alındı ancak henüz çalışmaya başlamadı. 'Çalışıyor' - iş çalışıyor. 'Tamamlandı' - iş başarıyla tamamlandı. 'Başarısız' - iş başarısız oldu. 'İptal' - iş iptali istendi (ancak yine de başarıyla tamamlanabilir). 'İptal edildi' - iş iptal edildi. 'Kısıtlandı' - iş kısıtlandı ve alan kullanılabilir olduğunda çalıştırılacak. |
|
Satır sayısı
|
row_count | integer |
Sorgudaki kayıtların sayısı. |
|
Sorgu sonuçları URI'si
|
sas_uri | string |
Sorgu sonuçlarına erişmek için URI. Bu URI, sorgu sonuçlarına erişmek için güvenli bir kimlik bilgisi olarak kabul edilmelidir; değer hassas olarak kabul edilir ve URI'nin süresi 15 dakika sonra dolacaktır. |
QueryApi.QuerySummary
Query
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
id | integer |
Sorgunun sistem kayıt kimliği. |
|
İsim
|
name | string |
Sorgunun benzersiz adı. |
|
Description
|
description | string |
Sorgunun açıklaması. |
|
Türü
|
type | string |
Sorgunun türü. |
|
Tür Kimliği
|
type_id | integer |
Sorgu türünün sistem kayıt kimliği. |
|
Kategori
|
category | string |
Sorgunun kategorisi. |
|
Kategori Kimliği
|
category_id | integer |
Sorgu kategorisinin sistem kayıt kimliği. |
|
Biçim
|
format | string |
Sorgu biçimi. |
|
Görünüm destekleniyor mu?
|
view_supported | boolean |
Sorgu görüntülenebilir mi? |
|
Düzenleme destekleniyor mu?
|
edit_supported | boolean |
Sorgu düzenlenebilir mi? |
|
Sık kullanılanlar mı?
|
favorite | boolean |
Sorgu sık kullanılan bir sorgu mu? |
|
Alanlar için sorun var mı?
|
has_ask_fields | boolean |
Sorguda ask işlecine sahip filtre alanları var mı? |
|
Sorgu tarafından mı oluşturuldu?
|
created_by_query | boolean |
Sorgu, sorgu modülü içinde mi oluşturuldu? |
|
Desteklenen yürütme modları
|
supported_execution_modes | string |
Desteklenen yürütme modları. |
|
Değişiklik yapabilir misiniz?
|
can_modify | boolean |
Kullanıcı sorguyu değiştirebilir mi? |
|
Yürütebilir mi?
|
can_execute | boolean |
Kullanıcı sorguyu yürütebilir mi? |
|
Diğerleri değişiklik yapabilir mi?
|
others_can_modify | boolean |
Diğer kullanıcılar sorguyu değiştirebilir mi? |
|
Başkaları yürütebilir mi?
|
others_can_execute | boolean |
Diğer kullanıcılar sorguyu yürütebilir mi? |
|
Sorgu listesi mi?
|
query_list | boolean |
Sorgu bir Sorgu Listesi sorgusu mu? |
|
Yinelenenler gizlensin mi?
|
suppress_duplicates | boolean |
Sorgu sonuçlarında yinelenenler gizleniyor mu? |
|
Sorgu adından seçim yapın
|
select_from_query_name | string |
Sorgu için temel seçim olarak kullanılan sorgunun adı. |
|
Sorgu kimliğinden seçme
|
select_from_query_id | integer |
Sorgu için temel seçim olarak kullanılan sorgunun sistem kayıt kimliği. |
|
Son çalıştırma
|
date_last_run | date-time |
Sorgunun son çalıştırıldığı tarih. |
|
Kayıt sayısı
|
num_records | integer |
Sorgunun en son çalıştırıldığında bulunan kayıt sayısı. |
|
Geçen süre
|
elapsed_ms | integer |
Sorgunun en son çalıştırıldığı geçen süre (milisaniye cinsinden). |
|
Oluşturulma tarihi
|
date_added | date-time |
Sorgunun oluşturulduğu tarih. |
|
Oluşturan:
|
added_by | string |
Sorguyu oluşturan kullanıcının adı. |
|
Değiştirme tarihi
|
date_changed | date-time |
Sorgunun en son değiştirildiği tarih. |
|
Değiştiren
|
last_changed_by | string |
Sorguyu son değiştiren kullanıcının adı. |
QueryApi.QuerySummaryCollection
Queries
| Name | Yol | Tür | Description |
|---|---|---|---|
|
queries
|
queries | array of QueryApi.QuerySummary |
Yanıta dahil edilen öğe kümesi. |