Freigeben über


Geschäftsübersicht

Businessmap ist die flexibelste Softwareplattform für ergebnisgesteuerte Unternehmensflexibilität. Die nicht übereinstimmende Funktionalität konsolidiert mehrere Tools in einem, wodurch eine kostengünstige Bereitstellung im Großen und Ganzen, die Sichtbarkeit aller Projekte/Portfolios und die Ausrichtung auf Ziele ermöglicht werden, um eine schnellere Qualität zu erzielen. Der Businessmap-Connector kann verwendet werden, um Änderungen an externen Tools (z. B. Problemverfolgungen, E-Mail, Zeitverfolgungstools usw.) in Ihren Kanban-Karten widerzuspiegeln.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Businessmap-Unterstützung
URL https://businessmap.io/customer-support
Email support@businessmap.io
Connectormetadaten
Herausgeber Geschäftsübersicht
Webseite https://businessmap.io
Datenschutzrichtlinie https://businessmap.io/privacy-policy
Kategorien Unternehmensführung; Business Intelligence

Businessmap ist die flexibelste Softwareplattform für ergebnisgesteuerte Unternehmensflexibilität. Sie hilft Vorgesetzten dabei, alle Projekte sichtbar zu machen, die Planung mit der Ausführung zu verbinden und führt zur kontinuierlichen Optimierung der Übermittlungsworkflows. Businessmap kann leicht von einem einzigen Lieferteam bis zu einem strategischen Portfolio erweitert werden. Die nicht übereinstimmende Funktionalität konsolidiert mehrere Tools in einem, wodurch eine kostengünstige Bereitstellung im Großen und Ganzen, die Sichtbarkeit aller Projekte/Portfolios und die Ausrichtung auf Ziele ermöglicht werden, um eine schnellere Qualität zu erzielen. Businessmap ist die führende Kanban-Plattform für effizientes Projektmanagement und -lieferung.

Dies ist Businessmap Connector für Power Automate. Es funktioniert direkt mit Daten aus Businessmap über unsere neueste API v2. Der Businessmap-Connector kann verwendet werden, um Änderungen an externen Tools in Ihren Kanban-Karten widerzuspiegeln oder Daten aus Businessmap zu lesen und in Connectors von Drittanbietern zu verwenden. Besuchen Sie den Abschnitt "Integrationen" in unserer Wissensdatenbank , um einige echte Beispiele zur Verwendung des Connectors zu erhalten.

Voraussetzungen

  • Um diesen Connector zu verwenden, benötigen Sie ein Businessmap-Konto und einen Benutzer mit Berechtigungen für den Zugriff auf die API. Sign-Up hier und erstellen und kontoieren, um es zu testen.

So erhalten Sie Anmeldeinformationen

Sie finden Ihren API-Schlüssel im Menü "API" in Ihrem Profil.

Erste Schritte mit Ihrem Connector

Der Connector hat einen Trigger, der allgemein ist und alle Ereignisse behandelt. Legen Sie diesen Trigger als ersten Schritt in Ihrem Fluss fest, wenn Sie Ereignisse von Businessmap empfangen möchten. Die nächste Aktion sollte eine "Bedingung"-Prüfung sein, bei der Sie einen Filter zu "Event" hinzufügen und nur fortfahren, wenn der Ereignistyp mit dem ereignistyp übereinstimmt, an dem Sie interessiert sind. Hier finden Sie eine Liste mit allen Ereignissen und möglichen Werten, die den Trigger auslösen. Der nächste Schritt lautet in der Regel "Karte nach ID abrufen", es werden alle Details von der Karte abgerufen, und Sie können diese Daten im folgenden Fluss verwenden und verwenden.

Bekannte Probleme und Einschränkungen

Bestimmte Grenzwerte werden angewendet, um sicherzustellen, dass das Produkt und unsere APIs so reibungslos und effizient wie möglich ausgeführt werden. Die genauen API-Grenzwerte sind von Ihrem Serviceplan abhängig. Weitere Informationen dazu finden Sie hier

Häufige Fehler und Abhilfemaßnahmen

Wenn ein 429-Fehler auftritt, bedeutet dies, dass Sie Ihre API-Grenzwerte erreicht haben. Die Fehlerdetails informieren Sie, wie lange Sie warten müssen, bevor Sie Ihre nächste Anforderung senden können. Alle anderen Fehler enthalten Meldungen, die den genauen Grund für den Fehler erklären.

Häufig gestellte Fragen

Wir haben einen umfangreichen Knowledge Base-Abschnitt , und wenn Sie Fragen haben, können Sie die Antwort nicht finden, kontaktieren Sie uns , und wir helfen Ihnen gerne.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
API-Schlüssel securestring Der API-Schlüssel für diese API Richtig
Subdomain Schnur Angeben der Unterdomäne Ihres Businessmap-Kontos Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Alle Karten abrufen

