{"id":22340,"date":"2026-07-30T11:42:02","date_gmt":"2026-07-30T11:42:02","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=22340"},"modified":"2026-08-13T04:51:00","modified_gmt":"2026-08-13T04:51:00","slug":"how-to-use-export-processor-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-use-export-processor-in-idempiere\/","title":{"rendered":"How to Use Export Processor in iDempiere"},"content":{"rendered":"\n

Learn how the Export Processor window in iDempiere configures replication delivery, connecting an Export Processor Type to a Replication Strategy.<\/p>\n\n\n\n

Introduction<\/strong><\/h2>\n\n\n\n

The Export Processor window in iDempiere defines the destination used to deliver replication data after an XML document has been generated. It does not create the XML itself; it acts as the runtime configuration that tells the replication engine how and where to send it.<\/p>\n\n\n\n

This window is used within standard iDempiere replication and data-exchange processes, typically by Distribution, Wholesale, and multi-branch organizations that synchronize records such as Business Partners between systems.<\/p>\n\n\n\n

It directly impacts business operations by determining whether replicated transactions are successfully delivered to an external file, folder, or messaging destination.<\/p>\n\n\n\n

Process Flow<\/strong><\/h2>\n\n\n\n

<\/p>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • Export Processor must be Active to be available for use.<\/li>\n\n\n\n
  • An Export Processor must reference an Export Processor Type.<\/li>\n\n\n\n
  • The selected Export Processor Type determines which Java class executes the export.<\/li>\n\n\n\n
  • Replication Strategy must reference an Export Processor to enable replication.<\/li>\n\n\n\n
  • Different Export Processor Types require different runtime parameters.<\/li>\n\n\n\n
  • The HDD Export Processor requires runtime parameters to determine the output file location.<\/li>\n\n\n\n
  • Host, Port, Account, and Password fields are available for processors that require connection details.<\/li>\n\n\n\n
  • The standard HDD Export Processor does not use the Host, Port, Account, or Password fields.<\/li>\n<\/ul>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n
      \n
    • An Export Processor Type must be created and linked to a valid Java processor class.<\/li>\n\n\n\n
    • The Export Format required for the replicated table must already be configured.<\/li>\n\n\n\n
    • A Replication Strategy must exist so the Export Processor can be assigned to it.<\/li>\n\n\n\n
    • The destination location (for example, a server folder) must be accessible and writable.<\/li>\n\n\n\n
    • The Client must have ExportModelValidator configured as a Model Validation Class.<\/li>\n<\/ul>\n\n\n\n

      Configuration Steps<\/strong><\/h2>\n\n\n\n

      Step 1: Create an Export Processor Type<\/strong><\/h3>\n\n\n\n

      This step is required to register the Java class that will perform the actual export. Without a processor type, no Export Processor can be created.<\/p>\n\n\n\n

      Navigate to Replication \u2192 Export Processor Type and create a new record. Provide a Search Key, Name, and the Java Class that implements the export logic, then save the record.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Tenant<\/td>GardenWorld<\/td>Tenant that owns the Export Processor Type<\/td><\/tr>
      Organization<\/td>*<\/td>Organization scope of the record<\/td><\/tr>
      Search Key<\/td>HDD Export Processor Type<\/td>Unique identifier for the processor type<\/td><\/tr>
      Name<\/td>HDD Export Processor Type<\/td>Display name of the processor type<\/td><\/tr>
      Description<\/td>Adempiere HDD Export Processor Type<\/td>Optional descriptive text<\/td><\/tr>
      Active<\/td>Checked<\/td>Enables the processor type for selection<\/td><\/tr>
      Java Class<\/td>org.adempiere.process.rpl.exp.HDDExportProcessor<\/td>Java class that executes the export<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Step 2: Create an Export Processor<\/strong><\/h3>\n\n\n\n

      This step creates the runtime processor configuration that the Replication Strategy will use. It links the processor type to a named, reusable configuration record.<\/p>\n\n\n\n

      Navigate to Replication \u2192 Export Processor and create a new record. Enter a Search Key and Name, then select the Export Processor Type created in Step 1. Save the record.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Tenant<\/td>GardenWorld<\/td>Tenant that owns the Export Processor<\/td><\/tr>
      Organization<\/td>*<\/td>Organization scope of the record<\/td><\/tr>
      Search Key<\/td>HDD Export Processor1<\/td>Unique identifier for the processor<\/td><\/tr>
      Name<\/td>HDD Export Processor1<\/td>Display name of the processor<\/td><\/tr>
      Export Processor Type<\/td>HDD Export Processor Type<\/td>Selects the processor implementation<\/td><\/tr>
      Description<\/td>HDD Export Processor Description<\/td>Optional descriptive text<\/td><\/tr>
      Active<\/td>Checked<\/td>Enables the processor for selection<\/td><\/tr>
      Host<\/td>192.168.0.183<\/td>Connection information used by some processor types<\/td><\/tr>
      Port<\/td>(blank)<\/td>Connection information used by some processor types<\/td><\/tr>
      Account<\/td>(blank)<\/td>Authentication information used by some processor types<\/td><\/tr>
      Password Info<\/td>(blank)<\/td>Authentication information used by some processor types<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Step 3: Configure Processor Parameters<\/strong><\/h3>\n\n\n\n

      This step provides the processor-specific runtime values that the selected Export Processor Type needs to deliver the XML. Required parameters differ by processor type.<\/p>\n\n\n\n

      In the Export Processor Parameter tab, add a row for each required parameter. For the HDD Export Processor, enter the fileName and folder parameters with their values, then save.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Search Key<\/td>fileName<\/td>Parameter name expected by the HDD processor<\/td><\/tr>
      Search Key<\/td>folder<\/td>Parameter name expected by the HDD processor<\/td><\/tr>
      Name<\/td>Name of file to export<\/td>Descriptive label for the parameter<\/td><\/tr>
      Parameter Value<\/td>BusinessPartner.xml<\/td>Output XML file name<\/td><\/tr>
      Parameter Value<\/td>\/home\/dev078\/Downloads\/<\/td>Destination folder for the output file<\/td><\/tr>
      Active<\/td>Checked<\/td>Enables the parameter for use at runtime<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      The processor combines the folder and fileName values to determine the output file location. The folder value should end with a directory separator so the resulting path is valid. If a required parameter such as fileName is missing, the processor cannot write the XML.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Step 4: Assign the Export Processor to a Replication Strategy<\/strong><\/h3>\n\n\n\n

      This step connects the processor configuration to the replication process. Replication cannot deliver data unless a Replication Strategy references a valid Export Processor.<\/p>\n\n\n\n

      Open the Replication Strategy window, select the target strategy, and choose the Export Processor created in Step 2 from the Export Processor field. Save the record.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Search Key<\/td>Example POS<\/td>Unique identifier for the Replication Strategy<\/td><\/tr>
      Name<\/td>Example POS Replication Strategy<\/td>Display name of the strategy<\/td><\/tr>
      Export Processor<\/td>HDD Export Processor1<\/td>Export Processor used when this strategy runs<\/td><\/tr>
      Active<\/td>Checked<\/td>Enables the strategy for replication<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Once saved, the strategy uses the selected Export Processor whenever a record configured in its Replication Table is created, updated, or completed.<\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n
      Issue<\/strong><\/td>Cause<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
      Export Processor not available for selection<\/td>The record is not Active<\/td>Verify the Export Processor record is marked Active<\/td><\/tr>
      Processor cannot execute<\/td>Export Processor Type does not reference a valid Java class<\/td>Verify the Java Class field points to a valid, deployed processor implementation<\/td><\/tr>
      XML not written by the HDD processor<\/td>fileName or folder parameters are missing or incorrect<\/td>Verify the parameters are configured correctly and the server has write permission to the destination directory<\/td><\/tr>
      Replication does not export data<\/td>Replication Strategy does not reference the correct Export Processor<\/td>Verify the Replication Strategy points to the intended Export Processor<\/td><\/tr>
      No export occurs at all<\/td>Client is not assigned the Replication Strategy or ExportModelValidator is not configured<\/td>Confirm the Client has the Replication Strategy assigned and ExportModelValidator set as a Model Validation Class<\/td><\/tr>
      Wrong file delivered to the wrong location<\/td>folder parameter does not end with a directory separator<\/td>Update the folder value so it ends with a valid directory separator<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Next Steps<\/strong><\/h2>\n\n\n\n
        \n
      1. Assign the configured Export Processor to the relevant Replication Strategy.<\/li>\n\n\n\n
      2. Configure the Export Format required for the tables being replicated.<\/li>\n\n\n\n
      3. Ensure the Client is assigned the Replication Strategy and ExportModelValidator.<\/li>\n\n\n\n
      4. Perform an end-to-end replication test to confirm XML generation and delivery.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"

        Learn how the Export Processor window in iDempiere configures replication delivery, connecting an Export Processor Type to a Replication Strategy. […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,91],"tags":[],"class_list":["post-22340","post","type-post","status-publish","format-standard","hentry","category-idempiere-product","category-idempiere-general-rules"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22340","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=22340"}],"version-history":[{"count":1,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22340\/revisions"}],"predecessor-version":[{"id":22345,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22340\/revisions\/22345"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=22340"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=22340"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=22340"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}