Mise en place

D'Angelo est très motivé pour se lancer dans l'installation de Chorus Pro en sandbox. Il reprend la liste des pré-requis et vérifie ce qu'il faut faire lors de l'installation.

Les checklists de D'Angelo

Pour ne rien oublier, D'Angelo affiche la checklist sur son deuxième écran :

1. Création d'un utilisateur Admin : chorusapi@dreamhouse.com 
2. Créer un compte sur la plateforme Chorus Pro 
3. Voir avec l'équipe ADV et la compta pour avoir les informations sur   

• SIRET client

• SIRET de la raison sociale

• Ref Marché ou Numéro de commande

• Code Service

• SIREN et NIC de la raison sociale

4. Vérifier les champs obligatoires sur la facture 

Très bien ! Il peut désormais préparer l'installation en suivant cette deuxième checklist fournie par le support Frisbii :

1. Installer le package ChorusBySofacto en utilisant le lien fourni par Frisbii, sur une org Sandbox ou production

2. Attribuer la licence Frisbii API 

3. Cocher la case Frisbii API sur l'utilisateur  

4. Attribuer les deux ensembles d'autorisation Chorus et Never Expire 

5. Attribuer la présentation de page Chorus_External_API_PL_v1 à l’objet Dépôts

6. Planification des batches 

7. Configuration de l'application connectée 

D'Angelo se fait un café, prends un petit biscuit et commence avec l'étape 1.

Le support Frisbii se charge d’installer l’extension package ChorusbySofacto sur votre sandbox et sur l’environnement de production.

Modifiez l'ensemble d'autorisation Never expire

Afin de pouvoir activer la permission Le mot de passe n'expire jamais pour éviter les problèmes de connexion dans le futur, il faut cloner l'ensemble d'autorisation Never expire.

A savoir : Nous ne pouvons pas packager cet ensemble d'autorisation de Salesforce, c'est pour cela que vous devez l'ajouter manuellement.  

Procédure

1. Allez dans la Configuration > Ensembles d'autorisations.  

2. Cliquez sur Cloner.
3. Modifier l'étiquette et le nom d'API.

4. Ouvrez l'ensemble d'autorisation cloné.
5. Scrollez tout en bas et cliquez sur Autorisations système.

6. Cliquez sur Modifier.

7. Cochez la case Le mot de passe n'expire jamais.

8. Enregistrez.

Paramétrez l'utilisateur API

Pour pouvoir tester Chorus dans sa sandbox, il faut que D'Angelo configure maintenant son utilisateur Admin Salesforce qui avait été créé exprès pour Chorus Pro :  

Procédure

1. Ouvrez l'utilisateur API.
2. Cochez la case Utilisateur API Sofacto.

3. Enregistrez.
4. Survolez Attributions d'ensemble d'autorisations en haut de la page et cliquez sur Modifier les attributions.

5. Ajoutez les ensembles d'autorisations :  

• Administrateur Sofacto (ADMIN)

• Chorus

• NeverExpire (votre clone!)

6. Enregistrez.

Paramétrez l'interface

Pour préparer l'interface des utilisateurs, il faut procéder à deux modifications :   1. Rendre visible la case à cocher Eligible pour Chorus ainsi que les champs requis (Code Service, SIRET...) dans le page layout de la facture ET/OU sur la donnée comptable si besoin.  2. Attribuer la présentation de page Chorus_External_API_PL_v1 à l’objet Dépôts.

Procédure : Visibilité du champ Eligible pour Chorus

1. Ouvrez un enregistrement d'une facture.
2. Cliquez sur Configuration > Modifier la page.
3. Dans le générateur d'application Lightning, allez dans l'onglet Champs dans la navigation à gauche de l'écran.
4. Ajoutez une section en glissant Section Champ de la navigation en bas à l'emplacement de votre choix.
5. Renommez l'étiquette Chorus ou Chorus Pro.

6. Tapez chorus dans la barre de recherche.
7. Faites glisser le champ Chorus Eligible dans la section Chorus.

Répétez ce démarche (étapes 6 et 7) avec les champs Numéro de commande et Code Service.

8. Enregistrez et activez la page.
9. Dans le popup Activation : Frisbii_Invoice_LEX_PL : cliquez sur Attribuer par défaut pour l'organisation.
10. Sélectionnez un facteur de forme et cliquez sur Suivant.
11. Cliquez sur Enregistrer.
12. Cliquez sur la flèche en haut à gauche pour revenir sur votre facture.

13. Cliquez sur Configuration > Modifier l'objet.
14. Allez dans Champs et relations et cherchez les champs Chorus Eligible, Code Service et Numéro de commande.
15. Paramétrez la sécurité au niveau du champ et l'accessibilité des champs en fonction de vos besoins métier.

Les champs sont maintenant disponibles pour les utilisateurs en question :

Procédure : Ajout des champs requis sur la Données comptables

