Intégration avec le minuteur personnel Toggl

Étape 1 : Installez le bouton Toggl

Installez le bouton Toggl à partir du Chrome Web Store.

Des instructions détaillées sont disponibles à l'adresse support.toggl.com.

Autorisez l'accès à votre compte Targetprocess sous l'onglet Autorisations. Ajoutez une autorisation d'URL de domaine personnalisé pour votre domaine Targetprocess.

Ensuite, connectez-vous à votre compte Toggl dans votre navigateur web Chrome. Le bouton de connexion s'affiche dans le menu des extensions Chrome.

Une fois terminé, le bouton Toggl apparaît à côté du nom de l'entité dans Targetprocess :

Appuyez une fois sur le bouton pour démarrer le minuteur. Appuyez à nouveau dessus pour arrêter le chronomètre et envoyer l'enregistrement de temps vers votre compte Toggl.

Nous sommes désormais prêts à transférer les enregistrements de temps de Toggl vers Targetprocess à l'aide de Zapier!

Étape 2 : Configurer Toggl Trigger dans Zapier

Connectez-vous à votre compte Zapier.

Créer un nouveau Zap. Sélectionnez Toggl comme application déclencheuse :

Sélectionnez « Nouvelle saisie horaire » pour le déclencheur Toggl :

Connectez votre compte Toggl à Toggl Trigger. Créez un nouveau compte dans Zapier si les informations relatives à votre compte Toggl n'y figurent pas encore.

Récupérez votre jeton API Toggl dans les détails de votre compte Toggl > section « Mon profil ». Connectez votre compte Toggl à Toggl trigger dans Zapier à l'aide du jeton.

Tester la connexion.

Pour tester l'ensemble du processus, veuillez soumettre une nouvelle saisie de temps dans Toggl, puis effectuer un test dans Zapier.

Étape 3 (facultative) : configurez « Filtrer par » dans Zapier.

Si vous utilisez Toggl en dehors du processus cible, Zapier recevra une erreur chaque fois qu'une entrée de temps non liée au processus cible sera créée. Un moyen rapide de réduire ces erreurs consiste à ajouter une étape « Filtrer par » dans Zapier, qui empêche le Zap de continuer à moins que la description de l'entrée Toggl ne commence par « # » (voir l'image ci-dessous).

Étape 4 : Extraire l'ID de l'entité et le temps restant à l'aide de l'action de code

Ajouter une nouvelle action. Sélectionnez « Code by Zapier » comme application d'action :

Choisissez Run Javascript pour l'action « Code by Zapier »

Modifier le modèle :

Modifiez les données d'entrée comme indiqué dans la capture d'écran ci-dessous :

| :---------- | :------------------------ | | description | Step 1 Description | | spent | Step 1 Duration Hours |

Copiez et collez le code suivant. Remplacez les access_token valeurs accountUrl et par vos valeurs personnelles.

var match = input.description.match(/[\w\s]*#(\d+)\s(.*)/i);
var id = match ? match[1] : 0;
var accountUrl = 'https://myaccount.tpondemand.com';
var access_token = 'MjkwMDI6c1RHczJaUWsrRWpKZkpEUWlNeXFibjdkajM2M3ppY2ZIaWhIS0owUEVDMD9=';
var url = accountUrl + '/api/v1/assignables/' + id + '?access_token=' + access_token + '&include=[TimeRemain,RoleEfforts]&format=json';

fetch(url)
  .then(function(res) {
    return res.json();
  })
  .then(function(json) {
    var newRemain = 0;
    var roleEffortsCount = Object.keys(json.RoleEfforts.Items).length;
    if (roleEffortsCount == 1) {
      newRemain = json.TimeRemain - input.spent;
      if (newRemain < 0) {
        newRemain = 0;
      }     
    }
    var output = { id: id, remain: newRemain };
    callback(null, output);
  })
  .catch(callback);
return { id: id, remain : 0 };

Étape 5 : Publier l'enregistrement du temps dans Targetprocess

Utilisez un modèle comme celui ci-dessous.

| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------- | | URL | https://myaccount.tpondemand.com/api/v1/times?access_token=MjkwMDI6c1RHczJaUWsrRWpKZkpEUWlNeXFibjdkajM2M4ppY2ZIaWhIS0owUEVDMD9= | Replace account URL and access token with your own values. | | Payload Type | Json | | | Wrap Request In Array | no | | | Unflatten | yes | |

| :--------------- | :------------------------ | :---------------------------------------------------------------------- | | Assignable__Id | Step 2 Id | Two underscore symbols are used. | | User__Id | 1234 | Two underscore symbols are used. Paste your Targetprocess User ID here. | | Spent | Step 1 Duration Hours | | | Remain | Step 2 Remain | | | Description | Time submitted via Toggl | Any text can be inserted here. |

Pour récupérer votre identifiant utilisateur Targetprocess, veuillez effectuer l'appel API REST suivant vers l'application Targetprocess dans votre navigateur Web :

GET /api/v1/Users/LoggedUser?include=[Id]&format=json

{"ResourceType":"User","Kind":"User","Id":1234}

| :----------- | :--------------- | | Content-type | application/json |

Testez cette étape.