Udostępnij przez


Mapa biznesowa

Mapa biznesowa to najbardziej elastyczna platforma oprogramowania do zapewniania elastyczności przedsiębiorstwa opartej na wynikach. Niedopasowana funkcja konsoliduje wiele narzędzi w jednym, umożliwiając niedrogie wdrażanie na dużą skalę, widoczność wszystkich projektów/portfeli oraz dopasowanie do celów w celu szybszego dostarczania pracy w jakości. Łącznik Mapy biznesowej może służyć do odzwierciedlenia zmian w narzędziach zewnętrznych (np. monitorach problemów, wiadomościach e-mail, narzędziach do śledzenia czasu itp.) na kartach Kanban.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Pomoc techniczna dotycząca mapy biznesowej
adres URL https://businessmap.io/customer-support
Email support@businessmap.io
Metadane łącznika
Publisher Mapa biznesowa
Witryna internetowa https://businessmap.io
Zasady ochrony prywatności https://businessmap.io/privacy-policy
Kategorie Zarządzanie biznesem; Analiza biznesowa

Mapa biznesowa to najbardziej elastyczna platforma oprogramowania do zapewniania elastyczności przedsiębiorstwa opartej na wynikach. Pomaga menedżerom uzyskać wgląd we wszystkie projekty, łączy planowanie z wykonaniem i prowadzi ciągłą optymalizację przepływów pracy dostarczania. Utworzona z myślą o skalowaniu mapa biznesowa może łatwo rozwinąć się od jednego zespołu dostarczania do strategicznego portfela. Niedopasowana funkcja konsoliduje wiele narzędzi w jednym, umożliwiając niedrogie wdrażanie na dużą skalę, widoczność wszystkich projektów/portfeli oraz dopasowanie do celów w celu szybszego dostarczania pracy w jakości. Businessmap to wiodąca platforma Kanban do wydajnego zarządzania projektami i dostarczania.

Jest to łącznik Mapy biznesowej dla usługi Power Automate. Działa ona bezpośrednio z danymi z mapy biznesowej za pośrednictwem naszego najnowszego interfejsu API w wersji 2. Łącznik Mapy biznesowej może służyć do odzwierciedlenia zmian w narzędziach zewnętrznych wewnątrz kart Kanban lub odczytywania danych z mapy biznesowej i używania ich w łącznikach innych firm. Odwiedź sekcję integracji w naszej bazie wiedzy , aby uzyskać kilka rzeczywistych przykładów dotyczących korzystania z łącznika.

Wymagania wstępne

  • Aby użyć tego łącznika, musisz mieć konto mapy biznesowej i użytkownika z uprawnieniami dostępu do interfejsu API. Sign-Up tutaj i utwórz i konto, aby go wypróbować.

Jak uzyskać poświadczenia

Klucz interfejsu API można znaleźć w menu "API" w profilu.

Wprowadzenie do łącznika

Łącznik ma jeden wyzwalacz, który jest ogólny i obsługuje wszystkie zdarzenia. Ustaw ten wyzwalacz jako pierwszy krok w przepływie, gdy chcesz odbierać zdarzenia z mapy biznesowej. Następną akcją powinno być sprawdzenie "Warunek", w którym zostanie dodany filtr "zdarzenie" i kontynuowanie tylko wtedy, gdy typ zdarzenia jest zgodny z tym, który cię interesuje. W tym miejscu można znaleźć listę ze wszystkimi zdarzeniami i możliwymi wartościami, które będą wyzwalać wyzwalacz. Następnym krokiem będzie zwykle "Pobierz identyfikator karty", otrzyma wszystkie szczegóły z karty i będzie można używać tych danych i wykonywać na nich operacje w przepływie, który następuje poniżej.

Znane problemy i ograniczenia

Niektóre limity są stosowane w celu zapewnienia, że produkt i nasze interfejsy API działają tak sprawnie i wydajnie, jak to możliwe. Dokładne limity interfejsu API zależą od planu usługi. Więcej informacji na ten temat można znaleźć tutaj

Typowe błędy i środki zaradcze

Jeśli wystąpi błąd 429, oznacza to, że osiągnięto limity interfejsu API. Szczegóły błędu informują o tym, jak długo trzeba czekać, zanim będzie można wysłać następne żądanie. Wszystkie inne błędy zawierają komunikaty, które wyjaśniają dokładną przyczynę błędu.

Często zadawane pytania

Mamy obszerną sekcję Bazy wiedzy i jeśli masz jakiekolwiek pytanie, na które nie możesz znaleźć odpowiedzi, skontaktuj się z nami i chętnie pomożemy.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz interfejsu API securestring Klucz interfejsu API dla tego interfejsu API Prawda
Subdomain ciąg Określanie poddomeny konta mapy biznesowej Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizacja karty (przestarzała) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj karty aktualizacji .

(Przestarzałe) Aktualizowanie właściwości karty (tytuł, opis, priorytet itp.)

