İş akışları için web kancalarını oluşturma ve yönetme
Web kancaları, belirli eylemler gerçekleştiğinde olay verilerini otomatik olarak göndererek uygulamalar arasındaki iletişimi otomatikleştirmenin basit bir yoludur. Qlik Cloud içinde web kancaları, manuel müdahale olmadan diğer uygulamalardaki eylemleri tetikleyebilir, böylece iş akışlarınıza Qlik Cloud entegrasyonu yapmayı ve sistem olaylarına dayalı görevleri otomatikleştirmeyi kolaylaştırır. Tanımlanan bir olay her gerçekleştiğinde, belirtilen web kancası uç noktasına bir JSON isteği gönderilir ve olay verileri seçtiğiniz uygulamaya iletilir.
Web kancalarını anlama
Web kancaları nasıl çalışır?
Qlik Cloud içinde bir olay gerçekleştiğinde (örneğin, yeni bir uygulama oluşturulduğunda veya bir kullanıcı silindiğinde) bir web kancası, bir HTTP geri çağrısı kullanarak belirtilen bir harici uygulamaya JSON biçiminde bilgi gönderir. Bu harici uygulama daha sonra başka eylemleri tetiklemek için olay verilerini kullanabilir.
Örneğin:
-
Yeni bir uygulama oluşturulduğunda, Slack aracılığıyla ekibinizi bilgilendirir.
-
Bir kiracıya yeni ekip üyesi eklendiğinde, kendisine otomatik olarak karşılama e-postası gönderir.
-
Kiracıdan bir kullanıcı silindiğinde, elektronik tabloyu otomatik olarak günceller.
Web kancaları kullanmanın faydaları
Web kancaları, diğer sistemlerle gerçek zamanlı entegrasyon sağlayarak sürekli manuel kontroller veya tekrarlayan API istekleri ihtiyacını ortadan kaldırır. Web kancaları, olayları dinleyerek ve ilgili verileri anında göndererek gereksiz işleri azaltır ve sorunsuz otomasyon sağlar.
Web kancası entegrasyonları için popüler platformlar
Web kancası verilerini işlemek ve yanıtlamak için özel hizmetler oluşturabilir veya aşağıdaki gibi üçüncü taraf platformları kullanabilirsiniz:
-
Qlik Application Automation (yalnızca İngilizce)
Web kancası sınırları
Sistem performansını korumak ve kaynakları yönetmek için aşağıdaki sınırlar geçerlidir:
-
Web kancası gönderim geçmişi 7 gün boyunca saklanır.
-
Her kullanıcı en fazla 150 web kancasına sahip olabilir.
-
Kiracı başına en fazla 100 web kancası oluşturulabilir.
Web kancası istek yapısı
Bir web kancası bir olay tarafından tetiklendiğinde, belirtilen uç noktaya bir JSON isteği gönderir. Bu isteğin yapısı; olay türü, zaman damgası ve diğer meta veriler gibi olayla ilgili önemli ayrıntıları içerir.
Web kancası isteği örneği: Uygulama silindi olayı
İşte bir uygulama silindiğinde gönderilen JSON isteğinin bir örneği:
İstek URL'si
https://api.blendr.io/v1/widgets/F502987A-AF89-4992-8127-F28794C5A74A?X-Execution-Token=xxxxx
Üst bilgiler
{
"Content-Type": "application/json",
"Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
"User-Agent": "Qlik Webhook"
}
Gövde
{
"cloudEventsVersion": "0.1",
"source": "com.qlik/engine",
"contentType": "application/json",
"eventId": "e65c1481-e8a-4be-a5ca-27dfcde077d7",
"eventTime": "2021-03-08T14:51:29Z",
"eventTypeVersion": "1.0.0",
"eventType": "com.qlik.v1.app.deleted",
"extensions": {
"ownerId": "vNRGrDZIypJzauw59BbpvkRhqbmI",
"tenantId": "oZcMPa_1PwH4FUdrh6839YHHdEJN",
"userId": "vNRGrDZIypJtcGTzauw59BbpqbmI"
},
"data": {
"attributes": {
"id": "0984fec4-aa8c-4253-b1d1-4fd4f9c78",
"name": "New App",
"createdDate": "2021-03-08T14:51:28.888Z",
"modifiedDate": "2021-03-08T14:51:29.316Z",
"owner": "auth0|b62a17c577a4abe6e807b07d18c4d82286352542d633d120100b03fb11",
"ownerId": "vNRGrDZIypJtcGTzauw59BbpvbmI",
"published": false,
"hasSectionAccess": false
}
}
}
Bu yük, silinen uygulama hakkında kimliği, adı, sahibi ve silme zaman damgası gibi ayrıntılı bilgiler sağlayarak alıcı sistemin olayı işlemesine yardımcı olur. Etkinlik yükleri hakkında daha fazla ayrıntı için bkz. Qlik Geliştirici Portalı: API olayları.
Web kancaları oluşturma
Web kancaları şu şekilde oluşturulabilir:
-
Yönetim etkinlik merkezinden kiracı yöneticileri.
-
Qlik Uygulama Otomasyonu arayüzünden tüm kullanıcılar.
Web kancalarını Uygulama Otomasyonu ile kullanma hakkında daha fazla bilgi için bkz. Web kancalarıyla çalışma (yalnızca İngilizce).
Aşağıdakileri yapın:
-
Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.
-
Yeni oluştur'a tıklayın.
-
Web kancası için bir ad ve isteğe bağlı olarak bir açıklama girin.
-
URL (uç nokta) için, web kancasının JSON verilerini göndereceği tam etki alanı adını (FQDN) girin.
-
Bu URL, HTTPS protokolünü kullanmalıdır (örnek: https://domain.com). IP adresleri, web kancası uç noktaları olarak kullanılamaz.
-
-
İsteğe bağlı olarak web kancası kimlik doğrulama parolası girin.
-
Doğrulama parolası 32 ila 64 karakter olmalıdır.
-
Oluşturulursa doğrulama parolası, bir karma değerin parçası olarak eklenecek ve HTTP isteğine qlik-signature olarak eklenecektir.
-
-
Dilerseniz isteğe eklemek üzere HTTP üst bilgileri ekleyin.
-
Olaylar altında, web kancasını tetikleyecek sistem olaylarını seçin. Mevcut olaylar şunlardır:
-
Uygulama olayları: Oluşturuldu, silindi, dışa aktarıldı, veriler güncellendi (yenilendi), yayınlandı, yeniden yüklendi.
-
Kullanıcı olayları: Oluşturuldu, silindi.
-
-
Oluştur'a tıklayın.
Web kancalarını yönetme
Web kancalarını sıralama ve arama
Tablodaki web kancalarını sıralamak ve aramak için:
-
Sıralama düzenini değiştirmek için bir sütunun üst kısmındaki seçeneğine tıklayın.
-
Web kancası aramak için bir sütunun üst kısmındaki seçeneğine tıklayın. Arama filtresi, tam ve kısmi eşleşmelerde çalışır.
Web kancalarını açma veya kapatma
Aşağıdakileri yapın:
-
Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.
-
Web kancasının yanındaki seçeneğine tıklayın.
-
Web kancasını açmak için Web kancasını etkinleştir öğesini seçin.
-
Web kancasını kapatmak için Web kancasını devre dışı bırak öğesini seçin.
Yeni oluşturulan web kancaları varsayılan olarak etkin durumdadır.
Web kancalarını düzenleme
Aşağıdakileri yapın:
-
Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.
-
Düzenlemek istediğiniz web kancası için seçeneğine tıklayın.
-
Düzenle'yi seçin.
-
Düzenlemelerinizi gerçekleştirin ve Kaydet'e tıklayın.
Web kancalarını silme
Aşağıdakileri yapın:
-
Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.
-
Silinecek web kancasını seçin.
-
Sil'e tıklayın.
-
Silme işlemini onaylayın.
Web kancası geçmişini görüntüleme
Web kancası olay geçmişi 7 gün boyunca saklanır.
Aşağıdakileri yapın:
-
Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.
-
Olay geçmişini genişletmek için bir web kancasının yanındaki seçeneğine tıklayın.
-
Bir olay teslimini manuel olarak yeniden göndermek için olay satırındaki seçeneğine tıklayın.
-
Olay yanıtı yükünü görüntülemek için olay satırındaki seçeneğine tıklayın.
Yük; uygulama kimliği, adı ve zaman damgası gibi ayrıntıları gösterir; bu da hata ayıklamak veya geçmiş olayları denetlemek için kullanışlıdır.