Installing the Customization Package for Acumatica-based ERPs

Created by Damien Zwillinger, Modified on Fri, 1 Nov at 7:38 AM by Pavel Kabir

Applies to:

  • Velixo NX
  • Velixo Classic
  • Acumatica, MYOB Acumatica, Cegid XRP Flex, Jamis Prime, Haufe x360  (v2020 R1 and newer)




*** IMPORTANT ***

Acumatica 2024R1 and 2024R2 require the use of the customization package.




Update: The customization package has been updated to accommodate changes introduced in Acumatica versions 2023R1 and 2023R2 (while continuing to support older versions of the ERP). If you currently use one of these newer versions or are planning to upgrade, you will want to make sure you upgrade your version of customization package.




TABLE OF CONTENTS



Overview


Velixo provides a customization package to facilitate the configuration process for system administrators.  


This package provides several features as well as many valuable integrations within your ERP.  Beyond that, it is only required when using Acumatica 2024R1 or higher.


The package includes the Velixo Connected Application Configuration required for:

  • single sign-on
  • the necessary Generic Inquiries used by Velixo
  • as well as the web services needed for Project Forecast Writeback.

 

It does not customize existing business logic screens (except by adding the Export to Velixo button to the base Generic Inquiry list graph) and is highly unlikely to cause any conflicts as it includes our own custom endpoints for writeback operations.



Already have the customization package installed?

 

This article is about installing the Package for the first time, if you already have the package installed, 

please see: Updating the Customization Package.







 

Downloading and installing the latest Customization Package


Select the correct customization package version depending on your ERP system version:





The customization must be published in every Tenant that will be accessed from Velixo. This is done from the Acumatica Customization Projects page:

 

custom_proj.png


Note: While most versions of the support ERPs allow for a customization to be published to multiple tenants, simultaneously, your version may require that the customization be published to each tenant, individually. 



Integrations within your ERP

Velixo Workspace within your ERP


Publishing the customization will add a Velixo workspace which groups together Velixo-related functionality and useful resources.



Note that the workspace is not visible in the side panel by default, but you can pin it for additional convenience:




Useful Velixo Resources

Velixo inquiries and graphs are present and visible in the workspace:



Note that Velixo workspace includes a resources section which provides a convenient way to access our online Help Center, YouTube channel, and Community Forum.


❗Clicking a button such as Help, Videos, or Community will navigate you away from Acumatica.  If pop-ups are being blocked by your browser, a notification will display in the browser's address box.  You need to allow the pop-up and then click the button again.



Exporting Generic Inquiry data


Each page in your ERP that displays data from a generic inquiry now includes an Export to Velixo Workbook button (the "Blue V button"):



Clicking this button downloads a Velixo workbook with the connection and table-mirrored (full mirroring) GI function connected to that inquiry and opens it in Excel with either Velixo Classic (v7.1.42.33793 or higher) or Velixo NX.


This button is available on all ERP screens that are Generic Inquiries (such as Invoices and Memos, AP Bills, or inquiry result sets from the "View Inquiry" button).



Exporting Import Scenarios


A similar "Blue V" button is available on each Import Scenario screen...



... which creates a Generic Writeback workbook in either Velixo Classic (v7.1.42.33793 or higher) or Velixo NX. 



Velixo NX Integration

For users of Velixo NX, clicking the New Velixo Workbook button...


... downloads a blank workbook with a pre-setup Velixo connection, and opens it in Excel.



If you previously had remembered credentials for the same connection, the file is immediately usable:





But if this is the first time you have logged in to this connection, you simply need to enter your credentials in the automatically displayed Connection Editor:


and click the Connect button






Help with importing and publishing a customization project


Assigning the Velixo Roles to Users

In Acumatica 2024R1 and newer, the inquiries you publish are (by default) not accessible to anyone.


To make the rollout process easier for you, our customization package now includes three roles:

  • Velixo Core - to identify the user in Acumatica, use Generic Writeback, access GI functionality etc.
  • Velixo GL - all financial functionality including GL / Budget writeback
  • Velixo PM - all project functionality including PM Forecast writeback


For more information please see: Configuring access rights



Note: The Velixo Customization package (supported by ERPs based on Acumatica 2020R1 and newer) requires Administrator rights to install in your ERP.  

We highly recommend you coordinate this step with your ERP consultant to avoid accidentally unpublishing other existing projects.

 


For information on how to import and publish a customization project, please refer to Acumatica's documentation:

 

 

New Version of the Customization Project

When your version of Velixo requires a newer version of the customization package than is currently published, an informational message will be displayed when a connection is made to the data. You will then have the option to download the latest version of the project.

 

Using an older version of the Acumatica package will not prevent Velixo from working, but you will not have access to the latest features included in the new version of the package.





Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article