# \[TUTO\] Importer ses tableaux depuis Trello vers Deck (Nextcloud)

**URL:** https://forum.yunohost.org/t/tuto-importer-ses-tableaux-depuis-trello-vers-deck-nextcloud/29546
**Category:** Tutorials
**Tags:** french, english
**Created:** [May 4, 2024, 11:36am UTC](https://forum.yunohost.org/t/tuto-importer-ses-tableaux-depuis-trello-vers-deck-nextcloud/29546 "2024-05-04T11:36:09Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![ImaCrea](https://forum.yunohost.org/user_avatar/forum.yunohost.org/imacrea/32/2089_2.png) [@ImaCrea](https://forum.yunohost.org/u/ImaCrea)
#### Post date: [May 4, 2024, 11:36am UTC](https://forum.yunohost.org/t/tuto-importer-ses-tableaux-depuis-trello-vers-deck-nextcloud/29546/1 "2024-05-04T11:36:09Z")

</div>

ℹ _Looking for an english version? I posted it on [official Nextcloud forum](https://help.nextcloud.com/t/tuto-how-to-import-your-boards-from-trello-to-deck/190639)_ 😉

* * *

Hello à toutes et à tous 👋  
Celles et ceux qui utilisent Trello l’ont peut-être remarqué : de nouvelles restrictions arrivent. Fini le temps du gratuit (!).

# Intro

Au collectif [MailTape](https://mailta.pe) ça fait un moment qu’on se disait qu’il fallait passer notre tableau Trello vers l’app [Deck](https://github.com/nextcloud/deck) sur notre Nextcloud. Vu que là y’avait plus le choix… je me suis lancé !

Et n’ayant pas trouvé de tuto, j’ai du pas mal me casser la tête pour y arriver. Il faut notamment passer par SSH et utiliser en direct les commandes `occ` de Nextcloud. Du coup, j’ai tout noté au fur et à mesure de mes recherches et voici donc un tuto pour que vous n’ayez pas à repasser par là.

Ce n’est pas si sorcier·e et j’espère qu’avec ce tuto vous vous en sortirez et pourrez déménager tranquillement vers Deck. 🎉

# Le tuto

* * *

On part du principe que vous avez la dernière version de Nextcloud installée (28.0.4) et l’app Deck (1.12.2) à jour avec leur dernières version au moment où j’écris ce tuto.

* * *

**Se connecter en SSH avec un compte admin à votre instance Yunohost**

**Passer en root**  
`sudo -su`

**Puis aller dans le dir de Nextcloud**  
`cd /var/www/nextcloud`

**Ensuite tester déjà que la commande OCC fonctionne bien:**  
`sudo -u nextcloud php8.2 --define apc.enable_cli=1 occ -V`

La version de Nextcloud installée devrait s’afficher. On est prêt.

Ensuite, se réferer à la doc de Deck là : [User documentation - Nextcloud Deck](https://deck.readthedocs.io/en/latest/User_documentation_en/#trello-api)

**On peut déjà voir si Deck répond bien, ainsi que son script d’import.**  
`sudo -u nextcloud php8.2 --define apc.enable_cli=1 occ deck:import -h`

Ça devrait afficher l’aide de la commande.

**Ensuite, [Créer un powerup sur Trello](https://developer.atlassian.com/cloud/trello/guides/power-ups/managing-power-ups/#adding-a-new-custom-power-up) et [générer une clé API](https://developer.atlassian.com/cloud/trello/guides/power-ups/managing-power-ups/#generating-an-api-key).**

Vous devrez ensuite obtenir un jeton d’authentification (token). Attention, il ne s’agit pas du “secret”. Il faut cliquer sur le lien “jeton” dans les instruction à côté de la clé API. (cf [cette video si besoin](https://www.youtube.com/watch?v=ndLSAD3StH8))

**Depuis votre commande SSH sur le serveur, envoyer cette requête pour obtenir un JSON (tableau) listant tous les tableaux Trello dont votre compte fait partie avec l’ID correspondant à chacun:**

```auto
curl --request GET \
  --url 'https://api.trello.com/1/members/{username}/boards?key={APIkey}&token={token}&fields=id,name' \
  --header 'Accept: application/json'

```

En remplaçant {username} par votre login Trello, {APIkey} par la clé API générée et {token} par le jeton.

Exemple:

```auto
curl --request GET \
  --url 'https://api.trello.com/1/members/imacrea/boards?key=7a9743b79cf9eecd1dbfbfddddd&token=Adddddd8ed305abe1a82fa7f7e2cd16585ca46ec7902c041e16ea820915c45b4f2f72D77306FE&fields=id,name' \
  --header 'Accept: application/json'

```

**⚠ Cette commande sert si vous souhaitez récupérer l’ID d’un tableau que vous avez créé avec un compte perso. Pour récupérer un tableau émanant d’une organisation, c’est la commande suivante :**

```auto
curl --request GET \
  --url 'https://api.trello.com/1/members/{orgID}/boards?key={APIkey}&token={token}&fields=id,name' \
  --header 'Accept: application/json'

```

Où `orgID` est le nom de votre org tel qu’il s’affiche dans l’url lorsque vous consultez la page de l’org. Par ex pour `https://trello.com/w/mailtape` c’est alors `mailtape`

```auto
curl --request GET \
  --url 'https://api.trello.com/1/organizations/mailtape/boards?key=7a9743b79cf9eecd1dbdfdffbf73d26799da&token=ATTA998ed305abffffdfe1a82fa7f7e2cd16585ca46ec7902c041e16ea820915c45b4f2f72D77dfdf306FE&fields=id,name' \
  --header 'Accept: application/json'

```

**Maintenant que vous avez récupéré l’ID du tableau que vous voulez importer dans Deck. Il faut créer un fichier de config.json en partant de [ce schema](https://github.com/nextcloud/deck/blob/main/lib/Service/Importer/fixtures/config-trelloApi-schema.json).**

Exemple :

```auto
{
    "owner": "imacrea", 
    "color": "0800fd",
    "api": {
        "key": "7a9743b79cf9eecd1dbfdfdbf73d26799da",
        "token": "ATTA998ed305abe1a82fa7f7e2cd16585cadfdf46ec7902c041e16ea820915c45b4f2f72D77306FE"
    },
    "board": "5022de990357dff867dfd09bbad",
    "uidRelation": {
        "username_sur_trello": "username_sur_nextcloud",
        "george12": "george"
    }
}

```

- `owner` est le username du compte Nextcloud qui sera propriétaire du tableau importé.
- `color` c’est la couleur du tableau, ne vous embêtez pas avec ça : on peut le modifier dans l’interface de Deck.
- `key` votre clé API (cf plus haut)
- `token` votre jeton (cf plus haut)
- `board` l’ID de votre tableau sur Trello, récupéré avec la commande précédente
- `uidRelation` là vous devez faire un tableau de correspondance entre les username des personnes membres du tableau sur Trello et leur username sur Nextcloud. Dans l’exemple, l’user “george12” est son login sur Trello, et “george” est sont login sur Nextcloud.

Plus facile de préparer le contenu de ce fichier dans un éditeur de texte en local, puis copier l’ensemble.

**Dans le dossier où l’on était (/var/www/nextcloud), créer un fichier json dans lequel on va coller notre config:**

`sudo -u nextcloud touch myBoard.json`

**Puis l’ouvrir avec vim pour l’éditer**

`sudo -u nextcloud vi myBoard.json`

**Une fois le fichier prêt, on va pouvoir lancer la commande d’import (et croiser les doigts !)**

`sudo -u nextcloud php8.2 --define apc.enable_cli=1 occ deck:import --system=TrelloApi --config=./myBoard.json`

**Mais il va y avoir probablement une erreur. Il faut corriger deux ligne de code dans un fichier du code d’import à l’heure où j’écris ce tuto. Fort heureusement, la résolution est expliquée dans [ce ticket](https://github.com/nextcloud/deck/issues/5136).**

**Une fois le fichier corrigé, on relance le script. Et c’est bon !**

Une fois l’import fait, un peu de patience côté Nextcloud selon la taille du tableau importé. Le tableau peut mettre ensuite plusieurs minutes à se reconstituer correctement. Evidemment, ce temps de mise en place dépend aussi de la puissance de votre serveur.

Et bye bye Trello ! 🎉

---

<div class="post-metadata">

### Author: ![rodinux](https://forum.yunohost.org/user_avatar/forum.yunohost.org/rodinux/32/7029_2.png) [@rodinux](https://forum.yunohost.org/u/rodinux)
#### Post date: [May 5, 2024, 9:20pm UTC](https://forum.yunohost.org/t/tuto-importer-ses-tableaux-depuis-trello-vers-deck-nextcloud/29546/2 "2024-05-05T21:20:59Z")

</div>

Vous avez du en passer des heures pour trouver la solution, bravo.

---

<div class="post-metadata">

### Author: ![pabruyelles](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/p/43a26b/32.png) [@pabruyelles](https://forum.yunohost.org/u/pabruyelles)
#### Post date: [May 4, 2025, 3:09pm UTC](https://forum.yunohost.org/t/tuto-importer-ses-tableaux-depuis-trello-vers-deck-nextcloud/29546/3 "2025-05-04T15:09:21Z")

</div>

Salut, pour ceux que ça intéresse à l’étape " Vous devrez ensuite obtenir un jeton d’authentification (token). Attention, il ne s’agit pas du “secret”. "

=\> voici le lien actuel (aujourd’hui retiré par trello dans l’instruction à côté de la clé API) : [https://trello.com/1/authorize?expiration=never&score=read,write,account&response\_type=token&key={api-key}](https://trello.com/1/authorize?expiration=never&score=read,write,account&response_type=token&key=%7Bapi-key%7D)

Remplacer {api-key} par votre clé api bien sûr 😉
