Skip to content

Field notes From the field

When WebCenter is running but the invoice process is not

TL;DR

A running server and a successful deployment establish part of an upgrade's readiness. Acceptance also needs to demonstrate the user's work: opening an invoice, correcting data, assigning accounts, completing a task and retrieving the image from the ERP. When a check fails, trace the action across component boundaries before deciding where to make the correction.

Scope and evidence

Scope
Invoice-process test planning across recognition, adapter and workflow boundaries.
Evidence basis
Checked the component roles described in Oracle’s WFR, adapter and SOA guides. The checklist is an engineering planning framework, not a record of executed invoice tests or a certified end-to-end configuration.
Sources checked

An invoice process crosses several boundaries. An image enters capture, its data is entered or extracted, users code and review it, services exchange information with the ERP, and the document remains available for later retrieval. Each implementation has its own sequence and exception paths.

The useful acceptance question is whether the people operating that process can complete their work. A platform health check is one piece of the evidence. The following diagnostic patterns help structure the rest.

Start with the action that fails

Describe the symptom in terms a user can reproduce: the task does not open, the account lookup returns an unexpected value, a save loses information, or the ERP screen opens the wrong image. Record the expected result and follow the action through the systems it touches.

That approach makes the investigation specific. A coding problem may originate in the form, its metadata customization, a reference-data lookup, permissions or the workflow action. Identify the responsible layer before changing the screen or rebuilding the application.

For a non-PO account distribution form, acceptance should include permitted account combinations, required values, totals and the information passed to the next task. Test a useful correction message as well as a valid submission.

Check behavior across servers

If an invoice task works through one server and fails through another route, compare the application behavior across those paths. Deployment consistency, routing, identity, session handling and application cache configuration are separate things to inspect.

Oracle's WebCenter application-adapter administration guide describes AXF and Imaging cache configuration. Use the requirements for the installed release and application scope. A load-balancer setting or a running cluster does not by itself demonstrate that the task's context is available where it is needed.

Validate the actual interaction with the relevant nodes participating: open the task, select a view, retrieve the image and complete an authorized action. Where failover is in scope, rehearse it and record the effect on the user's work. A proposed configuration change still needs that functional evidence.

Trace recognition back to its inputs

Growing correction work can have several causes. Inspect the document reaching WFR, the recognition configuration, reference data, validation and the handoff to the next stage.

During a platform move, review old image-preparation scripts and their operating-system dependencies. Determine whether the target's supported processing configuration can provide the required conversion. Oracle documents Capture document conversion processing; the output still needs to be tested against the recognition process in use.

Reference data also deserves a check. Where supplier or purchase-order lookups are part of validation, establish that they are current and that failure is visible to the operating team. Compare the same representative invoices before and after a change, including documents that need manual correction. The WFR review covers that wider diagnosis.

Recheck the contracts between applications

A saved service description or generated adapter may reflect an earlier environment. Review it against the target's current interface, parameter definitions, data mappings and security requirements. Resolve differences deliberately and test both accepted and rejected responses.

For a new ERP instance, reconcile business identifiers and document relationships as well as network connectivity. Confirm which identifiers remain valid, where a mapping is needed and how newly created records avoid collisions with migrated history. Opening a database connection is only the first check; the application still needs to retrieve and associate the intended record.

Build success is useful evidence of source compatibility. Deployment, runtime integration and user acceptance require their own checks.

Make recovery part of the design

A failed workflow activity may follow an operation that already succeeded in another system. Before retrying, establish the receiving system's result, the current business state and whether replay could create duplicate work. Agree who is authorized to recover the item and how they confirm the final status.

The same care applies at migration. Many teams complete and close SOA instances before moving. Any required active work needs its own treatment; open ERP invoices and stored images have separate lifecycles. The invoice cutover guide explains how to define that boundary.

Leave usable evidence behind

A useful handover records the symptom, the confirmed cause, the correction, the cases tested and any remaining limits. Proposed changes and unverified results should stay clearly marked until the relevant checks pass.

That record gives the operating team a repeatable way to test future patches, configuration changes and ERP connections. It also helps them distinguish a familiar symptom from a new problem with a different cause.

Questions

What should we test after an invoice-platform upgrade?

Test representative user actions and their downstream results: document intake, recognition review, account coding, task actions, ERP handoff and historical retrieval. Include relevant error and recovery paths alongside successful cases.

What if a task works on one server but fails through the cluster?

Compare the request path, deployment targets, application state, identity and cache configuration across the nodes. Check the application-specific clustering requirements for the installed release and reproduce the failing user action after any change.

Does more manual correction always mean WFR needs retraining?

No. Inspect image preparation, reference data, validation and the downstream handoff as well as the recognition project. Compare a representative sample before and after a proposed change.

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.