Habitica Wiki FR
Habitica Wiki FR
Habitica Wiki FR

Note: Il y a deux versions de l'intégration Habitica Zapier et cette page décrit la version non-officielle. Selon le développeur de la version non-officielle, la version officielle devrait être utilisée à la place et la version non-officielle sera supprimée (voir carte Trello). Cette page devra être remaniée pour correspondre à la version officielle. Lisez ce billet de blog de Habitica Developer pour obtenir des informations sur la version officielle.

Description

Zapier est un outil pour les utilisateurs et utilisatrices peu versé•e•s dans la technique pour connecter des applications web les unes avec les autres. Avec l'ajout de l'application Habitica, vous pouvez intégrer avec n'importe quelle autre application compatible avec Zapier, comme Google Sheets, Rescue time, Evernote, Trello, Github etc et accomplir des actions dans les autres applications suivant des informations se produisant dans Habitica, et vice-versa.

À noter: Ni la fonctionnalité ni la sécurité de cette application Zapier n'ont été revues ou approuvées par Zapier. La carte Trello traitant de l'application Zapier se trouve ici

Installation

  1. Tout d'abord créez un compte sur https://zapier.com/sign-up/
  2. Suivez le lien Developer Zapier Link
  3. Choisissez Accept Invite & Go to Dashboard
  4. L'application Habitica sera maintenant disponible pour vos Zaps.

Utilisation

Déclencheurs:

  • "New Party Chat" Se déclenche lorsqu'un nouveau message apparaît dans la discussion de l'équipe.
  • "New Task" Se déclenche lorsqu'une nouvelle tâche est créée.
  • "Scored Task" Se déclenche lorsque vous achevez une tâche. Cela se produit lorsque vous cliquez le plus/moins d'une Habitude, accomplissez une Quotidienne ou une tâche À Faire.

Actions:

  • "Create Task" Crée une tâche. Une tâche peut-être une Habitude, une Quotidienne ou une tâche À Faire.
  • "Score Task" Achève une tâche (Habitude, Quotidienne ou tâche À Faire). Cela peut soit marquer une Quotidienne / tâche À Faire comme accomplie (Up), décocher une Quotidienne / tâche À Faire (Down) ou cliquer le plus ou le moins d'une Habitude. Vous devrez fournir l'identifiant de la tâche (TaskID) pour marquer celle-ci.
  • "Find Task" Trouve une tâche selon son nom. Seules les correspondances exactes fonctionnent. La recherche est sensible à la casse.


Conseils & Astuces[]

Général[]

  • Puisque Zapier récupère les données périodiquement (toutes les 5 à 15 minutes), la discussion de l'équipe peut ne pas s'afficher dans l'ordre si deux messages ou plus se produisent pendant ce temps. Un message envoyé à 12h54 peut être récupéré avant un message envoyé à 12h51.
  • Pour le bon fonctionnement du Déclencheur "New Party Chat", le chat de l'équipe ou de la guilde visée doit nécessairement comporter au moins un message existant à l'établissement du Zap. À défaut, ce dernier ne pourra fonctionner.
  • À la création d'une tâche, la date d'échéance doit être changée en date UTC afin d'apparaître correctement sur le site.
  • Actuellement, la date d'échéance à la création d'une tâche ne se remplit pas correctement dans l'application (mais apparaît bien sur le site web). Pour régler ceci, il suffit de mettre à jour manuellement la date.

Google Sheets[]

  • Pour une utilisation de Google Sheets, le document doit:
    • Comporter un titre sur la première ligne;
    • N'avoir aucun vide enregistré dedans.
  • Le temps dans Habitica est enregistré en temps Epoch. Afin de correctement le faire apparaître dans Google Sheets, il est nécessaire de mettre la cellule au format temps/date de la façon suivante:
    • Pour convertir en UTC, il faut ajouter "ts" devant la zone Temps. Par exemple: ts[Habitica Timestamp]. NB: Le signe égal ne peut être utilisé ici.
    • Pour convertir à votre fuseau horaire

=[Habitica Timestamp]/86400000+"1 Jan 1970"+[GMT Adjustment]/24[GMT Adjustment] est le nombre d'heures avant ou après GMT. Pour PDT, c'est GMT -7, la formule sera donc =[Habitica Timestamp]/86400000+"1 Jan 1970" + -7/24.

  • Afin de convertir les dates d'échéances au format UTC lors de la création d'une tâche, la formule nécessaire est la suivante:

