{"type":"doc","content":[{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"END OF SUPPORT","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Release2ERP for NAV 2009 will still be functional and available, but Perfion does no longer provide support for it.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Perfion Release2ERP for NAV 2009 allows you to import and persist information from Perfion to the NAV environment.","type":"text"}]},{"type":"paragraph","content":[{"text":"This document will describe the installation and configuration of Perfion Release2ERP for the typical NAV environment.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have special use cases or need custom setup tailored to your needs, please contact your Perfion partner for more information.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"FAQ regarding installation of Perfion Release2ERP for NAV","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":481,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":481,"id":"5c666a8c-cc2b-4d5d-92cf-c387c1e0a1c9","collection":"contentId-244342153","type":"file","height":389}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"Perfion Release2NAV allows you to import and persist information from Perfion to the NAV environment.","type":"text"}]},{"type":"paragraph","content":[{"text":"This document will describe the installation and configuration of Perfion Release2NAV 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.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"General Considerations","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"A Word of Caution","type":"text"}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported NAV Versions","type":"text"}]},{"type":"paragraph","content":[{"text":"The following versions of Microsoft Dynamics NAV is supported:","type":"text"}]},{"type":"paragraph","content":[{"text":"Microsoft Dynamics NAV 2009","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported NAV Clients","type":"text"}]},{"type":"paragraph","content":[{"text":"The Classic and Role Tailored Client (Also known as the Windows client) are supported.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"The Service Layer server (if used) needs Microsoft .Net 4.5 installed.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installation","type":"text"}]},{"type":"paragraph","content":[{"text":"Release2NAV is very simple to install. Just import the Fob file and handle any conflicts you might have.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Release2NAV is a very versatile tool that can be configured to fit many different use cases. In this document, we will show simple examples that illustrate what is possible and discuss the options available.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Basic settings in Release2NAV","type":"text"}]},{"type":"paragraph","content":[{"text":"Run Form 81002 Perfion Setup.","type":"text"}]},{"type":"paragraph","content":[{"text":"You should see a form like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":32.0},"content":[{"type":"media","attrs":{"width":292,"id":"10010d90-98a5-453a-9fa4-b72f3f485cf8","collection":"contentId-244342153","type":"file","height":214}}]},{"type":"paragraph","content":[{"text":"For most, the default values will be perfectly fine.","type":"text"}]},{"type":"paragraph","content":[{"text":"Log","type":"text","marks":[{"type":"strong"}]},{"text":": The log field is where you choose what type of events to log. The options are: Error, Success, All","type":"text"}]},{"type":"paragraph","content":[{"text":"Log Period","type":"text","marks":[{"type":"strong"}]},{"text":": this field is where you set how far back in time the log entries will be kept. It is expressed as a date formula ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://docs.microsoft.com/en-us/dynamics-nav/dateformula-property"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setting up a Perfion Connection for Release2NAV","type":"text"}]},{"type":"paragraph","content":[{"text":"Run Form 81003 Perfion Connections","type":"text"}]},{"type":"paragraph","content":[{"text":"You should see a form like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":484,"id":"f810fcf1-a885-403a-bc96-79dcfd5b72f4","collection":"contentId-244342153","type":"file","height":96}}]},{"type":"paragraph","content":[{"text":"Fill in the fields to match your setup.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code","type":"text","marks":[{"type":"strong"}]},{"text":": This is the code for this connection.","type":"text"}]},{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]},{"text":": Enter a description of this connection.","type":"text"}]},{"type":"paragraph","content":[{"text":"Connection String","type":"text","marks":[{"type":"strong"}]},{"text":": Enter the full URL of the API service. Example: ","type":"text"},{"text":"http://url.com:8080/Perfion/GetData.asmx","type":"text","marks":[{"type":"link","attrs":{"href":"http://url.com:8080/Perfion/GetData.asmx"}}]}]},{"type":"paragraph","content":[{"text":"Image Server","type":"text","marks":[{"type":"strong"}]},{"text":": Enter the full URL of the API Image service. Example: ","type":"text"},{"text":"http://url.com:8080/Perfion/Image.aspx","type":"text","marks":[{"type":"link","attrs":{"href":"http://url.com:8080/Perfion/Image.aspx"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setting up a Release2NAV Integration","type":"text"}]},{"type":"paragraph","content":[{"text":"Run Form 81007 Perfion Integration Card","type":"text"}]},{"type":"paragraph","content":[{"text":"You should see a form like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":484,"id":"714b840b-f915-4afb-8e41-ef85b5e0416b","collection":"contentId-244342153","type":"file","height":135}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The General Section","type":"text"}]},{"type":"paragraph","content":[{"text":"This section contains the general setup elements for the integration.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code","type":"text","marks":[{"type":"strong"}]},{"text":": This is the code for this integration.","type":"text"}]},{"type":"paragraph","content":[{"text":"Connection Code","type":"text","marks":[{"type":"strong"}]},{"text":": Here you select which connection the integration will use to import data.","type":"text"}]},{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]},{"text":": Enter a description of this integration.","type":"text"}]},{"type":"paragraph","content":[{"text":"Last Run Date","type":"text","marks":[{"type":"strong"}]},{"text":": This field is not editable; it will automatically be updated whenever the integration is run successfully.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The Query Section","type":"text"}]},{"type":"paragraph","content":[{"text":"This section contains the settings that are related to the query of the API service.","type":"text"}]},{"type":"paragraph","content":[{"text":"For information about how to write a query, please see the Perfion API documentation.","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition to that: Any instance of %LASTRUN% will be replaced by the Last Run Date value.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an example query:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an overview of the fields in the query section:","type":"text"}]},{"type":"paragraph","content":[{"text":"Query Type","type":"text","marks":[{"type":"strong"}]},{"text":": This indicates the type of query storage used. Currently this is limited to File only.","type":"text"}]},{"type":"paragraph","content":[{"text":"Query File Name","type":"text","marks":[{"type":"strong"}]},{"text":": This is the full path to the text file that contains the query that is sent to the API service.","type":"text"}]},{"type":"paragraph","content":[{"text":"Record Root Node","type":"text","marks":[{"type":"strong"}]},{"text":": XPath that is used as root node in the result set of the query.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The Field Mapping Section","type":"text"}]},{"type":"paragraph","content":[{"text":"This is what we are here for: Mapping data fields from Perfion to data fields in NAV. It is simple, but there are a few things you have to keep in mind.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each line represents one value mapped from Perfion to NAV.","type":"text"}]},{"type":"paragraph","content":[{"text":"To map anything in to a table in NAV, you have to map all primary key fields of the destination table as a minimum.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an overview of the fields:","type":"text"}]},{"type":"paragraph","content":[{"text":"Table","type":"text","marks":[{"type":"strong"}]},{"text":": This is the number of the table that the line is pointing to.","type":"text"}]},{"type":"paragraph","content":[{"text":"Table Caption","type":"text","marks":[{"type":"strong"}]},{"text":": This is the caption of the table that the line is pointing to. When Table No. is changed this is automatically filled in.","type":"text"}]},{"type":"paragraph","content":[{"text":"Field No.","type":"text","marks":[{"type":"strong"}]},{"text":": This is the number of the field that the line is pointing to.","type":"text"}]},{"type":"paragraph","content":[{"text":"Field Caption","type":"text","marks":[{"type":"strong"}]},{"text":": This is the caption of the field that the line is pointing to. When Field No is changed this is automatically filled in.","type":"text"}]},{"type":"paragraph","content":[{"text":"XPath","type":"text","marks":[{"type":"strong"}]},{"text":": This is the Xml XPath to the value that is being imported from Perfion. This is a relative path from the root node that was declared in the Record Root Node field, in the Query section.","type":"text"}]},{"type":"paragraph","content":[{"text":"Validate Data","type":"text","marks":[{"type":"strong"}]},{"text":": This has 3 settings: Blank means no validation. When Different means that the data will be validated if the new value is different from the old value. Always means that the value will be validated every time the integration is run.","type":"text"}]},{"type":"paragraph","content":[{"text":"Accept Max. Length","type":"text","marks":[{"type":"strong"}]},{"text":": When enabled, the value from Perfion will be truncated to the length of the destination field if necessary.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default Value","type":"text","marks":[{"type":"strong"}]},{"text":": This is a constant value that will be inserted in the destination field if no value is was found in the XPath of the data from the API service.","type":"text"}]},{"type":"paragraph","content":[{"text":"Conversion Code","type":"text","marks":[{"type":"strong"}]},{"text":": If this is set to a valid Conversion Code, then the selected conversion will be applied to the value being imported.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setting up a Release2NAV Conversion","type":"text"}]},{"type":"paragraph","content":[{"text":"Run Form 81004 Perfion Conversion Card","type":"text"}]},{"type":"paragraph","content":[{"text":"You should see a form like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":32.0},"content":[{"type":"media","attrs":{"width":314,"id":"9215fecc-c79e-491d-963a-40b57cf298a3","collection":"contentId-244342153","type":"file","height":244}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The General Section","type":"text"}]},{"type":"paragraph","content":[{"text":"This section contains the general setup elements for the conversion.","type":"text"}]},{"type":"paragraph","content":[{"text":"Connection Code","type":"text","marks":[{"type":"strong"}]},{"text":": This is the Connection Code for this conversion.","type":"text"}]},{"type":"paragraph","content":[{"text":"Code","type":"text","marks":[{"type":"strong"}]},{"text":": This is the code for this conversion.","type":"text"}]},{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]},{"text":": Enter a description of this conversion.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The Values Section","type":"text"}]},{"type":"paragraph","content":[{"text":"Here you will find the Conversion Lines. Each line describes one value conversion.","type":"text"}]},{"type":"paragraph","content":[{"text":"The lines have two columns:","type":"text"}]},{"type":"paragraph","content":[{"text":"Perfion Value","type":"text","marks":[{"type":"strong"}]},{"text":": This value is used to compare values from Perfion against. Values are case sensitive and only exact matches are considered.","type":"text"}]},{"type":"paragraph","content":[{"text":"Microsoft Dynamics NAV Value","type":"text","marks":[{"type":"strong"}]},{"text":": If a match has been made then this value is used in NAV.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setting up the NAV Job Queue to run a Release2NAV Integration","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Departments/Administration/Application Setup/Job Queue ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"and choose ","type":"text"},{"text":"Job Queue Entries","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a new Job Queue entry by pressing ","type":"text"},{"text":"F3.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"You should see a page like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":733,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":941,"alt":"image-20250128-125552.png","id":"c7e818b0-7ce3-4e1c-b5ae-63f97635bcf8","collection":"contentId-244342153","type":"file","height":442}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":733,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":916,"alt":"image-20250128-125604.png","id":"95907888-4bda-47f6-8af3-673970e7d88c","collection":"contentId-244342153","type":"file","height":422}}]},{"type":"paragraph","content":[{"text":"The values in the screenshot above is a good starting point, but should obviously be adapted to your needs.","type":"text"}]},{"type":"paragraph","content":[{"text":"Object Type to Run:","type":"text","marks":[{"type":"strong"}]},{"text":" this should be set to Codeunit","type":"text"}]},{"type":"paragraph","content":[{"text":"Object ID to Run","type":"text","marks":[{"type":"strong"}]},{"text":": this should be set to 81005 (Perfion Data Management)","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameter String:","type":"text","marks":[{"type":"strong"}]},{"text":" this should be filled in with the Code of the Release2NAV Integration that you wish to run.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The remaining settings will need to be set according to your wishes.","type":"text"}]},{"type":"paragraph","content":[{"text":"When you are satisfied with everything, press the button ","type":"text"},{"text":"Set Status to Ready","type":"text","marks":[{"type":"strong"}]},{"text":" and your scheduled job is now activated.","type":"text"}]},{"type":"paragraph","content":[{"text":"Last, press the ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":" button to close the window.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"32710afd-b1af-4fde-9de7-f0cdde99257c"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"f7d12156-e1e2-4fbd-8225-50b8dd40ae1a"}}]}]},{"type":"paragraph"}],"version":1}

Browser not supported