Attachment Migration in Sage X3

By | August 30, 2021

In sage X3, you can add an attachment to entities like product, site, company and also you can add to transactions like sales order, delivery etc. Sage x3 provides functionality to maintain the attachment in an organized folder (Volume).

The attachment management function uses volumes, i.e. folders which already been added in X3. For each file, the path of an attachment is expressed with the following mandatory syntax: [VOL]/path, where VOL is a volume name, and path is the file path in the volume.

When you run Attachment management for the first time, it runs a check on the attachment tables. Once this analysis is done, a screen with two grids displays:

First grid: Files

The first grid lists the results of the AOBJTXT analysis. The first column displays either of the three following messages:

Anomalies: This message displays the reason for the error. The most common is “path starting with #”. This means that local attachments have been encountered. The number of files in this situation is displayed.

Validated: This message displays the number of files already assigned to volumes.

Volume doesn’t exist: This message displays directory paths that are not assigned to a volume. The number of attachments is displayed.

The total number of attachments is displayed at the bottom of the grid. Click Detail next to a result to create a log that gives you details regarding the corresponding results.

Second grid: Volumes

The second grid allows you to define actions for each result.

The first part of the grid displays the list of directories that are not assigned to a volume yet. Below are the option available:


If set to “Yes”, a volume is created with the name given, and assigned to a path that can be modified if a shorter path needs to be used. If set to “No”, no volume is created.


This can be set to “Yes” only if Create was set to “No”. You can then enter an existing volume name, and the corresponding attachments will be renamed with the corresponding volume, according to the document definition.

The code corresponds to the name of the volume to be used or created. The path corresponds to the volume to be created. It can only be entered if Create was set to “Yes”.

Click Validation to run the creation or modification. Triggers the updates according to the date entered in the second grid. When the operation is finished, the page displays with all issues that remain in the first grid.

Fig : Attachment

The following actions are available in the right-hand panel:

Refresh: Re-launches the analysis for the existing attachments and displays the results. It can be helpful if manual modifications have been performed at the attachment level.

Log: Displays the log file describing the operations done after validating changes.

Control files: Checks if the attachments can be physically found at their intended locations.

A recodification tool was created to help you replace all the existing operating system paths with a normalized path, based on a volume.

Hope this blog helps you in managing attachment.

About Us

Greytrix – a globally recognized and one of the oldest Sage Development Partner is a one-stop solution provider for Sage ERP and Sage CRM organizational needs. Being acknowledged and rewarded for multi-man years of experience, we bring complete end-to-end assistance for your technical consultations, product customizations, data migration, system integrations, third-party add-on development and implementation competence. 

Greytrix caters to a wide range of Sage X3, a Sage Business Cloud Solution, offerings. Our unique GUMU™ integrations include Sage X3 for Sage, Dynamics 365 CRM and Magento eCommerce along with Implementation and Technical Support worldwide for Sage X3. Currently we are Sage X3 Implementation Partner in East Africa, Middle East, Australia, Asia, US, UK. We also offer best-in-class Sage X3 customization and development services, integrated applications such as POS | WMS | Payment Gateway | Shipping System | Business Intelligence | eCommerce and have developed add-ons such as Catch – Weight  and Letter of Credit and India Legislation for Sage X3 to Sage business partners, end users and Sage PSG worldwide. Greytrix Sales Commission App for Sage X3 simplifies commission calculations and postings on sales transactions.

The GUMU™ Cloud framework by Greytrix forms the backbone of cloud integrations that are managed in real-time for processing and execution of application programs at the click of a button.

Greytrix is a recognized Sage champion ISV Partner for GUMU™ Sage X3 – Sage CRM integration also listed on Sage Marketplace; GUMU™ integration for Sage X3 – Salesforce is a 5-star rated app listed on Salesforce AppExchange and GUMU™ integration for Dynamics 365 CRM – Sage ERP listed on Microsoft AppSource.

For more information on Sage X3 Integration and Services, please contact us at, We would like to hear from you.