Run your migrations

AOBulk is a tool that allows you to migrate files and folders into your AODocs libraries.

Important: AOBulk is currently available for our service teams only. For EAP access, contact dev-migration@altirnao.com

This article explains how to run your migrations:

 Choose the type of migration to run 
 Extract details of your source data and migration setup
 Common options for all migration types
 Run migrations from a local file system
 Run migrations from a Google Drive folder
 Run migrations from Lotus Notes
 Run migrations from SharePoint
 Run migrations “from scratch” using a Google spreadsheet

 


Choose the type of migration to run

Choose the type of migration to run from the AOBulk homepage. A configuration screen opens.

Tip: When you have started a migration, you can monitor its progress in the migration panel.

image01.png


Extract details of your source data and migration setup

Before running your migration, you can analyse your source data and extract details about the migration. This gives you an idea of how to proceed when you run your migration.

Note: You can’t run an extraction of a manually-created Google spreadsheet or a Google Drive migration.

To run an extraction:

1. You must define your source data in the configuration screen:

2. Optionally, you can:

3. Press Extract. An extraction spreadsheet opens, providing details of your source data and migration, according to the options you selected in the configuration screen.

Note: The extraction spreadsheet is identical to the migration spreadsheet, but you can’t use it for migration. The extraction and migration spreadsheets are generated in exactly the same way, according to the options you select in the configuration screen.

Common options for all migration types

The following options are identical for all migration types.

1. In the Drive box, choose:

Important: Don’t use your AODocs storage account as an uploader account when you run a migration for the first time. AODocs storage accounts are used only for incremental migrations.

  • which (if any) Microsoft Office files to convert to Google format

Note: You can convert XLS, XLSX, DOC and DOCX files.

2. In the AODocs box, choose:

  • the target AODocs library
  • the document class (for all migration types except SharePoint)

Notes:
– For SharePoint migrations, you usually don’t need to select a document class because the CLASS_NAME column in the spreadsheet is populated with SharePoint’s Content Type. However, you can select a document class: if there are any missing Content Type values in the source data or if you remove a value from a CLASS_NAME cell, the document will be imported into the class you selected in the configuration screen.
– For all other migration types: if you select a document class, the spreadsheet doesn't contain a CLASS_NAME column (all documents will be imported into the document class you selected). If you don’t select a document class, the CLASS_NAME column in your migration spreadsheet is empty and you must fill it in manually.
– Learn more: CLASS_NAME column.

3. Under Additional migration details, you can enter a name for your migration so it is easily identifiable in the migration panel. If you don’t enter a name, the last four characters of the ID are used.


Run migrations from a local file system

1. Select the file system button in the main AOBulk screen. The configuration screen opens.

image02.png

2. In the File system box, manually enter the absolute path of the local folder you want to migrate.

Note: If you enter a folder that doesn’t exist, an error message appears.

3. Fill in the common options for all migration types.

4. For most file system migrations, there’s no versioning. However, if you’re migrating from a Windows server with versioning, you can select how many previous file versions to migrate in the Versions drop-down menu.

Note: The option Allow huge migrations isn’t currently available.

5. Press Start your migration to create a migration spreadsheet (extraction phase).

Note: After the extraction phase, the migration proceeds automatically to the upload phase, during which your source files are uploaded to the My Drive of your uploader account. Learn more: What is AOBulk?

6. Open the migration spreadsheet from the message that appears on your screen.

Tip: You can also open the migration from the box in the migration panel.

7. Make any required changes to the migration spreadsheet during the extraction and upload phases.

Important: Don’t change the attachments because they’re in the process of being uploaded.

8. Refresh the migration panel to follow the progress of your migration.

9. When your migration is in the setup phase, press the Check’n run button to continue with the migration. When the migration is complete, it moves to the Report column.

Note: If there are any errors during the creation of your files in AODocs, your migration stays in the Creation column and error messages are displayed. 


Run migrations from a Google Drive folder

Important:
– You can't migrate files that are shared with you in Google Drive. You must own all the files you migrate.
– For Google Drive migrations, you can't extract details of your source data and migration setup before running your migration.

1. Select the Google Drive button in the main AOBulk screen. The folder selection screen opens.

2. Select the Google Drive folder you want to migrate.

image03.png

3. Press Select. The configuration screen opens.

image04.png

4. Fill in the common options for all migration types.

Notes:
– For Google Drive migrations, leave the Versions option set to the default No versioning
– The options Skip permissions and Allow huge exports aren’t currently available.

5. Press Start your migration to create a migration spreadsheet. Follow from step 5 of the file server migration procedure.


Run migrations from Lotus Notes

Note: Before running a migration from Lotus Notes, you must export your data from Lotus Notes. A local folder is created, which you then import into AODocs using AOBulk.

1. Select the Lotus Notes button in the main AOBulk screen. The configuration screen opens.

image05.png

2. Enter the local path of the Lotus Notes folder you want to export and press Validate. A message opens indicating that AOBulk is loading Lotus Notes forms.

3. The Lotus entities drop-down list is populated with the list of forms in your selected folder. The number of documents in each form is indicated in the list. 

