Partager via


Businessmap

Businessmap est la plateforme logicielle la plus flexible pour l’agilité de l’entreprise pilotée par les résultats. La fonctionnalité sans correspondance consolide plusieurs outils en un, ce qui permet un déploiement abordable à grande échelle, une visibilité sur tous les projets/portefeuilles et l’alignement sur les objectifs, afin de fournir un travail de qualité plus rapidement. Le connecteur Businessmap peut être utilisé pour refléter les modifications apportées aux outils externes (par exemple, les suivis de problèmes, les e-mails, les outils de suivi du temps, etc.) à l’intérieur de vos cartes Kanban.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Prise en charge de Businessmap
URL https://businessmap.io/customer-support
Messagerie électronique support@businessmap.io
Métadonnées du connecteur
Éditeur Businessmap
Site internet https://businessmap.io
Politique de confidentialité https://businessmap.io/privacy-policy
Catégories Gestion de l’entreprise ; Informatique décisionnelle

Businessmap est la plateforme logicielle la plus flexible pour l’agilité de l’entreprise pilotée par les résultats. Il permet aux responsables d’obtenir une visibilité sur tous les projets, de se connecter à la planification avec l’exécution et de guider l’optimisation continue des flux de travail de livraison. Conçu à l’échelle, Businessmap peut facilement s’étendre d’une équipe de livraison unique à un portefeuille stratégique. La fonctionnalité sans correspondance consolide plusieurs outils en un, ce qui permet un déploiement abordable à grande échelle, une visibilité sur tous les projets/portefeuilles et l’alignement sur les objectifs, afin de fournir un travail de qualité plus rapidement. Businessmap est la plateforme Kanban de pointe pour une gestion et une livraison de projets efficaces.

Il s’agit du connecteur Businessmap pour Power Automate. Il fonctionne directement avec les données de Businessmap via notre dernière API v2. Le connecteur Businessmap peut être utilisé pour refléter les modifications apportées aux outils externes à l’intérieur de vos cartes Kanban ou pour lire des données à partir de Businessmap et l’utiliser dans des connecteurs tiers. Visitez la section intégrations de notre base de connaissances pour obtenir des exemples concrets sur l’utilisation du connecteur.

Prerequisites

  • Pour utiliser ce connecteur, vous avez besoin d’un compte Businessmap et d’un utilisateur disposant des autorisations nécessaires pour accéder à l’API. Sign-Up ici et créez et comptez-le pour essayer.

Comment obtenir des informations d’identification

Vous trouverez votre clé API dans le menu « API » dans votre profil.

Bien démarrer avec votre connecteur

Le connecteur a un déclencheur qui est général et gère tous les événements. Définissez ce déclencheur comme première étape de votre flux lorsque vous souhaitez recevoir des événements à partir de Businessmap. Votre action suivante doit être une vérification « Condition », où vous allez ajouter un filtre sur « événement » et continuer uniquement si le type d’événement correspond à celui qui vous intéresse. Ici , vous trouverez une liste avec tous les événements et valeurs possibles qui déclenchent le déclencheur. L’étape suivante est généralement « Obtenir une carte par ID », elle obtient tous les détails de la carte et vous serez en mesure d’utiliser et d’utiliser ces données dans le flux qui suit.

Problèmes connus et limitations

Certaines limites sont appliquées pour garantir que le produit et nos API s’exécutent aussi bien et efficacement que possible. Les limites d’API exactes dépendent de votre plan de service. Vous pouvez lire plus d’informations à ce sujet ici

Erreurs courantes et solutions

Si vous rencontrez une erreur 429, cela signifie que vous avez atteint vos limites d’API. Les détails de l’erreur vous indiquent combien de temps vous devez attendre avant de pouvoir envoyer votre requête suivante. Toutes les autres erreurs ont des messages qui expliquent la raison exacte de l’erreur.

Questions fréquentes (FAQ)

Nous avons une section complète de la Base de connaissances et si vous avez une question à laquelle vous ne pouvez pas trouver la réponse, contactez-nous et nous serons heureux d’aider.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Clé d’API securestring Clé API pour cette API Vrai
Subdomain ficelle Spécifier le sous-domaine de votre compte Businessmap Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Ajouter un commentaire

Ajoutez un commentaire à une carte ou une initiative.

Ajouter un commentaire (déconseillé) [DÉCONSEILLÉ]

Cette action a été déconseillée. Utilisez plutôt Ajouter un commentaire .

(Déconseillé) Ajoute un commentaire à une carte ou une initiative.

