Gonexa Connect

Si vous n’avez pas encore de site paramétré dans Sharepoint, veuillez en créer un.

💡Vous pouvez créer un site de test, pour l'installation du package Gonexa Connect en Sandbox.

• Depuis Sharepoint, accédez à Mes sites
• Cliquez sur "Créer un site"
• Sélectionnez "Site d'équipe"
• Nom du site : {Libre} ex. Salesforce
• Cliquez sur Suivant, puis Terminer

Configuration Salesforce

Depuis votre configuration Salesforce, accédez à Ensembles d'autorisations et cliquez sur Nouveau.

• Etiquette : FilesConnect
• Nom API : FilesConnect

Enregistrez

Dans la partie Système de votre ensemble d'autorisation

• Cliquez sur Autorisation Système
• Cliquez sur Modifier
• Recherchez Files connect dans le Cloud
• Cochez la case Activé et enregistrez
• Enregistrez la confirmation des changements d'autorisation
• Sur cette même page, cliquez sur Gérer les attributions
• Puis, cliquez sur Ajouter les attributions
• Changer la vue de liste pour apercevoir tous les utilisateurs et cochez ceux à qui attribuer les droits (et vous même)
• Cliquez sur Suivant puis sur Attribuer

Depuis la configuration Salesforce, accédez à Fournisseurs d'authentification.

Cliquez sur Nouveau