=[Cellule Excel comportant la date]+([Ajustement GMT]/24). Par exemple, si le fuseau horaire est PDT, cela correspond à GMT -7 et si la case comportant la date est C2, la formule sera: =C2+(-7/24)

Exemples[]

Copier la discussion de l'équipe / d'une guilde dans Google Sheets[]

Zapier-SampleGuildChat GoogleSheet

Page Google Sheet vierge avec entêtes

  1. Créer une page Google Sheet avec les entêtes de colonne correspondant aux données que vous désirez enregistrer, comme le Nom, le Niveau, la Date, le Texte.
  2. Appliquer le format temps/date sur la colonne Date.
  3. Aller sur le menu de Zapier. Cliquer sur "Make a Zap".
  4. Choisissez Habitica comme application "Trigger".
  5. Cliquer sur "New Party Chat", puis sur "Continue".
  6. Si cela n'a pas déjà été fait, choisissez "Connect to New Account" et remplissez votre ID d'utilisateur et votre jeton d'API, trouvables ici sur le site Habitica.
  7. Sélectionner le compte et cliquer sur "Yes, continue".
  8. Sélectionner l'Equipe ou la Guilde visée et cliquer sur "Continue".
  9. S'assurer qu'il existe au moins un message dans le chat de l'Equipe ou de la Guilde visée, puis cliquer sur "Fetch & Continue".
  10. Le message"Test Successful!" doit apparaître. Si cela n'est pas le cas, il faut s'assurer qu'au moins un message figure dans le chat de l'Equipe ou Guilde sélectionnée. Le résultat est visible en cliquant sur "view your chat" et la dernière ligne apparue dans l'équipe/la guilde visée s'affiche. Cliquer sur "Continue".
  11. Choisir Google Sheets comme application "Action".
  12. Sélectionner"Create Spreadsheet Row" pour créer une nouvelle ligne dans une Google Sheet.
  13. Si cela n'a pas déjà été fait, choisir de connecter un nouveau compte et remplir l'identifiant et mot de passe Google.
  14. Sélectionner le compte, et cliquer sur"Save + Continue".
  15. Sélectionner le document voulu dans "Spreadsheet" et la page visée dans "Worksheet".
  16. Zapier-SampleGuildChat SetFieldToPopulate

    Détail des informations Habitica pour remplir le document Google Sheet

    Remplissez le détail des colonnes avec les informations extraites d'Habitica en cliquant sur la liste déroulante à droite. (Ces colonnes peuvent apparaître dans un ordre différent)
    • La date est configurée ainsi

=[Step 1 Timestamp]/86400000+"1 Jan 1970" + -7/24 pour PDT(GMT-7). Merci de lire Conseils & Astuces pour Google Sheets pour de plus amples informations pour la configuration de l'horodatage.

  1. Ainsi,
    • [Step 1 User Name] correspond au Nom d'utilisateur,
    • [Step 1 Contributor Level]: [Step 1 Contributor Text] au niveau
    • [Step 1 Text] au message.
  2. Cliquer sur "Continue".
  3. Il est alors donné la possibilité de tester le Zap en insérant la dernière ligne du chat dans votre document Google Sheet en cliquant sur "Create & Continue".
  4. Le message "Test Successful!" doit alors apparaître. Si tel n'est pas le cas, il est nécessaire de vérifier qu'aucune ligne vide n'est laissé entre la première ligne (ligne d'entête) et la ligne où les données sont ajoutées
  5. Ouvrir le document Google Sheet et constater les résultats.
    • La première ligne doit mentionner:

      "Added by Zapier, ensuring we can access this spreadsheet. Feel free to delete it after you are all set up!"

      Cette ligne peut être supprimée (pas en ôtant simplemant le message, mais en supprimant totalement la ligne, sinon votre Zap ne pourra fonctionner!).
    • La prochaine ligne du document sera alors la ligne du chat qui s'enregistrera automatiquement.
  6. Cliquer sur "Finish".
  7. Nommer votre Zap, puis cliquer sur"Your Zap Is On" afin de commencer la collecte des données.
Zapier-SampleGuildChat FinalGoogleSheet

Document Google Sheet avec le Chat visé

Zapier-SampleGuildChat FinalCorrespondingChat

Chat visé pour le document Google Sheet


Charger de nouvelles tâches À Faire de Google Sheets[]

Ce tutoriel montre comment charger de nouvelles tâches À Faire lorsqu'une nouvelle ligne est créée. Par conséquent, si une liste existe déjà ou s'il est nécessaire de modifier les tâches À Faire avant le chargement, il faut d'abord l'éditer dans un autre document,, puis coller la ligne dans le document Google Sheet une fois le Zap activé.

