Udostępnij za pośrednictwem

Użytkownicy wpięć usługi

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Programowe tworzenie subskrypcji przy użyciu punktów zaczepienia usługi. Subskrypcja określa zdarzenie, odbiorcę i akcję.

Wybierz użytkownika, którego chcesz użyć w ramach subskrypcji od następujących odbiorców. Aby uzyskać więcej informacji na temat dostępnych usług, zobacz Integrowanie z punktami zaczepienia usług, Dostępne usługi.

Azure Service Bus

Zapewnia integrację z usługą Microsoft Azure Service Bus, w tym z usługą Notification Hubs.

Wysyłanie komunikatu do centrum powiadomień

Ta akcja wysyła ogólne powiadomienie o szablonie do określonego centrum powiadomień platformy Azure. Aby uzyskać więcej informacji, zobacz omówienie.

  • Identyfikator odbiorcy: azureServiceBus
  • Identyfikator akcji: serviceBusNotificationHubSend
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Connectionstring
      • Parametry połączenia sygnatury dostępu współdzielonego
      • Sygnatura dostępu współdzielonego (sygnatura dostępu współdzielonego) parametry połączenia używana do nawiązywania połączenia z usługą Azure Service Bus. Ta parametry połączenia jest dostępna w witrynie Azure Portal.
      • Typ danych: ciąg
      • Wymagane: Tak
    • notificationHubName
      • Nazwa centrum powiadomień
      • Nazwa centrum powiadomień do wysłania powiadomienia. Nazwa może zawierać tylko litery, cyfry, kropki, łączniki, ukośniki i podkreślenia. Nazwa musi zaczynać się i kończyć literą lub cyfrą. Koncentrator powinien już istnieć.
      • Typ danych: ciąg
      • Wymagane: Tak
    • tagsExpression
      • Tagi
      • Wyrażenie tagów (przeznaczone dla określonych zestawów urządzeń). Dowiedz się więcej.
      • Typ danych: ciąg
      • Wymagane: Nie

Wysyłanie komunikatu do kolejki usługi Service Bus

Ta akcja wysyła ciąg JSON reprezentujący zdarzenie do określonej kolejki usługi Azure Service Bus. Aby uzyskać więcej informacji, zobacz Kolejki, artykuły i subskrypcje usługi Service Bus.

  • Identyfikator odbiorcy: azureServiceBus
  • Identyfikator akcji: serviceBusQueueSend
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Connectionstring
      • Parametry połączenia sygnatury dostępu współdzielonego
      • Sygnatura dostępu współdzielonego (sygnatura dostępu współdzielonego) parametry połączenia używana do nawiązywania połączenia z usługą Azure Service Bus. Ta parametry połączenia jest dostępna w witrynie Azure Portal.
      • Typ danych: ciąg
      • Wymagane: Tak
    • Queuename
      • Nazwa kolejki
      • Nazwa kolejki do wysłania komunikatu. Nazwa może zawierać tylko litery, cyfry, kropki, łączniki, ukośniki i podkreślenia. Nazwa musi zaczynać się i kończyć literą lub cyfrą. Jeśli kolejka nie istnieje, zostanie utworzona, jeśli określona parametry połączenia ma niezbędne uprawnienia.
      • Typ danych: ciąg
      • Wymagane: Tak
    • resourceDetailsToSend
      • Szczegóły zasobu do wysłania
      • Kontrolowanie pól zasobów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • messagesToSend
      • Komunikaty do wysłania
      • Kontrolowanie komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • detailedMessagesToSend
      • Szczegółowe komunikaty do wysłania
      • Kontrolowanie szczegółowych komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie

Wysyłanie komunikatu do tematu usługi Service Bus