1. Allez dans la configuration > Gestionnaire d'objet.
2. Tapez dans la barre de recherche Donnée (attention à l'accent).
3. Allez dans Présentation de page.
4. Ajoutez une section et nommez-la Chorus.
5. Ajoutez les champs :  

• Numéro de commande (Ref Marché)

• Code Service

• SIRET

Très bien, continuons avec l'objet External API (Dépôt).

Procédure : Attribution de la présentation de page “Chorus_External_API_PL_v1”

1. Allez dans la configuration > Gestionnaire d'objet.
2. Tapez dans la barre de recherche Dépôt (attention aux accents).
3. Cliquez sur Présentation de page.
4. Cliquez sur le bouton Attribution de présentation de page en haut à droite.
5. Cliquez sur le bouton Modifier l'attribution.
6. Sélectionnez les lignes des profils qui correspond à votre besoin de métier.
7. Choisissez ensuite la Présentation de page à utiliser à partir de la liste de sélection en haut du tableau : Chorus_External_API_PL_v1.

8. Enregistrez.

Planifiez le batch de création des dépôts

Cette classe Apex permet de créer des enregistrements de l'objet Dépôt (External API) en reprenant les mentions obligatoires des factures éligibles au dépôt sur Chorus Pro.

Procédure 

1. Dans Configuration, allez dans Classes Apex.
2. Cliquez sur le bouton en haut du tableau Planifier Apex.
3. Nommez la tâche (ex: Dépôts Chorus).
4. Cliquez sur la loupe à côté du champ Classe Apex.
5. Tapez EXTAPI et choisissez EXTAPIScheduledCreation comme classe à planifier.
6. Choisissez la fréquence de lancement désirée grâce à l’agenda.
7. Entrez une date de fin assez loin dans le futur.
8. Sélectionnez une heure qui ne cause pas d'interférences avec d'autres processus.

Planifiez le batch de suppression des dépôts (optionnel)

Il est possible que les dépôts ne soient pas traités tout de suite à cause de problèmes de connexion ou de disponibilité de la plateforme Chorus. Si vous souhaitez anticipez ce genre de problème, vous pouvez utiliser ce batch (classe Apex) qui supprimera tous les dépôts en attente de plus de 24h. Ne vous inquiétez pas, ils seront de nouveau créés lors du prochain passage du batch de création.

Procédure

1. Dans Configuration, allez dans Classes Apex.
2. Cliquez sur le bouton en haut du tableau Planifier Apex.
3. Nommez la tâche (ex: Suppression Dépôts Chorus).
4. Cliquez sur la loupe à côté du champ Classe Apex.
5. Tapez EXTAPI et choisissez ErrorExtApiDeleter comme classe à planifier.
6. Choisissez la fréquence de lancement désirée grâce à l’agenda.
7. Entrez une date de fin assez loin dans le futur.
8. Sélectionnez une heure qui évite de causer des interférences avec d'autres processus.  

Créez l'application Connecteur Chorus

Ensuite nous allons créer le connecteur entre Salesforce (et Frisbii) et l'interface Chorus.
Il n'est pas possible de fournir cela avec l'extension que vous venez installer. Cependant, c'est une étape manuelle obligatoire afin d'ouvrir les API entre Salesforce et Chorus.
Allons-y !

Procédure

1. Allez dans Configuration > Applications > Gestionnaire d'applications.
2. Cliquez sur le bouton Nouvelle application connectée en haut à droite.
3. Renseignez les champs suivants :  

• Nom de l'application connectée : Chorus Connector

• Adresse e-mail du contact : L'email de l'utilisateur API (ex. chorusapi@dreamhouse.com)

• Cochez la case Activer les paramètres OAuth

• URL de rappel : https://login.Salesforce.com/Services/oauth2/callback

• Domaines OAUTH sélectionnés : Obtenir un accès complet (full)

4. Enregistrez.
5. Cliquez sur Continuer.

6. Cliquez sur Gérer.

7. Cliquez sur le bouton Modifier les politiques.
8. Sélectionnez Relâcher les restrictions IP comme Relaxe d'IP.
9. Enregistrez.  
D'Angelo regarde sa checklist et il est plutôt content !

1. Installer le package ChorusBySofacto en utilisant le lien fourni sur environnement Sandbox   

2. Attribuer la licence Sofacto API   

3. Cocher la case Sofacto API sur l'utilisateur   

4. Attribuer les deux ensembles d'autorisation Chorus et Never Expire   

5. Attribuer la présentation de page Chorus_External_API_PL_v1 à l’objet Dépôts  

6. Planification des batches  

7. Configuration de l'application connectée  

Super ! Il a bien mérité un autre biscuit avant d'envoyer toutes les informations nécessaires à Sofacto.

Communiquez les informations pour l'activation du connecteur au support Frisbii

Une synchronisation avec notre partenaire intégrateur Docoon est obligatoire pour le transfert de vos dépôts vers la plateforme Chorus Pro. Il est nécessaire de leur fournir un certain nombre d’informations à l’interconnexion entre la plateforme ChorusPro et Salesforce.
Retournez les informations demandées au support Frisbii qui fera le lien avec notre partenaire.

Utilisateur “technique” Chorus Pro
La page CRÉATION D’UN COMPTE TECHNIQUE POUR UN ACCÈS API EN PRODUCTION décrit les opérations permettant de créer un utilisateur technique ainsi que la possibilité de réinitialiser le mot de passe une fois le compte créé (ex:TECH_XXXXXXXXXXXXXX@cpp2017.fr).
Nous aurions besoin du nom d'utilisateur ainsi que le mot de passe.

Utilisateur Admin Salesforce
Nom et mot de passe de l'utilisateur que vous venez de créer et paramétrer.

Le nom et le SIRET de la raison sociale (N SIREN + NIC)
Ex. 82398059400019 (SIRET Raison social) sans espace

Il prépare un tableau avec tous les éléments demandé et l'envoi par email.

Attention : Le support de Frisbii n'accepte pas des captures d'écran, car il existe un risque d'erreur en copiant manuellement des codes et des clés.