Table of Contents

Installation and setup

Pimics works as an extension for Microsoft Dynamics Business Central or Dynamics NAV. There are several possible scenarios for installing Pimics, but the two most important criteria are:

Availability

Pimics is available for either cloud or on-premises installations of Business Central. You can use different versions of Business Central on your servers. Please keep in mind that we support only the latest three versions of Business Central, which follows the same maintenance-period policy as Microsoft. Each new major version of Pimics is also released for the previous two Business Central versions. Older versions do NOT receive new functionality, and we only fix critical issues there.

Packages

Name AppSource Description License Granule (on-premise license)
Allium Core Not available standalone in AppSource Contains shared code and functions across all Allium's extensions. There is no visible function to users
Pimics PIM Link This extension covers most PIM functionality. It is used for managing product data and publishing to channels Pimics 365
Pimics on-premise Not listed in AppSource Contains functionality for working with files stored in internal servers Allium catalog - MDM
Pimics - Vendor Catalog Link This extension contains functionality for importing and managing data from vendors Allium Catalog - Purchase Catalogue
BMECat for Pimics Link This extension contains functionality for importing and exporting BMECat files Allium Catalog - Integration
DataNorm for Pimics Link This extension contains functionality for importing and exporting DataNorm files Allium Catalog - Integration

For a complete overview, see Pimics in AppSource.

Business Central runs as SaaS

This is the easiest way. Go to AppSource and find the Pimics extension. Alternatively, you can start from Business Central, access the Extension Marketplace, and search for Pimics. Either way, you just need to follow the installation wizard to install Pimics.

Assisted setup

The easiest way to start with Pimics after installation is to use Assisted Setup. This helps you set up the default configuration and migrate any required data from standard BC.

  1. Using Alt+Q, search for assisted setup and open the relevant link
  2. From the list select Set Up Pimics in the Pimics category
  3. After reading the initial information, select Next to move to the next page
  4. On the language page, define your main language in the Default Language Code field. You can also define as many secondary languages as you need for your catalog on the Pimics FastTab. Select Next to move to the next page.
  5. The initial option for the digital assets repository is Database. If you are just evaluating Pimics or doing some tests that do not involve a significant amount of file-type data, this option is fine. If setting up a production instance of Pimics, please set up a proper repository for your digital asset files. Our first recommended option is SharePoint. See more here: SharePoint setup
  6. In Sales & Marketing Channels you can create the channels where you’d like to offer your products. They can be for example WEB, PRINT, etc., and also region or industry specific. Select Next to move to the next page
  7. In Pimics Users you will specify which users will work with Pimics, and you should also assign licenses to them. For more details about Pimics licensing, please see the User License & Permissions section. Select Next to move to the next page.
  8. Here you can select which data from existing items in Business Central will be overtaken to Pimics. Usually, it is safe to select all fields. Select Next to move to the next page.
Note

It can happen that Pimics cannot overtake all existing item data because something is missing in the current configuration. In case you get an error message about this, please run the setup again and do not select overtaking the data.

  1. Select Finish to create records and prepare your Pimics instance

Business Central runs on-premise

First, download the relevant packages:

Note

If you cannot access the repository, please ask your partner or account manager to give you access, or you can also write to info@pimics.com.

New customers

Before you can install Pimics, we need to extend your license. For this, we need to contact the Microsoft partner company that manages your BC license.

Install Pimics on-premise

Pimics on-premises also contains additional libraries that must be installed before the extension. Follow this process:

Note

Pimics contains only system libraries, so in many cases you do not need to copy the add-in folder. If you see an error that a package is missing, follow the steps below.

  1. Go to Release > Add-ins
  2. Download all DLL files from the folder
  3. Go to folder C:\Program Files\Microsoft Dynamics NAV\{YourBCVersion}\Service\Add-Ins\ and create there an Allium folder
  4. Move all DLL files to the Allium folder
  5. Repeat steps 3 - 4 for all BC servers
  6. Restart all Business Central services
  7. Install the extension

Dependencies

For on-premise installations, packages need to be installed in the following order

  1. Allium Core
    1. Pimics PIM
      1. Pimics on-premise (if needed) See Install Pimics on-premise
      2. Pimics - Vendor Catalog (if needed)
        1. DataNorm for Pimics (if needed)
        2. BMECat for Pimics (if needed)

PowerShell scripts for installation

The Pimics user role

After installing and setting up Pimics, you need to configure access for product managers, or any other users who will manage product information. To do this, you must assign them the Pimics role in Business Central: in Settings > My Settings modify the role to Pimics.

setup-install-1

After logging in again, the user is presented with a home page related to Pimics functionalities and statistics:

setup-install-2

Here you have everything you need to take advantage of the Pimics functionality. Enjoy!