Rufen Sie alle Karten von einer ausgewählten Tafel ab. Die Antwort enthält bis zu 200 Karten. Für mehr als 200 Karten verwenden Sie die Seitenverwaltung.

Alle Karten abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Alle Karten abrufen ".

(Veraltet) Rufen Sie alle Karten von einer bestimmten Tafel ab.

Anlage herunterladen

Laden Sie eine Anlage von einer Karte herunter. Dateiinhalte werden als base64-codierte Zeichenfolge zurückgegeben.

Anlage hochladen

Laden Sie eine Anlage auf eine Karte hoch.

Archivieren oder Aufheben der Archivierungskarte

Fügen Sie eine Karte zum Archivieren hinzu, oder extrahieren Sie sie aus dem Archiv.

Archivkarte (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Archiv- oder Archivierungskarte .

(Veraltet) Verschieben der Karte in das Archiv. Die Karte darf nicht blockiert werden und muss sich in Spalte "Fertig" oder "Spaltenarchiv" befinden.

Block- oder Entsperrungskarte (veraltet) [VERALTET]

(Veraltet) Blockieren, Aufheben der Blockierung oder Bearbeitung von Blockgründen für eine Karte.

Blockierung der Karte aufheben

Heben Sie die Blockierung einer Karte auf.

Blockkarte

Blockieren einer Karte.

Boards abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get Boards .

(Veraltet) Rufen Sie alle Boards aus dem Konto ab.

Festlegen eines benutzerdefinierten Feldwerts

Legen Sie den Wert eines benutzerdefinierten Felds fest.

Festlegen oder Aufheben der Aufkleber

Hinzufügen von Aufklebern zu einer Karte oder Entfernen zugewiesener Aufkleber von einer Karte

Festlegen oder Aufheben der Markierung

Hinzufügen von Tags zu einer Karte oder Entfernen zugewiesener Tags von einer Karte

Get Lanes (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get Lanes .

(Veraltet) Ruft alle Fahrspuren für eine angegebene Tafel ab.

Get Types (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get-Typen .

(Veraltet) Ruft alle Typen innerhalb des Kontos ab.

Karte aktualisieren

Aktualisieren Sie die Eigenschaften einer Karte (Titel, Beschreibung, Priorität usw.). Wenn ein Timeout oder ein API-Grenzwert erreicht wurde, versuchen Sie, die Einstellung von benutzerdefinierten Feldern, Aufklebern und Tags in separate Aktionen aufzubrechen.

Karte aktualisieren (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Karte aktualisieren" .

(Veraltet) Aktualisieren der Eigenschaften einer Karte (Titel, Beschreibung, Priorität usw.)

Karte erstellen

Erstellen Sie eine Karte in einem Board Ihrer Wahl. Zum Festlegen von benutzerdefinierten Feldern verwenden Aufkleber und Tags in Kombination mit "Karte aktualisieren".

Karte erstellen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Karte erstellen" .

(Veraltet) Erstellen Sie eine Karte in einem Board Ihrer Wahl.

Karte löschen (veraltet) [VERALTET]

(Veraltet) Löschen sie eine Karte.

Karte nach benutzerdefinierter ID abrufen

Karte nach benutzerdefinierter Karten-ID suchen. Wenn mehrere Karten gefunden werden, wird nur der erste zurückgegeben. Verwenden Sie den Parameter "Board", um die Suche nach Boards zu filtern.

Karte nach ID abrufen

Rufen Sie Kartendetails anhand ihrer internen ID ab.

Karte nach ID abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Karte nach ID abrufen".

(Veraltet) Karte anhand der ID abrufen

Karte verschieben

Verschieben einer Karte in eine neue Spalte, eine Spur, einen Workflow oder eine Tafel.

Karte verwerfen oder wiederherstellen

Verwerfen einer Karte oder Wiederherstellen einer zuvor verworfenen Karte.

Kartenanlagen abrufen

Dient zum Abrufen einer Liste mit allen Anlagen für eine angegebene Karte.

Kommentar hinzufügen

Fügen Sie einer Karte oder Initiative einen Kommentar hinzu.

Kommentar hinzufügen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Kommentar hinzufügen" .

(Veraltet) Fügt einer Karte oder Initiative einen Kommentar hinzu.

Linkkarten

Verknüpfen sie eine Karte mit einer vorhandenen Karte.

Move Card (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Move Card .

(Veraltet) Verschieben einer Karte (soweit möglich) in eine Spalte

Protokollzeit

Protokollierungszeit auf einer Karte.

Protokollzeit (Anzahl der Sekunden) (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Protokollzeit .

(Veraltet) Protokollierungszeit auf einer Karte. Die Uhrzeit wird in Sekunden protokolliert.

Tafelspalten abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Spalten abrufen ".

(Veraltet) Ruft alle Spalten für eine angegebene Tafel ab.

Teilvorgang erstellen

Erstellen Sie einen neuen Teilvorgang einer Karte oder Initiative.

Teilvorgang erstellen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen " Teilvorgang erstellen ".

(Veraltet) Erstellt einen neuen Teilvorgang einer Karte oder Initiative.

Verknüpfung von Karten aufheben

Entfernen sie eine Verknüpfung zwischen zwei Karten.

Workflows abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Workflows abrufen ".

(Veraltet) Rufen Sie alle Workflows von einem bestimmten Board ab.

{Object}-Name abrufen

Rufen Sie den Namen eines Objekts basierend auf seiner ID ab. Hilfsfunktion, die verwendet wird, wenn Sie den Namen der Tafel, des Workflows, der Spalte usw. basierend auf ihrer ID abrufen möchten

Alle Karten abrufen

Rufen Sie alle Karten von einer ausgewählten Tafel ab. Die Antwort enthält bis zu 200 Karten. Für mehr als 200 Karten verwenden Sie die Seitenverwaltung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorstand
board_ids True integer

Board muss aus der Dropdownliste ausgewählt werden.

Benutzerdefinierte Karten-IDs
custom_ids array

Benutzerdefinierte IDs eingeben

Seite
page integer

Seitennummer

Staat
state string

Der Statuswert von Karten, die Sie abrufen möchten. Standardmäßig ist es der aktive Zustand.

Gibt zurück

Alle Karten abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Alle Karten abrufen ".

(Veraltet) Rufen Sie alle Karten von einer bestimmten Tafel ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
boardid True string

Tafel aus der Dropdownliste auswählen

Anlage herunterladen

Laden Sie eine Anlage von einer Karte herunter. Dateiinhalte werden als base64-codierte Zeichenfolge zurückgegeben.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Dateiname
attachment_id True integer

Wählen Sie "Anlage" aus, oder geben Sie "Anlage-ID" aus "Kartenanlagen abrufen" ein.

Gibt zurück

Anlage hochladen

Laden Sie eine Anlage auf eine Karte hoch.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Dateiname
file_name True string

Dateinamen eingeben

Content
content True binary

Bereitstellen von Dateiinhalten (base64)

Gibt zurück

Archivieren oder Aufheben der Archivierungskarte

Fügen Sie eine Karte zum Archivieren hinzu, oder extrahieren Sie sie aus dem Archiv.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Maßnahme
is_archived True integer

Aktion auswählen

Archivkarte (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Archiv- oder Archivierungskarte .

(Veraltet) Verschieben der Karte in das Archiv. Die Karte darf nicht blockiert werden und muss sich in Spalte "Fertig" oder "Spaltenarchiv" befinden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
cardid True string

Karten-ID

Version
version string

Ausgabe

Block- oder Entsperrungskarte (veraltet) [VERALTET]

(Veraltet) Blockieren, Aufheben der Blockierung oder Bearbeitung von Blockgründen für eine Karte.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
boardid True string

Tafel aus der Dropdownliste auswählen

Kartenkennung
taskid True string

Karten-ID

Ereignistyp
event True string
Blockgrund
blockreason string

Grund für Blockierung

Blockierung der Karte aufheben

Heben Sie die Blockierung einer Karte auf.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Blockkarte

Blockieren einer Karte.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Kartenkennung
card_id True integer

Karten-ID eingeben

Blockgrund
reason_id True string

Blockgrund auswählen

Kommentar
comment string

Kommentar zum Blockierungsgrund hinzufügen

Boards abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get Boards .

(Veraltet) Rufen Sie alle Boards aus dem Konto ab.

Gibt zurück

Name Pfad Typ Beschreibung
Daten
data array of object

Daten

board_id
data.board_id integer

board_id

workspace_id
data.workspace_id integer

workspace_id

is_archived
data.is_archived integer

is_archived

name
data.name string

name

Festlegen eines benutzerdefinierten Feldwerts

Legen Sie den Wert eines benutzerdefinierten Felds fest.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Board-ID
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Feldname
field_id True integer

Benutzerdefiniertes Feld auswählen

Wert
values True string

Wählen Sie aus der Dropdownliste aus, oder geben Sie benutzerdefinierte Werte ein, die durch ein Komma getrennt sind.

Festlegen oder Aufheben der Aufkleber

Hinzufügen von Aufklebern zu einer Karte oder Entfernen zugewiesener Aufkleber von einer Karte

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Maßnahme
action True string

Festlegen oder Aufheben der Aufkleber

Aufkleber
stickers True string

Wählen Sie einen einzelnen Aufkleber aus der Dropdownliste aus, oder geben Sie mehrere Aufkleber ein, die durch ein Komma getrennt sind.

Wenn Aufkleber fehlt
missing_stickers integer

Gewünschtes Verhalten auswählen, wenn ein Aufkleber fehlt

Festlegen oder Aufheben der Markierung

Hinzufügen von Tags zu einer Karte oder Entfernen zugewiesener Tags von einer Karte

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Maßnahme
action True string

Festlegen oder Aufheben der Markierung

Stichwörter
tags True string

Wählen Sie ein einzelnes Tag aus der Dropdownliste aus, oder geben Sie mehrere Tags ein, die durch ein Komma getrennt sind.

Wenn "Tag" fehlt
missing_tags integer

Gewünschtes Verhalten auswählen, wenn ein Tag fehlt

Get Lanes (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get Lanes .

(Veraltet) Ruft alle Fahrspuren für eine angegebene Tafel ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
board_id True string

Die Tafel, um die Fahrspuren zu bekommen.

Gibt zurück

Name Pfad Typ Beschreibung
Daten
data array of object

Daten

lane_id
data.lane_id integer

lane_id

Arbeitsablauf
data.workflow integer

Arbeitsablauf

parent_lane_id
data.parent_lane_id integer

parent_lane_id

Position
data.position integer

Position

name
data.name string

name

Beschreibung
data.description string

Beschreibung

color
data.color string

color

Get Types (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen Get-Typen .

(Veraltet) Ruft alle Typen innerhalb des Kontos ab.

Gibt zurück

Name Pfad Typ Beschreibung
Daten
data array of object

Daten

type_id
data.type_id integer

type_id

icon_type
data.icon_type integer

icon_type

icon_id
data.icon_id integer

icon_id

name
data.name string

name

Beschreibung
data.description string

Beschreibung

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

Karte aktualisieren

Aktualisieren Sie die Eigenschaften einer Karte (Titel, Beschreibung, Priorität usw.). Wenn ein Timeout oder ein API-Grenzwert erreicht wurde, versuchen Sie, die Einstellung von benutzerdefinierten Feldern, Aufklebern und Tags in separate Aktionen aufzubrechen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Arbeitsablauf
workflow_id integer

Workflow muss aus der Dropdownliste ausgewählt werden.

Template
template_id integer

Vorlage auswählen

Kolumne
column_id

Spaltennamen oder ID als benutzerdefinierter Wert auswählen oder Spaltenname oder ID eingeben

Gasse
lane_id

Wählen Sie "Lane" oder "Lane Name" oder "ID" als benutzerdefinierter Wert aus.

Title
title string

Kartentitel

Description
description string

Kartenbeschreibung

Benutzerdefinierte ID
custom_id string

Benutzerdefinierte ID

Besitzer
owner_user_id integer

Kartenbesitzer auswählen

Typ
type_id integer

Kartentyp auswählen

Kartengröße
size double

Kartengröße

Priority
priority integer

Priorität auswählen

Farbe
color string

Farbe (Hex, z. B. #000000)

Deadline
deadline string

Stichtag (Format: JJJJ-MM-DD)

Geplanter Anfangstermin
planned_start_date string

Geplanter Anfangstermin (Format: JJJJ-MM-DD) (nur Initiativen)

Geplanter Endtermin
planned_end_date string

Geplantes Enddatum (Format: JJJJ-MM-DD) (nur Initiativen)

Aktuelle Startzeit
actual_start_time string

Ist-Startzeit (Format: JJJJ-MM-DDTHH:mm:ssZ) (Nur Initiativen)

Aktuelle Endzeit
actual_end_time string

Tatsächliche Endzeit (Format: JJJJ-MM-DDTHH:mm:ssZ) (nur Initiativen)

Aufkleber
stickers string

Wählen Sie Aufkleber aus, oder fügen Sie sie als Text hinzu, der durch Komma getrennt ist.

Stichwörter
tags string

Markieren von Tags oder Hinzufügen als Text, der durch Kommas getrennt ist

Name
field_id integer

Benutzerdefiniertes Feld auswählen

Wert
value string

Wert des benutzerdefinierten Felds

Gibt zurück

Karte aktualisieren (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Karte aktualisieren" .

(Veraltet) Aktualisieren der Eigenschaften einer Karte (Titel, Beschreibung, Priorität usw.)

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Inhaltstyp
Content-Type True string

Immer festgelegt auf: application/json

Akzeptieren
Accept True string

Immer festgelegt auf: application/json

Board-ID
boardid integer

Tafel aus der Dropdownliste auswählen

Kartenkennung
taskid integer

Karten-ID

Title
title string

title

Description
description string

Kartendetails

Priority
priority string
Zugewiesene Person
assignee string

Benutzername des Zugewiesenen

Farbe
color string

Hex-Farbcode wie dieser #F37325

Größe
size integer

size

Stichwörter
tags string

Mehrere Tags sollten durch Leerzeichen getrennt werden.

Benutzerdefinierte Felder
cfields string

JSON-formatierte Liste von benutzerdefinierten Feldern und deren Werte {"field1":"value1","field2":"value2"}

Deadline
deadline string

Stichtag im Format JJJJ-MM-DD

Externer Link
extlink string

Externer Link

Typ
type string

der Name des Typs, den Sie festlegen möchten

Karte erstellen

Erstellen Sie eine Karte in einem Board Ihrer Wahl. Zum Festlegen von benutzerdefinierten Feldern verwenden Aufkleber und Tags in Kombination mit "Karte aktualisieren".

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Arbeitsablauf
workflow_id True integer

Workflow muss aus der Dropdownliste ausgewählt werden.

Template
template_id integer

Vorlage auswählen

Kolumne
column_id True

Spaltennamen oder ID als benutzerdefinierter Wert auswählen oder Spaltenname oder ID eingeben

Gasse
lane_id True

Wählen Sie "Lane" oder "Lane Name" oder "ID" als benutzerdefinierter Wert aus.

Title
title True string

Kartentitel

Description
description string

Kartenbeschreibung

Benutzerdefinierte ID
custom_id string

Benutzerdefinierte Karten-ID

Besitzer
owner_user_id integer

Kartenbesitzer auswählen

Reporter User
reporter_user_id integer

Select reporter from Businessmap users

Reporter Email
reporter_email string

Geben Sie die E-Mail-Adresse des Reporters ein, nur wenn oben kein Benutzer ausgewählt ist.

Typ
type_id integer

Kartentyp auswählen

Kartengröße
size double

Kartengröße

Priority
priority integer

Priorität auswählen

Farbe
color string

Farbe (Hex, z. B. #000000)

Deadline
deadline string

Stichtag (Format: JJJJ-MM-DD)

Geplanter Anfangstermin
planned_start_date string

Geplanter Anfangstermin (Format: JJJJ-MM-DD) (nur Initiativen)

Geplanter Endtermin
planned_end_date string

Geplantes Enddatum (Format: JJJJ-MM-DD) (nur Initiativen)

Aktuelle Startzeit
actual_start_time string

Ist-Startzeit (Format: JJJJ-MM-DDTHH:mm:ssZ) (Nur Initiativen)

Aktuelle Endzeit
actual_end_time string

Tatsächliche Endzeit (Format: JJJJ-MM-DDTHH:mm:ssZ) (nur Initiativen)

Gibt zurück

Karte erstellen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Karte erstellen" .

(Veraltet) Erstellen Sie eine Karte in einem Board Ihrer Wahl.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Inhaltstyp
Content-Type string

Immer verwenden: application/json

Inhaltstyp
Accept string

Immer verwenden: application/json

Board-ID
boardid True string

Board auswählen

Title
title string

title

Description
description string

Kartendetails

Priority
priority string

mögliche Werte: Niedrig, Mittelwert, Hoch, Kritisch

Zugewiesene Person
assignee string

Benutzername des Zugewiesenen

Farbe
color string

Hex-Farbcode wie dieser #F37325

Größe
size string

size

Stichwörter
tags string

Mehrere Tags sollten durch Leerzeichen getrennt werden.

Benutzerdefinierte Felder
cfields string

JSON-formatierte Liste von benutzerdefinierten Feldern und deren Werte {"field1":"value1","field2":"value2"}

Deadline
deadline string

Stichtag im Format JJJJ-MM-DD

Externer Link
extlink string

Externer Link

Typ
type string

der Name des Typs, den Sie festlegen möchten

Kartenvorlage
template string

der Name der Kartenvorlage, die Sie anwenden möchten

Spaltenname
column string

Exakter Spaltenname

Gasse
lane string

Spurname

Position
position string

Kartenposition in der Spalte

Überschreitung des Grunds
exceedingreason string

Überschreitung des Grunds

Karte löschen (veraltet) [VERALTET]

(Veraltet) Löschen sie eine Karte.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
boardid True string

Tafel aus der Dropdownliste auswählen

Kartenkennung
taskid True string

Karten-ID

Karte nach benutzerdefinierter ID abrufen

Karte nach benutzerdefinierter Karten-ID suchen. Wenn mehrere Karten gefunden werden, wird nur der erste zurückgegeben. Verwenden Sie den Parameter "Board", um die Suche nach Boards zu filtern.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzerdefinierte Karten-ID
custom_ids True string

Benutzerdefinierte IDs eingeben

Vorstand
board_ids integer

Board muss aus der Dropdownliste ausgewählt werden.

Gibt zurück

Karte nach ID abrufen

Rufen Sie Kartendetails anhand ihrer internen ID ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Gibt zurück

Karte nach ID abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Karte nach ID abrufen".

(Veraltet) Karte anhand der ID abrufen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
boardid True string

Tafel aus der Dropdownliste auswählen

Kartenkennung
taskid True string

Karten-ID

Geschichte abrufen
history string

auf "Ja" festgelegt, wenn Sie den Kartenverlauf abrufen möchten

Abrufen von Kommentaren
comments string

Auf "Ja" festlegen, wenn Sie Kartenkommentare erhalten möchten

Textformat
textformat string

Für die Kartenbeschreibung zurückgegebenes Textformat

Gibt zurück

Name Pfad Typ Beschreibung
taskid
taskid string

taskid

Boardid
boardid string

Boardid

title
title string

title

Beschreibung
description string

Beschreibung

type
type string

type

Abtretungsempfänger
assignee string

Abtretungsempfänger

Unteraufgaben
subtasks string

Unteraufgaben

Teilvorgängecomplete
subtaskscomplete string

Teilvorgängecomplete

color
color string

color

priority
priority string

priority

size
size string

size

Stichtag
deadline string

Stichtag

deadlineoriginalformat
deadlineoriginalformat string

deadlineoriginalformat

extlink
extlink string

extlink

tags
tags string

tags

Vorlaufzeit
leadtime integer

Vorlaufzeit

gesperrt
blocked string

gesperrt

blockedreason
blockedreason string

blockedreason

Spaltenname
columnname string

Spaltenname

Lanename
lanename string

Lanename

Teilvorgangsdetails
subtaskdetails array of

Teilvorgangsdetails

columnid
columnid string

columnid

Laneid
laneid string

Laneid

Position
position string

Position

Arbeitsablauf
workflow integer

Arbeitsablauf

workflow_id
workflow_id integer

workflow_id

URL
attachments.FXPR1VE0LIC9.url string

URL

clientName
attachments.FXPR1VE0LIC9.clientName string

clientName

uniqueName
attachments.FXPR1VE0LIC9.uniqueName string

uniqueName

Dateigröße
attachments.FXPR1VE0LIC9.fileSize float

Dateigröße

fileType
attachments.FXPR1VE0LIC9.fileType string

fileType

status
attachments.FXPR1VE0LIC9.status string

status

URL
attachments.0XC7C1PRR9ZK.url string

URL

clientName
attachments.0XC7C1PRR9ZK.clientName string

clientName

uniqueName
attachments.0XC7C1PRR9ZK.uniqueName string

uniqueName

Dateigröße
attachments.0XC7C1PRR9ZK.fileSize float

Dateigröße

fileType
attachments.0XC7C1PRR9ZK.fileType string

fileType

status
attachments.0XC7C1PRR9ZK.status string

status

Columnpath
columnpath string

Columnpath

Reporter
reporter string

Reporter

benutzerdefinierte Felde
customfields array of object

benutzerdefinierte Felde

fieldid
customfields.fieldid integer

fieldid

name
customfields.name string

name

type
customfields.type string

type

value
customfields.value string

value

obligatorisch
customfields.mandatory boolean

obligatorisch

unveränderbar
customfields.immutable boolean

unveränderbar

updatedat
updatedat string

updatedat

protokollierte Uhrzeit
loggedtime integer

protokollierte Uhrzeit

Verlaufsdetails
historydetails array of object

Verlaufsdetails

eventtype
historydetails.eventtype string

eventtype

historyevent
historydetails.historyevent string

historyevent

taskid
historydetails.taskid string

taskid

details
historydetails.details string

details

Autor
historydetails.author string

Autor

Eintragsdatum
historydetails.entrydate string

Eintragsdatum

historyid
historydetails.historyid string

historyid

comments
comments array of

comments

Karte verschieben

Verschieben einer Karte in eine neue Spalte, eine Spur, einen Workflow oder eine Tafel.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Arbeitsablauf
workflow_id True integer

Workflow muss aus der Dropdownliste ausgewählt werden.

Kolumne
column_id True

Spaltennamen oder ID als benutzerdefinierter Wert auswählen oder Spaltenname oder ID eingeben

Gasse
lane_id True

Wählen Sie "Lane" oder "Lane Name" oder "ID" als benutzerdefinierter Wert aus.

Karte verwerfen oder wiederherstellen

Verwerfen einer Karte oder Wiederherstellen einer zuvor verworfenen Karte.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Maßnahme
is_discarded True integer

Aktion auswählen

Kartenanlagen abrufen

Dient zum Abrufen einer Liste mit allen Anlagen für eine angegebene Karte.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Gibt zurück

Kommentar hinzufügen

Fügen Sie einer Karte oder Initiative einen Kommentar hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Kommentar
text True string

Kommentar

Kommentar hinzufügen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Kommentar hinzufügen" .

(Veraltet) Fügt einer Karte oder Initiative einen Kommentar hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Inhaltstyp
Content-Type True string

Immer verwenden: application/json

Inhaltstyp
Accept True string

Immer verwenden: application/json

Kartenkennung
taskid string

Karten-ID

Kommentar
comment string

Kommentar

Linkkarten

Verknüpfen sie eine Karte mit einer vorhandenen Karte.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True integer

Karten-ID eingeben

Wird verknüpft als
link_type True string

Linktyp auswählen

Zur Karten-ID
linked_card_id True integer

Karten-ID zum Verknüpfen mit der aktuellen Karte

Move Card (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Move Card .

(Veraltet) Verschieben einer Karte (soweit möglich) in eine Spalte

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Inhaltstyp
Content-Type True string

Immer verwenden: application/json

Inhaltstyp
Accept True string

Immer verwenden: application/json

Kartenkennung
taskid string

Karten-ID

Board-ID
boardid True string

Board-ID

Kolumne
column string

Spaltenname

Gasse
lane string

Spurname

Position
position string

Kartenposition in der Spalte

Überschreitung des Grunds
exceedingreason string

Überschreitung des Grunds

Protokollzeit

Protokollierungszeit auf einer Karte.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenkennung
card_id True string

Interne Karten-ID

Zeiteinheit
time_unit True string

Zeiteinheit

Dauer
time True integer

Dauer

Kommentar
comment string

Kommentar

Protokollzeit (Anzahl der Sekunden) (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen die Protokollzeit .

(Veraltet) Protokollierungszeit auf einer Karte. Die Uhrzeit wird in Sekunden protokolliert.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Inhaltstyp
Content-Type True string

Immer verwenden: application/json

Inhaltstyp
Accept True string

Immer verwenden: application/json

Kartenkennung
card_id string

Interne Karten-ID

Uhrzeit
time string

Zeit in Sekunden

Kommentar
comment string

Kommentar

Tafelspalten abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Spalten abrufen ".

(Veraltet) Ruft alle Spalten für eine angegebene Tafel ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
board_id True string

Die Tafel, für die die Spalten abgerufen werden sollen.

Gibt zurück

Name Pfad Typ Beschreibung
Daten
data array of object

Daten

column_id
data.column_id integer

column_id

Arbeitsablauf
data.workflow integer

Arbeitsablauf

section
data.section integer

section

parent_column_id
data.parent_column_id integer

parent_column_id

Position
data.position integer

Position

name
data.name string

name

Beschreibung
data.description string

Beschreibung

color
data.color string

color

Grenze
data.limit integer

Grenze

cards_per_row
data.cards_per_row integer

cards_per_row

flow_type
data.flow_type integer

flow_type

Teilvorgang erstellen

Erstellen Sie einen neuen Teilvorgang einer Karte oder Initiative.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Kartenkennung
card_id True integer

Karten-ID eingeben

Description
description True string

Beschreibung des Teilvorgangs

Besitzer
owner_user_id string

Benutzer auswählen

Teilvorgangsstatus
is_finished integer

Teilvorgangsstatus auswählen

Teilvorgang erstellen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen " Teilvorgang erstellen ".

(Veraltet) Erstellt einen neuen Teilvorgang einer Karte oder Initiative.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Inhaltstyp
Content-Type True string

Immer verwenden: application/json

Inhaltstyp
Accept True string

Immer verwenden: application/json

Id der übergeordneten Karte
taskparent integer

ID der übergeordneten Karte

Title
title string

title

Zugewiesene Person
assignee string

Benutzername des Zugewiesenen

Verknüpfung von Karten aufheben

Entfernen sie eine Verknüpfung zwischen zwei Karten.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Verknüpfungskarten-ID aufheben
card_id True integer

Karten-ID eingeben

Verknüpft als
link_type True string

Linktyp auswählen

Zur Karten-ID
linked_card_id True integer

Geben Sie die verknüpfte Karten-ID ein.

Workflows abrufen (veraltet) [VERALTET]

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Workflows abrufen ".

(Veraltet) Rufen Sie alle Workflows von einem bestimmten Board ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
board_id True string

Vorstand

Gibt zurück

Name Pfad Typ Beschreibung
Daten
data array of object

Daten

type
data.type integer

type

Position
data.position integer

Position

is_enabled
data.is_enabled integer

is_enabled

is_collapsible
data.is_collapsible integer

is_collapsible

name
data.name string

name

workflow_id
data.workflow_id integer

workflow_id

{Object}-Name abrufen

Rufen Sie den Namen eines Objekts basierend auf seiner ID ab. Hilfsfunktion, die verwendet wird, wenn Sie den Namen der Tafel, des Workflows, der Spalte usw. basierend auf ihrer ID abrufen möchten

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Vorstand
board_id True integer

Board muss aus der Dropdownliste ausgewählt werden.

Artikel
item True string

Objekttyp auswählen

ID
id True integer

Objekt-ID eingeben

Gibt zurück

Auslöser

Allgemeiner Trigger

Trigger für jede Aktion auf der Tafel. Verwenden Sie Ctrl/Condition oder Control/Switch, um den Fluss für unterschiedliche Trigger zu verwalten. Hier ist eine Teilliste der unterstützten Ereignistypen: "Card created", "Card moved", "Card details changed", "Card deleted", "Card blocked" \n\n Your next step after the trigger should be "Get Card By ID" so you can take all card details \n\nUse Control/Condition on author ID in bidirektionale Integrationen, um Schleifen zu verhindern

Allgemeiner Trigger

Trigger für jede Aktion auf der Tafel. Verwenden Sie Ctrl/Condition oder Control/Switch, um den Fluss für unterschiedliche Trigger zu verwalten. Hier ist eine Teilliste der unterstützten Ereignistypen: "Card created", "Card moved", "Card details changed", "Card deleted", "Card blocked" \n\n Your next step after the trigger should be "Get Card By ID" so you can take all card details \n\nUse Control/Condition on author ID in bidirektionale Integrationen, um Schleifen zu verhindern

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Board-ID
board_id True string

Board auswählen

Gibt zurück

Name Pfad Typ Beschreibung
Firma
company string

Firma

Ereignis
event string

Ereignis

user_id
user_id integer

user_id

board_id
board_id integer

board_id

card_id
card_id integer

card_id

Definitionen

downloadAttachmentResponse

Name Pfad Typ Beschreibung
Dateiname
data.file_name string

Dateiname der Anlage

Content
data.content binary

Anlageninhalt (base64)

getAllCardsResponse

Name Pfad Typ Beschreibung
Alle Seiten
data.pagination.all_pages integer

Gesamtzahl der Seiten

Aktuelle Seite
data.pagination.current_page integer

Aktuelle Seite

Ergebnisse pro Seite
data.pagination.results_per_page integer

Anzahl der Ergebnisse pro Seite

Daten
data.data array of object
Karten-ID
data.data.card_id integer

Interne Karten-ID

Benutzerdefinierte Karten-ID
data.data.custom_id string

Benutzerdefinierte Karten-ID

Board-ID
data.data.board_id integer

Board-ID der Karte

Workflow-ID
data.data.workflow_id integer

Workflow-ID der Karte

Kartentitel
data.data.title string

Titel der Karte

Benutzer-ID des Besitzers
data.data.owner_user_id

Besitzer-ID der Karte

Typ-ID
data.data.type_id

Kartentyp-ID

Farbe
data.data.color string

Farbe der Karte

`Section`
data.data.section integer

Abschnitts-ID der Karte

Spalten-ID
data.data.column_id integer

Spalten-ID der Karte

Spur-ID
data.data.lane_id integer

Spur-ID der Karte

getCardAttachmentsResponse

Name Pfad Typ Beschreibung
Daten
data array of object

Daten

id
data.id integer

Kartenanlagen-ID

file_name
data.file_name string

Dateiname der Kartenanlage

link
data.link string

Link "Kartenanlage"

getCardResponse

Name Pfad Typ Beschreibung
Karten-ID
data.card_id integer

Interne Karten-ID

Benutzerdefinierte Karten-ID
data.custom_id string

Benutzerdefinierte Karten-ID

Board-ID
data.board_id integer

Board-ID der Karte

Workflow-ID
data.workflow_id integer

Workflow-ID der Karte

Kartentitel
data.title string

Titel der Karte

Benutzer-ID des Besitzers
data.owner_user_id

Besitzer-ID der Karte

Typ-ID
data.type_id

Kartentyp-ID

Farbe
data.color string

Farbe der Karte

`Section`
data.section integer

Abschnitts-ID der Karte

Spalten-ID
data.column_id integer

Spalten-ID der Karte

Spur-ID
data.lane_id integer

Die Spur-ID der Karte

Position
data.position integer

Position der Karte

Kartenbeschreibung
data.description string

Beschreibung der Karte

Kartengröße
data.size

Größe der Karte

Priority
data.priority integer

Prioritäts-ID der Karte

Deadline
data.deadline string

Stichtag der Karte

Typ
data.reporter.type string

Typ des Werts. Kann intern oder extern sein

Melder
data.reporter.value

Reporter der Karte

Erstellt unter
data.created_at string

Zeitstempel der Erstellung der Karte

Zuletzt geändert
data.last_modified string

Zeitstempel der letzten Änderung der Karte

Blocked
data.is_blocked integer

Boolescher Wert, ob die Karte blockiert ist

Benutzerdefinierte Felder
data.custom_fields array of object

Array der benutzerdefinierten Felder, die der Karte zugewiesen sind

Feld-ID
data.custom_fields.field_id integer

Id des benutzerdefinierten Felds

Feldname
data.custom_fields.name string

Name des benutzerdefinierten Felds

Feldwert
data.custom_fields.value

Wert des benutzerdefinierten Felds

Feldanzeigewert
data.custom_fields.display_value

Anzeigewert des benutzerdefinierten Felds

values
data.custom_fields.values array of object
Wert-ID
data.custom_fields.values.value_id integer

ID des benutzerdefinierten Feldwerts

Feldwert
data.custom_fields.values.value

Wert des benutzerdefinierten Felds

getObjectNameResponse

Name Pfad Typ Beschreibung
name
data.name string

Name

uploadAttachmentResponse

Name Pfad Typ Beschreibung
Daten
data array of object

Daten

Karten-ID
data.card_id integer

Interne Karten-ID

Dateiname
data.file_name string

Name der hochzuladenden Datei