Ta akcja wysyła reprezentację ciągu JSON zdarzenia do określonego tematu usługi Azure Service Bus. Aby uzyskać więcej informacji, zobacz Tworzenie tematu i subskrypcji usługi Service Bus przy użyciu witryny Azure Portal.

  • Identyfikator odbiorcy: azureServiceBus
  • Identyfikator akcji: serviceBusTopicSend
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Connectionstring
      • Parametry połączenia sygnatury dostępu współdzielonego
      • Sygnatura dostępu współdzielonego (sygnatura dostępu współdzielonego) parametry połączenia używana do nawiązywania połączenia z usługą Azure Service Bus. Ta parametry połączenia jest dostępna w witrynie Azure Portal.
      • Typ danych: ciąg
      • Wymagane: Tak
    • nazwa tematu
      • Nazwa tematu
      • Nazwa tematu do wysłania wiadomości. Nazwa może zawierać tylko litery, cyfry, kropki, łączniki, ukośniki i podkreślenia. Nazwa musi zaczynać się i kończyć literą lub cyfrą. Jeśli temat nie istnieje, zostanie utworzony, jeśli określony parametry połączenia ma niezbędne uprawnienia.
      • Typ danych: ciąg
      • Wymagane: Tak
    • resourceDetailsToSend
      • Szczegóły zasobu do wysłania
      • Kontrolowanie pól zasobów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • messagesToSend
      • Komunikaty do wysłania
      • Kontrolowanie komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • detailedMessagesToSend
      • Szczegółowe komunikaty do wysłania
      • Kontrolowanie szczegółowych komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie

Azure Storage

Zapewnia integrację z usługą Microsoft Azure Storage.

Wstawianie komunikatu w kolejce magazynu