Zapier-GoogleLoadToDo GoogleSheet

Document Google Sheet avec une tâche À Faire

  1. Créer un document Google Sheet avec les entêtes suivants: Nom Tâche, Notes, Date échéance réelle, Date échéance UTC.
  2. Apposer le format Date-heure pour la date d'échéance.
  3. Remplir comme voulu le nom de la tâche, les notes et la date d'échéance réelle . Ne remplir qu'une seule ligne À Faire, car les lignes suivantes seront ignorées et ne seront pas chargées. Ajouter ces prochaines tâches qu'une fois le Zap créé.
  4. Dans la colonne Date d'échéance UTC, écrire la formule

=C2+(-7/24) pour l'heure PDT(GMT-7).

  1. Aller sur la page d'accueil de Zapier. Choisir "Make a Zap".
  2. Sélectionner comme déclancheur l'application Google Sheets.
  3. Choisir "New Spreadsheet Row" puis cliquer sur "Save + Continue".
  4. Si cela n'a pas déjà été fait, choisir de connecter un nouveau compte et remplir l'identifiant et mot de passe Google.
  5. Choisir le compte Google, puis cliquer sur "Save + Continue".
  6. Sélectionner le document Google Sheet et la page voulue, puis cliquer sur "Continue".
  7. Cliquer sur "Fetch & Continue" pour confirmer.
  8. Il est alors possible de voir la ligne du document afin de confirmer que les données sont correctes. Si elles le sont, cliquer sur "Continue".
  9. Sélectionner comme Action l'application Habitica.
  10. Choisir "Create Task", puis cliquer sur "Save + Continue".
  11. Si cela n'a pas déjà été fait, choisissez "Connect to New Account" et remplissez votre ID d'utilisateur et votre jeton d'API, trouvables ici sur le site Habitica.
  12. Sélectionner le compte, puis cliquer sur "Save + Continue".
  13. Remplir le détail des barres avec les nom de colonnes précédemment établis pour chaque information à insérer dans Habitica.
    • To-Do pour le "Type"
    • [Step 1 nomtâche] pour la "Task"
    • [Step 1 notes] pour les "Notes"
    • [Step 1 dateéchéanceutc] pour la date d'échéance UTC.
  14. Cliquer sur "Continue".
  15. Relire pour vérifier l'exactitude des données, puis cliquer sur "Create & Continue".
  16. Zapier-GoogleLoadToDo FinalTask

    La tâche À Faire Habitica créée

    Rafraichir le compte Habitica sur l'application ou le site web, et constater la nouvelle tâche créée.
  17. Cliquer sur "Finish".
  18. Nommer le Zap et cliquer sur "Your Zap Is On".
  19. Ajouter de nouvelles lignes au document Google Sheet pour de nouvelles tâches À Faire, en s'assurant que la colonne Date échéance UTC est correctement remplie.

Ajouter des tâches complétées à RescueTime[]

Un compte Rescue Time premium est nécessaire. Lien

  1. Aller sur la page d'accueil de Zapier, et choisir "Make a Zap".
  2. Sélectionner comme déclancheur l'application Habitica.
  3. Cliquer sur "Score Task" puis sur "Save + Continue".
  4. Si cela n'a pas déjà été fait, choisissez "Connect to New Account" et remplissez votre ID d'utilisateur et votre jeton d'API, trouvables ici sur le site Habitica.
  5. Sélectionner le compte, puis cliquer sur "Save + Continue".
  6. Cliquer sur "Continue" si "Test is Successful" apparaît.
  7. Choisir comme Action l'application RescueTime.
  8. Sélectionner "Log a Highlight Event", puis cliquer sur "Save + Continue".
  9. Si cela n'a pas déjà été fait, sélectionner "Connect to new account" et remplir l'identifiant et le mot de passe RescueTime.
  10. Choisir le compte, puis cliquer sur "Save + Continue".
  11. Zapier-RescueTime SetupFields

    Création de tâche À Faire

    Remplir les barres selon les informations suivantes:
    • [Step 1 Updated At] pour "Date / Time"
    • [Step 1 Task Text] was scored [Step 1 Direction]. Completion: [Step 1 Task Completed] pour "Description"
    • Habitica pour "Action Label"
  12. Cliquer sur "Continue".
  13. Relire pour vérifier l'exactitude des informations, puis cliquer sur "Create & Continue".
  14. Cliquer sur "Finish".
  15. Nommer le Zap puis cliquer sur "Your Zap Is On".
Rescuetime

Tâche à faire Habitica créée