Archiver ou annuler l’archivage de la carte

Ajoutez une carte à archiver ou extrayez-la de l’archive.

Bloquer la carte

Bloquer une carte.

Bloquer ou débloquer une carte (déconseillée) [DÉPRÉCIÉE]

(Déconseillé) Bloquer, débloquer ou modifier des raisons de bloc pour une carte.

Carte d’archivage (déconseillée) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez plutôt archiver ou annuler l’archivage de la carte .

(Déconseillé) Déplacer la carte vers l’archive. La carte ne doit pas être bloquée et doit être dans la colonne Terminé ou dans l’archive de colonne.

Cartes de liens

Lier une carte à une carte existante.

Charger une pièce jointe

Chargez une pièce jointe dans une carte.

Créer un sous-tâche (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez à la place Créer un sous-tâche .

(Déconseillé) Crée une sous-tâche d’une carte ou d’une initiative.

Créer une carte

Créez une carte dans un tableau de votre choix. Pour définir des champs personnalisés, des autocollants et des étiquettes utilisés en combinaison avec « Mettre à jour la carte ».

Créer une carte (déconseillée) [DÉPRÉCIÉE]

Cette action a été déconseillée. Utilisez plutôt Créer une carte .

(Déconseillé) Créez une carte dans un tableau de votre choix.

Créer une tâche subordonnée

Créez une sous-tâche d’une carte ou d’une initiative.

Dissocier les cartes

Supprimez un lien entre deux cartes.

Débloquer la carte

Débloquer une carte.

Définir la valeur du champ personnalisé

Définissez la valeur d’un champ personnalisé.

Définir ou annuler des autocollants

Ajouter des autocollants à une carte ou supprimer des autocollants attribués d’une carte

Définir ou annuler les balises

Ajouter des étiquettes à une carte ou supprimer des étiquettes affectées d’une carte

Déplacer la carte (déconseillée) [DÉPRÉCIÉE]

Cette action a été déconseillée. Utilisez plutôt Déplacer une carte .

(Déconseillé) Déplacez une carte (tâche ou initiative, si possible) vers une colonne.

Déplacer une carte

Déplacez une carte vers une nouvelle colonne, une voie, un flux de travail ou une carte.

Get Board Columns (déconseillé) [DEPRECATED]

Cette action a été déconseillée. Utilisez plutôt Obtenir des colonnes .

(Déconseillé) Obtenir toutes les colonnes d’un tableau spécifié.

Get Boards (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Boards .

(Déconseillé) Obtenez tous les tableaux du compte.

Get Lanes (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Lanes .

(Déconseillé) Obtient toutes les voies pour une carte spécifiée.

Get Types (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Types .

(Déconseillé) Obtient tous les types dans le compte.

Heure du journal

Connectez-vous à une carte.

Heure du journal (nombre de secondes) (déconseillée) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez plutôt l’heure du journal .

(Déconseillé) Connectez-vous à une carte. L’heure est consignée en secondes.

Ignorer ou restaurer une carte

Ignorer une carte ou restaurer une carte précédemment ignorée.

Mettre à jour la carte

Mettez à jour les propriétés d’une carte (Titre, Description, Priorité, etc.). Si vous obtenez un délai d’attente ou une limite d’API atteint des erreurs, essayez de décomposer le paramètre des champs personnalisés, des autocollants et des balises en actions distinctes.

Mettre à jour la carte (déconseillée) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez la carte de mise à jour à la place.

(Déconseillé) Mettre à jour les propriétés d’une carte (Titre, Description, Priorité, etc.)

Obtenir des flux de travail (déconseillés) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Workflows .

(Déconseillé) Obtenez tous les flux de travail à partir d’un tableau donné.

Obtenir des pièces jointes de carte

Obtenez une liste avec toutes les pièces jointes pour une carte spécifiée.

Obtenir la carte par ID (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Obtenir une carte par ID .

(Déconseillé) Obtenir une carte par son ID

Obtenir le nom {Object}

Obtenez le nom d’un objet en fonction de son ID. Fonction d’assistance utilisée lorsque vous souhaitez obtenir le nom du tableau, du flux de travail, de la colonne, etc. en fonction de son ID

Obtenir toutes les cartes

Obtenez toutes les cartes d’un tableau sélectionné. La réponse contient jusqu’à 200 cartes. Pour plus de 200 cartes, utilisez la pagination.

Obtenir toutes les cartes (déconseillées) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez plutôt Obtenir toutes les cartes .

(Déconseillé) Obtenez toutes les cartes d’un tableau donné.

Obtenir une carte par ID

Obtenez les détails de la carte par son ID interne.

Obtenir une carte par ID personnalisé

Recherchez la carte par ID de carte personnalisée. Si plusieurs cartes sont trouvées, seules les premières sont retournées. Utilisez le paramètre « Board » pour filtrer la recherche par tableaux.

Supprimer la carte (déconseillée) [DÉCONSEILLÉE]

(Déconseillé) Supprimez une carte.

Télécharger la pièce jointe

Téléchargez une pièce jointe à partir d’une carte. Le contenu du fichier est retourné sous forme de chaîne encodée en base64.

Ajouter un commentaire

Ajoutez un commentaire à une carte ou une initiative.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Commentaire
text True string

Commentaire

Ajouter un commentaire (déconseillé) [DÉCONSEILLÉ]

Cette action a été déconseillée. Utilisez plutôt Ajouter un commentaire .

(Déconseillé) Ajoute un commentaire à une carte ou une initiative.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type True string

Toujours utiliser : application/json

Type de contenu
Accept True string

Toujours utiliser : application/json

ID de carte
taskid string

ID de carte

Commentaire
comment string

commentaire

Archiver ou annuler l’archivage de la carte

Ajoutez une carte à archiver ou extrayez-la de l’archive.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Action
is_archived True integer

Sélectionner une action

Bloquer la carte

Bloquer une carte.

Paramètres

Nom Clé Obligatoire Type Description
Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

ID de carte
card_id True integer

Entrer l’ID de carte

Raison de blocage
reason_id True string

Sélectionner bloquer la raison

Commentaire
comment string

Ajouter un commentaire à la raison du bloc

Bloquer ou débloquer une carte (déconseillée) [DÉPRÉCIÉE]

(Déconseillé) Bloquer, débloquer ou modifier des raisons de bloc pour une carte.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
boardid True string

Sélectionner un tableau dans la liste déroulante

ID de carte
taskid True string

ID de carte

Type d'événement
event True string
Raison de blocage
blockreason string

raison du blocage

Carte d’archivage (déconseillée) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez plutôt archiver ou annuler l’archivage de la carte .

(Déconseillé) Déplacer la carte vers l’archive. La carte ne doit pas être bloquée et doit être dans la colonne Terminé ou dans l’archive de colonne.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
cardid True string

ID de carte

Version
version string

version

Cartes de liens

Lier une carte à une carte existante.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Sera lié en tant que
link_type True string

Sélectionner le type de lien

Pour l’ID de carte
linked_card_id True integer

ID de carte à lier à la carte actuelle

Charger une pièce jointe

Chargez une pièce jointe dans une carte.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Nom du fichier
file_name True string

Entrer le nom de fichier

Content
content True binary

Fournir du contenu de fichier (base64)

Retours

Créer un sous-tâche (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez à la place Créer un sous-tâche .

(Déconseillé) Crée une sous-tâche d’une carte ou d’une initiative.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type True string

Toujours utiliser : application/json

Type de contenu
Accept True string

Toujours utiliser : application/json

ID de carte parente
taskparent integer

ID de la carte parente

Titre
title string

title

Assignee
assignee string

nom d’utilisateur du bénéficiaire

Créer une carte

Créez une carte dans un tableau de votre choix. Pour définir des champs personnalisés, des autocollants et des étiquettes utilisés en combinaison avec « Mettre à jour la carte ».

Paramètres

Nom Clé Obligatoire Type Description
Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

Flux de travail
workflow_id True integer

Le flux de travail doit être sélectionné dans la liste déroulante

Template
template_id integer

Sélectionner un modèle

Colonne
column_id True

Sélectionner une colonne ou entrer le nom ou l’ID de colonne en tant que valeur personnalisée

Pelouse
lane_id True

Sélectionnez Lane ou Entrez le nom ou l’ID de la voie en tant que valeur personnalisée

Titre
title True string

Titre de la carte

Descriptif
description string

Description de la carte

ID personnalisé
custom_id string

ID de carte personnalisée

Propriétaire
owner_user_id integer

Sélectionner le propriétaire de la carte

Utilisateur reporter
reporter_user_id integer

Sélectionner un reporter à partir d’utilisateurs Businessmap

Courrier électronique du reporter
reporter_email string

Entrez l’adresse e-mail reporter, uniquement si aucun utilisateur n’est sélectionné ci-dessus

Type
type_id integer

Sélectionner le type de carte

Taille de la carte
size double

Taille de la carte

Priority
priority integer

Sélectionner Priorité

Color
color string

Couleur (hexadécimal, par exemple # 0000000)

Échéance
deadline string

Échéance (Format : AAAA -MM-DD)

Date de début planifiée
planned_start_date string

Date de début planifiée (Format : AAAA-MM-DD) (Initiatives uniquement)

Date de fin planifiée
planned_end_date string

Date de fin planifiée (format : AAAA-MM-DD) (Initiatives uniquement)

Heure de début réelle
actual_start_time string

Heure de début réelle (Format : AAAA-MM-DDTHH :mm :ssZ) (Initiatives uniquement)

Heure de fin réelle
actual_end_time string

Heure de fin réelle (Format : AAAA-MM-DDTHH :mm :ssZ) (Initiatives uniquement)

Retours

Créer une carte (déconseillée) [DÉPRÉCIÉE]

Cette action a été déconseillée. Utilisez plutôt Créer une carte .

(Déconseillé) Créez une carte dans un tableau de votre choix.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type string

Toujours utiliser : application/json

Type de contenu
Accept string

Toujours utiliser : application/json

ID de carte
boardid True string

Sélectionner un tableau

Titre
title string

title

Descriptif
description string

détails de la carte

Priority
priority string

valeurs possibles : Faible, Moyenne, Élevée, Critique

Assignee
assignee string

nom d’utilisateur du bénéficiaire

Color
color string

Code de couleur hexadécimal comme cette #F37325

Taille
size string

size

Étiquettes
tags string

plusieurs balises doivent être séparées par de l’espace

Champs personnalisés
cfields string

Liste au format JSON des champs personnalisés et leurs valeurs {"field1 » :"value1 »,"field2 » :"value2"}

Échéance
deadline string

date d’échéance dans ce format AAAA-MM-DD

Lien externe
extlink string

lien externe

Type
type string

nom du type que vous souhaitez définir

Modèle de carte
template string

nom du modèle de carte que vous souhaitez appliquer

Nom de colonne
column string

nom de colonne exact

Pelouse
lane string

Nom de la voie

Poste
position string

position de carte dans la colonne

Dépassement de la raison
exceedingreason string

dépassement de la raison

Créer une tâche subordonnée

Créez une sous-tâche d’une carte ou d’une initiative.

Paramètres

Nom Clé Obligatoire Type Description
Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

ID de carte
card_id True integer

Entrer l’ID de carte

Descriptif
description True string

Description de la sous-tâche

Propriétaire
owner_user_id string

Sélectionner l’utilisateur

État de la tâche subordonnée
is_finished integer

Sélectionner l’état du sous-tâche

Dissocier les cartes

Supprimez un lien entre deux cartes.

Paramètres

Nom Clé Obligatoire Type Description
Dissocier l’ID de carte
card_id True integer

Entrer l’ID de carte

Lié en tant que
link_type True string

Sélectionner le type de lien

À l’ID de carte
linked_card_id True integer

Entrer l’ID de carte liée

Débloquer la carte

Débloquer une carte.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Définir la valeur du champ personnalisé

Définissez la valeur d’un champ personnalisé.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

ID de carte
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

Nom du champ
field_id True integer

Sélectionner un champ personnalisé

Valeur
values True string

Sélectionnez dans la liste déroulante ou entrez des valeurs personnalisées séparées par une virgule

Définir ou annuler des autocollants

Ajouter des autocollants à une carte ou supprimer des autocollants attribués d’une carte

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

Action
action True string

Choisir de définir ou d’annuler les autocollants

Autocollants
stickers True string

Sélectionnez un seul autocollant dans la liste déroulante ou entrez plusieurs autocollants séparés par une virgule

Si l’autocollant est manquant
missing_stickers integer

Sélectionner le comportement souhaité lorsqu’un autocollant est manquant

Définir ou annuler les balises

Ajouter des étiquettes à une carte ou supprimer des étiquettes affectées d’une carte

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

Action
action True string

Choisir de définir ou d’annuler les balises

Étiquettes
tags True string

Sélectionnez une seule balise dans la liste déroulante ou entrez plusieurs balises séparées par une virgule

Si la balise est manquante
missing_tags integer

Sélectionner le comportement souhaité lorsqu’une balise est manquante

Déplacer la carte (déconseillée) [DÉPRÉCIÉE]

Cette action a été déconseillée. Utilisez plutôt Déplacer une carte .

(Déconseillé) Déplacez une carte (tâche ou initiative, si possible) vers une colonne.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type True string

Toujours utiliser : application/json

Type de contenu
Accept True string

Toujours utiliser : application/json

ID de carte
taskid string

ID de carte

ID de carte
boardid True string

id de carte

Colonne
column string

nom de colonne

Pelouse
lane string

Nom de la voie

Poste
position string

position de carte dans la colonne

Dépassement de la raison
exceedingreason string

dépassement de la raison

Déplacer une carte

Déplacez une carte vers une nouvelle colonne, une voie, un flux de travail ou une carte.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

Flux de travail
workflow_id True integer

Le flux de travail doit être sélectionné dans la liste déroulante

Colonne
column_id True

Sélectionner une colonne ou entrer le nom ou l’ID de colonne en tant que valeur personnalisée

Pelouse
lane_id True

Sélectionnez Lane ou Entrez le nom ou l’ID de la voie en tant que valeur personnalisée

Get Board Columns (déconseillé) [DEPRECATED]

Cette action a été déconseillée. Utilisez plutôt Obtenir des colonnes .

(Déconseillé) Obtenir toutes les colonnes d’un tableau spécifié.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
board_id True string

Tableau pour lequel obtenir les colonnes.

Retours

Nom Chemin d’accès Type Description
données
data array of object

données

column_id
data.column_id integer

column_id

flux de travail
data.workflow integer

flux de travail

section
data.section integer

section

parent_column_id
data.parent_column_id integer

parent_column_id

position
data.position integer

position

nom
data.name string

nom

descriptif
data.description string

descriptif

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

Get Boards (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Boards .

(Déconseillé) Obtenez tous les tableaux du compte.

Retours

Nom Chemin d’accès Type Description
données
data array of object

données

board_id
data.board_id integer

board_id

workspace_id
data.workspace_id integer

workspace_id

is_archived
data.is_archived integer

is_archived

nom
data.name string

nom

Get Lanes (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Lanes .

(Déconseillé) Obtient toutes les voies pour une carte spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
board_id True string

Le conseil d’administration pour obtenir les voies pour.

Retours

Nom Chemin d’accès Type Description
données
data array of object

données

lane_id
data.lane_id integer

lane_id

flux de travail
data.workflow integer

flux de travail

parent_lane_id
data.parent_lane_id integer

parent_lane_id

position
data.position integer

position

nom
data.name string

nom

descriptif
data.description string

descriptif

color
data.color string

color

Get Types (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Types .

(Déconseillé) Obtient tous les types dans le compte.

Retours

Nom Chemin d’accès Type Description
données
data array of object

données

type_id
data.type_id integer

type_id

icon_type
data.icon_type integer

icon_type

icon_id
data.icon_id integer

icon_id

nom
data.name string

nom

descriptif
data.description string

descriptif

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

disponibilité
data.availability integer

disponibilité

is_enabled
data.is_enabled integer

is_enabled

Heure du journal

Connectez-vous à une carte.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True string

ID de carte interne

Unité de temps
time_unit True string

Unité de temps

Durée
time True integer

Durée

Commentaire
comment string

Commentaire

Heure du journal (nombre de secondes) (déconseillée) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez plutôt l’heure du journal .

(Déconseillé) Connectez-vous à une carte. L’heure est consignée en secondes.

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type True string

Toujours utiliser : application/json

Type de contenu
Accept True string

Toujours utiliser : application/json

ID de carte
card_id string

ID de carte interne

Heure
time string

Durée en secondes

Commentaire
comment string

Commentaire

Ignorer ou restaurer une carte

Ignorer une carte ou restaurer une carte précédemment ignorée.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Action
is_discarded True integer

Sélectionner une action

Mettre à jour la carte

Mettez à jour les propriétés d’une carte (Titre, Description, Priorité, etc.). Si vous obtenez un délai d’attente ou une limite d’API atteint des erreurs, essayez de décomposer le paramètre des champs personnalisés, des autocollants et des balises en actions distinctes.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

Flux de travail
workflow_id integer

Le flux de travail doit être sélectionné dans la liste déroulante

Template
template_id integer

Sélectionner un modèle

Colonne
column_id

Sélectionner une colonne ou entrer le nom ou l’ID de colonne en tant que valeur personnalisée

Pelouse
lane_id

Sélectionnez Lane ou Entrez le nom ou l’ID de la voie en tant que valeur personnalisée

Titre
title string

Titre de la carte

Descriptif
description string

Description de la carte

ID personnalisé
custom_id string

ID personnalisé

Propriétaire
owner_user_id integer

Sélectionner le propriétaire de la carte

Type
type_id integer

Sélectionner le type de carte

Taille de la carte
size double

Taille de la carte

Priority
priority integer

Sélectionner Priorité

Color
color string

Couleur (hexadécimal, par exemple # 0000000)

Échéance
deadline string

Échéance (Format : AAAA -MM-DD)

Date de début planifiée
planned_start_date string

Date de début planifiée (Format : AAAA-MM-DD) (Initiatives uniquement)

Date de fin planifiée
planned_end_date string

Date de fin planifiée (format : AAAA-MM-DD) (Initiatives uniquement)

Heure de début réelle
actual_start_time string

Heure de début réelle (Format : AAAA-MM-DDTHH :mm :ssZ) (Initiatives uniquement)

Heure de fin réelle
actual_end_time string

Heure de fin réelle (Format : AAAA-MM-DDTHH :mm :ssZ) (Initiatives uniquement)

Autocollants
stickers string

Sélectionnez des autocollants ou ajoutez-les en tant que texte séparé par des virgules

Étiquettes
tags string

Sélectionnez des balises ou ajoutez-les en tant que texte séparé par des virgules

Nom
field_id integer

Sélectionner un champ personnalisé

Valeur
value string

Valeur de champ personnalisée

Retours

Mettre à jour la carte (déconseillée) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez la carte de mise à jour à la place.

(Déconseillé) Mettre à jour les propriétés d’une carte (Titre, Description, Priorité, etc.)

Paramètres

Nom Clé Obligatoire Type Description
Type de contenu
Content-Type True string

Toujours défini sur : application/json

Accept
Accept True string

Toujours défini sur : application/json

ID de carte
boardid integer

Sélectionner un tableau dans la liste déroulante

ID de carte
taskid integer

ID de carte

Titre
title string

title

Descriptif
description string

détails de la carte

Priority
priority string
Assignee
assignee string

nom d’utilisateur du bénéficiaire

Color
color string

Code de couleur hexadécimal comme cette #F37325

Taille
size integer

size

Étiquettes
tags string

plusieurs balises doivent être séparées par de l’espace

Champs personnalisés
cfields string

Liste au format JSON des champs personnalisés et leurs valeurs {"field1 » :"value1 »,"field2 » :"value2"}

Échéance
deadline string

date d’échéance dans ce format AAAA-MM-DD

Lien externe
extlink string

lien externe

Type
type string

nom du type que vous souhaitez définir

Obtenir des flux de travail (déconseillés) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Get Workflows .

(Déconseillé) Obtenez tous les flux de travail à partir d’un tableau donné.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
board_id True string

Conseil

Retours

Nom Chemin d’accès Type Description
données
data array of object

données

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

nom
data.name string

nom

workflow_id
data.workflow_id integer

workflow_id

Obtenir des pièces jointes de carte

Obtenez une liste avec toutes les pièces jointes pour une carte spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Retours

Obtenir la carte par ID (déconseillé) [DÉPRÉCIÉ]

Cette action a été déconseillée. Utilisez plutôt Obtenir une carte par ID .

(Déconseillé) Obtenir une carte par son ID

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
boardid True string

Sélectionner un tableau dans la liste déroulante

ID de carte
taskid True string

ID de carte

Obtenir l’historique
history string

défini sur « oui » si vous souhaitez obtenir l’historique des cartes

Obtenir des commentaires
comments string

défini sur « oui » si vous souhaitez obtenir des commentaires de carte

Format de texte
textformat string

format de texte retourné pour la description de la carte

Retours

Nom Chemin d’accès Type Description
taskid
taskid string

taskid

boardid
boardid string

boardid

title
title string

title

descriptif
description string

descriptif

type
type string

type

cessionnaire
assignee string

cessionnaire

Sous-tâches
subtasks string

Sous-tâches

sous-tâchescomplete
subtaskscomplete string

sous-tâchescomplete

color
color string

color

priority
priority string

priority

size
size string

size

date limite
deadline string

date limite

deadlineoriginalformat
deadlineoriginalformat string

deadlineoriginalformat

extlink
extlink string

extlink

tags
tags string

tags

délai d’avance
leadtime integer

délai d’avance

bloqué
blocked string

bloqué

blockedreason
blockedreason string

blockedreason

columnname
columnname string

columnname

lanename
lanename string

lanename

sous-tâchesdetails
subtaskdetails array of

sous-tâchesdetails

columnid
columnid string

columnid

laneid
laneid string

laneid

position
position string

position

flux de travail
workflow integer

flux de travail

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

taille du fichier
attachments.FXPR1VE0LIC9.fileSize float

taille du fichier

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

taille du fichier
attachments.0XC7C1PRR9ZK.fileSize float

taille du fichier

fileType
attachments.0XC7C1PRR9ZK.fileType string

fileType

status
attachments.0XC7C1PRR9ZK.status string

status

columnpath
columnpath string

columnpath

reporter
reporter string

reporter

customfields
customfields array of object

customfields

fieldid
customfields.fieldid integer

fieldid

nom
customfields.name string

nom

type
customfields.type string

type

value
customfields.value string

value

obligatoire
customfields.mandatory boolean

obligatoire

immuable
customfields.immutable boolean

immuable

updatedat
updatedat string

updatedat

heure de journalisation
loggedtime integer

heure de journalisation

historydetails
historydetails array of object

historydetails

eventtype
historydetails.eventtype string

eventtype

historyevent
historydetails.historyevent string

historyevent

taskid
historydetails.taskid string

taskid

details
historydetails.details string

details

author
historydetails.author string

author

entrydate
historydetails.entrydate string

entrydate

historyid
historydetails.historyid string

historyid

comments
comments array of

comments

Obtenir le nom {Object}

Obtenez le nom d’un objet en fonction de son ID. Fonction d’assistance utilisée lorsque vous souhaitez obtenir le nom du tableau, du flux de travail, de la colonne, etc. en fonction de son ID

Paramètres

Nom Clé Obligatoire Type Description
Conseil
board_id True integer

La carte doit être sélectionnée dans la liste déroulante

Élément
item True string

Sélectionner le type d’objet

ID
id True integer

Entrer l’ID d’objet

Retours

Obtenir toutes les cartes

Obtenez toutes les cartes d’un tableau sélectionné. La réponse contient jusqu’à 200 cartes. Pour plus de 200 cartes, utilisez la pagination.

Paramètres

Nom Clé Obligatoire Type Description
Conseil
board_ids True integer

La carte doit être sélectionnée dans la liste déroulante

ID de carte personnalisée
custom_ids array

Entrer des ID personnalisés

Page
page integer

Numéro de page

État
state string

Valeur d’état des cartes que vous souhaitez obtenir. Par défaut, il s’agit de l’état actif.

Retours

Obtenir toutes les cartes (déconseillées) [DÉCONSEILLÉE]

Cette action a été déconseillée. Utilisez plutôt Obtenir toutes les cartes .

(Déconseillé) Obtenez toutes les cartes d’un tableau donné.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
boardid True string

Sélectionner un tableau dans la liste déroulante

Obtenir une carte par ID

Obtenez les détails de la carte par son ID interne.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Retours

Obtenir une carte par ID personnalisé

Recherchez la carte par ID de carte personnalisée. Si plusieurs cartes sont trouvées, seules les premières sont retournées. Utilisez le paramètre « Board » pour filtrer la recherche par tableaux.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte personnalisée
custom_ids True string

Entrer des ID personnalisés

Conseil
board_ids integer

La carte doit être sélectionnée dans la liste déroulante

Retours

Supprimer la carte (déconseillée) [DÉCONSEILLÉE]

(Déconseillé) Supprimez une carte.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
boardid True string

Sélectionner un tableau dans la liste déroulante

ID de carte
taskid True string

ID de carte

Télécharger la pièce jointe

Téléchargez une pièce jointe à partir d’une carte. Le contenu du fichier est retourné sous forme de chaîne encodée en base64.

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
card_id True integer

Entrer l’ID de carte

Nom de fichier
attachment_id True integer

Sélectionnez Pièce jointe ou entrez l’ID de pièce jointe dans Obtenir des pièces jointes de carte

Retours

Déclencheurs

Déclencheur général

Déclencheurs pour toute action sur la carte. Utilisez Control/Condition ou Control/Switch pour gérer le flux pour différents déclencheurs. Voici la liste partielle des types d’événements pris en charge : « Carte créée », « Carte déplacée », « Détails de la carte modifiée », « Carte supprimée », « Carte bloquée » \n\n L’étape suivante après le déclencheur doit être « Obtenir carte par ID » afin de pouvoir prendre tous les détails de carte \n\nUtiliser le contrôle/condition sur l’ID d’auteur dans les intégrations bidirectionnelle pour empêcher les boucles

Déclencheur général

Déclencheurs pour toute action sur la carte. Utilisez Control/Condition ou Control/Switch pour gérer le flux pour différents déclencheurs. Voici la liste partielle des types d’événements pris en charge : « Carte créée », « Carte déplacée », « Détails de la carte modifiée », « Carte supprimée », « Carte bloquée » \n\n L’étape suivante après le déclencheur doit être « Obtenir carte par ID » afin de pouvoir prendre tous les détails de carte \n\nUtiliser le contrôle/condition sur l’ID d’auteur dans les intégrations bidirectionnelle pour empêcher les boucles

Paramètres

Nom Clé Obligatoire Type Description
ID de carte
board_id True string

Sélectionner un tableau

Retours

Nom Chemin d’accès Type Description
Entreprise
company string

Entreprise

événement
event string

événement

user_id
user_id integer

user_id

board_id
board_id integer

board_id

card_id
card_id integer

card_id

Définitions

downloadAttachmentResponse

Nom Chemin d’accès Type Description
Nom du fichier
data.file_name string

Nom du fichier de pièce jointe

Content
data.content binary

Contenu de pièce jointe (base64)

getAllCardsResponse

Nom Chemin d’accès Type Description
Toutes les pages
data.pagination.all_pages integer

Nombre total de pages

Page active
data.pagination.current_page integer

Page active

Résultats par page
data.pagination.results_per_page integer

Nombre de résultats par page

données
data.data array of object
ID de carte
data.data.card_id integer

ID de carte interne

ID de carte personnalisée
data.data.custom_id string

ID de carte personnalisée

ID de carte
data.data.board_id integer

ID de carte de la carte

ID de flux de travail
data.data.workflow_id integer

ID de flux de travail de la carte

Titre de la carte
data.data.title string

Titre de la carte

ID d’utilisateur du propriétaire
data.data.owner_user_id

ID de propriétaire de la carte

Type Id
data.data.type_id

ID de type de carte

Color
data.data.color string

Couleur de la carte

Section
data.data.section integer

ID de section de la carte

ID de colonne
data.data.column_id integer

ID de colonne de la carte

Id de la voie
data.data.lane_id integer

ID de la voie de la carte

getCardAttachmentsResponse

Nom Chemin d’accès Type Description
données
data array of object

données

pièce d'identité
data.id integer

ID de pièce jointe de carte

nom_de_fichier
data.file_name string

Nom du fichier de pièce jointe de carte

link
data.link string

Lien de pièce jointe de carte

getCardResponse

Nom Chemin d’accès Type Description
ID de carte
data.card_id integer

ID de carte interne

ID de carte personnalisée
data.custom_id string

ID de carte personnalisée

ID de carte
data.board_id integer

ID de carte de la carte

ID de flux de travail
data.workflow_id integer

ID de flux de travail de la carte

Titre de la carte
data.title string

Titre de la carte

ID d’utilisateur du propriétaire
data.owner_user_id

ID de propriétaire de la carte

Type Id
data.type_id

ID de type de carte

Color
data.color string

Couleur de la carte

Section
data.section integer

ID de section de la carte

ID de colonne
data.column_id integer

ID de colonne de la carte

Id de la voie
data.lane_id integer

ID de la voie de la carte

Poste
data.position integer

Position de la carte

Description de la carte
data.description string

Description de la carte

Taille de la carte
data.size

Taille de la carte

Priority
data.priority integer

ID de priorité de la carte

Échéance
data.deadline string

Échéance de la carte

Type
data.reporter.type string

Type de valeur. Peut être interne ou externe

Avertisseur
data.reporter.value

Reporter de la carte

Créé à
data.created_at string

Horodatage de la création de la carte

Dernière modification
data.last_modified string

Horodatage de la dernière modification de la carte

Bloqué
data.is_blocked integer

Boolean, indique si la carte est bloquée

Champs personnalisés
data.custom_fields array of object

Tableau des champs personnalisés affectés à la carte

ID de champ
data.custom_fields.field_id integer

ID de champ personnalisé

Nom du champ
data.custom_fields.name string

Nom du champ personnalisé

Valeur de champ
data.custom_fields.value

Valeur du champ personnalisé

Valeur d’affichage du champ
data.custom_fields.display_value

Valeur d’affichage du champ personnalisé

values
data.custom_fields.values array of object
ID de valeur
data.custom_fields.values.value_id integer

ID de valeur de champ personnalisé

Valeur de champ
data.custom_fields.values.value

Valeur du champ personnalisé

getObjectNameResponse

Nom Chemin d’accès Type Description
nom
data.name string

Nom

uploadAttachmentResponse

Nom Chemin d’accès Type Description
données
data array of object

données

ID de carte
data.card_id integer

ID de carte interne

Nom du fichier
data.file_name string

Nom du fichier à charger