Étape 1: Configurer Deltek Vantagepoint pour l’intégration

12 minutes
Il y a 2 jours

Cette intégration permet à Newforma Konekt de synchroniser les projets, employés et contacts de Deltek Vantagepoint. Les enregistrements sélectionnés pour la synchronisation sont automatiquement mis à jour dans Newforma Konekt chaque fois que des modifications sont apportées dans Deltek Vantagepoint.

Avant de pouvoir connecter les deux systèmes, vous devez configurer les éléments suivants dans Deltek Vantagepoint:

  1. Autorisation d’API (ou intégration) Newforma Konekt
  2. Rôle de sécurité NEWFORMA_KONEKT
  3. Utilisateur NEWFORMA KONEKT
  4. Champs personnalisés

1. Créer une autorisation d’API (ou intégration) Newforma Konekt

L’autorisation d’API (ou intégration) Newforma Konekt permet à Newforma Konekt de se connecter de façon sécurisée à Deltek Vantagepoint et d’accéder aux données nécessaires à l’intégration.

Pour la configurer, créez une nouvelle autorisation d’API (ou intégration) nommée « Newforma Konekt » en suivant les étapes ci-dessous:

  1. Allez à Utilities → Integrations → API Authorization (ou Integrations Manager).
  2. Cliquez sur + New API Authorization (ou + New Integration).
  3. Entrez « Newforma Konekt » dans le champ Authorization Name (ou Integration Name) field.
  4. Ajoutez l’URL suivante dans le champ Callback URL: https://deltek-replacebyyourdatacenternumber.bimtrackapp.co/oauth/replacebyyourhubname/callback
    • Remplacez replacebyyourdatacenternumber et replacebyyourhubname dans l’URL par le numéro de votre centre de données et le nom de votre hub.
    • Le numéro de votre centre de données dépend de son emplacement :
      • États-Unis : « bt03 ».
      • Europe : « bt02 ».
      • Canada : « bt00 ».
  5. Sélectionnez Match Role Access dans le menu déroulant Scopes.
  6. Laissez les autres champs se remplir automatiquement.
  7. Cliquez sur Save.

Ces étapes génèrent les éléments suivants :

  • Clé de consommateur
  • Secret
  • Nom de la base de données

Ces trois éléments seront requis plus tard pour activer le connecteur Deltek Vantagepoint dans Newforma Konekt.

Dans les versions de Deltek Vantagepoint antérieures à 5.0, la clé de consommateur correspond au Client ID, et le secret, au Client Secret.

2. Créer un rôle de sécurité NEWFORMA_KONEKT

Le rôle de sécurité NEWFORMA_KONEKT définit les permissions qu’utilise Newforma Konekt pour accéder aux données de Deltek Vantagepoint et les synchroniser.

Créez un nouveau rôle de sécurité nommé « NEWFORMA_KONEKT » dans Deltek Vantagepoint en suivant les étapes ci-dessous:

  1. Allez à Settings → Security → Roles.
  2. Cliquez sur + New Role.
  3. Entrez « NEWFORMA_KONEKT » comme nom du rôle.
  4. Sous Type of Role, sélectionnez Administrator et décochez la case CRM.
  5. Dans l’onglet OVERVIEW, activez les permissions suivantes :
    • Hubs → Projects
    • Settings → Workflows → User initiated workflows
    • Hubs →Contacts
    • Hubs →Employees
  6. Cliquez sur Save.

Si votre base de données Deltek Vantagepoint comprend plusieurs compagnies, précisez à quelles compagnies le rôle de sécurité NEWFORMA_KONEKT peut accéder :

  1. Allez à Settings → Security → Roles.
  2. Ouvrez l’onglet Access Rights.
  3. Dans le menu déroulant Functional Area, sélectionnez Companies.
  4. Sélectionnez Full Access to All Companies, ou précisez l’accès en ajoutant des compagnies à la grille.

3. Créer un utilisateur NEWFORMA KONEKT

L’utilisateur NEWFORMA KONEKT sert de compte de service que Newforma Konekt utilise pour s’authentifier et accéder à Deltek Vantagepoint. Ce compte sera utilisé plus tard pour connecter votre instance Deltek Vantagepoint à votre hub Newforma Konekt.

