> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Importer depuis Quip

> Importez vos documents, feuilles de calcul et dossiers Quip directement dans Craft, sans export de fichiers.

## Comment lancer l'import

Ouvrez [docs.craft.do/import/quip](https://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.

<Steps>
  <Step title="Ouvrez la page des jetons Quip">
    Rendez-vous sur [quip.com/dev/token](https://quip.com/dev/token) en étant connecté au compte Quip depuis lequel vous souhaitez importer.
  </Step>

  <Step title="Générez et copiez votre jeton">
    Cliquez sur **Get Personal Access Token** et copiez le jeton qui s'affiche.

    <Warning title="Traitez votre jeton comme un mot de passe">
      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.
    </Warning>
  </Step>
</Steps>

<Info title="Quels documents sont importés">
  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.
</Info>

## Importez vos documents

<Steps>
  <Step title="Collez votre jeton d'accès">
    Collez le jeton dans le champ de la page d'import.
  </Step>

  <Step title="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é.
  </Step>

  <Step title="Configurez les options">
    Activez éventuellement **Inclure les commentaires** pour importer vos commentaires Quip en même temps que vos documents.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip title="Les comptes volumineux prennent du temps">
  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.
</Tip>

## 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.

<Check title="Cela ne veut pas dire que l'import a échoué">
  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.
</Check>

<Info title="Tout ce qui est listé n'est pas ouvrable">
  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é.
</Info>

## Ce qui est repris

<AccordionGroup>
  <Accordion title="Documents et mise en forme">
    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.
  </Accordion>

  <Accordion title="Dossiers et documents favoris">
    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.
  </Accordion>

  <Accordion title="Images et pièces jointes">
    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.
  </Accordion>

  <Accordion title="Feuilles de calcul">
    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.
  </Accordion>

  <Accordion title="Tableaux Kanban et Project Trackers">
    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.
  </Accordion>

  <Accordion title="Liens entre documents">
    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.
  </Accordion>

  <Accordion title="Dates">
    Les mentions de date Quip deviennent de véritables dates Craft plutôt que du texte brut.
  </Accordion>

  <Accordion title="Commentaires">
    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.
  </Accordion>
</AccordionGroup>

## 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.

<Info title="Votre compte Quip n'est pas modifié">
  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.
</Info>

## Dépannage

<AccordionGroup>
  <Accordion title="Jeton d'accès Quip non valide">
    Vérifiez que vous avez bien copié le jeton dans son intégralité depuis [quip.com/dev/token](https://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.
  </Accordion>

  <Accordion title="Aucun document trouvé">
    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.
  </Accordion>

  <Accordion title="L'import prend beaucoup de temps">
    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.
  </Accordion>

  <Accordion title="Un document est manquant ou dans le mauvais dossier">
    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.
  </Accordion>

  <Accordion title="Échec de l'import">
    Essayez de relancer l'import. Les documents déjà repris ne seront pas dupliqués. Si le problème persiste, contactez le support.
  </Accordion>
</AccordionGroup>