Skip to content

Support Technical guide

Bulk-loading Oracle WebCenter Content with the Batch Loader

TL;DR

Oracle’s Batch Loader supports bulk content actions, including insert, update and delete. Each action has its own record requirements and effects. Select the supported loading method for the target release, test metadata and security mappings, and reconcile every intended item and revision. A completed run or empty error file alone does not establish that a migration is correct.

Scope and evidence

Scope
Batch Loader action types, execution boundaries and reconciliation.
Evidence basis
Checked Oracle’s Content 14.1.2 Batch Loading chapter. This page supplies planning controls and deliberately defers executable syntax and release-specific setup to Oracle documentation; no load was executed.
Sources checked

Choose the method before generating records

Oracle’s Batch Loading documentation covers insert, update and delete actions, record formats, local execution and remote command-file options. Their requirements differ. Use the exact-release instructions for syntax, authentication and execution; do not treat a generic check-in example as a migration procedure.

Batch Loader is one option for an import or a separately designed repository migration. It is not a mandatory step in every 12c-to-14c upgrade. Establish whether the task is a product upgrade, content transfer or metadata change before selecting a utility.

Define the manifest and mapping

Create an authoritative manifest of the intended items and revisions. Record the source identifier, target identifier strategy, file location, expected action and metadata mapping. If another application stores a document reference, include that reference in the design.

Validate content types, required custom fields, date formats, security groups, accounts and ownership against the target configuration. Do not default protected documents into a public security group. Decide how identifier collisions and existing revisions will be handled before submitting a batch.

Control staging and execution

Use a controlled staging location and the permissions required by the selected method. Confirm file readability, completeness and integrity without exposing credentials in generated files or logs. Test an approved representative subset first, including invalid metadata and missing files so the failure handling is understood.

Choose batch size and error handling from rehearsal results. Keep the input manifest, generated load files, execution logs and reconciliation results together so each attempted change can be traced.

Handle partial success deliberately

A run can apply some changes before another record fails. Review the successful and failed records before retrying. The error output helps identify problems, but an empty error file does not prove correct metadata, authorization or business references.

Test what happens when a record is submitted twice. Depending on its action, identifier and repository state, a retry may create another revision or repeat an update. Define the recovery approach separately for insert, update and delete; a general promise to rerun the file safely is insufficient.

Reconcile before releasing the target

  • Match every intended item and revision to its target outcome, with exceptions owned and resolved.
  • Compare file integrity where applicable and retrieve representative originals and renditions.
  • Verify metadata and authorization using the intended user roles, including denied access.
  • Test application links and record associations, not only repository searches.
  • Record acceptance and the remaining rollback or cleanup boundary before enabling production intake.

Use the repository migration guide for the wider cutover design and the upgrade rehearsal guide when the objective is a supported product upgrade. ECMWorks can help scope the loading method, mapping and reconciliation evidence.

Questions

Is every batch record a new check-in?

No. Insert, update and delete have different requirements and effects. Follow Oracle’s action-specific record format for the target release.

Does a WebCenter upgrade require Batch Loader?

No. It is a bulk-loading option for a separately designed content movement. A supported product upgrade may retain the existing repository; choose the migration method deliberately.

Can I rerun a failed batch safely?

Assess partial successes first. Retrying records without checking identifiers, actions and revision behavior can repeat changes. Reconcile the failed subset and test retry behavior before production.

What proves a load succeeded?

Reconcile the source manifest to target identifiers and revisions, verify expected metadata and authorization, and test document retrieval and dependent application links. Counts and loader logs are supporting evidence, not the whole acceptance test.

Put the recurring work in an engineer’s hands.

Describe the operational issues and capacity you need. We can agree priorities, coverage, escalation and a visible way to track the work.