Créez un nouvel utilisateur nommé « NEWFORMA KONEKT » dans Deltek Vantagepoint en suivant les étapes ci-dessous:

  1. Allez à Settings → Security → Users → Roles.
  2. Cliquez sur + New User.
  3. Entrez « NEWFORMA KONEKT » dans le champ User ID.
  4. Entrez un mot de passe dans le champ Password.
  5. Sélectionnez « NEWFORMA_KONEKT » dans le menu déroulant Role.
  6. Cliquez sur Save.

Laissez le champ Employee vide et n’activez pas Windows Authentication. L’utilisateur NEWFORMA KONEKT ne doit pas être lié à un employé.

Après avoir créé l’utilisateur NEWFORMA KONEKT, déconnectez-vous de Deltek Vantagepoint et reconnectez-vous avec ce compte. À la première connexion, vous serez invité à changer le mot de passe. Suivez les instructions et enregistrez le nouveau mot de passe.

4. Créer les champs personnalisés

Les champs personnalisés déterminent quels projets, employés et contacts de Deltek Vantagepoint sont synchronisés dans Newforma Konekt. Par exemple, si vous cochez le champ personnalisé Create in NK <name of hub> d’un projet, ce projet sera synchronisé dans ce hub Newforma Konekt une fois l’intégration terminée.

Assurez-vous d’accorder au rôle NEWFORMA_KONEKT l’accès à tous vos champs personnalisés (consultez la section « Créer un champ personnalisé dans Deltek Vantagepoint » ci-dessous pour plus de détails)

Créez les champs personnalisés suivants dans Deltek Vantagepoint :

  • « Create in NK <name of hub> » dans Project (obligatoire)
  • « Project template » dans Project (optionnel)
  • « Project access » dans Project (optionnel)
  • « Create in NK <name of hub> » dans Employees (obligatoire si vous voulez synchroniser les employés)
  • « Create in NK <name of hub> » dans Contacts (obligatoire si vous voulez synchroniser les contacts)

Une fois créés, ces champs apparaissent sur les pages Project, Employees et Contacts de Deltek Vantagepoint.

Pour créer vos champs personnalisés dans Deltek Vantagepoint :

  1. Connectez-vous à Deltek Vantagepoint avec un utilisateur qui a accès à l’outil de design (pas l’utilisateur NEWFORMA KONEKT).
  2. Accédez à l’une des pages suivantes :
    • HUBS → Projects → Project
    • HUBS → Employees
    • HUBS → Contacts
  3. Sur la page sélectionnée, cliquez sur le menu déroulant Other Actions.
  4. Cliquez sur Design.
  5. Cliquez sur Add Field.
  6. Sélectionnez le type de champ approprié dans Field type (voir la section 4.1).
  7. Entrez le nom du champ personnalisé dans Caption.
  8. Laissez le champ Database Column Name se remplir automatiquement. Ne modifiez pas cette valeur.
  9. Cliquez sur Apply.
  10. S’il y a lieu, ajoutez des valeurs au menu déroulant en cliquant sur + Add Value (voir la section 4.1 pour les options).
  11. Cliquez sur Apply.
  12. Cliquez sur le champ sous Field security dans le menu de droite. La fenêtre modale Field Security Rights s’affiche.
  13. Sélectionnez l’option Displayed pour le rôle NEWFORMA_KONEKT créé précédemment.
  14. Cliquez sur Save dans cette modale.
  15. Cliquez sur Save dans le coin supérieur droit de la page.
  16. Rechargez la page et vérifiez que le nouveau champ personnalisé apparaît sur la page sélectionnée.

Répétez cette procédure jusqu’à ce que les cinq champs personnalisés soient créés.

4.1 Détails des champs personnalisés

Les tableaux ci-dessous indiquent comment configurer chaque champ personnalisé dans Deltek Vantagepoint.

4.1.1 Projets

Le tableau ci-dessous présente les détails des trois champs personnalisés de Project.

