Sana Connector 2.0

Owned by Morten Lindequist Køhler
Feb 14, 2024
2 min read

End of support

Please be advised that Perfion support for Sana Connector 2.0.X has ended in favor of Sana Connector 3.X. If you are in need of support, please upgrade to the newest version of Sana Connector 3.X.

The Perfion/Sana Connector 2.0 is a so called extension to Sana. A concept that was introduced in Sana Commerce SDK version 9.2.0.

What this connector basically does is that it allows products in you ERP-system to be augmented with more and “richer” data coming from Perfion.

Without the Perfion Connector, Sana (depicted very simplistic) works as follows:

Figure 1: Sana connected to ERP System

Sana asks the ERP-system for data, that can be products, product categories, orders, customers etc. etc. and the ERP-system will provide that data. Sana can also create data (orders, customers etc.) but that is not shown in the above figure.

With the Perfion Connector Sana (instead) asks the connector for data and does not go straight to the ERP. In most cases the Connector will just go straight to the ERP-system, which will give the usual behavior, but in a few cases Perfion will augment the data returned from the ERP-system as shown in Figure 2.

Figure 2: Sana connected to ERP system utilizing the Perfion Connector

Mainly it is the “Get Products”-call from Sana, which will have its data augmented heavily from Perfion.

Perfion overrides the behavior of the following calls from Sana:

  • Get Entity Fields (for products only): Here the ERP-system will still be called, but Perfion extends the fields returned from the ERP with whatever fields are created in Perfion. These are so-called “Extra fields” or “Custom fields” in Sana.

  • Get Products: The ERP-system will also here still be called, but the products returned will have their data augmented with data from Perfion. That will be the custom fields, Related Products, Attachments and Images.

  • Get Product Images: This method will be answered by Perfion alone returning the list of images on each product and variant, if any.

  • Get Product Image File: This method is also answered by Perfion alone, returning the binary data for each file returned by Get Product Images previously.

  • Get Attachment File: The Connector assumes that all attachments on products are to be found in Perfion. Attachments are added to products in the Get Products-call, and this method (called by Sana afterwards) will supply the binary data for attachments of file type (as opposed to url-type attachments).

Installation

Installing the connector into a Sana environment is a manual task. For more information about how to do this, please contact your Sana Partner, or the Sana Consultancy team.

 

Read more: