Agnostic Guides
...
Solution Guide
DocMigrator

Execution: Load

7min
loading the migration table sets the stage for what content is to be migrated and from what source (a gimmal link endpoint, file, sap content server, sap db) any sap repository id or doctype mapping (via configuration) where the content is to be migrated to (ie what gimmal link endpoint repository id) this can be done using 3 separate "source" methods archivelink links csv file containing file references and required archivelink data custom abap class method content stored in your sap database regardless of the method used, it is highly recommended to enter a useful descriptor/tag that identifies this migration run you can run the load process in test mode without making any chances to the load table the results of the load phase are displayed on the screen according to the option "display results in alv" checkbox if this option is chosen, all entries are displayed in the alv report format, else a simple message indicating the number of entries loaded successfully, with info message, or errors is displayed if alv is chosen, the header will display information as to the breakdown of entries loaded successfully, with info message, or errors be careful when choosing "display results in alv" as for large datasets this will significantly increase runtime and potential sap system memory usage and timeouts it is therefore suggested to use the "display" mode of the migrator afterwards instead of displaying the results in alv format clicking on the source or target hotspot/hyperlink in the alv allows you to view the image the docmanager rule and/or metadata mapping does not happen at the load stage this is done in the migrate phase no additional flags are set at this stage, as the load phase creates the entries in the migration table archivelink links this method relies entirely on existing link entries in your archivelink link tables (toa01, etc) specify the parameters in the section "source archivelink selection criteria" to determine which entries will be read by the docmigrator each entry found will equate to an entry in the load table before writing the entry to the load table, docmigrator reads the docmigrator configuration to determine repository id and doctype mapping the source of this content must be accessible through an archivelink content server or equivalent to be read csv file this method relies entirely on an input csv file that you compile yourself to add entries to the migration table the source type of these entries are data files only (ie you cannot use this method to load archivelink link entries into the migration table) the csv file must follow the below columns, in order sap object object id archiv id arc doc id ar object ar date del date (optional) reserve (this must align with your viewing platform, thus either or file extension) source file path source file name these files must be accessible by the docmigrator program, be sure to take into consideration if the migration run will be executed in the background (and therefore the files must be accessible by the sap server) custom abap class method this method relies entirely on an abap class method that you can develop yourself to add entries to the migration table, which takes the form of archivelink links refer to /dflow/cl migrator helper=>get abap links example for an example of this logic the custom class method must set the following archivelink source ev source type = "a" for archivelink content server = "d" for gimmal link ecm sap object object id archiv id arc doc id ar object ar date del date (optional) reserve (this must align with your viewing platform, thus either or file extension) sap database with the information available to us for this as a source being limited, this method relies on specifying and sap business object and the corresponding object id "range" not that as part of the load phase, unlike the other sources, mime type and therefore extension (reserve) will not be known until migration is executed (or even in validation mode) an example would be "equi" for equipment, and then specifying the object id "range", ie the equipement numbers that you like to migrate the content for select either/both attachments or notes options the sap object and object id (the sap key) are optional if you are unsure of what is in your database, you can run this wide open to see!