Ana içeriğe geç Tamamlayıcı içeriğe geç

İş 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:

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:

  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.

  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 Yukarı-aşağı ok seçeneğine tıklayın.

  • Web kancası aramak için bir sütunun üst kısmındaki Filtre seçeneğine tıklayın. Arama filtresi, tam ve kısmi eşleşmelerde çalışır.

Web kancaları tablosu.

Yönetim Konsolu web kancaları tablosu

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 Daha fazla 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 Daha fazla 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 Aşağı ok kullanıcı arayüzü simgesi Web kancası menüsünü genişletiyor seçeneğine tıklayın.

    Web kancası geçmişi.

    Yönetim Konsolu web kancası geçmişi
  3. Bir olay teslimini manuel olarak yeniden göndermek için olay satırındaki Yeniden gönder simgesi seçeneğine tıklayın.

  4. Olay yanıtı yükünü görüntülemek için olay satırındaki Aşağı ok 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.

    Olay yanıtı yükü.

    Yönetim Konsolu web kancası olay türü yük bilgileri

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız, bize bildirin, düzeltelim!