¶ Application Zapier
Zapier est une plateforme permettant à des personnes sans connaissances techniques de connecter différentes applications entre elles.
Cette application est en version beta sur invitation en cliquant sur ce lien.
Pour les utilisateurs d'ERPNext, cette application est également compatible avec la version 12.x.x.
¶ Installer l'application Zapier
¶ Récupérer l'URI de redirection
Allez sur zapier.com et connectez-vous ou créez-vous un compte
-
Dans la section
My Appscliquez dansConnect a new accountet cherchezdokos
-
Dans la fenêtre qui s'ouvre, copiez l'adresse de redirection (Redirect URI) affichée au dessus des champs Client ID et Client Secret.
Il s'agit de la même adresse, donc vous pouvez n'en copier qu'une seule.
-
Gardez cette fenête ouverte pour terminer la connexion après l'étape 1.2.
¶ Enregistrer une nouvelle connection sur dokos
Ouvrez dokos et allez dans le module
Intégrations
- Créez un nouveau document
Client OAuth, donnez un nom à l'application cliente (Ex. Zapier) et collez l'URI de redirection copiée plus haut dans les champsURIs de redirectionetURI de redirection par défaut.
- Enregistrez et dokos va générer automatiquement les deux informations manquantes pour terminer notre connexion à Zapier: L'ID client et le secret client.
Copiez ces deux clés.
¶ Configurer les connexions sociales
Pour permettre les intégrations de type OAuth2, il faut avoir au moins une clé de connexion sociale Dodock.
- Allez dans
Intégrations > Clé de connexion sociale - Créez une nouvelle clé de connexion de sociale
- Dans le champ Fournisseur de connexion sociale sélectionnez
Dodock - Dans le champ URL de base entrez l'URL de base de votre site sans les éventuels sous-domaines.
Ex: Si votre URL esthttps://demo.dokos.io, entrezhttps://dokos.io
- Enregistrez
¶ Terminer l'authentification de Zapier
Retournez sur Zapier et ouvrez à nouveau la fenêtre de la section 1.1.
- Base URL: Entrez l'URL de base de votre site dokos. Ex.
https://demo.dokos.io - Client ID: Collez la clé générée à l'étape 1.2. correspondante
- Client Secret: Collez la clé générée à l'étape 1.2. correspondante
- Cliquez sur
Yes, Continue - Vous allez être redirigé sur votre site dokos pour valider l'authentification. Cliquez sur
Autoriser
Votre application Zapier est désormais connectée à votre site dokos.
Vous pouvez créer votre premier Zap.
¶ Créer un Zap
L'application Zapier dokos permet de créer deux types d'interactions:
- La génération d'un Zap en fonction d'un événement affectant un document
- La recherche ou la création d'un document
¶ Génération d'un Zap
Pour générer un nouveau Zap, séléctionnez l'application dokos dans l'éditeur de Zap.
- Dans le champ Choose Trigger Event sélectionnez Document events.
- Sélectionnez le compte à utiliser. Il s'agit probablement du compte créé à l'étape 1.
- Dans la section Customize Document, sélectionnez:
- Le DocType (Type de document) utilisé pour déclencher un Zap
- L'événement (Trigger Event) qui déclenchera ce Zap.
Cet évément peut être l'un des suivants:- After insert: Après la création d'un document
- On change: Après la modification du document (peut être déclenché en même temps que
On updateouOn submit) - On update: Après l'enregistrement du document
- On submit: Après la validation du document
- On update after submit: Après enregistrement d'un document déjà soumis. Possible seulement si certains champs sont éditables après validation.
- On cancel: Après l'annulation du document
- On trash: Après suppression du document
- Les champs à envoyer à Zapier (Webhook Data)
Cliquez sur le bouton + pour ajouter un champ supplémentaire
L'intégration avec Zapier crée des nouveaux Webhooks dans dokos.
Vous pouvez les retrouver en allant dansIntégrations > Webhooks.
Vous pouvez ensuite enregistrer et créer votre action avec une autre application Zapier ou avec l'application dokos si vous le souhaitez.
¶ Déclenchement d'une action sur dokos
Il existe deux types d'actions disponibles sur dokos: Créer un document (Create Document) ou Rechercher un document (Find Document)
¶ Création de document
Un fois que vous avez sélectionné le type de document à créer, choisissez des valeurs pour les champs obligatoires et testez votre Zap.
Un nouveau document devrait être créé sur votre site dokos.
¶ Recherche de document
Si vous sélectionnez la recherche de documents, vous pouvez définir 3 paramètres:
1. Le nombre de document maximum à récupérer
2. Le nom des champs à récupérer
3. Un filtre pour trouver votre/vos documents
Si vous cherchez un document en particulier, pensez à filtrer par identifiant (Nom dans dokos).
En cochant la case Create dokos Document if it doesn't exist yet? vous autorisez Zapier à créer un nouveau document s'il ne trouve pas de document correspondant à vos filtres.
Une fois votre document trouvé ou créé, vous pouvez passer à l'étape suivante et le réutiliser dans un autre Zap.
¶ Formats des données
¶ Dates
Lorsque vous envoyez un champ de type Date ou Date/Heure(Datetime), vous devez utiliser les formats suivants:
- Date:
YYYY-MM-DD
Ex: 2019-11-30 - Date/Heure:
YYYY-MM-DD HH:mm:ss
Ex: 2019-11-30 08:30:00
Vous pouvez utiliser les outils Zapier Formatter pour cela si besoin.
Pour le format Date/Heure, vous pouvez sélectionner l'option "Use a Custom Value":
¶ Listes
L'application n'autorise pas encore l'envoi de listes dans les objects composant les documents.
Veuillez envoyer un mail à help@dokos.io si cette limitation vous pose des problèmes d'intégrations.