Entity Mapping/Import
The web services and values defined in the Entities tab are available in the next tab, Entity Mapping/Import. This screen allows users to import ERP fields from Sage. Customers for example along with their respective contacts can be imported into Salesforce Accounts and Contacts. The import routine can be run as needed or automated to a set schedule.
Login into Salesforce, navigate to the GUMU™ Settings app and click on the Entity Mapping/Import tab (you will notice default mappings that were created during the installation process)
Note: If you are unable to click the buttons, go to Session Settings > Lightening Web Security and uncheck the Use Lightning Web Security for Lightning Web components and Aura components checkboxes
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FoQ05qc4nDWL3xqwXi4wf%252F1.png%3Falt%3Dmedia%26token%3D8ec6494e-c25c-4afe-9551-acfb5c1cf560&width=768&dpr=4&quality=100&sign=af56aa17&sv=1)
You need to sync the import routines one by one, to do this click the blue eye icon to view and then click the Sync Now button.
The Sequence in which the Import routines should be synchronized are as follows:
UOM
TaxCalss
Warehouse
SalesPerson
ShipVia
TermsCode
PaymentType
ARDivision
ShipMethod
TaxSchedule
ProductFamily
Products
PricebookEntrySTD
PricebookEntry
Customer
Contact
Ship_to
DefaultShipTo
Order
OrderLines
ARItemProducts
You can sort the import routines based on type.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FJ6ClkhjMOM0XwYF76QiZ%252F2.png%3Falt%3Dmedia%26token%3D14189703-ce46-4c5d-8f52-05866c564da1&width=768&dpr=4&quality=100&sign=51a2090e&sv=1)
Entity Mapping/Import Filter Types
Filter | Description |
---|---|
All | This filter will display all the import routines. |
Configuration | This filter will display regular imports which are designed to synchronize related data necessary for the master data import or creation process. |
Master | This filter will display importing details about key entities such as Contacts, Customers, and Products. |
Transaction | This filter will display importing details of financial or business activities. |
To view the entity you want to import (here we have selected the Entity Customer), under the Action panel click the blue eye icon
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FPM3Ra4pmCdgxzlQS8lr4%252F3.png%3Falt%3Dmedia%26token%3Db9f9b610-32ad-44c5-8a31-793f79420dea&width=768&dpr=4&quality=100&sign=5d4a8b17&sv=1)
A new page will open in the Header section consisting of the following fields
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252F0YP2hQw9NQ1jejWXlt73%252F4.png%3Falt%3Dmedia%26token%3Da31cf20a-0e50-43d7-a0eb-f276dd777080&width=768&dpr=4&quality=100&sign=97f9d06a&sv=1)
Entity Mapping Fields
Fields | Detail |
---|---|
Entity Mapping Name | Specify the Name for the Entity import routine. |
Description | This field will give an overview of the import routine. |
Salesforce Object | Salesforce Object’s API name where you want to import your data to. |
Sage Entity | The Sage Entity created where you want to import data from. |
Chain Next | Specify the next import routine to be run (as per the image above, Contact import will run once Customer has been imported successfully) |
Type | This is an auto populated field that will display the filter type selected (in the image above the filter type Master was selected) |
Active | Check to keep the current mapping Active |
Default for promotion | Checking this checkbox for the import routine it will only be used for promotion, not for importing |
Last Sync Field | |
Last Sync Value | |
Size | Specify the size for the records to be fetched from Sage |
To schedule Import Routines, under the Action panel click on the green pencil icon to edit.
Click on the Schedule button at the top right and a new screen will appear as shown.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FRD6k55QT6CQZVGlJ5JYo%252F5.png%3Falt%3Dmedia%26token%3D17789851-e918-472b-86f1-2fc05d83b20c&width=768&dpr=4&quality=100&sign=4db4e513&sv=1)
Set the Next Run Date & Time select Schedule Type as Hourly/Daily/Weekly/Monthly and click on the Save button (you can see the Previous Run Time when the current import routine runs)
To skip a schedule for a specific time, use the Skip Schedule tab, enter the start time and end time, and click Save.
Export Mapping
If you want to add the mapping to a different Salesforce Org without creating it manually, you can now Export the mapping from one org to another (e.g., Sandbox to Production)
Select the entity mapping you want to export and click on the Export Mapping button.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252F67U2Wly0v5eH23ejAI2r%252F6.png%3Falt%3Dmedia%26token%3D66dc8d95-aede-4160-a3b9-7508acc8f4f3&width=768&dpr=4&quality=100&sign=b3c96953&sv=1)
The selected Entity Mapping file will download immediately.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FnXwuvuPrEN2cm8zcMw4C%252F7.png%3Falt%3Dmedia%26token%3Db03e5ec4-8631-4365-8107-3641a4cd61f9&width=768&dpr=4&quality=100&sign=88647cdf&sv=1)
The next step is to log in to the other Org (Here we are showcasing in the same Org) and navigate to the Entity Mapping/Import tab, click the Import Mapping button, then click the Upload File button to upload the file.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FOBikKk24Exc3K8tWBWbS%252F8.png%3Falt%3Dmedia%26token%3D9cc0038c-cabe-49ae-a22f-d7346b1301bc&width=768&dpr=4&quality=100&sign=1e93f9e7&sv=1)
After the file uploads, the user needs to click on the “Import” button. This will start the internal processing and once done user will be notified with a success message.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FhEelOoxl28MMojJMq8qv%252F9.png%3Falt%3Dmedia%26token%3Dc536d46d-64bf-4697-9f73-7a76c3b7ffe5&width=768&dpr=4&quality=100&sign=ad4619fa&sv=1)
Details Tab
Navigate to the Details tab and click on the Mappings tab, here you can map the Sage fields with Salesforce fields (add additional mappings by clicking on the Edit button followed by the Refresh Fields button at the top).
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252Fsmbhvob3PKHjy5HZgOkO%252F10.png%3Falt%3Dmedia%26token%3D5a949d9f-84d7-438b-91f8-1ae2fdd74337&width=768&dpr=4&quality=100&sign=bc59a4a9&sv=1)
Navigate to the Filter tab, here you can add a filter to the import routine if you want to import specific data (for example, we have filtered the import routine based on the Customer No 0000010), and click Save.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FmOlT5XdkIaFLlapLYQRz%252F11.png%3Falt%3Dmedia%26token%3D6e293ba4-0b4d-4e09-9a53-b2d76504f394&width=768&dpr=4&quality=100&sign=4f81cee0&sv=1)
Click on the Preview button at the top to view the data from Sage, then import by clicking the Sync Now button present next to the Preview button.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FC7jXnyTTSlmwICc6J9ru%252F12.png%3Falt%3Dmedia%26token%3D81903883-9b5a-4dbe-a9b3-213d7b5c587a&width=768&dpr=4&quality=100&sign=dcee0330&sv=1)
The Relationship tab allows you to specify Parent-Child relationships (for example, Contact will always have a relationship with Account which we can define here).
You can set up a Relationship to Sync if the target object has a parent in Salesforce (for example, Account-Contact)
To add a relationship, click on the Add Row button, and select the Target, Source Field, and Parent Object Name from the list of Salesforce Objects (for example, Account is the Parent Object of the Contact object in Salesforce).
In the Logs tab, you can view the status of the import/sync.
![](https://docs.greytrix.com/~gitbook/image?url=https%3A%2F%2F794987320-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MCRVg-TYx3gVa2Tqtf_%252Fuploads%252FDh7kmx7ri6tYt04So4v5%252F13.png%3Falt%3Dmedia%26token%3D84c8bf5e-4318-4b5e-b437-e79bb0b0d5ee&width=768&dpr=4&quality=100&sign=db6c4cd9&sv=1)
Last updated