Skip to main content

​
Comment lancer l’import

Ouvrez docs.craft.do/import/quip dans votre navigateur et connectez-vous à votre compte Craft si ce n’est pas déjà fait.

​
Obtenez votre jeton d’accès Quip

Craft se connecte à Quip à l’aide d’un jeton d’accès personnel que vous générez vous-même.
1

Ouvrez la page des jetons Quip

Rendez-vous sur quip.com/dev/token en étant connecté au compte Quip depuis lequel vous souhaitez importer.
2

Générez et copiez votre jeton

Cliquez sur Get Personal Access Token et copiez le jeton qui s’affiche.
Votre jeton d’accès donne un accès complet à tout ce que contient votre compte Quip. Ne le partagez pas et ne le publiez nulle part.
Le jeton donne à Craft accès à tout ce que votre compte Quip peut voir : vos documents privés, ainsi que les dossiers partagés et de groupe dont vous êtes membre. Vous n’avez pas besoin d’accorder l’accès document par document.

​
Importez vos documents

1

Collez votre jeton d'accès

Collez le jeton dans le champ de la page d’import.
2

Choisissez votre destination

Sélectionnez le Craft Space dans lequel vos documents Quip doivent apparaître. Vous pouvez également choisir un dossier de destination pour regrouper le contenu importé.
3

Configurez les options

Activez éventuellement Inclure les commentaires pour importer vos commentaires Quip en même temps que vos documents.
4

Lancez l'import

Cliquez sur Import. Une barre de progression s’affiche pendant l’import de vos documents. Vous pouvez fermer la page à tout moment : l’import se poursuit en arrière-plan.
Quip limite la vitesse à laquelle ses données peuvent être lues. Si votre compte est volumineux, l’import se met en pause et reprend tout seul jusqu’à ce que tout soit passé : quelques centaines de documents peuvent prendre quinze minutes ou plus. Vous n’avez pas besoin de laisser la page ouverte.

​
Après l’import

Une fois l’opération terminée, une confirmation s’affiche avec un bouton qui vous emmène dans Craft, où vous retrouverez vos documents importés.

​
Ce que Craft n’a pas pu reprendre

Certains éléments de Quip n’ont pas d’équivalent dans Craft, et il arrive qu’un fichier ne se télécharge pas. Plutôt que de vous laisser le découvrir, Craft dresse à la fin de l’import la liste de tout ce qu’il n’a pas pu reprendre intégralement, avec les documents concernés, afin que vous puissiez les vérifier. Vous pouvez voir apparaître :
  • Des documents qui n’ont pas pu être importés : discussions et présentations, ou un document que Quip n’a pas renvoyé.
  • Des images ou pièces jointes qui n’ont pas pu être téléchargées : le document a été importé sans elles.
  • Des Live Apps importées sous forme de tableaux : leur contenu est bien là, mais elles ne sont plus interactives.
  • Des commentaires qui n’ont pas pu être importés : le document est arrivé sans eux.
  • Des fichiers joints à des commentaires : le texte du commentaire a bien été repris, le fichier joint non.
  • Des commentaires qui ont perdu leur emplacement : ils sont rattachés au document plutôt qu’au passage sur lequel ils portaient.
Un tel récapitulatif est normal, en particulier pour les comptes volumineux, et vos documents sont déjà dans Craft. Il est là pour vous indiquer précisément ce qu’il faut regarder, pas pour signaler un problème.
Une discussion ou une présentation qui n’a pas été importée ne correspond à aucun document Craft à ouvrir : elle est donc simplement listée par son nom. Tout le reste renvoie directement au document importé.

​
Ce qui est repris