Nom du champ personnaliséType de champOptions à ajouter au menu déroulantObligatoire ou optionnelUtilisation du champ
Create in NK <name of hub>Case à cocherN/A ObligatoireLes projets dont ce champ est coché sont synchronisés dans votre hub Newforma Konekt. Si votre hub s’appelle « hub1 », nommez le champ « Create in NK hub1 ». Si vous vous connectez à plusieurs hubs, créez un champ distinct pour chacun.

Le champ Database Column Name se remplit automatiquement avec la valeur « CustCreateinNK ». Sinon, entrez « CustCreateinNK ».
Project template Menu déroulantLes noms de vos modèles de projets dans Newforma KonektOptionnelLes gabarits de projet permettent de sauvegarder les paramètres d’un projet passé ou en cours et de les appliquer à un nouveau projet.

Les valeurs de ce menu déroulant doivent correspondre aux modèles de projets de votre hub Newforma Konekt. Si ce champ personnalisé n’est pas créé ou associé, le modèle Newforma Konekt par défaut est appliqué à vos projets Deltek Vantagepoint.

Une fois un projet Deltek Vantagepoint synchronisé dans Newforma Konekt, il est impossible de modifier le modèle de projet qui lui est lié.
Project access Menu déroulantPrivate et LimitedOptionnelL’accès au projet permet aux administrateurs de contrôler la visibilité d’un projet pour les autres utilisateurs. Pour en savoir plus sur l’accès aux projets, consultez cet article.

Si vous ne créez pas ce champ personnalisé et ne l’associez pas dans le flux de configuration, l’accès au projet est privé par défaut : seuls le propriétaire du hub et l’utilisateur qui active le connecteur Deltek Vantagepoint ont accès aux projets synchronisés. Vous pourrez toutefois modifier l’accès au projet directement dans Newforma Konekt une fois le projet créé.
4.1.2 Employés

Le tableau ci-dessous présente les détails du champ personnalisé de Employees.

Nom du champ personnaliséType de champOptions à ajouter au menu déroulantObligatoire ou optionnelUtilisation du champ
Create in NK <name of hub>Case à cocherN/A Obligatoire si vous voulez synchroniser les employés Deltek Vantagepoint dans Newforma Konekt.Les employés dont ce champ est coché sont synchronisés dans votre hub Newforma Konekt. Si votre hub s’appelle « hub1 », nommez le champ « Create in NK hub1 ». Si vous vous connectez à plusieurs hubs, créez un champ distinct pour chacun.

Le champ Database Column Name se remplit automatiquement avec la valeur « CustCreateinNK ». Sinon, entrez « CustCreateinNK ».

Pour pouvoir synchroniser les membres des équipes de projet, assurez-vous que l’onglet TEAM de vos projets Deltek Vantagepoint possède l’option de sécurité de champ Displayed pour votre rôle NEWFORMA_KONEKT :

  1. Dans le menu de navigation de Deltek Vantagepoint, allez à HUBS → Projects → Project.
  2. Dans le coin supérieur droit, sélectionnez Other Actions → Design.
  3. Sélectionnez l’onglet TEAM.
  4. Sélectionnez le tableau Team members.
  5. Sélectionnez le champ sous Field security dans le menu de droite. La fenêtre modale Field Security Rights s’affiche.
  6. Sélectionnez l’option Displayed pour le rôle NEWFORMA_KONEKT créé précédemment.
  7. Cliquez sur Save dans cette modale.
  8. Cliquez sur Save dans le coin supérieur droit de la page.
4.1.3 Contacts

Le tableau ci-dessous présente les détails du champ personnalisé de Contacts.

Nom du champ personnaliséType de champOptions à ajouter au menu déroulantObligatoire ou optionnelUtilisation du champ
Create in NK <name of hub>Case à cocherN/A Obligatoire si vous voulez synchroniser les contacts Deltek Vantagepoint dans Newforma Konekt.Les contacts dont ce champ est coché sont synchronisés dans votre hub Newforma Konekt. Si votre hub s’appelle « hub1 », nommez le champ « Create in NK hub1 ». Si vous vous connectez à plusieurs hubs, créez un champ distinct pour chacun.