Note: Forms in Lotus Notes are the equivalent to document classes in AODocs.

By default, nothing is selected in the Lotus entities list and all forms are exported. If required, select the forms you want to export. 

4. Press Start your migration to create a migration spreadsheet. Follow from step 5 of the file server migration procedure.


Run migrations from SharePoint

1. Select the SharePoint button in the main AOBulk screen. The configuration screen opens.

image03.png

2. In the SharePoint box:

  • enter your SharePoint username and password
  • (if you’re using online SharePoint) enter your SharePoint URL

or (if you’re using SharePoint 2013 or 2016) deactivate the switch and enter your local SharePoint URL

3. Press Validate next to the SharePoint URL.

4. If you’re a SharePoint super admin you can:

  • press Export structure to generate a spreadsheet listing the SharePoint sites and lists you have access to (depending on the SharePoint URL you entered). The SharePoint structure spreadsheet contains the following information:

image04.png

  • select the required SharePoint site from the drop-down list, which lists all sites available from the SharePoint URL you entered

5. Select one or more SharePoint lists from the drop-down menu.

Tip: You can filter the list using the drop-down menu.

6. In the Options box, you can select the number of previous versions of files to include in the migration. If you don’t use versioning in SharePoint, leave the default No versioning. Learn more: VERSION column.

7. In the Options box, choose whether to enable the cache:

  • Enable the cache (default): when documents are being created in AODocs, the responses from SharePoint are stored in cache. This avoids having to make multiple calls to Sharepoint, so the migration process is faster. However, if you run incremental SharePoint migrations you must clear the cache manually to be able to identify which source files have been changed since you ran the last migration.
  • Don’t use cache: when documents are being created in AODocs, the responses from SharePoint aren’t stored in cache, so multiple calls to SharePoint are required. This makes the migration process slower. However, if you run incremental SharePoint migrations there’s no need to clear the cache manually.

Note: The options Skip permissions and Allow huge exports aren’t currently available.

8. Press Start your migration to create a migration spreadsheet. Follow from step 5 of the file server migration procedure.


Run migrations “from scratch” using a Google spreadsheet

You can run migrations from a blank Google spreadsheet that you fill in from scratch. This feature is usually used to create new documents in AODocs in contexts where you don’t have any source files.

Note: You can’t run an extraction of a manually-created Google spreadsheet.

Generate your migration spreadsheet

1. Select the Google Spreadsheet button in the main AOBulk screen. The configuration screen opens.

2. Fill in the common options for all migration types.

3. Press Start your migration to create a migration spreadsheet.

4. Open the migration spreadsheet from the message that appears on your screen.

Fill in your migration spreadsheet

1. Enter a different ID for each document you want to create.

Note: These IDs aren’t used as IDs for your target files. In the context of a “from scratch” migration, they’re used to indicate to AOBulk to create a different document for each ID.

2. Enter a title for each document.

3. Enter an initial author for each document.

4. In the data tab, create or add values to any required columns.

In this example we created:

  • the CLASS_NAME column
  • the VERSION column
  • columns for properties Contract No. and Amount

Note: If you selected a document class in the configuration screen, columns are created in your spreadsheet for all existing properties in the document class you selected. You can add values as required. Learn more: The data tab.

image05.png

You can add or edit any of the standard columns in the data tab:

  • VERSION – enter different version numbers for two or more identical IDs
  • VERSION_DESCRIPTION
  • FOLDER
  • RICH_TEXT
  • CREATION_DATE
  • MODIFICATION_DATE
  • UPDATE_AUTHOR
  • ATTACHMENT -– enter file: then the local path of a file, for example: file:/Users/carolinecharron/Documents/AOBulkMigration3/AllContracts2019.xls

Note: You can’t currently add Google file attachments.

  • [Property names] – enter values in columns corresponding to properties in the document class you selected or create new columns to create new properties.

Important: You must leave the AODOCS_ID column empty.

5. In the binding tab, set up binding between any columns from the data tab you want to include in your migration and your AODocs configuration.

6. In the mapping tab, map the users you entered in the data tab to users on your AODocs domain.

Continue your migration to create documents in AODocs

1. Refresh your migration panel. While you have been filling in your migration sheet, your migration has passed through the extraction and upload phases and is now in the setup phase. Learn more: What is AOBulk?

Important:
– If you didn’t add any attachments to your migration sheet, you can continue with your migration. Go to step 4.
– If you added attachments to your migration sheet, you must run your migration through the upload phase again to ensure your attachments have been uploaded to the My Drive of your uploader account. Go to step 2.

2. In the migration panel, select Incremental in the drop-down menu on the box showing your migration. The migration moves back to the extraction phase.

3. Select Reset to pending in the drop-down menu. Your migration passes through the upload phase again and then moves to the setup phase. Your attachments have been loaded in the My Drive of your updater account.

4. Press the Check’n run button to continue with the migration. When the migration is complete, it moves to the Report column.

Note: If there are any errors during the creation of your files in AODocs, your migration stays in the Creation column and error messages are displayed.

Was this article helpful? 0 out of 0 found this helpful
If you didn’t find what you were looking for, don’t hesitate to leave a comment!
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.