İş akışları için web kancalarını oluşturma ve yönetme

Gerekli web kancası izinleri

Qlik Cloud Web Kancaları API'si ve otomasyonlar kullanıcı arayüzünü kullanarak web kancaları oluştururken veya yönetirken, bu izinlerden birini ya da her ikisini de talep etmeniz gerekir:

• Web kancalarını kullanma: Kullanıcının sahip olduğu web kancalarını oluşturmak, görüntülemek, güncellemek ve silmek için gereklidir.

• Web kancalarını yönetme: Diğer kullanıcılar tarafından oluşturulanlar da dahil olmak üzere kiracıdaki tüm web kancalarını yönetmek için gereklidir.

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 bilgilendirin.

• 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 Automate (yalnızca İngilizce)

• Pipedream

• Zapier

• Microsoft Power Automate

https://<your-tenantURL>/api/v1/webhooks/{id}

{
    "Content-Type": "application/json",
    "X-Execution-Token: <your-execution-token>",
    "Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
    "User-Agent": "Qlik Webhook"
}

{
    "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
        }
    }
}

Web kancaları oluşturma

Web kancaları şu şekilde oluşturulabilir:

• Yönetim etkinlik merkezinden kiracı yöneticileri.

• Qlik Automate arayüzünden tüm kullanıcılar.

Web kancalarını Qlik Automate ile kullanma hakkında daha fazla bilgi için bkz. Web kancalarıyla çalışma (yalnızca İngilizce).

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.

2. Yeni oluştur'a tıklayın.

3. Web kancası için bir ad ve isteğe bağlı olarak bir açıklama girin.

4. 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.

5. İsteğe bağlı olarak, web kancası kimlik doğrulaması için bir parola 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.

6. Bulut olayı Qlik Cloud Web Kancaları hizmeti tarafından yayılan olay yükü. Etkinleştirildikten ve kaydedildikten sonra değişiklik geri alınamaz.

7. Sertifika iptalini denetle etkinleştirildiğinde web kancası sertifikalarının geçerli ve iptal edilmemiş olduğunu doğrular.

8. Dilerseniz isteğe eklemek üzere HTTP üst bilgileri ekleyin. Başlık değerini şifrelemek için onay kutusunu seçin.

   Bilgi notuGüvenlik nedenleriyle şifrelenmiş başlıkları düzenleyemezsiniz. Başlığı silmek için silme simgesine tıklayın. Değeri kaldırmak için kaldırma simgesine tıklayın ve yeni bir tane girin.

9. Olaylar altında, web kancasını tetikleyecek sistem olaylarını seçin. Bir olayı filtrelemek için Etkinliklere filtre ekleme bakınız.

   Mevcut olaylar şunlardır:

   • Otomasyon etkinlikleri

   • API etkinlikleri

   • Uygulama olayları

   • Veri entegrasyonu etkinlikleri

   • Kullanıcı etkinlikleri

10. Oluştur'a tıklayın.

Etkinliklere filtre ekleme

Bir webhook oluştururken veya düzenlerken bir filtre ekleyebilirsiniz. Bir filtre, yalnızca seçilen olay filtre koşullarıyla eşleştiğinde veri gönderir.

Bir filtre simgesi, o kategorideki bir etkinlikte filtre olduğunda bir etkinlik kategorisinin yanında görünür.

Aşağıdakileri yapın:

1. Olaylar bölümünde, filtrelemeyi destekleyen bir olay seçin. Filtre ekle düğmesi, desteklenen bir olay seçtiğinizde görünür.

2. Filtre ekle'ye tıklayın.

   Bilgi notuFiltreli bir webhook'ta yalnızca bir olay seçili olabilir. Bir filtre eklemek, seçili diğer tüm olayları devre dışı bırakır. Zaten başka etkinlikler seçtiyseniz, bir onay iletişim kutusu bunların seçimlerinin kaldırılacağını size bildirir.

3. Filtre oluşturucuda bir alan, operatör ve değer seçin.

   • Mevcut alanlar seçilen etkinliğe göre değişir.

   • Mevcut değer kontrolü, seçilen alana bağlıdır. Listelenen bir değeri seçebilir, bir kaynak arayabilir veya değeri manuel olarak girebilirsiniz.

4. Gruba bir koşul eklemek için Koşul ekle öğesine tıklayın. Koşulların nasıl birleştirileceğini tanımlamak için ve veya veya seçin.

5. Bir koşul grubu eklemek için Grup ekle seçeneğine tıklayın. Grupların nasıl birleştirileceğini tanımlamak için ve veya veya seçin.

6. Filtre ifadesi önizlemesini gözden geçirin.

   Bilgi notuFiltre ifadesi sorun giderme ve doğrulama amacıyla gösterilir ve düzenlenemez. Filtreyi değiştirmek için filtre oluşturucuyu kullanın. Bir filtre ifadesi 512 karaktere kadar içerebilir.

7. Webhook'u oluştur veya kaydet.

Örnek

Yeniden yükleme yalnızca başarıyla tamamlandığında olayları almak için, Yeniden Yükleme Görevi Tamamlandı olayı için bir filtre oluşturun. Ortaya çıkan filtre ifadesi şudur: data.status eq "SUCCEEDED"

Filtrelemeyi desteklemeyen olaylar

Aşağıdaki etkinlikler için filtreleme desteklenmez:

• Uygulama Veri Modeli Güncellendi
• API anahtarı doğrulanamadı
• Otomasyon oluşturuldu
• Otomasyon silindi
• Otomasyon güncellendi
• Kullanıcı oluşturuldu
• Kullanıcı silindi

Web kancalarını yönetme

Bilgi notu

Qlik Automate ile oluşturulan webhook'lar yalnızca Yönetim etkinlik merkezinde görüntülenebilir. Bunlar düzenlenemez, silinemez, etkinleştirilemez veya devre dışı bırakılamaz.

Bu webhook'ları yönetmek için Qlik Automate arayüzünü kullanın.

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:

1. Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.

2. Web kancasının yanındaki seçeneğine tıklayın.

3. Web kancasını açmak için Etkinleştir öğesini seçin.

4. Web kancasını kapatmak için 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:

1. Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.

2. Düzenlemek istediğiniz web kancası için seçeneğine tıklayın.

3. Düzenle'yi seçin.

4. Düzenlemelerinizi gerçekleştirin ve Kaydet'e tıklayın.

Bilgi notuKaydedilmemiş değişiklikler varken İptal düğmesine tıklarsanız, bir onay iletişim kutusu görünür. Değişikliklerinizi kaydetmeden kapatmak için Vazgeç'e tıklayın.

Web kancalarını silme

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.

2. Silinecek web kancasını seçin.

3. Sil'e tıklayın.

4. Silme işlemini onaylayın.

Bilgi notuBir veya daha fazla webhook seçene kadar Sil düğmesi kullanılamaz. Eylem çubuğu, seçilen webhook sayısını görüntüler.

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:

1. Yönetim etkinlik merkezindeki Web kancaları seçeneğine gidin.

2. Olay geçmişini genişletmek için bir web kancasının yanındaki seçeneğine tıklayın.

   

3. Bir olay teslimini manuel olarak yeniden göndermek için olay satırındaki seçeneğine tıklayın.

4. 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.