Le champ Database Column Name se remplit automatiquement avec la valeur « CustCreateinNK ». Sinon, entrez « CustCreateinNK ».

5. Vérifier les informations de connexion

Avant de configurer le connecteur Deltek Vantagepoint dans Newforma Konekt, assurez-vous d’avoir les informations suivantes, qui seront requises aux prochaines étapes :

  • La clé de consommateur de l’autorisation d’API (ou intégration) Newforma Konekt
  • Le secret de l’autorisation d’API (ou intégration) Newforma Konekt
  • Le nom de la base de données de l’autorisation d’API (ou intégration) Newforma Konekt
  • L’URL de base de votre instance Deltek Vantagepoint
    Exemple:
    https://<instance>.deltekfirst.com/<instance>
    ou
    https://<yourdomain>/Vantagepoint)
  • Le ID utilisateur et le mot de passe de l’utilisateur NEWFORMA KONEKT

6. Préparer la connexion à plusieurs hubs Newforma Konekt (optionnelle)

Si vous prévoyez connecter une même instance Deltek Vantagepoint à plusieurs hubs Newforma Konekt, une configuration supplémentaire est requise.

Créez d’abord une autorisation d’API (ou intégration) distincte dans Deltek Vantagepoint pour chaque hub supplémentaire. Pour chaque autorisation, assurez-vous que la callback URL contient le bon numéro de centre de données et le bon nom de hub.

Ensuite, pour contrôler quels enregistrements sont synchronisés dans chaque hub, créez les champs personnalisés « Create in NK <name of hub> » (voir la section 4) pour chaque hub supplémentaire.

Par exemple, si vous avez deux hubs supplémentaires nommés « hub2 » et « hub3 », créez les champs personnalisés suivants pour les pages Project, Employees et Contacts :

  • Create in NK hub2
  • Create in NK hub3

À l’étape 2 de l’intégration, vous devrez configurer un connecteur Deltek Vantagepoint distinct pour chaque hub supplémentaire à synchroniser.

7. Sélectionner les enregistrements à synchroniser

Enfin, sélectionnez les projets, employés et contacts de Deltek Vantagepoint à synchroniser dans votre ou vos hubs Newforma Konekt.

Ouvrez chaque projet, employé et contact à synchroniser et cochez le ou les champs personnalisés Create in NK <name of hub>. L’enregistrement sera alors synchronisé dans le ou les hubs correspondants.

Si un employé ou un contact est ajouté à un projet à synchroniser dans Newforma Konekt, et que le champ Create in NK <name of hub> est coché pour l’utilisateur et pour le projet, l’utilisateur est aussi synchronisé dans le projet correspondant dans Newforma Konekt.

FAQ

Puis-je réutiliser la même autorisation d’API, le même rôle de sécurité et le même utilisateur pour d’autres intégrations (autres que Newforma Konekt) ? Il est recommandé de créer une autorisation d’API, un rôle et un utilisateur distincts pour l’intégration Newforma Konekt afin que les intégrations n’interfèrent pas entre elles.

Que se passe-t-il si je me connecte à Deltek Vantagepoint avec mes identifiants personnels ? Newforma Konekt utilisera vos identifiants personnels pour se connecter à Deltek Vantagepoint. Vous pouvez quand même configurer l’intégration, y compris créer le rôle de sécurité NEWFORMA_KONEKT et l’utilisateur NEWFORMA KONEKT, mais votre compte doit disposer des permissions requises.

L’intégration de Deltek Vantagepoint avec Newforma Konekt est-elle unidirectionnelle ou bidirectionnelle ? L’intégration est unidirectionnelle. Les modifications apportées dans Deltek Vantagepoint sont synchronisées dans Newforma Konekt, mais les modifications apportées dans Newforma Konekt ne sont pas synchronisées vers Deltek Vantagepoint.

Puis-je activer ou modifier la conversion de clés de Deltek Vantagepoint après la configuration de l’intégration ? Non. Cette intégration ne prend pas en charge la fonction de conversion de clés de Deltek Vantagepoint. Modifier les paramètres de conversion de clés peut entraîner la duplication irréversible de données déjà synchronisées dans Newforma Konekt.

Articles connexes