END OF SUPPORT

Add-in for NAV 2009 will still be functional and available, but Perfion does no longer provide support for it.

Perfion ERP Add-in for NAV 2009 allows you to quickly lookup related information in Perfion, from within the Dynamics NAV 2009 environment.

This document describes the configuration of Perfion ERP Add-in for the typical Dynamics NAV 2009 environment.

If you have special use cases or need custom setup tailored to your needs, please contact your Perfion partner for more information.

FAQ regarding installation of Perfion Add-in for NAV

Introduction

Perfion Add-in for NAV allows you to quickly lookup related information in Perfion, from within the NAV environment.

This document will describe the installation and configuration of Perfion Add-in for the typical NAV environment. If you have special use cases or need custom setup tailored to your needs, please contact your Perfion representative for more information.

General Considerations

A Word of Caution

Any changes made to you ERP system should be tested in a proper test environment before being deployed to the live ERP system. Please consult with your Microsoft Dynamics Partner about the changes required to implement this software, before continuing further.

Supported NAV Versions

The following version of Microsoft Dynamics NAV is supported:

Microsoft Dynamics NAV 2009

Supported NAV Clients

The Classic and the Role Tailored Client are supported.

Prerequisites

The client computer needs the following:

Microsoft .Net 4.5 or newer.
Perfion Windows Client Application.

Installation

Installing .Net Assemblies in RTC

Go to Perfion Knowledge Base - Client NAV RTC - Latest version - and download the Perfion Client NAV RTC package.
Once downloaded, locate the file on your computer, right click it, and select Properties.

It should look something like this:

If you are given the option, check the “Unblock” checkbox and press OK.
Unzip the file to a location of your choice.
Locate the Add-ins folder of you Navision RTC client. The default is C:\Program Files (x86)\Microsoft Dynamics NAV\60\RoleTailored Client\Add-ins
Create a new folder in the Add-ins folder called PerfionAdd-in
Copy the unpacked files to the newly created PerfionAdd-in folder.

Defining .Net Assembly Reference in NAV

Open Microsoft Dynamics NAV Classic Client
Locate table 2000000069 Client Add-in and run it
Add a new line and fill in the values as follows:
Control Add-in Name = Perfion.AddIn
Public Key Token = 1fdff5e624d34e41

Make sure to leave the newly created line and close the table to save the values.

Importing Perfion Objects into NAV

Open Microsoft Dynamics NAV Classic Client
Go to the menu File -> Import
Locate the file Perfion.AddIn-2.1.0-[3.5.4785]-[NAV2009].fob and press the “Open” button.

You will get a window that looks something like this:

Press the “Yes” button.

You will get a window that looks something like this:

Press the “OK” button to finish the import.

Configuration

Defining a Connection to Perfion

Open Microsoft Dynamics NAV Classic Client
Locate Form 81003 Perfion Connection List and run it
Add a new line and fill in the values to suit your setup.

Here is a short description of what each column means:

Code: This column is the primary key of the table. It should be filled out with a meaningful string of max 10 characters. It is used in the UI of other pages when selecting a connection.

Connection Type: This column has two possible values: “Direct” and “API”. “Direct” means that the connection will route through the local Perfion Client to connect to the Perfion database. Please note that Perfion Add-in requires a connection type of “Direct”. “API” means that the connection will route through a Perfion Webservice to connect to the Perfion database. Please note that Perfion Release 2 NAV requires a connection type of “API”.

Login Type: This column has two possible values: “WINUser” and “PerfionID”. WINUser is selected when Perfion is configured to accept Windows Users (or Active Directory users) to log in. Otherwise, use PerfionID. When using PerfionID it is assumed that you are logged on to NAV with a username that is identical to a username in Perfion.

Description: A short description of the connection.

Perfion API URL: The full URL to the Perfion API Web Service. This is required for API connections.

Perfion Image API URL: The full URL to the Perfion API Image Server. This is required for API connections.

Setting up a Mapping

Open Microsoft Dynamics NAV Classic Client
Locate Form 81021 Perfion Add-in Mappings and run it
Add a new line and fill in the values to suit your setup.

Here is a short description of what each column means:

Primary Key: This column is the primary key of the table. It should be filled out with a meaningful string of max 10 characters.

Connection Code: Select the connection that will be used for the mapping.

Table No.: Select the table on the NAV side of the mapping.

Table Caption: This will display the table caption of the table on the NAV side of the mapping, once it has been selected.

Languages: This column defines what language or languages to map to, on the Perfion side of the mapping. Multiple language codes should be comma separated. Any mix of language codes that is valid in Perfion, will be valid here.

FromFeature: This is the primary feature on the Perfion side of the mapping.

KeyFeature: This is the sub feature on the Perfion side of the mapping, whose value will be used to match against NAV.

Field No.: This is the field number of the field in the selected table on the NAV side of the mapping, whose value will be used to match against Perfion.

Field Caption: This will display the field caption of the field on the NAV side of the mapping, once it has been selected.

Role: This is the NAV security role, that is allowed to use the mapping. If left empty, everyone will be allowed to use the mapping.

Integrating Perfion on the Item Card Page

Open Microsoft Dynamics NAV Classic Client
Locate Page 81012 Item Card Example and design it
Locate the line that is named PerfionItemCardEditor, right click it and select “Copy”.

Locate Page 30 Item Card and design it
Find the desired location of the PerfionItemCardEditor and press “F3” to insert a new line. Then press “Ctrl + v” to paste PerfionItemCardEditor into place.
Close page 30 and save and compile.

Integrating Perfion on the Item List Page

Open Microsoft Dynamics NAV Development Environment
Locate Page 81014 Item List Example and design it
Locate the line that is named Perfion, right click it and select “Copy”.

Locate Page 31 Item List and design it
Find the desired location of the Perfion Factbox and press “F3” to insert a new line. Then press “Ctrl + v” to paste the Perfion Factbox into place.
Close page 31 and save and compile.

Integrating Perfion on the Item Card Form

Open Microsoft Dynamics NAV Classic Client
Locate Form 81012 Item Card Example and design it
Open the code editor (press F9)
Locate the functions OnOpenForm() and OnCloseForm() and copy the code lines to the destination form

Open local variables in OnOpenForm() and copy the variable shown here:

Insert the local variable in the destination form, in both OnOpenForm() and OnCloseForm()
Locate function OnAfterGetCurrRecord() and paste the lines from 81012 Item Card Example, open then locals for the function and add the following locals:

Save, close and compile the destination form.

FAQ – Know how

The User is not known by Perfion

When interacting with the Addin module it is possible to receive the user is not know in Perfion error message.

The reason to this is that connection to the Perfion client is through windows login, and the Perfion user that is created and in use have not been given a “Windows Domain Username”.

How to fix: there must be created a Windows login in NAV2009 classic client, as well as in Perfion the user that is being used must have a Windows Domain User.

Configure windows login in NAV 2009 Classic client (Tools > Security > Windows Login)
Run “whoami” in CMD to find the Windows user on the machine
Copy and Paste the output
Set role for the Windows login to Super (Roles > Select super).
Create a new Perfion Admin user with windows domain.