Aracılığıyla paylaş

Hizmet kancası tüketicileri

  • Makale

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Program aracılığıyla abonelik oluşturmak için hizmet kancası tüketicilerini kullanın. Abonelik olayı, tüketiciyi ve eylemi belirtir.

Aşağıdaki tüketicilerden aboneliğinizde kullanmak istediğiniz tüketiciyi seçin. Kullanılabilir hizmetler hakkında daha fazla bilgi için bkz . Hizmet kancalarıyla tümleştirme, Kullanılabilir hizmetler.

Azure Service Bus

Notification Hubs da dahil olmak üzere Microsoft Azure Service Bus ile tümleştirme sağlar.

Bildirim Hub'ına ileti gönderme

Bu eylem, belirtilen Azure Notification Hub'a genel bir şablon bildirimi gönderir. Daha fazla bilgi için genel bakışa bakın.

  • Tüketici Kimliği: azureServiceBus
  • Eylem Kimliği: serviceBusNotificationHubSend
  • Desteklenen olaylar: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ayarlar:
    • connectionString
      • SAS bağlantı dizesi
      • SAS (paylaşılan erişim imzası) Azure Service Bus'a bağlanmak için kullanılacak bağlantı dizesi. Bu bağlantı dizesi Azure portalında kullanılabilir.
      • Veri türü: dize
      • Gerekli: Evet
    • notificationHubName
      • Bildirim Merkezi adı
      • Bildirimin gönderilmesi için bildirim hub'ının adı. Ad yalnızca harf, sayı, nokta, kısa çizgi, eğik çizgi ve alt çizgi içerebilir. Ad bir harf veya numarayla başlayıp bitmelidir. Hub zaten mevcut olmalıdır.
      • Veri türü: dize
      • Gerekli: Evet
    • tagsExpression
      • Etiketler
      • Etiketler ifadesi (belirli cihaz kümelerini hedeflemek için). Daha fazla bilgi edinin.
      • Veri türü: dize
      • Gerekli: Hayır

Service Bus Kuyruğuna ileti gönderme

Bu eylem, belirtilen Azure Service Bus kuyruğuna olayın JSON dize gösterimini gönderir. Daha fazla bilgi için bkz . Service Bus kuyrukları, makaleleri ve abonelikleri.

  • Tüketici Kimliği: azureServiceBus
  • Eylem Kimliği: serviceBusQueueSend
  • Desteklenen olaylar: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ayarlar:
    • connectionString
      • SAS bağlantı dizesi
      • SAS (paylaşılan erişim imzası) Azure Service Bus'a bağlanmak için kullanılacak bağlantı dizesi. Bu bağlantı dizesi Azure portalında kullanılabilir.
      • Veri türü: dize
      • Gerekli: Evet
    • queueName
      • Kuyruk adı
      • İletinin gönder olduğu kuyruğun adı. Ad yalnızca harf, sayı, nokta, kısa çizgi, eğik çizgi ve alt çizgi içerebilir. Ad bir harf veya numarayla başlayıp bitmelidir. Kuyruk yoksa, belirtilen bağlantı dizesi gerekli izinlere sahipse oluşturulur.
      • Veri türü: dize
      • Gerekli: Evet
    • resourceDetailsToSend
      • Gönderilecek kaynak ayrıntıları
      • Gönderilecek kaynak alanlarını denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • messagesToSend
      • Gönderilecek iletiler
      • Gönderilecek iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • detailedMessagesToSend
      • Gönderilecek ayrıntılı iletiler
      • Gönderilecek ayrıntılı iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır

Service Bus Konusuna ileti gönderme

