Obchodní mapa
Businessmap je nejflexibilnější softwarová platforma pro flexibilitu podniků řízenou výsledky. Chybějící funkce konsolidují několik nástrojů do jednoho, což umožňuje cenově dostupné nasazení ve velkém, přehled o všech projektech a portfoliech a sladění cílů, aby bylo možné rychleji pracovat na kvalitě. Konektor Businessmap se dá použít k vyjádření změn v externích nástrojích (např. sledování problémů, e-mail, nástroje pro sledování času atd.) na kartách Kanban.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Podpora obchodní mapy |
| URL | https://businessmap.io/customer-support |
| support@businessmap.io |
| Metadata konektoru | |
|---|---|
| Vydavatel | Obchodní mapa |
| Internetová stránka | https://businessmap.io |
| Zásady ochrany osobních údajů | https://businessmap.io/privacy-policy |
| Kategorie | Řízení podniku; Business Intelligence |
Businessmap je nejflexibilnější softwarová platforma pro flexibilitu podniků řízenou výsledky. Pomáhá správcům získat přehled o všech projektech, spojit plánování s prováděním a průběžně optimalizovat pracovní postupy doručování. Obchodní mapa vytvořená s ohledem na škálování se může snadno rozšířit z jednoho doručovacího týmu do strategického portfolia. Chybějící funkce konsolidují několik nástrojů do jednoho, což umožňuje cenově dostupné nasazení ve velkém, přehled o všech projektech a portfoliech a sladění cílů, aby bylo možné rychleji pracovat na kvalitě. Businessmap je přední platforma Kanbanu pro efektivní řízení a doručování projektů.
Toto je konektor Businessmap pro Power Automate. Funguje přímo s daty z Businessmap prostřednictvím našeho nejnovějšího rozhraní API v2. Konektor Businessmap můžete použít k vyjádření změn v externích nástrojích uvnitř karet Kanban nebo ke čtení dat z obchodní mapy a jejich použití v konektorech třetích stran. Navštivte část Integrace v naší znalostní bázi a získejte několik skutečných příkladů o tom, jak konektor používat.
Požadavky
- Abyste mohli tento konektor používat, potřebujete účet Businessmap a uživatele s oprávněními pro přístup k rozhraní API. Sign-Up tady a vytvořte účet a zkuste to.
Jak získat přihlašovací údaje
Klíč rozhraní API najdete v nabídce "API" ve vašem profilu.
Začínáme s konektorem
Konektor má jeden trigger, který je obecný a zpracovává všechny události. Tuto aktivační událost nastavte jako první krok v toku, když chcete přijímat události z businessmap. Další akcí by měla být kontrola "Podmínka", kde přidáte filtr na "událost" a pokračujte pouze v případě, že typ události odpovídá typu události, který vás zajímá. Tady najdete seznam se všemi událostmi a možnými hodnotami, které aktivují trigger. Dalším krokem obvykle bude "Získat kartu podle ID", z karty se zobrazí všechny podrobnosti a v následujícím toku budete moct tato data používat a pracovat s ním.
Známé problémy a omezení
Určitá omezení se použijí, aby se zajistilo, že produkt a naše rozhraní API běží co nejefektivněji a co nejefektivněji. Přesné limity rozhraní API závisí na vašem plánu služeb. Další informace o tom si můžete přečíst tady.
Běžné chyby a nápravné prostředky
Pokud dojde k chybě 429, znamená to, že jste dosáhli limitů rozhraní API. Podrobnosti o chybě vám řeknou, jak dlouho budete muset počkat, než budete moct odeslat další požadavek. Všechny ostatní chyby obsahují zprávy, které vysvětlují přesný důvod chyby.
časté otázky
Máme rozsáhlou část Znalostní báze a pokud máte nějakou otázku, na kterou nemůžete najít odpověď, kontaktujte nás a rádi vám pomůžeme.
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Klíč rozhraní API | securestring | Klíč rozhraní API pro toto rozhraní API | Pravdivé |
| Subdomain | řetězec | Zadejte subdoménu vašeho účtu Businessmap. | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Aktualizace karty (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte aktualizovat kartu .
|
| Aktualizovat kartu |
Aktualizujte vlastnosti karty (Název, Popis, Priorita atd.). Pokud došlo k chybám vypršení časového limitu nebo limitu rozhraní API, zkuste rozdělit nastavení vlastních polí, nálepek a značek do samostatných akcí. |
| Archivní karta (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte archivní nebo nearchivovou kartu .
|
| Archivovat nebo zrušit archivaci karty |
Přidejte kartu do archivu nebo ji extrahujte z archivu. |
| Blokovat nebo odblokovat kartu (zastaralé) [ZASTARALÉ] |
(Zastaralé) Blokování, odblokování nebo úprava důvodů blokování karty |
| Bloková karta |
Zablokujte kartu. |
| Karty odkazů |
Propojení karty s existující kartou |
| Nahrát přílohu |
Nahrajte přílohu na kartu. |
| Nastavení hodnoty vlastního pole |
Nastavte hodnotu vlastního pole. |
| Nastavení nebo zrušení nastavení nálepek |
Přidání nálepek na kartu nebo odebrání přiřazených nálepek z karty |
| Nastavení nebo zrušení sady značek |
Přidání značek na kartu nebo odebrání přiřazených značek |
| Odblokovat kartu |
Odblokujte kartu. |
| Odstranit kartu (zastaralé) [ZASTARALÉ] |
(Zastaralé) Odstraňte kartu. |
| Přesunout kartu |
Přesunutí karty do nového sloupce, pruhu, pracovního postupu nebo panelu |
| Přesunout kartu (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Použijte prosím přesunout kartu .
|
| Přidat komentář |
Přidejte komentář na kartu nebo iniciativu. |
| Přidat komentář (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte přidat komentář .
|
| Stáhnout přílohu |
Stáhněte si přílohu z karty. Obsah souboru se vrátí jako řetězec kódovaný v base64. |
| Vytvoření dílčího dotazu (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte vytvořit dílčí úkol .
|
| Vytvoření karty (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte vytvořit kartu .
|
| Vytvořit dílčí úkol |
Vytvořte nový dílčí úkol karty nebo iniciativy. |
| Vytvořit kartu |
Vytvořte kartu na panelu podle svého výběru. K nastavení vlastních polí, nálepek a značek se používají v kombinaci s aktualizační kartou. |
| Zahodit nebo obnovit kartu |
Zahoďte kartu nebo obnovte dříve zahozenou kartu. |
| Zrušení propojení karet |
Odeberte propojení mezi dvěma kartami. |
| Získat všechny karty |
Získejte všechny karty z vybrané desky. Odpověď obsahuje až 200 karet. Pro více než 200 karet použijte stránkování. |
| Získání karty podle ID |
Získejte podrobnosti o kartě podle jeho interního ID. |
| Získání karty podle ID (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte Get Card by ID .
|
| Získání karty podle vlastního ID |
Najděte kartu podle ID vlastní karty. Pokud se najde více karet, vrátí se pouze první z nich. Pomocí parametru Board můžete filtrovat vyhledávání podle panelů. |
| Získání názvu objektu {Object} |
Získá název objektu na základě jeho ID. Pomocná funkce použitá v případě, že chcete získat název panelu, pracovního postupu, sloupce atd. na základě jeho ID |
| Získání panelů (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho prosím použijte Get Boards .
|
| Získání pracovních postupů (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte funkci Získat pracovní postupy .
|
| Získání pruhů (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho prosím použijte Get Lanes .
|
| Získání příloh karet |
Získejte seznam se všemi přílohami pro zadanou kartu. |
| Získání sloupců panelu (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte funkci Získat sloupce .
|
| Získání typů (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho prosím použijte Get Types . (Získat typy).
|
| Získání všech karet (zastaralé) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte možnost Získat všechny karty .
|
| Čas protokolu |
Zakažte čas na kartu. |
| Čas protokolu (počet sekund) (zastaralý) [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte čas protokolu .
|
Aktualizace karty (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte aktualizovat kartu .
(Zastaralé) Aktualizace vlastností karty (název, popis, priorita atd.)
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ obsahu
|
Content-Type | True | string |
Vždy nastaveno na: application/json |
|
Přijmout
|
Accept | True | string |
Vždy nastaveno na: application/json |
|
ID panelu
|
boardid | integer |
Výběr panelu z rozevíracího seznamu |
|
|
ID karty
|
taskid | integer |
ID karty |
|
|
Title
|
title | string |
title |
|
|
Description
|
description | string |
podrobnosti o kartě |
|
|
Priority
|
priority | string | ||
|
Pověřený
|
assignee | string |
uživatelské jméno přiřazeného uživatele |
|
|
Barva
|
color | string |
šestnáctkový barevný kód podobný tomuto #F37325 |
|
|
Velikost
|
size | integer |
size |
|
|
Štítky
|
tags | string |
Více značek by mělo být odděleno mezerou. |
|
|
Vlastní pole
|
cfields | string |
Seznam vlastních polí ve formátu JSON a jejich hodnoty {"field1":"value1","field2":"value2"} |
|
|
Deadline
|
deadline | string |
datum konečného termínu v tomto formátu RRRR-MM-DD |
|
|
Externí odkaz
|
extlink | string |
externí odkaz |
|
|
Typ
|
type | string |
název typu, který chcete nastavit |
Aktualizovat kartu
Aktualizujte vlastnosti karty (Název, Popis, Priorita atd.). Pokud došlo k chybám vypršení časového limitu nebo limitu rozhraní API, zkuste rozdělit nastavení vlastních polí, nálepek a značek do samostatných akcí.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
Workflow
|
workflow_id | integer |
Pracovní postup musí být vybraný z rozevíracího seznamu. |
|
|
Template
|
template_id | integer |
Vybrat šablonu |
|
|
Sloupec
|
column_id |
Výběr sloupce nebo zadání názvu nebo ID sloupce jako vlastní hodnoty |
||
|
Dráha
|
lane_id |
Výběr pruhu nebo zadání názvu nebo ID pruhu jako vlastní hodnoty |
||
|
Title
|
title | string |
Název karty |
|
|
Description
|
description | string |
Popis karty |
|
|
Vlastní ID
|
custom_id | string |
Vlastní ID |
|
|
Vlastník
|
owner_user_id | integer |
Vybrat vlastníka karty |
|
|
Typ
|
type_id | integer |
Vybrat typ karty |
|
|
Velikost karty
|
size | double |
Velikost karty |
|
|
Priority
|
priority | integer |
Vybrat prioritu |
|
|
Barva
|
color | string |
Barva (šestnáctkový, např. #000000) |
|
|
Deadline
|
deadline | string |
Konečný termín (formát: RRRR-MM-DD) |
|
|
Plánované počáteční datum
|
planned_start_date | string |
Plánované datum zahájení (formát: RRRR-MM-DD) (pouze iniciativy) |
|
|
Plánované koncové datum
|
planned_end_date | string |
Plánované koncové datum (formát: RRRR-MM-DD) (pouze iniciativy) |
|
|
Skutečný čas zahájení
|
actual_start_time | string |
Skutečný čas zahájení (formát: RRRR-MM-DDTHH:mm:ssZ) (pouze iniciativy) |
|
|
Skutečný koncový čas
|
actual_end_time | string |
Skutečný čas ukončení (formát: RRRR-MM-DDTHH:mm:ssZ) (pouze iniciativy) |
|
|
Nálepky
|
stickers | string |
Vyberte nálepky nebo je přidejte jako text oddělený čárkou. |
|
|
Štítky
|
tags | string |
Vyberte značky nebo je přidejte jako text oddělený čárkou. |
|
|
Název
|
field_id | integer |
Vybrat vlastní pole |
|
|
Hodnota
|
value | string |
Vlastní hodnota pole |
Návraty
- Body
- getCardResponse
Archivní karta (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte archivní nebo nearchivovou kartu .
(Zastaralé) Přesunutí karty do archivu Karta nesmí být blokovaná a musí být ve sloupci Hotovo nebo ve sloupci Archiv.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
cardid | True | string |
ID karty |
|
Version
|
version | string |
verze |
Archivovat nebo zrušit archivaci karty
Přidejte kartu do archivu nebo ji extrahujte z archivu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Činnost
|
is_archived | True | integer |
Vybrat akci |
Blokovat nebo odblokovat kartu (zastaralé) [ZASTARALÉ]
(Zastaralé) Blokování, odblokování nebo úprava důvodů blokování karty
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
boardid | True | string |
Výběr panelu z rozevíracího seznamu |
|
ID karty
|
taskid | True | string |
ID karty |
|
Typ události
|
event | True | string | |
|
Důvod blokování
|
blockreason | string |
důvod blokování |
Bloková karta
Zablokujte kartu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Důvod blokování
|
reason_id | True | string |
Vybrat důvod blokování |
|
Comment
|
comment | string |
Přidání komentáře k důvodu blokování |
Karty odkazů
Propojení karty s existující kartou
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Bude propojen jako
|
link_type | True | string |
Vybrat typ odkazu |
|
ID karty na kartu
|
linked_card_id | True | integer |
ID karty pro propojení s aktuální kartou |
Nahrát přílohu
Nahrajte přílohu na kartu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Název souboru
|
file_name | True | string |
Zadejte název souboru. |
|
Content
|
content | True | binary |
Poskytnutí obsahu souboru (base64) |
Návraty
Nastavení hodnoty vlastního pole
Nastavte hodnotu vlastního pole.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
ID panelu
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
Název pole
|
field_id | True | integer |
Vybrat vlastní pole |
|
Hodnota
|
values | True | string |
Vyberte z rozevíracího seznamu nebo zadejte vlastní hodnoty oddělené čárkou. |
Nastavení nebo zrušení nastavení nálepek
Přidání nálepek na kartu nebo odebrání přiřazených nálepek z karty
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
Činnost
|
action | True | string |
Volba nastavení nebo zrušení nastavení nálepek |
|
Nálepky
|
stickers | True | string |
Vyberte jednu nálepku z rozevíracího seznamu nebo zadejte více nálepek oddělených čárkou. |
|
Pokud nálepka chybí
|
missing_stickers | integer |
Vyberte požadované chování, když chybí nálepka. |
Nastavení nebo zrušení sady značek
Přidání značek na kartu nebo odebrání přiřazených značek
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
Činnost
|
action | True | string |
Volba nastavení nebo zrušení nastavení značek |
|
Štítky
|
tags | True | string |
V rozevíracím seznamu vyberte jednu značku nebo zadejte více značek oddělených čárkou. |
|
Pokud chybí značka
|
missing_tags | integer |
Výběr požadovaného chování, když chybí značka |
Odblokovat kartu
Odblokujte kartu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
Odstranit kartu (zastaralé) [ZASTARALÉ]
(Zastaralé) Odstraňte kartu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
boardid | True | string |
Výběr panelu z rozevíracího seznamu |
|
ID karty
|
taskid | True | string |
ID karty |
Přesunout kartu
Přesunutí karty do nového sloupce, pruhu, pracovního postupu nebo panelu
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
Workflow
|
workflow_id | True | integer |
Pracovní postup musí být vybraný z rozevíracího seznamu. |
|
Sloupec
|
column_id | True |
Výběr sloupce nebo zadání názvu nebo ID sloupce jako vlastní hodnoty |
|
|
Dráha
|
lane_id | True |
Výběr pruhu nebo zadání názvu nebo ID pruhu jako vlastní hodnoty |
Přesunout kartu (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Použijte prosím přesunout kartu .
(Zastaralé) Pokud je to možné, přesuňte kartu (úkol nebo iniciativu) do sloupce.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ obsahu
|
Content-Type | True | string |
Vždy používat: application/json |
|
Typ obsahu
|
Accept | True | string |
Vždy používat: application/json |
|
ID karty
|
taskid | string |
ID karty |
|
|
ID panelu
|
boardid | True | string |
ID panelu |
|
Sloupec
|
column | string |
název sloupce |
|
|
Dráha
|
lane | string |
název pruhu |
|
|
Position
|
position | string |
umístění karty ve sloupci |
|
|
Překročení důvodu
|
exceedingreason | string |
překročení důvodu |
Přidat komentář
Přidejte komentář na kartu nebo iniciativu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Comment
|
text | True | string |
Comment |
Přidat komentář (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte přidat komentář .
(Zastaralé) Přidá do karty nebo iniciativy komentář.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ obsahu
|
Content-Type | True | string |
Vždy používat: application/json |
|
Typ obsahu
|
Accept | True | string |
Vždy používat: application/json |
|
ID karty
|
taskid | string |
ID karty |
|
|
Comment
|
comment | string |
komentář |
Stáhnout přílohu
Stáhněte si přílohu z karty. Obsah souboru se vrátí jako řetězec kódovaný v base64.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Název souboru
|
attachment_id | True | integer |
Vyberte Přílohu nebo zadejte ID přílohy ze seznamu Získat přílohy karet. |
Návraty
Vytvoření dílčího dotazu (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte vytvořit dílčí úkol .
(Zastaralé) Vytvoří nový dílčí úkol karty nebo iniciativy.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ obsahu
|
Content-Type | True | string |
Vždy používat: application/json |
|
Typ obsahu
|
Accept | True | string |
Vždy používat: application/json |
|
ID nadřazené karty
|
taskparent | integer |
ID nadřazené karty |
|
|
Title
|
title | string |
title |
|
|
Pověřený
|
assignee | string |
uživatelské jméno přiřazeného uživatele |
Vytvoření karty (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte vytvořit kartu .
(Zastaralé) Vytvořte kartu na panelu podle svého výběru.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ obsahu
|
Content-Type | string |
Vždy používat: application/json |
|
|
Typ obsahu
|
Accept | string |
Vždy používat: application/json |
|
|
ID panelu
|
boardid | True | string |
Výběr panelu |
|
Title
|
title | string |
title |
|
|
Description
|
description | string |
podrobnosti o kartě |
|
|
Priority
|
priority | string |
možné hodnoty: Nízká, Průměr, Vysoká, Kritická |
|
|
Pověřený
|
assignee | string |
uživatelské jméno přiřazeného uživatele |
|
|
Barva
|
color | string |
šestnáctkový barevný kód podobný tomuto #F37325 |
|
|
Velikost
|
size | string |
size |
|
|
Štítky
|
tags | string |
Více značek by mělo být odděleno mezerou. |
|
|
Vlastní pole
|
cfields | string |
Seznam vlastních polí ve formátu JSON a jejich hodnoty {"field1":"value1","field2":"value2"} |
|
|
Deadline
|
deadline | string |
datum konečného termínu v tomto formátu RRRR-MM-DD |
|
|
Externí odkaz
|
extlink | string |
externí odkaz |
|
|
Typ
|
type | string |
název typu, který chcete nastavit |
|
|
Šablona karty
|
template | string |
název šablony karty, kterou chcete použít |
|
|
Název sloupce
|
column | string |
přesný název sloupce |
|
|
Dráha
|
lane | string |
název pruhu |
|
|
Position
|
position | string |
umístění karty ve sloupci |
|
|
Překročení důvodu
|
exceedingreason | string |
překročení důvodu |
Vytvořit dílčí úkol
Vytvořte nový dílčí úkol karty nebo iniciativy.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Description
|
description | True | string |
Popis dílčího úkolu |
|
Vlastník
|
owner_user_id | string |
Výběr uživatele |
|
|
Stav dílčího úkolu
|
is_finished | integer |
Select Subtask Status |
Vytvořit kartu
Vytvořte kartu na panelu podle svého výběru. K nastavení vlastních polí, nálepek a značek se používají v kombinaci s aktualizační kartou.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
Workflow
|
workflow_id | True | integer |
Pracovní postup musí být vybraný z rozevíracího seznamu. |
|
Template
|
template_id | integer |
Vybrat šablonu |
|
|
Sloupec
|
column_id | True |
Výběr sloupce nebo zadání názvu nebo ID sloupce jako vlastní hodnoty |
|
|
Dráha
|
lane_id | True |
Výběr pruhu nebo zadání názvu nebo ID pruhu jako vlastní hodnoty |
|
|
Title
|
title | True | string |
Název karty |
|
Description
|
description | string |
Popis karty |
|
|
Vlastní ID
|
custom_id | string |
ID vlastní karty |
|
|
Vlastník
|
owner_user_id | integer |
Vybrat vlastníka karty |
|
|
Uživatel reportéru
|
reporter_user_id | integer |
Výběr reportéru z uživatelů obchodní mapy |
|
|
E-mail zpravodaje
|
reporter_email | string |
Zadejte e-mailovou adresu Reporteru, pouze pokud není vybraný žádný uživatel výše. |
|
|
Typ
|
type_id | integer |
Vybrat typ karty |
|
|
Velikost karty
|
size | double |
Velikost karty |
|
|
Priority
|
priority | integer |
Vybrat prioritu |
|
|
Barva
|
color | string |
Barva (šestnáctkový, např. #000000) |
|
|
Deadline
|
deadline | string |
Konečný termín (formát: RRRR-MM-DD) |
|
|
Plánované počáteční datum
|
planned_start_date | string |
Plánované datum zahájení (formát: RRRR-MM-DD) (pouze iniciativy) |
|
|
Plánované koncové datum
|
planned_end_date | string |
Plánované koncové datum (formát: RRRR-MM-DD) (pouze iniciativy) |
|
|
Skutečný čas zahájení
|
actual_start_time | string |
Skutečný čas zahájení (formát: RRRR-MM-DDTHH:mm:ssZ) (pouze iniciativy) |
|
|
Skutečný koncový čas
|
actual_end_time | string |
Skutečný čas ukončení (formát: RRRR-MM-DDTHH:mm:ssZ) (pouze iniciativy) |
Návraty
- Body
- getCardResponse
Zahodit nebo obnovit kartu
Zahoďte kartu nebo obnovte dříve zahozenou kartu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Činnost
|
is_discarded | True | integer |
Vybrat akci |
Zrušení propojení karet
Odeberte propojení mezi dvěma kartami.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Zrušení propojení s ID karty
|
card_id | True | integer |
Zadejte ID karty. |
|
Propojeno jako
|
link_type | True | string |
Vybrat typ odkazu |
|
Do ID karty
|
linked_card_id | True | integer |
Zadejte ID propojené karty. |
Získat všechny karty
Získejte všechny karty z vybrané desky. Odpověď obsahuje až 200 karet. Pro více než 200 karet použijte stránkování.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Board
|
board_ids | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
ID vlastních karet
|
custom_ids | array |
Zadejte vlastní ID. |
|
|
Stránka
|
page | integer |
Číslo stránky |
|
|
Stát
|
state | string |
Hodnota stavu karet, které chcete získat. Ve výchozím nastavení se jedná o aktivní stav. |
Návraty
- Body
- getAllCardsResponse
Získání karty podle ID
Získejte podrobnosti o kartě podle jeho interního ID.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
Návraty
- Body
- getCardResponse
Získání karty podle ID (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte Get Card by ID .
(Zastaralé) Získání karty podle ID
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
boardid | True | string |
Výběr panelu z rozevíracího seznamu |
|
ID karty
|
taskid | True | string |
ID karty |
|
Získat historii
|
history | string |
pokud chcete získat historii karet, nastavte na ano. |
|
|
Získání komentářů
|
comments | string |
pokud chcete získat komentáře ke kartám, nastavte na ano. |
|
|
Formát textu
|
textformat | string |
textový formát vrácený pro popis karty |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
taskid
|
taskid | string |
taskid |
|
boardid
|
boardid | string |
boardid |
|
title
|
title | string |
title |
|
popis
|
description | string |
popis |
|
typ
|
type | string |
typ |
|
pověřená osoba
|
assignee | string |
pověřená osoba |
|
Dílčí úkoly
|
subtasks | string |
Dílčí úkoly |
|
dílčí úkoly
|
subtaskscomplete | string |
dílčí úkoly |
|
color
|
color | string |
color |
|
priority
|
priority | string |
priority |
|
size
|
size | string |
size |
|
konečný termín
|
deadline | string |
konečný termín |
|
konečný formát
|
deadlineoriginalformat | string |
konečný formát |
|
extlink
|
extlink | string |
extlink |
|
tags
|
tags | string |
tags |
|
předstih
|
leadtime | integer |
předstih |
|
blokovaný
|
blocked | string |
blokovaný |
|
blockedreason
|
blockedreason | string |
blockedreason |
|
columnname
|
columnname | string |
columnname |
|
lanename
|
lanename | string |
lanename |
|
subtaskdetails
|
subtaskdetails | array of |
subtaskdetails |
|
columnid
|
columnid | string |
columnid |
|
laneid
|
laneid | string |
laneid |
|
postavení
|
position | string |
postavení |
|
pracovní postup
|
workflow | integer |
pracovní postup |
|
workflow_id
|
workflow_id | integer |
workflow_id |
|
adresa URL
|
attachments.FXPR1VE0LIC9.url | string |
adresa URL |
|
clientName
|
attachments.FXPR1VE0LIC9.clientName | string |
clientName |
|
jedinečné_jméno
|
attachments.FXPR1VE0LIC9.uniqueName | string |
jedinečné_jméno |
|
velikost souboru
|
attachments.FXPR1VE0LIC9.fileSize | float |
velikost souboru |
|
fileType
|
attachments.FXPR1VE0LIC9.fileType | string |
fileType |
|
stav
|
attachments.FXPR1VE0LIC9.status | string |
stav |
|
adresa URL
|
attachments.0XC7C1PRR9ZK.url | string |
adresa URL |
|
clientName
|
attachments.0XC7C1PRR9ZK.clientName | string |
clientName |
|
jedinečné_jméno
|
attachments.0XC7C1PRR9ZK.uniqueName | string |
jedinečné_jméno |
|
velikost souboru
|
attachments.0XC7C1PRR9ZK.fileSize | float |
velikost souboru |
|
fileType
|
attachments.0XC7C1PRR9ZK.fileType | string |
fileType |
|
stav
|
attachments.0XC7C1PRR9ZK.status | string |
stav |
|
columnpath
|
columnpath | string |
columnpath |
|
reportér
|
reporter | string |
reportér |
|
vlastní pole
|
customfields | array of object |
vlastní pole |
|
fieldid
|
customfields.fieldid | integer |
fieldid |
|
název
|
customfields.name | string |
název |
|
typ
|
customfields.type | string |
typ |
|
value
|
customfields.value | string |
value |
|
povinný
|
customfields.mandatory | boolean |
povinný |
|
neměnný
|
customfields.immutable | boolean |
neměnný |
|
updatedat
|
updatedat | string |
updatedat |
|
loggedtime
|
loggedtime | integer |
loggedtime |
|
popisy historie
|
historydetails | array of object |
popisy historie |
|
eventtype
|
historydetails.eventtype | string |
eventtype |
|
historie
|
historydetails.historyevent | string |
historie |
|
taskid
|
historydetails.taskid | string |
taskid |
|
Podrobnosti
|
historydetails.details | string |
Podrobnosti |
|
autor
|
historydetails.author | string |
autor |
|
entrydate
|
historydetails.entrydate | string |
entrydate |
|
historyid
|
historydetails.historyid | string |
historyid |
|
comments
|
comments | array of |
comments |
Získání karty podle vlastního ID
Najděte kartu podle ID vlastní karty. Pokud se najde více karet, vrátí se pouze první z nich. Pomocí parametru Board můžete filtrovat vyhledávání podle panelů.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID vlastní karty
|
custom_ids | True | string |
Zadejte vlastní ID. |
|
Board
|
board_ids | integer |
Panel musí být vybraný z rozevíracího seznamu. |
Návraty
- Body
- getCardResponse
Získání názvu objektu {Object}
Získá název objektu na základě jeho ID. Pomocná funkce použitá v případě, že chcete získat název panelu, pracovního postupu, sloupce atd. na základě jeho ID
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Board
|
board_id | True | integer |
Panel musí být vybraný z rozevíracího seznamu. |
|
Položka
|
item | True | string |
Vybrat typ objektu |
|
ID
|
id | True | integer |
Zadejte ID objektu. |
Návraty
Získání panelů (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho prosím použijte Get Boards .
(Zastaralé) Získejte všechny panely z účtu.
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
board_id
|
data.board_id | integer |
board_id |
|
workspace_id
|
data.workspace_id | integer |
workspace_id |
|
is_archived
|
data.is_archived | integer |
is_archived |
|
název
|
data.name | string |
název |
Získání pracovních postupů (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte funkci Získat pracovní postupy .
(Zastaralé) Získejte všechny pracovní postupy z dané desky.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
board_id | True | string |
Board |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
typ
|
data.type | integer |
typ |
|
postavení
|
data.position | integer |
postavení |
|
is_enabled
|
data.is_enabled | integer |
is_enabled |
|
is_collapsible
|
data.is_collapsible | integer |
is_collapsible |
|
název
|
data.name | string |
název |
|
workflow_id
|
data.workflow_id | integer |
workflow_id |
Získání pruhů (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho prosím použijte Get Lanes .
(Zastaralé) Získá všechny pruhy pro zadanou desku.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
board_id | True | string |
Na palubu se dostanete na pruhy. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
lane_id
|
data.lane_id | integer |
lane_id |
|
pracovní postup
|
data.workflow | integer |
pracovní postup |
|
parent_lane_id
|
data.parent_lane_id | integer |
parent_lane_id |
|
postavení
|
data.position | integer |
postavení |
|
název
|
data.name | string |
název |
|
popis
|
data.description | string |
popis |
|
color
|
data.color | string |
color |
Získání příloh karet
Získejte seznam se všemi přílohami pro zadanou kartu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | integer |
Zadejte ID karty. |
Návraty
Získání sloupců panelu (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte funkci Získat sloupce .
(Zastaralé) Získejte všechny sloupce pro zadanou desku.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
board_id | True | string |
Panel pro získání sloupců. |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
column_id
|
data.column_id | integer |
column_id |
|
pracovní postup
|
data.workflow | integer |
pracovní postup |
|
section
|
data.section | integer |
section |
|
parent_column_id
|
data.parent_column_id | integer |
parent_column_id |
|
postavení
|
data.position | integer |
postavení |
|
název
|
data.name | string |
název |
|
popis
|
data.description | string |
popis |
|
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 |
Získání typů (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho prosím použijte Get Types . (Získat typy).
(Zastaralé) Získá všechny typy v rámci účtu.
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
type_id
|
data.type_id | integer |
type_id |
|
icon_type
|
data.icon_type | integer |
icon_type |
|
icon_id
|
data.icon_id | integer |
icon_id |
|
název
|
data.name | string |
název |
|
popis
|
data.description | string |
popis |
|
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 |
|
dostupnost
|
data.availability | integer |
dostupnost |
|
is_enabled
|
data.is_enabled | integer |
is_enabled |
Získání všech karet (zastaralé) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte možnost Získat všechny karty .
(Zastaralé) Získejte všechny karty z dané desky.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
boardid | True | string |
Výběr panelu z rozevíracího seznamu |
Čas protokolu
Zakažte čas na kartu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID karty
|
card_id | True | string |
ID interní karty |
|
Časová jednotka
|
time_unit | True | string |
Časová jednotka |
|
Doba trvání
|
time | True | integer |
Doba trvání |
|
Comment
|
comment | string |
Comment |
Čas protokolu (počet sekund) (zastaralý) [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte čas protokolu .
(Zastaralé) Zakažte čas na kartu. Čas se zaprotokoluje v sekundách.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Typ obsahu
|
Content-Type | True | string |
Vždy používat: application/json |
|
Typ obsahu
|
Accept | True | string |
Vždy používat: application/json |
|
ID karty
|
card_id | string |
ID interní karty |
|
|
Time
|
time | string |
Čas v sekundách |
|
|
Comment
|
comment | string |
Comment |
Aktivační události
| Obecná aktivační událost |
Aktivuje se pro jakoukoli akci na panelu. Ke správě toku pro různé triggery použijte řízení, podmínku nebo řízení nebo přepínač. Tady je částečný seznam podporovaných typů událostí: "Karta vytvořená", "Karta přesunuta", "Podrobnosti o kartě změněné", "Karta odstraněna", "Karta blokována" \n\n Další krok po triggeru by měl být "Získat kartu podle ID", takže můžete vzít všechny podrobnosti o kartě \n\nPoužít control/Condition u ID autora v obousměrných integracích, abyste zabránili smyčkám. |
Obecná aktivační událost
Aktivuje se pro jakoukoli akci na panelu. Ke správě toku pro různé triggery použijte řízení, podmínku nebo řízení nebo přepínač. Tady je částečný seznam podporovaných typů událostí: "Karta vytvořená", "Karta přesunuta", "Podrobnosti o kartě změněné", "Karta odstraněna", "Karta blokována" \n\n Další krok po triggeru by měl být "Získat kartu podle ID", takže můžete vzít všechny podrobnosti o kartě \n\nPoužít control/Condition u ID autora v obousměrných integracích, abyste zabránili smyčkám.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID panelu
|
board_id | True | string |
Výběr panelu |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
společnost
|
company | string |
společnost |
|
událost
|
event | string |
událost |
|
user_id
|
user_id | integer |
user_id |
|
board_id
|
board_id | integer |
board_id |
|
card_id
|
card_id | integer |
card_id |
Definice
downloadAttachmentResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Název souboru
|
data.file_name | string |
Název souboru přílohy |
|
Content
|
data.content | binary |
Obsah přílohy (base64) |
getAllCardsResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Všechny stránky
|
data.pagination.all_pages | integer |
Celkový počet stránek |
|
Aktuální stránka
|
data.pagination.current_page | integer |
Aktuální stránka |
|
Výsledky na stránku
|
data.pagination.results_per_page | integer |
Počet výsledků na stránku |
|
data
|
data.data | array of object | |
|
ID karty
|
data.data.card_id | integer |
ID interní karty |
|
ID vlastní karty
|
data.data.custom_id | string |
ID vlastní karty |
|
ID panelu
|
data.data.board_id | integer |
ID karty panelu |
|
ID pracovního postupu
|
data.data.workflow_id | integer |
ID pracovního postupu karty |
|
Název karty
|
data.data.title | string |
Název karty |
|
ID uživatele vlastníka
|
data.data.owner_user_id |
ID vlastníka karty |
|
|
ID typu
|
data.data.type_id |
ID typu karty |
|
|
Barva
|
data.data.color | string |
Barva karty |
|
Oddíl
|
data.data.section | integer |
ID oddílu karty |
|
ID sloupce
|
data.data.column_id | integer |
ID sloupce karty |
|
ID pruhu
|
data.data.lane_id | integer |
ID pruhu karty |
getCardAttachmentsResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
identifikační číslo
|
data.id | integer |
ID přílohy karty |
|
název_souboru
|
data.file_name | string |
Název souboru přílohy karty |
|
odkaz
|
data.link | string |
Odkaz na přílohu karty |
getCardResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID karty
|
data.card_id | integer |
ID interní karty |
|
ID vlastní karty
|
data.custom_id | string |
ID vlastní karty |
|
ID panelu
|
data.board_id | integer |
ID karty panelu |
|
ID pracovního postupu
|
data.workflow_id | integer |
ID pracovního postupu karty |
|
Název karty
|
data.title | string |
Název karty |
|
ID uživatele vlastníka
|
data.owner_user_id |
ID vlastníka karty |
|
|
ID typu
|
data.type_id |
ID typu karty |
|
|
Barva
|
data.color | string |
Barva karty |
|
Oddíl
|
data.section | integer |
ID oddílu karty |
|
ID sloupce
|
data.column_id | integer |
ID sloupce karty |
|
ID pruhu
|
data.lane_id | integer |
ID pruhu karty |
|
Position
|
data.position | integer |
Pozice karty |
|
Popis karty
|
data.description | string |
Popis karty |
|
Velikost karty
|
data.size |
Velikost karty |
|
|
Priority
|
data.priority | integer |
ID priority karty |
|
Deadline
|
data.deadline | string |
Konečný termín karty |
|
Typ
|
data.reporter.type | string |
Typ hodnoty. Může být interní nebo externí. |
|
Reportér
|
data.reporter.value |
Reportér karty |
|
|
Vytvořeno na adrese
|
data.created_at | string |
Časové razítko vytvoření karty |
|
Naposledy změněno
|
data.last_modified | string |
Časové razítko poslední změny karty |
|
Blokované
|
data.is_blocked | integer |
Logická hodnota, jestli je karta zablokovaná |
|
Vlastní pole
|
data.custom_fields | array of object |
Pole vlastních polí přiřazených k kartě |
|
ID pole
|
data.custom_fields.field_id | integer |
ID vlastního pole |
|
Název pole
|
data.custom_fields.name | string |
Název vlastního pole |
|
Hodnota pole
|
data.custom_fields.value |
Hodnota vlastního pole |
|
|
Zobrazovaná hodnota pole
|
data.custom_fields.display_value |
Zobrazení hodnoty vlastního pole |
|
|
values
|
data.custom_fields.values | array of object | |
|
ID hodnoty
|
data.custom_fields.values.value_id | integer |
ID hodnoty vlastního pole |
|
Hodnota pole
|
data.custom_fields.values.value |
Hodnota vlastního pole |
getObjectNameResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
název
|
data.name | string |
Název |
uploadAttachmentResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
data
|
data | array of object |
data |
|
ID karty
|
data.card_id | integer |
ID interní karty |
|
Název souboru
|
data.file_name | string |
Název souboru, který se má nahrát |