Ta akcja wstawia ciąg JSON reprezentujący zdarzenie do określonej kolejki usługi Azure Storage. Aby uzyskać więcej informacji, zobacz Co to są kolejki platformy Azure?.

  • Identyfikator odbiorcy: azureStorageQueue
  • Identyfikator akcji: enqueue
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Accountname
      • Nazwa konta magazynu
      • Nazwa skojarzona z kontem usługi Azure Storage (na przykład https://STORAGE_ACCOUNT_NAME.queue.core.windows.net).
      • Typ danych: ciąg
      • Wymagane: Tak
    • accountKey
      • Klucz konta magazynu
      • Klucz skojarzony z kontem usługi Azure Storage.
      • Typ danych: ciąg
      • Wymagane: Tak
    • Queuename
      • Nazwa kolejki
      • Mała nazwa kolejki, która ma być używana w usłudze Azure Storage. Kolejka o tej nazwie zostanie utworzona, jeśli jeszcze nie istnieje.
      • Typ danych: ciąg
      • Wymagane: Tak
    • visiTimeout
      • Limit czasu widoczności komunikatu (w sekundach)
      • Określa wartość limitu czasu widoczności w sekundach dla komunikatu w kolejce względem czasu serwera. Wartość musi być większa lub równa 0 i nie może być większa niż siedem dni lub 604 800 sekund. Limit czasu widoczności musi być ustawiony na wartość mniejszą niż wartość czasu wygaśnięcia komunikatu.
      • Typ danych: liczba
      • Wymagane: Tak
    • Ttl
      • Czas wygaśnięcia komunikatu (w sekundach)
      • Określa interwał czasu wygaśnięcia komunikatu kolejki w sekundach. Maksymalny dozwolony czas wygaśnięcia wynosi siedem dni lub 604 800 sekund.
      • Typ danych: liczba
      • Wymagane: Tak
    • resourceDetailsToSend
      • Szczegóły zasobu do wysłania
      • Kontrolowanie pól zasobów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • messagesToSend
      • Komunikaty do wysłania
      • Kontrolowanie komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • detailedMessagesToSend
      • Szczegółowe komunikaty do wysłania
      • Kontrolowanie szczegółowych komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie

Campfire

Ognisko jest podobne do wiadomości błyskawicznych, ale przeznaczone wyłącznie dla grup.

Publikowanie wiadomości w pokoju

Opublikuj wiadomość o zdarzeniu do pokoju w Campfire.

  • Identyfikator odbiorcy: ognisko
  • Identyfikator akcji: postMessageToRoom
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Accountname
      • Nazwa konta
      • Nazwa konta, na przykład https://{account name}.campfirenow.com
      • Typ danych: ciąg
      • Wymagane: Tak
    • authToken
      • Token uwierzytelniania interfejsu API
      • Token uwierzytelniania interfejsu API dla użytkownika, z którego są publikowane komunikaty. Ten token można uzyskać na stronie profilu użytkownika na stronie Campfire.
      • Typ danych: ciąg
      • Wymagane: Tak
    • roomId
      • Pokój
      • Miejsce na opublikowanie wiadomości.
      • Typ danych: liczba
      • Wymagane: Tak
    • showDetails
      • Wysyłanie szczegółowej wiadomości
      • Opublikuj krótki lub szczegółowy komunikat o zdarzeniu.
      • Typ danych: wartość logiczna
      • Wymagane: Nie

Jenkins

Jenkins to serwer ciągłej integracji, który umożliwia ciągłe kompilowanie i testowanie projektów oprogramowania.

Wyzwalanie kompilacji usługi Git

Wyzwala kompilację skonfigurowaną do korzystania z repozytorium Git przy użyciu wtyczki Git serwera Jenkins.

  • Identyfikator odbiorcy: jenkins
  • Identyfikator akcji: triggerGitBuild
  • Obsługiwane zdarzenia: git.push
  • Ustawienia:
    • serverBaseUrl
      • Podstawowy adres URL usługi Jenkins
      • Podstawowy adres URL hostujący serwer Jenkins
      • Typ danych: identyfikator URI
      • Wymagane: Tak
    • Nazwę użytkownika
      • User name
      • Nazwa użytkownika usługi Jenkins, który może wyzwolić kompilację
      • Typ danych: ciąg
      • Wymagane: Tak
    • Hasło
      • Token interfejsu API użytkownika (lub hasło)
      • Token interfejsu API użytkownika, który jest dostępny na stronie konfiguracji użytkownika usługi Jenkins. Token interfejsu API jest nowy od wersji 1.426. W przypadku wcześniejszych wersji serwera Jenkins należy określić rzeczywiste hasło użytkownika.
      • Typ danych: ciąg
      • Wymagane: Tak

Wyzwalanie kompilacji ogólnej

Wyzwala ogólną kompilację serwera Jenkins, wywołując adres URL kompilacji narzędzia Jenkins.

  • Identyfikator odbiorcy: jenkins
  • Identyfikator akcji: triggerGenericBuild
  • Obsługiwane zdarzenia: git.push, build.complete, tfvc.checkin
  • Ustawienia:
    • serverBaseUrl
      • Podstawowy adres URL usługi Jenkins
      • Podstawowy adres URL hostujący serwer Jenkins
      • Typ danych: identyfikator URI
      • Wymagane: Tak
    • Nazwę użytkownika
      • User name
      • Nazwa użytkownika usługi Jenkins, który może wyzwolić kompilację
      • Typ danych: ciąg
      • Wymagane: Tak
    • Hasło
      • Token interfejsu API użytkownika (lub hasło)
      • Token interfejsu API użytkownika, który jest dostępny na stronie konfiguracji użytkownika usługi Jenkins. Token interfejsu API jest nowy od wersji 1.426. W przypadku wcześniejszych wersji serwera Jenkins należy określić rzeczywiste hasło użytkownika.
      • Typ danych: ciąg
      • Wymagane: Tak
    • buildName
      • Tworzenie
      • Nazwa kompilacji do wyzwolenia
      • Typ danych: ciąg
      • Wymagane: Tak
    • buildAuthToken
      • Token kompilacji
      • Token autoryzacji w postaci ciągu, dzięki czemu tylko użytkownicy, którzy wiedzą, że będzie mógł zdalnie wyzwolić kompilacje tego projektu
      • Typ danych: ciąg
      • Wymagane: Nie
    • buildParameterized
      • Akceptuje parametry
      • Wskazuje, czy kompilacja jest sparametryzowana, czy nie (parametry kompilacji są opcjonalnie określone wcześniej)
      • Typ danych: wartość logiczna
      • Wymagane: Nie
    • buildParams
      • Parametry kompilacji
      • Nazwy parametrów kompilacji i wartości oddzielone dwukropkiem (na przykład "param1:value1") z każdą parą name-value wyświetlaną we własnym wierszu tekstu
      • Typ danych: ciąg
      • Wymagane: Nie

Kato

Kato oferuje usługę obsługi komunikatów dla nowoczesnych organizacji.

Opublikuj wydarzenie w pokoju

Publikuje wydarzenie w pokoju Kato

  • Identyfikator konsumenta: kato
  • Identyfikator akcji: postEventToRoom
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • roomToken
      • Token pokoju
      • Token do interakcji z pokojem przy użyciu interfejsu API Kato
      • Typ danych: ciąg
      • Wymagane: Tak
    • roomName
      • Nazwa pokoju
      • Nazwa pokoju widoczna w Kato
      • Typ danych: ciąg
      • Wymagane: Nie

Trello

Zapewnia integrację z aplikacją Trello.

Utwórz kartę

Ta akcja powoduje utworzenie karty na istniejącej liście w aplikacji Trello. Karta może reprezentować zadanie, problem, zdarzenie lub prawie wszystko. Stan karty jest zwykle określany przez listę, na której jest włączona. Aby uzyskać więcej informacji, zobacz Create a service hook with Trello (Tworzenie elementu zaczepienia usługi za pomocą aplikacji Trello).

  • Identyfikator odbiorcy: trello
  • Identyfikator akcji: createCard
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Usertoken
      • Token użytkownika (potrzebujesz go? Pobierz go teraz.)
      • Token użytkownika dostarczony przez firmę Trello. Wybierz link w opisanym wcześniej opisie akcji, aby dowiedzieć się, jak uzyskać ten token.
      • Typ danych: ciąg
      • Wymagane: Tak
    • boardId
      • Board (płytka drukowana)
      • Nazwa tablicy, na której zostanie utworzona karta Trello.
      • Typ danych: ciąg
      • Wymagane: Tak
    • listId
      • List
      • Nazwa listy, na której zostanie utworzona karta Trello.
      • Typ danych: ciąg
      • Wymagane: Tak
    • Etykiety
      • Etykiety
      • Rozdzielona przecinkami lista kolorów etykiet, które mają być stosowane do utworzonej karty. Prawidłowe nazwy kolorów etykiet to czerwony, pomarańczowy, żółty, zielony, niebieski i fioletowy.
      • Typ danych: ciąg
      • Wymagane: Nie
    • addToTop
      • Utwórz na początku listy
      • Wskazuje, czy karta powinna zostać utworzona na początku listy Trello, a nie na końcu.
      • Typ danych: wartość logiczna
      • Wymagane: Nie

Utwórz listę

Ta akcja tworzy listę na istniejącej tablicy w aplikacji Trello. Lista służy do organizowania kart na tablicy i zazwyczaj reprezentuje stan. Aby uzyskać więcej informacji, zobacz Create a service hook with Trello (Tworzenie elementu zaczepienia usługi za pomocą aplikacji Trello).

  • Identyfikator odbiorcy: trello
  • Identyfikator akcji: createList
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Usertoken
      • Token użytkownika (potrzebujesz go? Pobierz go teraz.)
      • Token użytkownika dostarczony przez firmę Trello. Wybierz link w opisanym wcześniej opisie akcji, aby dowiedzieć się, jak uzyskać ten token.
      • Typ danych: ciąg
      • Wymagane: Tak
    • boardId
      • Board (płytka drukowana)
      • Nazwa tablicy, na której zostanie utworzona lista Trello.
      • Typ danych: ciąg
      • Wymagane: Tak
    • addToBottom
      • Utwórz w dolnej części tablicy
      • Wskazuje, czy lista powinna zostać utworzona w dolnej części tablicy, a nie u góry.
      • Typ danych: wartość logiczna
      • Wymagane: Nie

Elementy webhook

Elementy webhook zapewniają komunikację zdarzeń za pośrednictwem protokołu HTTP.

Publikowanie za pośrednictwem protokołu HTTP

Ta akcja powoduje opublikowanie reprezentacji obiektu JSON zdarzenia do określonego adresu URL. Zalecane są punkty końcowe HTTPS ze względu na potencjalne dane prywatne w ładunku zdarzenia. Aby uzyskać więcej informacji, zobacz Webhooks (Elementy webhook).

  • Identyfikator odbiorcy: elementy webHook
  • Identyfikator akcji: httpRequest
  • Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Ustawienia:
    • Adres url
      • URL
      • Adres URL, do którego jest wysyłany komunikat HTTP POST.
      • Typ danych: identyfikator URI
      • Wymagane: Tak
    • httpHeaders
      • Nagłówki HTTP
      • Klucze nagłówka HTTP i wartości oddzielone dwukropkiem (na przykład "Key1:value1") z każdą parą klucz-wartość-wartość wyświetlaną we własnym wierszu tekstu.
      • Typ danych: ciąg
      • Wymagane: Nie
    • basicAuthUsername
      • Nazwa użytkownika uwierzytelniania podstawowego
      • Wprowadź nazwę użytkownika standardowego uwierzytelniania HTTP. Podstawowe uwierzytelnianie HTTP wysyła poświadczenia w postaci zwykłego tekstu (niezaszyfrowanego), co oznacza, że należy użyć adresu URL rozpoczynającego się od "https", aby włączyć szyfrowanie tych poświadczeń za pośrednictwem bezpiecznej warstwy transportu (SSL).
      • Typ danych: ciąg
      • Wymagane: Nie
    • basicAuthPassword
      • Hasło uwierzytelniania podstawowego
      • Wprowadź hasło do standardowego uwierzytelniania HTTP. Podstawowe uwierzytelnianie HTTP wysyła poświadczenia w postaci zwykłego tekstu (niezaszyfrowanego), co oznacza, że należy użyć adresu URL rozpoczynającego się od "https", aby włączyć szyfrowanie tych poświadczeń za pośrednictwem protokołu SSL.
      • Typ danych: ciąg
      • Wymagane: Nie
    • resourceDetailsToSend
      • Szczegóły zasobu do wysłania
      • Kontrolowanie pól zasobów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • messagesToSend
      • Komunikaty do wysłania
      • Kontrolowanie komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie
    • detailedMessagesToSend
      • Szczegółowe komunikaty do wysłania
      • Kontrolowanie szczegółowych komunikatów do wysłania
      • Typ danych: ciąg
      • Wymagane: Nie

Zendesk

Zendesk to pakiet SaaS, który oferuje bilet pomocy technicznej, śledzenie problemów i pomoc techniczną.

Tworzenie prywatnego komentarza w bilecie

Użyj aplikacji Zendesk, aby utworzyć prywatny komentarz w bilecie.

  • Identyfikator odbiorcy: zendesk
  • Identyfikator akcji: createPrivateComment
  • Obsługiwane zdarzenia: workitem.commented
  • Ustawienia:
    • Accountname
      • Nazwa konta
      • Nazwa konta zendesk, na przykład https://{account name}.zendesk.com
      • Typ danych: ciąg
      • Wymagane: Tak
    • Nazwę użytkownika
      • User name
      • Nazwa użytkownika aplikacji Zendesk, który aktualizuje bilety
      • Typ danych: ciąg
      • Wymagane: Tak
    • apiToken
      • Token interfejsu API
      • Token interfejsu API zendesk (można go znaleźć w aplikacji Zendesk w interfejsie API kanałów > Administracja>)
      • Typ danych: ciąg
      • Wymagane: Tak