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

• Pipedream

• Zapier

• Microsoft Power Automate

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.

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

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

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

8. 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:

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 Web kancasını etkinleştir öğesini seçin.

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

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.

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.

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.