• Type de fournisseur : Open Id Connect
• Nom : Sharepoint
• Suffice d'URL : Sharepoint
• Clé consommateur : collez le consumer ID (préalablement trouvé depuis l'onglet Vue d'ensemble, dans la partie ID d'application (client) sur Sharepoint)
• Secret consommateur : Collez le secret (Préalablement trouvé depuis Sharepoint dans certificats & Secrets, dans l’onglet Secrets clients.  Copiez le code contenu dans la colonne Valeur.)
• URL de point de terminaison d’autorisation :  https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2FYOUR_TENANT.sharepoint.com&prompt=login
  
  (Remplacer YOUR_TENANT par le nom de votre Sharepoint Ex. : Gonexa https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2FGONEXA.sharepoint.com&prompt=login)
• URL de point de terminaison de jeton : https://login.microsoftonline.com/common/oauth2/token
• URL de point de terminaison d’information utilisateur : (vide)
• Emetteur du jeton : (vide)
• Etendue par défaut : (vide)
• Envoyer un jeton d’accès dans l’entête : Coché
• Inclure le secret consommateur dans les réponses d’API SOAP : Coché
• URL d’erreur personnalisée : (vide)
• URL de déconnexion personnalisée : (vide)
• Gestionnaire d’enregistrement : (vide)
• Exécuter l’enregistrement en tant que : (vide)
• Portail : (vide)
• URL d’icône : (vide)

Enregistrez

Récupérer l’URL de Rappel disponible dans le bloc Configuration Salesforce après validation du Fournisseur d’authentification Sharepoint.

Ex https://gonexa.my.salesforce.com/services/authcallback/Sharepoint

Dans la catégorie URL de redirection, depuis la Vue d'ensemble dans le portail Azure, cliquez sur Ajouter un URL de redirection.

• Cliquez sur + Ajouter une plateforme
• Sélectionnez WEB
• Dans la partie URL de redirection, collez l'URL de rappel que vous avez récupéré dans le fournisseur d'authentification Sharepoint.
• Cliquez sur Configurer

⚠️ Cette étape doit être effectuée par un utilisateur Salesforce qui détient un accès à l’application Sharepoint qui a été créée, c’est-à-dire, par exemple du propriétaire. Il devra, à la validation du paramétrage, se connecter à Sharepoint avec son identifiant et son mot de passe.

Depuis la configuration Salesforce, accédez à Sources de données externes. Cliquez sur Nouvelle source de données externe.

• Source de données externe : Sharepoint
• Nom : Sharepoint
• Type : Files connect > Microsoft SharePoint Online
• URL du site : Depuis Sharepoint, copiez la première partie de l’URL (ex : https://gonexa.sharepoint.com/sites/MonSite/) nom du site et collez-la ici.
• Type d'identité : Par utilisateur
• Protocole d'authentification : OAuth 2.0
• Fournisseur d'authentification : Sélectionnez Sharepoint
• Etendue : (vide)
• Statut d'authentification d'administration : en attente
• Démarrer le flux d'authentification à l'enregistrement : cocher

Enregistrez et connectez-vous à votre Sharepoint avec votre identifiant et mot de passe pour valider cette étape.

⚠️ Cette étape ne peut être détournée. Si l’approbation administrateur est requise, reportez-vous à l’étape #Ajout d’autorisation. Votre Administrateur Sharepoint doit vous accorder un consentement d’administrateur dans l’onglet API Autorisées.

Depuis la configuration Salesforce

• Accédez à la source de donnée externe : Sharepoint
• Cliquez sur Valider et synchroniser sur la source de données externe
• Depuis la page : Valider la source de données externes : Sharepoint.
• Sélectionnez le tableau items_Sharepoint
• Cliquez sur Synchroniser

• Accédez aux Ensembles d'autorisations et sélectionnez Files Connect
• Dans la section paramètres d'applications, accédez à Paramètres d'objets
• Cherchez items-Sharepoint, et ouvrez-le
• Dans la section Autorisations de champs, Cochez toutes les cases Accès en lecture.
• Dans la section Autorisations d'objet, cochez la case Activé
• Depuis la page de configuration de l'ensembles d'autorisations Files Connect, dans la section paramètres d'application, accédez à Accès à la source de données externe
• Cliquez sur Modifier
• Passez Sharepoint dans les sources de données externes activées et enregistrez.

Depuis la configuration Salesforce, accédez à Paramètres personnalisés.
Trouvez la ligne Sharepoint, et cliquez sur Gérer.
Cliquez sur Nouveau dans la première section, pour créer le custom setting par défaut au niveau de l’organisation.

• Client Id : {Collez le consumer Id trouvé depuis l’onglet Vue d’ensemble de Sharepoint dans ID d’application (client)}
• Client Secret : (trouvé au préalable dans Sharepoint. Dans la catégorie certificats & Secrets, dans l’onglet Secrets clients. Depuis la ligne Gonexa Connect. Copiez le code contenu dans la colonne Valeur.)
• Default path : Il s’agit du chemin Sharepoint dans lequel déposer le fichier généré
  
  Ce champ ainsi pilote l’endroit de stockage de l’ensemble des documents stockés sur Sharepoint de la plateforme. Vous pouvez le laisser vide si vous voulez paramétrer un chemin par modèle. Sinon, remplissez le chemin tel quel : /NomDuDossier
  
  Ex. Devis/2022/ClientA
  
  💡 Il s'agit de l'endroit de stockage du fichier généré par défaut mais vous pouvez piloter celui-ci depuis le modèle ou la boite de flow
• Site id : Id sharepoint (obligatoire)
  
  💡 L'Id Sharepoint se trouve dans l’URL de votre site Sharepoint /_api/site/id
  ‍Ex. gonexa.sharepoint.com/sites/Salesforce/_api/site/id
  ‍Depuis le code XML affiché, récupérez l’Id.
• Tenant id : Trouvé au préalable dans Sharepoint. Il s’agit de l’ID de l’annuaire (locataire), trouvé dans la vue d’ensemble
• Library : renseignez le nom de la librairie dans laquelle stocker le document s’il y en a une, sinon laisser vide auquel cas les documents seront stockés dans Document.
  
  ex. GonexaConnect

Enregistrez

Choix de l'emplacement par modèle

Depuis Salesforce, accédez aux modèles de document (Document template).

• Ouvrez le.s modèle.s à partir de(s)quel(s) vous souhaitez générer sur Sharepoint.
• Accédez au champ Emplacement de stockage, cliquez sur le symbole modifier.
• Sélectionnez l'emplacement de stockage souhaité.
  
  💡Astuce, choisissez de stocker les documents sur Sharepoint ou Salesforce et Sharepoint.
• Cliquez sur Enregistrer.