Titres, gras, italique, barré, code en ligne, liens, surlignages, listes à puces et numérotées, listes de tâches, tableaux, blocs de code, séparateurs et citations.Quip propose le soulignement, contrairement à Craft : le texte souligné arrive donc avec un surlignage gris clair. La mise en valeur est préservée, même si le style exact diffère.
Votre structure de dossiers est recréée dans Craft, et les documents que vous aviez mis en favori dans Quip arrivent en favori.Dans Quip, un document peut se trouver dans plusieurs dossiers à la fois. Craft place chaque document dans un seul : un document importé se retrouve donc dans le premier dossier où il a été trouvé. Les dossiers vides ne sont pas recréés.
Les images et les pièces jointes sont téléchargées puis réimportées dans Craft, ce qui leur permet de continuer à fonctionner après l’import : ce ne sont pas de simples liens vers Quip.
Une feuille de calcul Quip devient un tableau Craft, que vous pouvez lire et modifier directement. Le classeur .xlsx d’origine est également joint au document, afin que rien ne soit perdu.
Ils deviennent des collections Craft, vos colonnes se transformant en propriété de statut et chaque carte conservant le sien. Les couleurs des colonnes sont reprises.
Les liens et mentions pointant vers d’autres documents et dossiers Quip sont réécrits pour pointer vers les versions importées dans Craft, afin que vos liens internes continuent de fonctionner. Les liens vers des documents qui ne faisaient pas partie de l’import continuent de pointer vers Quip.
Les mentions de date Quip deviennent de véritables dates Craft plutôt que du texte brut.
Si vous activez Inclure les commentaires, les commentaires et leurs réponses sont repris avec les noms d’auteur et les horodatages d’origine, rattachés au texte sur lequel ils portaient.

​
Limites

La plupart de ces cas sont signalés dans le récapitulatif affiché après l’import, avec les documents concernés. Les deux points marqués ci-dessous ne le sont pas, car il ne manque rien que Craft puisse signaler.
  • Les discussions et les présentations ne sont pas importées. Craft n’a d’équivalent ni pour l’une ni pour l’autre : les conversations et présentations Quip sont donc ignorées. Les documents et les feuilles de calcul, eux, sont importés.
  • Les Live Apps autres que les tableaux Kanban et les Project Trackers (les calendriers, par exemple) sont importées sous forme de tableau simple reprenant leur contenu. L’information est là, mais elle n’est plus interactive.
  • Les fichiers joints aux commentaires ne sont pas importés. Le texte du commentaire est bien repris ; le fichier joint non.
  • Certains commentaires peuvent perdre leur emplacement. Si le texte sur lequel portait un commentaire n’existe plus dans l’export Quip, le commentaire est rattaché au document dans son ensemble plutôt qu’à ce passage. Rien n’est perdu, mais il peut ne pas se trouver là où vous l’attendez.
  • Les modèles sont importés comme des documents ordinaires (non signalé). Un modèle Quip arrive sous forme de document Craft classique, et non de modèle Craft. Tout son contenu est là, il n’est simplement pas configuré comme un modèle.
  • Les documents dans la corbeille Quip ne sont pas importés (non signalé). Craft ne voit que les documents que votre compte Quip conserve en dehors de la corbeille.
L’import se contente de lire depuis Quip. Rien dans votre compte Quip n’est déplacé, modifié ou supprimé : vous pouvez donc continuer à l’utiliser normalement et relancer l’import si nécessaire.

​
Dépannage

Vérifiez que vous avez bien copié le jeton dans son intégralité depuis quip.com/dev/token. Si vous n’êtes pas certain que le jeton collé soit le jeton actuel, rouvrez cette page et copiez celui qui s’y affiche.
Cela signifie que le jeton a fonctionné, mais que Craft n’a vu aucun document à travers lui. Assurez-vous d’avoir généré le jeton en étant connecté au bon compte Quip : si vous en avez plusieurs, il est facile de créer un jeton pour le mauvais.
C’est généralement dû aux limites de débit de Quip, et non à un problème. L’import se met en pause puis reprend de lui-même, et il continue même après la fermeture de la page. Les comptes volumineux peuvent prendre un certain temps.
Un document présent dans plusieurs dossiers Quip est placé dans le premier trouvé : il peut donc ne pas se trouver là où vous l’attendez. Si un document manque totalement, vérifiez s’il s’agit d’une discussion ou d’une présentation, qui ne sont pas importées, et s’il se trouve dans la corbeille Quip.
Essayez de relancer l’import. Les documents déjà repris ne seront pas dupliqués. Si le problème persiste, contactez le support.