Step 2: Connect Deltek Vantagepoint to a Newforma Konekt hub
Once the initial setup is complete, proceed with establishing the connection between Deltek Vantagepoint and your Newforma Konekt hub.
1. Fill Out Deltek Vantagepoint Connection Info
The first step of the connection process is to enter your Deltek Vantagepoint credentials and API details in Newforma Konekt to establish a secure connection between the two systems.
Start by accessing the Deltek Vantagepoint connector from your Newforma Konekt hub:
- Go to Integrations.
- Locate the Deltek Vantagepoint connector and click Connect.
This opens the Deltek Vantagepoint connection configuration modal. Fill out the following fields:
- Consumer key: Enter the consumer key from the initial setup.
- Secret: Enter the secret from the initial setup.
- Database name: Enter the database name from the initial setup.
- Base URL: Enter the URL of your Deltek Vantagepoint instance.
The Deltek Vantagepoint base URL depends on whether your instance is cloud-hosted (Deltek First) or on-premise. It is typically part of the URL shown in your browser’s address bar when you are logged in.
- For cloud-hosted instances: https://<instance>.deltekfirst.com/<instance>
- For on-premise instances: https://<yourdomain>/Vantagepoint
Click Next after entering all required information.
2. Log Into Deltek Vantagepoint from Newforma Konekt
Your Newforma Konekt hub needs to authenticate with Deltek Vantagepoint.
On this page, enter the credentials for the NEWFORMA KONEKT user created during the initial setup:
- Enter the user ID for your NEWFORMA KONEKT user in the User ID field.
- Enter the password for your NEWFORMA KONEKT user in the Password field.
- Select the appropriate database.
Click Log in when you’re ready to proceed to the next step.
3. Configure Data to Sync
An integration with a Newforma Konekt hub always syncs projects by default, while syncing employees and contacts is optional.
In this step, choose whether to include employees and contacts and define the project role they will be assigned in Newforma Konekt:
- Check the I confirm that I have created the Create in NK <name of hub> field in Deltek Vantagepoint checkbox.
- Enable the Sync employees toggle if you have employees to sync.
- Click the Initial project role dropdown menu to select the initial project role that will be assigned to these users.
- Enable the Sync contacts toggle if you have contacts to sync.
- Click the Initial project role dropdown menu to select the initial project role that will be assigned to these users.
Click Next when you’re ready to proceed to the next step.
4. Map Data from Deltek Vantagepoint to Newforma Konket
The mapping process links Newforma Konekt fields (right) to their corresponding Deltek Vantagepoint fields (left), ensuring data is properly aligned and transferred during synchronization.
4.1 Map Project Fields
Start by mapping your Newforma Konekt project fields:
- Project name: Mandatory field. The project name cannot contain any of the following characters: <, >, &.
- Project number: If this field is not mapped, synced projects will not have a project number in Newforma Konekt. You can still add project numbers manually in Newforma Konekt afterward.
- Project access: If this field is not mapped, project access of synced projects in Newforma Konekt will be set to Private by default. You can still edit project access manually in Newforma Konekt afterward.
- Start date: If the field is not mapped, the start date of your synced projects will be blank in Newforma Konekt. You can still add start dates to your projects manually in Newforma Konekt afterward.
- End date: If the field is not mapped, the end date of your synced projects will be blank in Newforma Konekt. You can still add end dates to your projects manually in Newforma Konekt afterward.
- Project template: If the field is not mapped, the project template of your synced projects will be set to the default Newforma Konekt template.
While unmapped project fields can be edited in Newforma Konekt after sync, mapped fields can only be edited in Deltek Vantagepoint.
For example, if you map the Project Number field, any changes to project numbers must be made in Deltek Vantagepoint, which will then carry over to Newforma Konekt. In other words, you won’t be able to edit the project numbers for these projects in Newforma Konekt.
4.2 Map User Fields (Employees and Contacts)
Next, map the user fields:
- Email: Mandatory field.
- First name: Optional.
- Last name: Optional.
- Job title: Optional.
- Company: Optional.
If optional fields are not mapped, these values will not be populated in Newforma Konekt after syncing. You can still add them manually in Newforma Konekt.
Once you’ve mapped both the project and user fields, click Next to proceed to the next step.
5. Review Summary
The summary step lets you review the configurations selected in previous steps before starting the sync process. Follow the steps below:
- Read through the summary carefully.
- Click Next to proceed to the sync verification step.
Once syncing begins, it cannot be stopped.
6. Verify Sync
This step allows Newforma Konekt to confirm that the previous steps were completed correctly. This verification process can take up to two minutes.
No action is required during this step.
Connection Outcome
Once the verification is complete, the connection configuration modal will close, and syncing will continue in the background. You can navigate to other activity centers in Newforma Konekt while the sync is in progress. A confirmation email will be sent to hub admins once the connection process is complete.
The connection status of the Deltek Vantagepoint connector will be visible in Integrations, with the following possible statuses:
- Connected
- Syncing
- Error
FAQ
Can I change the project role of my employees and contacts after syncing? Yes. You can change their project role post-sync in Newforma Konekt.
Do my employees and contacts need to share the same project role during syncing? Yes. If users need to have different project roles, update them individually in Newforma Konekt.
Will synced contacts take up a license in Newforma Konekt? Yes. Contacts count as active users and take up a license in Newforma Konekt.
Can I map Newforma Konekt fields that don’t exist in Deltek Vantagepoint? For Newforma Konekt fields that don’t exist in Deltek Vantagepoint, create a corresponding custom field in Deltek Vantagepoint. Set the field type to Dropdown and ensure the options match those in the corresponding Newforma Konekt field.
Related Items
- Deltek Vantagepoint Integration Overview
- Step 1: Set Up Deltek Vantagepoint for Integration
- Step 3: Validate Deltek Vantagepoint Integration
