Ana içeriğe geç

İş akışları için web kancaları oluşturma

Web kancaları, Qlik Sense sistem olaylarını iş akışınızda tetikleyici olarak kullanmanız için bir yol sağlar. Bir web kancası oluşturduğunuzda, tanımlanan sistem olayı her gerçekleştiğinde web kancası uç noktasına otomatik olarak bir JSON isteği gönderir. JSON verilerini alabilen bir uygulamaya olay verileri göndermek için web kancalarını kullanabilirsiniz.

Web kancası özellikleri

Web kancası oluşturmak için web kancası ve uç nokta özelliklerini yapılandırmanız ve Qlik Sense olay türlerini seçmeniz gerekir.

Web kancası özellikleri
Özellik Açıklama
Ad Web kancasının adı.
Açıklama (isteğe bağlı) Web kancasının açıklaması.
URL Web kancası uç noktasının URL'si. URL (web kancası uç noktası), tam etki alanı adı (FDQN) olmalı ve HTTPS protokolü kullanmalıdır. Uç nokta bir IP adresi olamaz.
Parola (isteğe bağlı) Web kancası kimlik doğrulama parolası. Parola en az 32 karakter ve en fazla 64 karakter olmalıdır. Bir web kancası gizli bilgisi oluşturulursa, bu bilgi HTTP isteğine bir qlik-signature olarak eklenen bir karma değerin parçasıdır.
Üst bilgiler (isteğe bağlı)

HTTP isteğine eklenebilecek başlıklar.

Her web kancası, bir veya daha fazla olay türü ile yapılandırılır.

Web kancalarının olay türleri
Kaynak Olay türleri
Uygulamalar Oluşturuldu, Silindi, Veriler Güncellendi, Yeniden Yüklendi, Yayınlandı, Dışa Aktarıldı
Bilgi notuVeri güncelleme işlemi yenilenmekte olan verileri belirtir. Yeniden yükleme işlemi, yeniden yüklenen Qlik Sense uygulamasını ve ilişkili veri tablolarını belirtir.
Kullanıcılar Oluşturuldu, Silindi

Web kancası, olaylardan birinin gerçekleşmesini bekler ve gerçekleştiğinde, olay verilerini web kancası uç noktasına gönderir. Veriler bir JSON isteği olarak uç nokta URL'sine iletilir.

Bilgi notuEtkinlik yükleri hakkında daha fazla bilgi edinmek için bkz. Qlik Geliştirici Portalı: API etkinlikleri.

Örnek: Uygulama silindi olay türü için JSON isteği

Request
URL
https://api.blendr.io/v1/widgets/F502987A-AF89-4992-8127-F28794C5A74A?X-Execution-Token=xxxxx
Headers
{
    "Content-Type": "application/json",
    "Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
    "User-Agent": "Qlik Webhook"
}
Body
{
    "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 kancası oluşturma

Web kancalarını Yönetim Konsolu'ndan, Entegrasyon > Web Kancaları altından oluşturursunuz.

Bilgi notuHer kiracı için maksimum 100 web kancası oluşturabilirsiniz.
Bilgi notuWeb kancaları ayrıca Qlik Uygulama Otomasyonu arayüzünden de oluşturulabilir. Daha fazla bilgi için bkz. Web kancalarıyla çalışma (yalnızca İngilizce).
  1. Sağ üst köşedeki Oluştur'a tıklayın.

  2. Web Kancası Oluştur diyalog penceresine web kancası için adı girin.

  3. İsteğe bağlı açıklama ekleyin.

  4. Üçüncü taraf entegrasyon uygulaması için URL'yi girin.

  5. Dilerseniz HTTP isteğine eklemek üzere parolayı girin.

  6. Dilerseniz isteğe eklemek üzere HTTP üst bilgileri ekleyin.

  7. Olaylar altında, web kancası için olay türünü seçin.

  8. Bitirdikten sonra Oluştur'a tıklayın.

    Web kancaları tabloda listelenir. Yeni oluşturulan web kancaları varsayılan olarak açık durumdadır.

Yönetim Konsolu web kancaları tablosu
İpucu notuWeb kancası satırının sonundaki Üç nokta kullanıcı arayüzü simgesi Web kancası seçenekler menüsünü açıyor düğmesine tıklayarak ve Web kancasını etkinleştir veya Web kancasını devre dışı bırak seçimini yaparak web kancasını açıp kapatabilirsiniz. Web kancaları varsayılan olarak açık durumdadır.
İpucu notuSıralama düzenini değiştirmek üzere sütunlardan birinin üstündeki Yukarı-aşağı ok simgesi sütun değerlerini sıralıyor simgesine tıklayarak veya bir web kancasını manuel olarak aramak için her sütunun üstündeki filtre simgesine Her Web kancası sütununun en üstündeki filtre simgesi tıklayarak tablodaki web kancalarını sıralayabilir ve arayabilirsiniz. Arama filtresi, hem tam hem de kısmi eşleşmelerde çalışır.

Web kancasını düzenleme

Web kancalarını Yönetim Konsolu'ndan, Entegrasyon > Web Kancaları altından düzenlersiniz.

  1. Düzenlemek istediğiniz web kancası için satırın sonundaki Üç nokta kullanıcı arayüzü simgesi Web kancası seçenekler menüsünü açıyor düğmesine tıklayın.

  2. Düzenle'ye tıklayın.

    Düzenleme paneli, web kancası yapılandırmasını değiştirme seçenekleriyle görüntülenir.

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

Web kancasını silme

Web kancalarını Yönetim Konsolu'ndan, Entegrasyon > Web Kancaları altından silersiniz.

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

  2. Sağ üst köşedeki Sil'e tıklayın.

  3. Seçiminizi onaylamanız için bir diyalog penceresi açılır. Sil'e tıklayın.

Web kancası geçmişini görüntüleme

Web kancaları geçmişine Yönetim Konsolu'ndan, Entegrasyon > Web Kancaları altından erişirsiniz.

Bilgi notuOlay gönderimleri 7 gün sonra web kancası geçmişinden kaldırılır.
  • Web kancası geçmişini görüntülemek için web kancası satırının sonundaki Aşağı ok kullanıcı arayüzü simgesi Web kancası menüsünü genişletiyor düğmesine tıklayın.

    Web kancası geçmişi görüntülenir.

    Yönetim Konsolu web kancası geçmişi

  • Bir olay teslimini manuel olarak yeniden göndermek için olay satırının sonundaki Yeniden gönderme simgesi Web kancasını yeniden göndermek için kullanılıyor düğmesine tıklayın.

  • Olay yanıtı yükünü görüntülemek için olay satırının sonundaki Aşağı ok kullanıcı arayüzü simgesi olay yükü menüsünü genişletiyor düğmesine tıklayın.

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