Bu eylem, belirtilen Azure Service Bus konusuna olayın JSON dize gösterimini gönderir. Daha fazla bilgi için bkz . Azure portalını kullanarak bir Service Bus konusu ve konu başlığına abonelikler oluşturma.

  • Tüketici Kimliği: azureServiceBus
  • Eylem Kimliği: serviceBusTopicSend
  • Desteklenen olaylar: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ayarlar:
    • connectionString
      • SAS bağlantı dizesi
      • SAS (paylaşılan erişim imzası) Azure Service Bus'a bağlanmak için kullanılacak bağlantı dizesi. Bu bağlantı dizesi Azure portalında kullanılabilir.
      • Veri türü: dize
      • Gerekli: Evet
    • topicName
      • Konu adı
      • İletinin gönder olduğu konunun adı. Ad yalnızca harf, sayı, nokta, kısa çizgi, eğik çizgi ve alt çizgi içerebilir. Ad bir harf veya numarayla başlayıp bitmelidir. Konu yoksa, belirtilen bağlantı dizesi gerekli izinlere sahipse oluşturulur.
      • Veri türü: dize
      • Gerekli: Evet
    • resourceDetailsToSend
      • Gönderilecek kaynak ayrıntıları
      • Gönderilecek kaynak alanlarını denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • messagesToSend
      • Gönderilecek iletiler
      • Gönderilecek iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • detailedMessagesToSend
      • Gönderilecek ayrıntılı iletiler
      • Gönderilecek ayrıntılı iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır

Azure Depolama

Microsoft Azure Depolama ile tümleştirme sağlar.

Depolama Kuyruğuna ileti ekleme

