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

Gerekli web kancası izinleri

Qlik Cloud Webhooks API ve otomasyon kullanıcı arayüzünü kullanarak web kancaları oluştururken veya yönetirken, bu izinlerden birini veya her ikisini talep etmelisiniz:

• Web kancalarını kullan: 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önet: Diğer kullanıcılar tarafından oluşturulanlar da dahil olmak üzere kiracı içindeki 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 araması kullanarak belirtilen harici bir uygulamaya JSON formatında bilgi gönderir. Bu harici uygulama daha sonra olay verilerini kullanarak daha fazla eylemi tetikleyebilir.

Örneğin:

• Yeni bir uygulama oluşturulduğunda ekibinizi Slack üzerinden bilgilendirin.

• Bir kiracıya yeni bir ekip üyesi eklendiğinde otomatik olarak bir hoş geldiniz e-postası gönderin.

• Bir kullanıcı kiracıdan silindiğinde bir elektronik tabloyu güncelleyin.

Web kancalarını kullanmanın faydaları

Web kancaları, diğer sistemlerle gerçek zamanlı entegrasyona olanak tanıyarak sürekli manuel kontrol veya tekrarlayan API istekleri ihtiyacını ortadan kaldırır. Olayları dinleyerek ve ilgili verileri anında göndererek, web kancaları gereksiz işleri azaltır ve sorunsuz otomasyon sağlar.

Web kancası entegrasyonları için popüler platformlar

Web kancası verilerini işlemek ve bunlara yanıt vermek 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ı şunlar tarafından 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 merkezinde Web kancaları bölümüne gidin.

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

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

4. URL (uç nokta) için, web kancasının JSON verilerini göndereceği tam nitelikli 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 sır girin.

   • Sır 32 ile 64 karakter arasında olmalıdır.

   • Oluşturulursa, sır bir karmanın parçası olarak dahil edilecek ve HTTP isteğine bir qlik-signature olarak eklenecektir.

6. Bulut olayı Qlik Cloud Webhooks hizmeti tarafından yayınlanan olay yükü. Etkinleştirilip kaydedildikten sonra değişiklik geri alınamaz.

7. Sertifika iptalini kontrol et etkinleştirildiğinde, web kancası sertifikalarının geçerli olduğunu ve iptal edilmediğini doğrular.

8. İsteğe bağlı olarak, isteğe eklenecek HTTP başlıkları 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 sil simgesine tıklayın. Değeri kaldırmak için kaldır simgesine tıklayın ve yeni bir tane girin.

9. Olaylar altında, web kancasını tetikleyecek sistem olaylarını seçin. Mevcut olaylar şunları içerir:

   • Otomasyon olayları

   • API olayları

   • Uygulama olayları

   • Veri entegrasyonu olayları

   • Kullanıcı olayları

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

Web kancalarını yönetme

Bilgi notu

Qlik Automate ile oluşturulan web kancaları yalnızca Yönetim etkinlik merkezinde görüntülenebilir. Düzenlenemez, silinemez, etkinleştirilemez veya devre dışı bırakılamazlar.

Bu web kancalarını 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 simgesine tıklayın.

• Bir web kancası aramak için bir sütunun üst kısmındaki simgesine tıklayın. Arama filtresi tam ve kısmi eşleşmeler için çalışır.

Web kancalarını açma veya kapatma

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde Web kancaları bölümüne gidin.

2. Web kancasının yanındaki simgesine tıklayın.

3. Web kancasını açmak için Etkinleştir'i seçin.

4. Web kancasını kapatmak için Devre dışı bırak'ı seçin.

Yeni oluşturulan web kancaları varsayılan olarak etkindir.

Web kancalarını düzenleme

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde Web kancaları bölümüne gidin.

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

3. Düzenle'yi seçin.

4. Düzenlemelerinizi yapın ve Kaydet'e tıklayın.

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

Web kancalarını silme

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde Web kancaları bölümüne 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 web kancası seçene kadar Sil düğmesi kullanılamaz. Eylem çubuğu seçilen web kancalarının 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 merkezinde Web kancaları bölümüne gidin.

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

   

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

4. Olay yanıtı yükünü görüntülemek için olay satırındaki simgesine tıklayın.

   Yük, geçmiş olaylarda hata ayıklamak veya bunları denetlemek için yararlı olan uygulama kimliği, adı ve zaman damgası gibi ayrıntıları gösterir.