Aktualizowanie karty

Zaktualizuj właściwości karty (tytuł, opis, priorytet itp.). Jeśli występuje przekroczenie limitu czasu lub limit interfejsu API, spróbuj podzielić ustawienie pól niestandardowych, naklejek i tagów na osobne akcje.

Blokuj lub odblokuj kartę (przestarzałą) [PRZESTARZAŁE]

(Przestarzałe) Blokuj, odblokuj lub edytuj przyczyny blokowania karty.

Czas dziennika (liczba sekund) (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj czasu dziennika .

(Przestarzałe) Czas rejestrowania na karcie. Czas jest rejestrowany w sekundach.

Czas rejestrowania

Czas rejestrowania na karcie.

Dodaj komentarz

Dodaj komentarz do karty lub inicjatywy.

Dodaj komentarz (przestarzały) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Dodaj komentarz .

(Przestarzałe) Dodaje komentarz do karty lub inicjatywy.

Karta archiwum (przestarzała) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj karty Archiwum lub Niearchiwnej .

(Przestarzałe) Przenieś kartę do archiwum. Karta nie może być zablokowana i musi znajdować się w kolumnie Gotowe lub w archiwum kolumny.

Karta archiwum lub niearchiwna

Dodaj kartę do archiwum lub wyodrębnij ją z archiwum.

Karta blokuj

Blokuj kartę.

Karty łączy

Połącz kartę z istniejącą kartą.

Odblokowywanie karty

Odblokuj kartę.

Odrzuć lub przywróć kartę

Odrzuć kartę lub przywróć wcześniej odrzuconą kartę.

Odłącz karty

Usuń połączenie między dwiema kartami.

Pobieranie karty według identyfikatora

Pobierz szczegóły karty według jego wewnętrznego identyfikatora.

Pobieranie karty według identyfikatora (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz kartę według identyfikatora .

(Przestarzałe) Pobieranie karty według jego identyfikatora

Pobieranie karty według identyfikatora niestandardowego

Znajdź kartę według identyfikatora karty niestandardowej. Jeśli zostanie znalezionych wiele kart, zostanie zwróconych tylko pierwszy z nich. Użyj parametru "Tablica", aby filtrować wyszukiwanie według tablic.

Pobieranie pasów ruchu (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Get Lanes .

(Przestarzałe) Pobiera wszystkie pasy ruchu dla określonej tablicy.

Pobieranie przepływów pracy (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz przepływy pracy .

(Przestarzałe) Pobierz wszystkie przepływy pracy z danej tablicy.

Pobieranie typów (przestarzałych) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz typy .

(Przestarzałe) Pobiera wszystkie typy na koncie.

Pobieranie załączników kart

Pobierz listę ze wszystkimi załącznikami dla określonej karty.

Pobierz kolumny tablicy (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz kolumny .

(Przestarzałe) Pobierz wszystkie kolumny dla określonej tablicy.

Pobierz tablice (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz tablice .

(Przestarzałe) Pobierz wszystkie tablice z konta.

Pobierz wszystkie karty

Pobierz wszystkie karty z wybranej tablicy. Odpowiedź zawiera maksymalnie 200 kart. W przypadku ponad 200 kart użyj stronicowania.

Pobierz wszystkie karty (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj opcji Pobierz wszystkie karty .

(Przestarzałe) Pobierz wszystkie karty z danej tablicy.

Pobierz załącznik

Pobierz załącznik z karty. Zawartość pliku jest zwracana jako ciąg zakodowany w formacie base64.

Przekaż załącznik

Przekaż załącznik do karty.

Przenieś kartę

Przenieś kartę do nowej kolumny, pasa ruchu, przepływu pracy lub tablicy.

Przenieś kartę (przestarzałą) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj opcji Przenieś kartę .

(Przestarzałe) Przenieś kartę (zadanie lub inicjatywę, jeśli to możliwe) do kolumny.

Tworzenie karty

Utwórz kartę w wybranej tablicy. Aby ustawić pola niestandardowe, naklejki i tagi są używane w połączeniu z "Aktualizuj kartę".

Tworzenie karty (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz kartę .

(Przestarzałe) Utwórz kartę w wybranej tablicy.

Tworzenie podzadaku

Utwórz nową podzadanie karty lub inicjatywy.

Ustaw wartość pola niestandardowego

Ustaw wartość pola niestandardowego.

Ustawianie lub usuwanie naklejek

Dodaj naklejki do karty lub usuń przypisane naklejki z karty

Ustawianie lub usuwanie tagów

Dodawanie tagów do karty lub usuwanie przypisanych tagów z karty

Usuń kartę (przestarzałą) [PRZESTARZAŁE]

(Przestarzałe) Usuń kartę.

Utwórz podzadanie (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz podzadanie .

(Przestarzałe) Tworzy nową podzadanie karty lub inicjatywy.

Uzyskiwanie nazwy obiektu {Object}

Pobierz nazwę obiektu na podstawie jego identyfikatora. Funkcja pomocnika używana, gdy chcesz uzyskać nazwę tablicy, przepływu pracy, kolumny itp. na podstawie jego identyfikatora

Aktualizacja karty (przestarzała) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj karty aktualizacji .

(Przestarzałe) Aktualizowanie właściwości karty (tytuł, opis, priorytet itp.)

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ zawartości
Content-Type True string

Zawsze ustawiane na: application/json

Akceptuj
Accept True string

Zawsze ustawiane na: application/json

Identyfikator tablicy
boardid integer

Wybierz tablicę z listy rozwijanej

Identyfikator karty
taskid integer

identyfikator karty

Title
title string

title

Description
description string

szczegóły karty

Priority
priority string
Cesjonariusza
assignee string

nazwa użytkownika przypisywanego

Kolor
color string

Kod koloru szesnastkowego podobny do tego #F37325

Rozmiar
size integer

size

Etykiety
tags string

wiele tagów powinno być rozdzielonych spacjami

Pola niestandardowe
cfields string

Sformatowana lista pól niestandardowych w formacie JSON i ich wartości {"field1":"value1","field2":"value2"}

Deadline
deadline string

data terminu w tym formacie RRRR-MM-DD

Łącze zewnętrzne
extlink string

łącze zewnętrzne

Typ
type string

nazwa typu, który chcesz ustawić

Aktualizowanie karty

Zaktualizuj właściwości karty (tytuł, opis, priorytet itp.). Jeśli występuje przekroczenie limitu czasu lub limit interfejsu API, spróbuj podzielić ustawienie pól niestandardowych, naklejek i tagów na osobne akcje.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Workflow
workflow_id integer

Przepływ pracy należy wybrać z listy rozwijanej

Template
template_id integer

Wybieranie szablonu

Kolumna
column_id

Wybierz kolumnę lub wprowadź nazwę lub identyfikator kolumny jako wartość niestandardową

Alejka
lane_id

Wybierz pozycję Lane lub Enter Lane Name (Wprowadź nazwę lub identyfikator pasa) jako wartość niestandardową

Title
title string

Tytuł karty

Description
description string

Opis karty

Identyfikator niestandardowy
custom_id string

Identyfikator niestandardowy

Właściciel
owner_user_id integer

Wybierz pozycję Właściciel karty

Typ
type_id integer

Wybierz typ karty

Rozmiar karty
size double

Rozmiar karty

Priority
priority integer

Wybierz priorytet

Kolor
color string

Kolor (szesnastkowy, np. #000000)

Deadline
deadline string

Termin ostateczny (format: RRRR-MM-DD)

Planowana data rozpoczęcia
planned_start_date string

Planowana data rozpoczęcia (format: RRRR-MM-DD) (tylko inicjatywy)

Planowana data zakończenia
planned_end_date string

Planowana data zakończenia (format: RRRR-MM-DD) (tylko inicjatywy)

Rzeczywisty czas rozpoczęcia
actual_start_time string

Rzeczywisty czas rozpoczęcia (format: RRRR-MM-DDTHH:mm:ssZ) (tylko inicjatywy)

Rzeczywisty czas zakończenia
actual_end_time string

Rzeczywisty czas zakończenia (format: RRRR-MM-DDTHH:mm:ssZ) (tylko inicjatywy)

Naklejki
stickers string

Zaznacz naklejki lub dodaj je jako tekst rozdzielony przecinkami

Etykiety
tags string

Wybierz tagi lub dodaj je jako tekst rozdzielony przecinkami

Name
field_id integer

Wybieranie pola niestandardowego

Wartość
value string

Wartość pola niestandardowego

Zwraca

Blokuj lub odblokuj kartę (przestarzałą) [PRZESTARZAŁE]

(Przestarzałe) Blokuj, odblokuj lub edytuj przyczyny blokowania karty.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
boardid True string

Wybierz tablicę z listy rozwijanej

Identyfikator karty
taskid True string

identyfikator karty

Typ zdarzenia
event True string
Przyczyna blokowania
blockreason string

przyczyna blokowania

Czas dziennika (liczba sekund) (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj czasu dziennika .

(Przestarzałe) Czas rejestrowania na karcie. Czas jest rejestrowany w sekundach.

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ zawartości
Content-Type True string

Zawsze używaj: application/json

Typ zawartości
Accept True string

Zawsze używaj: application/json

Identyfikator karty
card_id string

Identyfikator karty wewnętrznej

Time
time string

Czas w sekundach

Comment
comment string

Comment

Czas rejestrowania

Czas rejestrowania na karcie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True string

Identyfikator karty wewnętrznej

Jednostka czasu
time_unit True string

Jednostka czasu

Czas trwania
time True integer

Czas trwania

Comment
comment string

Comment

Dodaj komentarz

Dodaj komentarz do karty lub inicjatywy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Comment
text True string

Comment

Dodaj komentarz (przestarzały) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Dodaj komentarz .

(Przestarzałe) Dodaje komentarz do karty lub inicjatywy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ zawartości
Content-Type True string

Zawsze używaj: application/json

Typ zawartości
Accept True string

Zawsze używaj: application/json

Identyfikator karty
taskid string

identyfikator karty

Comment
comment string

komentarz

Karta archiwum (przestarzała) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj karty Archiwum lub Niearchiwnej .

(Przestarzałe) Przenieś kartę do archiwum. Karta nie może być zablokowana i musi znajdować się w kolumnie Gotowe lub w archiwum kolumny.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
cardid True string

identyfikator karty

wersja
version string

wersja

Karta archiwum lub niearchiwna

Dodaj kartę do archiwum lub wyodrębnij ją z archiwum.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Akcja
is_archived True integer

Wybieranie akcji

Karta blokuj

Blokuj kartę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Przyczyna blokowania
reason_id True string

Wybierz przyczynę blokowania

Comment
comment string

Dodawanie komentarza do przyczyny blokowania

Karty łączy

Połącz kartę z istniejącą kartą.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Zostanie połączone jako
link_type True string

Wybierz typ łącza

Identyfikator karty
linked_card_id True integer

Identyfikator karty, aby połączyć się z bieżącą kartą

Odblokowywanie karty

Odblokuj kartę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Odrzuć lub przywróć kartę

Odrzuć kartę lub przywróć wcześniej odrzuconą kartę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Akcja
is_discarded True integer

Wybieranie akcji

Odłącz karty

Usuń połączenie między dwiema kartami.

Parametry

Nazwa Klucz Wymagane Typ Opis
Odłącz identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Połączone jako
link_type True string

Wybierz typ łącza

Do identyfikatora karty
linked_card_id True integer

Wprowadź identyfikator połączonej karty

Pobieranie karty według identyfikatora

Pobierz szczegóły karty według jego wewnętrznego identyfikatora.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Zwraca

Pobieranie karty według identyfikatora (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz kartę według identyfikatora .

(Przestarzałe) Pobieranie karty według jego identyfikatora

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
boardid True string

Wybierz tablicę z listy rozwijanej

Identyfikator karty
taskid True string

identyfikator karty

Pobierz historię
history string

ustaw wartość "yes", jeśli chcesz pobrać historię kart

Pobieranie komentarzy
comments string

ustaw wartość "tak", jeśli chcesz uzyskać komentarze do karty

Format tekstu
textformat string

format tekstowy zwrócony dla opisu karty

Zwraca

Nazwa Ścieżka Typ Opis
identyfikator zadania
taskid string

identyfikator zadania

boardid
boardid string

boardid

title
title string

title

opis
description string

opis

typ
type string

typ

osoba przydzielona
assignee string

osoba przydzielona

Podzadania
subtasks string

Podzadania

podzadaniacomplete
subtaskscomplete string

podzadaniacomplete

color
color string

color

priority
priority string

priority

size
size string

size

termin
deadline string

termin

deadlineoriginalformat
deadlineoriginalformat string

deadlineoriginalformat

extlink
extlink string

extlink

tags
tags string

tags

leadtime
leadtime integer

leadtime

Zablokowany
blocked string

Zablokowany

blockedreason
blockedreason string

blockedreason

nazwa kolumny
columnname string

nazwa kolumny

lanename
lanename string

lanename

podtaskdetails
subtaskdetails array of

podtaskdetails

columnid
columnid string

columnid

laneid
laneid string

laneid

pozycja
position string

pozycja

przepływ pracy
workflow integer

przepływ pracy

workflow_id
workflow_id integer

workflow_id

URL
attachments.FXPR1VE0LIC9.url string

URL

clientName
attachments.FXPR1VE0LIC9.clientName string

clientName

uniqueName (unikatowa) nazwa
attachments.FXPR1VE0LIC9.uniqueName string

uniqueName (unikatowa) nazwa

rozmiar pliku
attachments.FXPR1VE0LIC9.fileSize float

rozmiar pliku

fileType
attachments.FXPR1VE0LIC9.fileType string

fileType

stan
attachments.FXPR1VE0LIC9.status string

stan

URL
attachments.0XC7C1PRR9ZK.url string

URL

clientName
attachments.0XC7C1PRR9ZK.clientName string

clientName

uniqueName (unikatowa) nazwa
attachments.0XC7C1PRR9ZK.uniqueName string

uniqueName (unikatowa) nazwa

rozmiar pliku
attachments.0XC7C1PRR9ZK.fileSize float

rozmiar pliku

fileType
attachments.0XC7C1PRR9ZK.fileType string

fileType

stan
attachments.0XC7C1PRR9ZK.status string

stan

ścieżka kolumny
columnpath string

ścieżka kolumny

reporter
reporter string

reporter

pola niestandardowe
customfields array of object

pola niestandardowe

fieldid
customfields.fieldid integer

fieldid

nazwa
customfields.name string

nazwa

typ
customfields.type string

typ

value
customfields.value string

value

obowiązkowy
customfields.mandatory boolean

obowiązkowy

Niezmienialny
customfields.immutable boolean

Niezmienialny

zaktualizowanyat
updatedat string

zaktualizowanyat

logtime
loggedtime integer

logtime

historydetails
historydetails array of object

historydetails

typ zdarzenia
historydetails.eventtype string

typ zdarzenia

historyevent
historydetails.historyevent string

historyevent

identyfikator zadania
historydetails.taskid string

identyfikator zadania

details
historydetails.details string

details

autor
historydetails.author string

autor

entrydate
historydetails.entrydate string

entrydate

historyid
historydetails.historyid string

historyid

comments
comments array of

comments

Pobieranie karty według identyfikatora niestandardowego

Znajdź kartę według identyfikatora karty niestandardowej. Jeśli zostanie znalezionych wiele kart, zostanie zwróconych tylko pierwszy z nich. Użyj parametru "Tablica", aby filtrować wyszukiwanie według tablic.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty niestandardowej
custom_ids True string

Wprowadź identyfikatory niestandardowe

Zarząd
board_ids integer

Tablica musi być wybrana z listy rozwijanej

Zwraca

Pobieranie pasów ruchu (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Get Lanes .

(Przestarzałe) Pobiera wszystkie pasy ruchu dla określonej tablicy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
board_id True string

Tablica, aby uzyskać pasy ruchu.

Zwraca

Nazwa Ścieżka Typ Opis
dane
data array of object

dane

lane_id
data.lane_id integer

lane_id

przepływ pracy
data.workflow integer

przepływ pracy

parent_lane_id
data.parent_lane_id integer

parent_lane_id

pozycja
data.position integer

pozycja

nazwa
data.name string

nazwa

opis
data.description string

opis

color
data.color string

color

Pobieranie przepływów pracy (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz przepływy pracy .

(Przestarzałe) Pobierz wszystkie przepływy pracy z danej tablicy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
board_id True string

Zarząd

Zwraca

Nazwa Ścieżka Typ Opis
dane
data array of object

dane

typ
data.type integer

typ

pozycja
data.position integer

pozycja

is_enabled
data.is_enabled integer

is_enabled

is_collapsible
data.is_collapsible integer

is_collapsible

nazwa
data.name string

nazwa

workflow_id
data.workflow_id integer

workflow_id

Pobieranie typów (przestarzałych) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz typy .

(Przestarzałe) Pobiera wszystkie typy na koncie.

Zwraca

Nazwa Ścieżka Typ Opis
dane
data array of object

dane

type_id
data.type_id integer

type_id

icon_type
data.icon_type integer

icon_type

icon_id
data.icon_id integer

icon_id

nazwa
data.name string

nazwa

opis
data.description string

opis

color
data.color string

color

card_color_sync
data.card_color_sync integer

card_color_sync

all_properties_are_locked
data.all_properties_are_locked integer

all_properties_are_locked

availability
data.availability integer

availability

is_enabled
data.is_enabled integer

is_enabled

Pobieranie załączników kart

Pobierz listę ze wszystkimi załącznikami dla określonej karty.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Zwraca

Pobierz kolumny tablicy (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz kolumny .

(Przestarzałe) Pobierz wszystkie kolumny dla określonej tablicy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
board_id True string

Tablica do pobrania kolumn.

Zwraca

Nazwa Ścieżka Typ Opis
dane
data array of object

dane

column_id
data.column_id integer

column_id

przepływ pracy
data.workflow integer

przepływ pracy

section
data.section integer

section

parent_column_id
data.parent_column_id integer

parent_column_id

pozycja
data.position integer

pozycja

nazwa
data.name string

nazwa

opis
data.description string

opis

color
data.color string

color

limit
data.limit integer

limit

cards_per_row
data.cards_per_row integer

cards_per_row

flow_type
data.flow_type integer

flow_type

Pobierz tablice (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz tablice .

(Przestarzałe) Pobierz wszystkie tablice z konta.

Zwraca

Nazwa Ścieżka Typ Opis
dane
data array of object

dane

board_id
data.board_id integer

board_id

workspace_id
data.workspace_id integer

workspace_id

is_archived
data.is_archived integer

is_archived

nazwa
data.name string

nazwa

Pobierz wszystkie karty

Pobierz wszystkie karty z wybranej tablicy. Odpowiedź zawiera maksymalnie 200 kart. W przypadku ponad 200 kart użyj stronicowania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zarząd
board_ids True integer

Tablica musi być wybrana z listy rozwijanej

Identyfikatory kart niestandardowych
custom_ids array

Wprowadź identyfikatory niestandardowe

Strona
page integer

Numer strony

State
state string

Wartość stanu kart, które chcesz uzyskać. Domyślnie jest to aktywny stan.

Zwraca

Pobierz wszystkie karty (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj opcji Pobierz wszystkie karty .

(Przestarzałe) Pobierz wszystkie karty z danej tablicy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
boardid True string

Wybierz tablicę z listy rozwijanej

Pobierz załącznik

Pobierz załącznik z karty. Zawartość pliku jest zwracana jako ciąg zakodowany w formacie base64.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Nazwa pliku
attachment_id True integer

Wybierz pozycję Załącznik lub wprowadź identyfikator załącznika z pozycji Pobierz załączniki karty

Zwraca

Przekaż załącznik

Przekaż załącznik do karty.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Nazwa pliku
file_name True string

Wprowadź nazwę pliku

Content
content True binary

Podaj zawartość pliku (base64)

Zwraca

Przenieś kartę

Przenieś kartę do nowej kolumny, pasa ruchu, przepływu pracy lub tablicy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Workflow
workflow_id True integer

Przepływ pracy należy wybrać z listy rozwijanej

Kolumna
column_id True

Wybierz kolumnę lub wprowadź nazwę lub identyfikator kolumny jako wartość niestandardową

Alejka
lane_id True

Wybierz pozycję Lane lub Enter Lane Name (Wprowadź nazwę lub identyfikator pasa) jako wartość niestandardową

Przenieś kartę (przestarzałą) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj opcji Przenieś kartę .

(Przestarzałe) Przenieś kartę (zadanie lub inicjatywę, jeśli to możliwe) do kolumny.

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ zawartości
Content-Type True string

Zawsze używaj: application/json

Typ zawartości
Accept True string

Zawsze używaj: application/json

Identyfikator karty
taskid string

identyfikator karty

Identyfikator tablicy
boardid True string

identyfikator tablicy

Kolumna
column string

nazwa kolumny

Alejka
lane string

nazwa pasa ruchu

Position
position string

położenie karty w kolumnie

Przekroczenie przyczyny
exceedingreason string

przekroczenie przyczyny

Tworzenie karty

Utwórz kartę w wybranej tablicy. Aby ustawić pola niestandardowe, naklejki i tagi są używane w połączeniu z "Aktualizuj kartę".

Parametry

Nazwa Klucz Wymagane Typ Opis
Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Workflow
workflow_id True integer

Przepływ pracy należy wybrać z listy rozwijanej

Template
template_id integer

Wybieranie szablonu

Kolumna
column_id True

Wybierz kolumnę lub wprowadź nazwę lub identyfikator kolumny jako wartość niestandardową

Alejka
lane_id True

Wybierz pozycję Lane lub Enter Lane Name (Wprowadź nazwę lub identyfikator pasa) jako wartość niestandardową

Title
title True string

Tytuł karty

Description
description string

Opis karty

Identyfikator niestandardowy
custom_id string

Identyfikator karty niestandardowej

Właściciel
owner_user_id integer

Wybierz pozycję Właściciel karty

Użytkownik reportera
reporter_user_id integer

Wybieranie reportera z użytkowników mapy biznesowej

Wiadomość e-mail reportera
reporter_email string

Wprowadź adres e-mail reportera tylko wtedy, gdy żaden użytkownik nie jest zaznaczony powyżej

Typ
type_id integer

Wybierz typ karty

Rozmiar karty
size double

Rozmiar karty

Priority
priority integer

Wybierz priorytet

Kolor
color string

Kolor (szesnastkowy, np. #000000)

Deadline
deadline string

Termin ostateczny (format: RRRR-MM-DD)

Planowana data rozpoczęcia
planned_start_date string

Planowana data rozpoczęcia (format: RRRR-MM-DD) (tylko inicjatywy)

Planowana data zakończenia
planned_end_date string

Planowana data zakończenia (format: RRRR-MM-DD) (tylko inicjatywy)

Rzeczywisty czas rozpoczęcia
actual_start_time string

Rzeczywisty czas rozpoczęcia (format: RRRR-MM-DDTHH:mm:ssZ) (tylko inicjatywy)

Rzeczywisty czas zakończenia
actual_end_time string

Rzeczywisty czas zakończenia (format: RRRR-MM-DDTHH:mm:ssZ) (tylko inicjatywy)

Zwraca

Tworzenie karty (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz kartę .

(Przestarzałe) Utwórz kartę w wybranej tablicy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ zawartości
Content-Type string

Zawsze używaj: application/json

Typ zawartości
Accept string

Zawsze używaj: application/json

Identyfikator tablicy
boardid True string

Wybieranie tablicy

Title
title string

title

Description
description string

szczegóły karty

Priority
priority string

możliwe wartości: Niski, Średni, Wysoki, Krytyczny

Cesjonariusza
assignee string

nazwa użytkownika przypisywanego

Kolor
color string

Kod koloru szesnastkowego podobny do tego #F37325

Rozmiar
size string

size

Etykiety
tags string

wiele tagów powinno być rozdzielonych spacjami

Pola niestandardowe
cfields string

Sformatowana lista pól niestandardowych w formacie JSON i ich wartości {"field1":"value1","field2":"value2"}

Deadline
deadline string

data terminu w tym formacie RRRR-MM-DD

Łącze zewnętrzne
extlink string

łącze zewnętrzne

Typ
type string

nazwa typu, który chcesz ustawić

Szablon karty
template string

nazwa szablonu karty, który chcesz zastosować

Nazwa kolumny
column string

dokładna nazwa kolumny

Alejka
lane string

nazwa pasa ruchu

Position
position string

położenie karty w kolumnie

Przekroczenie przyczyny
exceedingreason string

przekroczenie przyczyny

Tworzenie podzadaku

Utwórz nową podzadanie karty lub inicjatywy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Description
description True string

Opis podzadaku

Właściciel
owner_user_id string

Wybieranie użytkownika

Stan podzadanie
is_finished integer

Wybierz pozycję Stan podzadanie

Ustaw wartość pola niestandardowego

Ustaw wartość pola niestandardowego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Identyfikator tablicy
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Nazwa pola
field_id True integer

Wybieranie pola niestandardowego

Wartość
values True string

Wybierz z listy rozwijanej lub wprowadź wartości niestandardowe oddzielone przecinkami

Ustawianie lub usuwanie naklejek

Dodaj naklejki do karty lub usuń przypisane naklejki z karty

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Akcja
action True string

Wybierz, aby ustawić lub usunąć naklejki

Naklejki
stickers True string

Wybierz pojedynczą naklejkę z listy rozwijanej lub wprowadź wiele naklejek oddzielonych przecinkami

Jeśli brakuje naklejki
missing_stickers integer

Wybierz żądane zachowanie, gdy brakuje naklejki

Ustawianie lub usuwanie tagów

Dodawanie tagów do karty lub usuwanie przypisanych tagów z karty

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator karty
card_id True integer

Wprowadź identyfikator karty

Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Akcja
action True string

Wybierz, aby ustawić lub usunąć zestaw tagów

Etykiety
tags True string

Wybierz pojedynczy tag z listy rozwijanej lub wprowadź wiele tagów oddzielonych przecinkami

Jeśli brakuje tagu
missing_tags integer

Wybierz żądane zachowanie, gdy brakuje tagu

Usuń kartę (przestarzałą) [PRZESTARZAŁE]

(Przestarzałe) Usuń kartę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
boardid True string

Wybierz tablicę z listy rozwijanej

Identyfikator karty
taskid True string

identyfikator karty

Utwórz podzadanie (przestarzałe) [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz podzadanie .

(Przestarzałe) Tworzy nową podzadanie karty lub inicjatywy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Typ zawartości
Content-Type True string

Zawsze używaj: application/json

Typ zawartości
Accept True string

Zawsze używaj: application/json

Identyfikator karty nadrzędnej
taskparent integer

Identyfikator karty nadrzędnej

Title
title string

title

Cesjonariusza
assignee string

nazwa użytkownika przypisywanego

Uzyskiwanie nazwy obiektu {Object}

Pobierz nazwę obiektu na podstawie jego identyfikatora. Funkcja pomocnika używana, gdy chcesz uzyskać nazwę tablicy, przepływu pracy, kolumny itp. na podstawie jego identyfikatora

Parametry

Nazwa Klucz Wymagane Typ Opis
Zarząd
board_id True integer

Tablica musi być wybrana z listy rozwijanej

Produkt
item True string

Wybierz typ obiektu

identyfikator
id True integer

Wprowadź identyfikator obiektu

Zwraca

Wyzwalacze

Wyzwalacz ogólny

Wyzwalacze dla dowolnej akcji na tablicy. Użyj kontrolki/warunku lub kontrolki/przełącznika, aby zarządzać przepływem dla różnych wyzwalaczy. Oto częściowa lista obsługiwanych typów zdarzeń: "Utworzono kartę", "Przeniesiono kartę", "Zmieniono szczegóły karty", "Karta usunięta", "Karta zablokowana" \n\n Następnym krokiem po wyzwoleniu powinien być "Pobierz identyfikator karty", aby można było pobrać wszystkie szczegóły karty, \n\nUżyj kontrolki/warunku dla identyfikatora autora w integracji dwukierunkowych, aby zapobiec pętli

Wyzwalacz ogólny

Wyzwalacze dla dowolnej akcji na tablicy. Użyj kontrolki/warunku lub kontrolki/przełącznika, aby zarządzać przepływem dla różnych wyzwalaczy. Oto częściowa lista obsługiwanych typów zdarzeń: "Utworzono kartę", "Przeniesiono kartę", "Zmieniono szczegóły karty", "Karta usunięta", "Karta zablokowana" \n\n Następnym krokiem po wyzwoleniu powinien być "Pobierz identyfikator karty", aby można było pobrać wszystkie szczegóły karty, \n\nUżyj kontrolki/warunku dla identyfikatora autora w integracji dwukierunkowych, aby zapobiec pętli

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator tablicy
board_id True string

Wybieranie tablicy

Zwraca

Nazwa Ścieżka Typ Opis
firma
company string

firma

wydarzenie
event string

wydarzenie

user_id
user_id integer

user_id

board_id
board_id integer

board_id

card_id
card_id integer

card_id

Definicje

downloadAttachmentResponse

Nazwa Ścieżka Typ Opis
Nazwa pliku
data.file_name string

Nazwa pliku załącznika

Content
data.content binary

Zawartość załącznika (base64)

getAllCardsResponse

Nazwa Ścieżka Typ Opis
Wszystkie strony
data.pagination.all_pages integer

Łączna liczba stron

Bieżąca strona
data.pagination.current_page integer

Bieżąca strona

Wyniki na stronę
data.pagination.results_per_page integer

Liczba wyników na stronę

dane
data.data array of object
Identyfikator karty
data.data.card_id integer

Identyfikator karty wewnętrznej

Identyfikator karty niestandardowej
data.data.custom_id string

Identyfikator karty niestandardowej

Identyfikator tablicy
data.data.board_id integer

Identyfikator tablicy karty

Identyfikator przepływu pracy
data.data.workflow_id integer

Identyfikator przepływu pracy karty

Tytuł karty
data.data.title string

Tytuł karty

Identyfikator użytkownika właściciela
data.data.owner_user_id

Identyfikator właściciela karty

Identyfikator typu
data.data.type_id

Identyfikator typu karty

Kolor
data.data.color string

Kolor karty

Section
data.data.section integer

Identyfikator sekcji karty

Identyfikator kolumny
data.data.column_id integer

Identyfikator kolumny karty

Identyfikator pasa ruchu
data.data.lane_id integer

Identyfikator pasa ruchu karty

getCardAttachmentsResponse

Nazwa Ścieżka Typ Opis
dane
data array of object

dane

id
data.id integer

Identyfikator załącznika karty

nazwa_pliku
data.file_name string

Nazwa pliku załącznika karty

łącze
data.link string

Łącze załącznika karty

getCardResponse

Nazwa Ścieżka Typ Opis
Identyfikator karty
data.card_id integer

Identyfikator karty wewnętrznej

Identyfikator karty niestandardowej
data.custom_id string

Identyfikator karty niestandardowej

Identyfikator tablicy
data.board_id integer

Identyfikator tablicy karty

Identyfikator przepływu pracy
data.workflow_id integer

Identyfikator przepływu pracy karty

Tytuł karty
data.title string

Tytuł karty

Identyfikator użytkownika właściciela
data.owner_user_id

Identyfikator właściciela karty

Identyfikator typu
data.type_id

Identyfikator typu karty

Kolor
data.color string

Kolor karty

Section
data.section integer

Identyfikator sekcji karty

Identyfikator kolumny
data.column_id integer

Identyfikator kolumny karty

Identyfikator pasa ruchu
data.lane_id integer

Identyfikator pasa ruchu karty

Position
data.position integer

Położenie karty

Opis karty
data.description string

Opis karty

Rozmiar karty
data.size

Rozmiar karty

Priority
data.priority integer

Identyfikator priorytetu karty

Deadline
data.deadline string

Termin karty

Typ
data.reporter.type string

Typ wartości. Może być wewnętrzny lub zewnętrzny

Reporter
data.reporter.value

Reporter karty

Utworzono pod adresem
data.created_at string

Sygnatura czasowa tworzenia karty

Ostatnia modyfikacja
data.last_modified string

Znacznik czasu ostatniej modyfikacji karty

Zablokowany
data.is_blocked integer

Wartość logiczna, czy karta jest zablokowana

Pola niestandardowe
data.custom_fields array of object

Tablica pól niestandardowych przypisanych do karty

Identyfikator pola
data.custom_fields.field_id integer

Identyfikator pola niestandardowego

Nazwa pola
data.custom_fields.name string

Nazwa pola niestandardowego

Wartość pola
data.custom_fields.value

Wartość pola niestandardowego

Wartość wyświetlana pola
data.custom_fields.display_value

Wyświetlanie wartości pola niestandardowego

values
data.custom_fields.values array of object
Identyfikator wartości
data.custom_fields.values.value_id integer

Identyfikator wartości pola niestandardowego

Wartość pola
data.custom_fields.values.value

Wartość pola niestandardowego

getObjectNameResponse

Nazwa Ścieżka Typ Opis
nazwa
data.name string

Name

uploadAttachmentResponse

Nazwa Ścieżka Typ Opis
dane
data array of object

dane

Identyfikator karty
data.card_id integer

Identyfikator karty wewnętrznej

Nazwa pliku
data.file_name string

Nazwa pliku, który ma zostać przekazany