Bu eylem, olayın JSON dize gösterimini belirtilen Azure depolama kuyruğuna ekler. Daha fazla bilgi için bkz . Azure kuyrukları nedir?.

  • Tüketici Kimliği: azureStorageQueue
  • Eylem Kimliği: sıraya alma
  • Desteklenen olaylar: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ayarlar:
    • accountName
      • Depolama hesabı adı
      • Azure depolama hesabınızla ilişkili ad (örneğin, https://STORAGE_ACCOUNT_NAME.queue.core.windows.net).
      • Veri türü: dize
      • Gerekli: Evet
    • accountKey
      • Depolama hesabı anahtarı
      • Azure depolama hesabınızla ilişkili anahtar.
      • Veri türü: dize
      • Gerekli: Evet
    • queueName
      • Kuyruk adı
      • Azure depolama alanında kullanılacak kuyruğun yalnızca küçük harfli adı. Bu ada sahip bir kuyruk henüz yoksa oluşturulur.
      • Veri türü: dize
      • Gerekli: Evet
    • visiTimeout
      • İleti görünürlüğü zaman aşımı (saniye)
      • Sıralanan ileti için sunucu zamanına göre saniye olarak görünürlük zaman aşımı değerini belirtir. Değer 0'dan büyük veya buna eşit olmalıdır ve yedi günden veya 604.800 saniyeden uzun olamaz. Görünürlük zaman aşımı, iletinin yaşam süresi değerinden daha küçük bir değere ayarlanmalıdır.
      • Veri türü: sayı
      • Gerekli: Evet
    • Ttl
      • İleti yaşam süresi (saniye)
      • Kuyruk iletisi için yaşam süresini saniye cinsinden belirtir. İzin verilen maksimum yaşam süresi yedi gündür veya 604.800 saniyedir.
      • Veri türü: sayı
      • Gerekli: Evet
    • resourceDetailsToSend
      • Gönderilecek kaynak ayrıntıları
      • Gönderilecek kaynak alanlarını denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • messagesToSend
      • Gönderilecek iletiler
      • Gönderilecek iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • detailedMessagesToSend
      • Gönderilecek ayrıntılı iletiler
      • Gönderilecek ayrıntılı iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır

Jenkins

Jenkins, yazılım projelerinin sürekli olarak oluşturulmasına ve test edilmesine olanak tanıyan sürekli bir tümleştirme sunucusudur.

Git derlemesi tetikleme

Jenkins Git Eklentisini kullanarak Git deposu kullanacak şekilde yapılandırılmış bir derlemeyi tetikler.

  • Tüketici Kimliği: jenkins
  • Eylem Kimliği: triggerGitBuild
  • Desteklenen olaylar: git.push
  • Ayarlar:
    • serverBaseUrl
      • Jenkins temel URL'si
      • Jenkins sunucusunu barındıran temel URL
      • Veri türü: uri
      • Gerekli: Evet
    • kullanıcı adı
      • User name
      • Derlemeyi tetiklemesine izin verilen bir kullanıcının Jenkins kullanıcı adı
      • Veri türü: dize
      • Gerekli: Evet
    • parola
      • Kullanıcı API belirteci (veya parolası)
      • Jenkins kullanıcı yapılandırması sayfasında bulunan kullanıcının API belirteci. API belirteci 1.426 sürümünden bu yana yenidir. Jenkins'in önceki sürümleri için gerçek kullanıcı parolası belirtilmelidir.
      • Veri türü: dize
      • Gerekli: Evet

Genel derlemeyi tetikleme

Jenkins derleme URL'sini çağırarak genel bir Jenkins derlemesini tetikler.

  • Tüketici Kimliği: jenkins
  • Eylem Kimliği: triggerGenericBuild
  • Desteklenen olaylar: git.push, build.complete, tfvc.checkin
  • Ayarlar:
    • serverBaseUrl
      • Jenkins temel URL'si
      • Jenkins sunucusunu barındıran temel URL
      • Veri türü: uri
      • Gerekli: Evet
    • kullanıcı adı
      • User name
      • Derlemeyi tetiklemesine izin verilen bir kullanıcının Jenkins kullanıcı adı
      • Veri türü: dize
      • Gerekli: Evet
    • parola
      • Kullanıcı API belirteci (veya parolası)
      • Jenkins kullanıcı yapılandırması sayfasında bulunan kullanıcının API belirteci. API belirteci 1.426 sürümünden bu yana yenidir. Jenkins'in önceki sürümleri için gerçek kullanıcı parolası belirtilmelidir.
      • Veri türü: dize
      • Gerekli: Evet
    • buildName
      • Derleme
      • Tetikleme yapı adı
      • Veri türü: dize
      • Gerekli: Evet
    • buildAuthToken
      • Derleme belirteci
      • Yalnızca bunu bilen kullanıcıların bu projenin derlemelerini uzaktan tetikleyebilmesi için bir dize biçiminde yetkilendirme belirteci
      • Veri türü: dize
      • Gerekli: Hayır
    • buildParameterized
      • Parametreleri kabul eder
      • Derlemenin parametreli olup olmadığını gösterir (derleme parametreleri isteğe bağlı olarak daha önce belirtilir)
      • Veri türü: boole
      • Gerekli: Hayır
    • buildParams
      • Derleme parametreleri
      • Her ad-değer çiftinin kendi metin satırında görünmesiyle parametre adlarını ve değerlerini iki nokta üst üste (örneğin "param1:value1") ile ayırarak oluşturun
      • Veri türü: dize
      • Gerekli: Hayır

Trello

Trello ile tümleştirme sağlar.

Kart oluşturma

Bu eylem, Trello'da var olan bir listede kart oluşturur. Kart bir görevi, sorunu, olayı veya hemen hemen her şeyi temsil edebilir. Bir kartın durumu genellikle hangi listede olduğuna göre belirlenir. Daha fazla bilgi için bkz . Trello ile hizmet kancası oluşturma.

  • Tüketici Kimliği: trello
  • Eylem Kimliği: createCard
  • Desteklenen olaylar: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ayarlar:
    • userToken
      • Kullanıcı belirteci (Gerekli mi? Hemen edinin.)
      • Trello tarafından sağlanan kullanıcı belirteciniz. Bu belirteci nasıl edineceğinizi öğrenmek için daha önce açıklanan eylem açıklamasındaki bağlantıyı seçin.
      • Veri türü: dize
      • Gerekli: Evet
    • boardId
      • Kurul
      • Trello kartının oluşturulduğu panonun adı.
      • Veri türü: dize
      • Gerekli: Evet
    • listId
      • Liste
      • Trello kartının oluşturulduğu listenin adı.
      • Veri türü: dize
      • Gerekli: Evet
    • Etiket
      • Etiketler
      • Oluşturulan karta uygulanacak etiket renklerinin virgülle ayrılmış listesi. Geçerli etiket rengi adları kırmızı, turuncu, sarı, yeşil, mavi ve mor şeklindedir.
      • Veri türü: dize
      • Gerekli: Hayır
    • addToTop
      • Listenin başında oluştur
      • Kartın bitiş yerine Trello listesinin başında oluşturulup oluşturulmaması gerektiğini gösterir.
      • Veri türü: boole
      • Gerekli: Hayır

Liste oluştur

Bu eylem, Trello'daki mevcut bir panoda bir liste oluşturur. Liste, kart üzerindeki kartları düzenlemek için kullanılır ve genellikle bir durumu temsil eder. Daha fazla bilgi için bkz . Trello ile hizmet kancası oluşturma.

  • Tüketici Kimliği: trello
  • Eylem Kimliği: createList
  • Desteklenen olaylar: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ayarlar:
    • userToken
      • Kullanıcı belirteci (gerekli mi? Hemen edinin.)
      • Trello tarafından sağlanan kullanıcı belirteciniz. Bu belirteci nasıl edineceğinizi öğrenmek için daha önce açıklanan eylem açıklamasındaki bağlantıyı seçin.
      • Veri türü: dize
      • Gerekli: Evet
    • boardId
      • Kurul
      • Trello listesinin oluşturulduğu panonun adı.
      • Veri türü: dize
      • Gerekli: Evet
    • addToBottom
      • Panonun en altında oluşturma
      • Listenin üst yerine panonun en altında oluşturulup oluşturulmaması gerektiğini gösterir.
      • Veri türü: boole
      • Gerekli: Hayır

Web kancaları

Web kancaları HTTP aracılığıyla olay iletişimi sağlar.

HTTP aracılığıyla gönderme

Bu eylem, olayın JSON nesne gösterimini belirtilen URL'ye iletir. Olay yükündeki özel veri potansiyeli nedeniyle HTTPS uç noktaları önerilir. Daha fazla bilgi için bkz . Web Kancaları.

  • Tüketici Kimliği: web Kancaları
  • Eylem Kimliği: httpRequest
  • Desteklenen olaylar: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ayarlar:
    • URL
      • URL
      • HTTP POST'un gönderildiği URL.
      • Veri türü: uri
      • Gerekli: Evet
    • httpHeaders
      • HTTP üst bilgileri
      • HTTP üst bilgi anahtarları ve değerleri iki nokta üst üste (örneğin"Anahtar1:değer1") ile ayrılmıştır ve her anahtar-değer çifti kendi metin satırında görünür.
      • Veri türü: dize
      • Gerekli: Hayır
    • basicAuthUsername
      • Temel kimlik doğrulaması kullanıcı adı
      • Standart HTTP kimlik doğrulaması için bir kullanıcı adı girin. Temel HTTP kimlik doğrulaması kimlik bilgilerini düz metin (şifrelenmemiş) olarak gönderir. Bu, güvenli aktarım katmanı (SSL) aracılığıyla bu kimlik bilgilerinin şifrelenmesini sağlamak için "https" ile başlayan bir URL kullanmanız gerektiği anlamına gelir.
      • Veri türü: dize
      • Gerekli: Hayır
    • basicAuthPassword
      • Temel kimlik doğrulama parolası
      • Standart HTTP kimlik doğrulaması için bir parola girin. Temel HTTP kimlik doğrulaması, kimlik bilgilerini düz metin (şifrelenmemiş) olarak gönderir. Bu, bu kimlik bilgilerinin SSL aracılığıyla şifrelenmesini sağlamak için "https" ile başlayan bir URL kullanmanız gerektiği anlamına gelir.
      • Veri türü: dize
      • Gerekli: Hayır
    • resourceDetailsToSend
      • Gönderilecek kaynak ayrıntıları
      • Gönderilecek kaynak alanlarını denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • messagesToSend
      • Gönderilecek iletiler
      • Gönderilecek iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır
    • detailedMessagesToSend
      • Gönderilecek ayrıntılı iletiler
      • Gönderilecek ayrıntılı iletileri denetleme
      • Veri türü: dize
      • Gerekli: Hayır

Zendesk

Zendesk, yardım masası bilet oluşturma, sorun izleme ve müşteri hizmetleri desteği sunan bir SaaS paketidir.

Bilette özel açıklama oluşturma

Bilette özel yorum oluşturmak için Zendesk'i kullanın.

  • Tüketici Kimliği: zendesk
  • Eylem Kimliği: createPrivateComment
  • Desteklenen olaylar: workitem.commented
  • Ayarlar:
    • accountName
      • Hesap adı
      • Zendesk hesap adı https://{account name}.zendesk.com
      • Veri türü: dize
      • Gerekli: Evet
    • kullanıcı adı
      • User name
      • Biletleri güncelleştiren bir kullanıcının Zendesk kullanıcı adı
      • Veri türü: dize
      • Gerekli: Evet
    • apiToken
      • API belirteci
      • Zendesk API belirteci (Yönetim > Kanalları > API'sindeki Zendesk uygulamasında bulunabilir)
      • Veri türü: dize
      • Gerekli: Evet