Aller au contenu
Sections de la documentation

Installation Salesforce

Ce guide installe et configure le package Safecube dans un environnement Salesforce. La procédure ne se fait qu'une fois par instance Salesforce. L'utilisation de l'app Safecube une fois installée est décrite dans le guide d'utilisation Salesforce.

Avant de commencer

  • L'intégration Salesforce est un add-on sur mesure, qui ne fait partie d'aucun plan Safecube : Safecube en ouvre l'accès sur demande. Contactez l'équipe Safecube avant l'installation.
  • L'étape 5 demande la clé d'API de votre espace de travail Safecube. Seul un Admin ou un Owner de l'espace de travail peut l'ouvrir, comme décrit dans Identifiants d'API.

Les libellés de Salesforce sont cités en anglais, tels qu'ils apparaissent dans l'interface anglaise de Salesforce.

1. Installer le package Safecube

Ouvrez le lien d'installation du package Safecube. Salesforce demande alors de :

  • se connecter à l'environnement Salesforce ;
  • confirmer l'installation d'une application non-Salesforce ;
  • autoriser api.sinay.ai à envoyer les données de suivi de conteneurs à Salesforce.

2. Affecter le permission set Safecube

Chaque utilisateur Salesforce qui a besoin de Safecube doit avoir le permission set Safecube :

  1. Ouvrez Setup dans Salesforce.
  2. Dans la zone Quick Find, saisissez Permission Sets et sélectionnez-le.
  3. Cliquez sur le permission set Safecube.
  4. Cliquez sur Manage Assignments, puis sur Add Assignments.
  5. Sélectionnez les utilisateurs qui ont besoin d'un accès, cliquez sur Next, puis sur Assign.

3. Activer un site pour obtenir une URL publique

Salesforce exige une URL de site public pour les intégrations externes :

  1. Ouvrez Setup dans Salesforce.
  2. Dans la zone Quick Find, saisissez Sites et sélectionnez-le.
  3. Cliquez sur New pour créer un site.
  4. Renseignez les informations du site :
    ChampValeur
    Site LabelSafecube
    Site NameSafecube
    Default Web AddressSafecube
    ActiveCoché
    Active Site Home PageUnauthorized
  5. Cliquez sur Save.

4. Affecter le permission set de l'utilisateur invité

Un utilisateur invité technique porte les permissions sur les paramètres de l'application Safecube, clé d'API comprise :

  1. Dans la zone Quick Find, saisissez Sites et sélectionnez-le.
  2. Cliquez sur le site Safecube.
  3. Sélectionnez Public Access Settings, puis View Users.
  4. Cliquez sur Site Guest User.
  5. Sélectionnez Permission Set Assignment, puis Edit Assignments.
  6. Recherchez Safecube Guest User, cliquez sur Add, puis sur Save.

5. Configurer la clé d'API Safecube

La clé d'API donne à Salesforce le droit d'accéder aux données de suivi de conteneurs :

  1. Dans la zone Quick Find, saisissez Custom Settings et sélectionnez-le.
  2. À côté de Safecube Settings, sélectionnez Manage, puis New.
  3. Dans un autre onglet du navigateur, ouvrez la plateforme Safecube en tant qu'Admin ou Owner, sélectionnez Developers dans la barre latérale, puis l'onglet API Credentials, et sélectionnez Copy key.
  4. De retour dans les Safecube Settings de Salesforce, collez la clé d'API dans le champ API Key et cliquez sur Save.

6. Configurer l'URL publique Safecube

Safecube envoie les données de suivi à l'instance Salesforce par cette URL publique :

  1. Dans la zone Quick Find, saisissez Sites et sélectionnez-le.
  2. Sur le site Safecube, faites un clic droit sur le Domain Name et sélectionnez Copier l'adresse du lien.
  3. Dans la zone Quick Find, saisissez Custom Settings et sélectionnez Safecube Settings.
  4. Sélectionnez Manage, puis Edit.
  5. Collez l'URL publique et cliquez sur Save.

7. Activer l'endpoint

  1. Ouvrez l'App Launcher, puis l'application Safecube.
  2. Sélectionnez l'onglet Safecube Settings.
  3. Cliquez sur Create endpoint.

L'installation est terminée : l'app de suivi de conteneurs Safecube est prête à l'emploi dans l'instance Salesforce.

Pour tout problème pendant l'installation, contactez le support Safecube.