Business Function Spec Metadata Validation

If the dynamic Java connector program calls a business function from OneWorldBSFNSpecSource, you do not need to validate the business function metadata. The business function metadata in OneWorldBSFNSpecSource is always the same as the business function metadata that is on the JD Edwards EnterpriseOne server where the business function runs. You must ensure that all input parameters are set correctly, according to OneWorldBSFNSpecSource.

If the dynamic Java connector program calls a business function from a spec source other than OneWorldBSFNSpecSource (such as ImageBSFNSpecSource or a custom business function spec source), the business function metadata that is in the local spec source might not be compatible with the business function metadata that is on the JD Edwards EnterpriseOne server where the business function runs. Local business function spec metadata can be validated during these conditions:

Condition

Explanation

Deploy Time

The dynamic Java connector program validates the local spec source against the JD Edwards EnterpriseOne server spec source before run time. You should perform this validation, as all business functions in the local spec source are validated. The program can be redesigned before it is shipped.

Run Time

The dynamic Java connector validates the program based on the local spec design when running business functions. During this condition, only the business function that is called is validated. Run time validations should be treated as error handling when incompatible business function specs are found.

The dynamic Java connector provides two ways to validate business function spec metadata during deploy time: SpecImageValidator APIs and SpecImageConsole command line.

The APIs for SpecImageValidator are:

  • public SpecImageValidator(BSFNSpecSource srcSpecSource).

  • public ValidationResultSet validate(SpecDictionary dictionary) throws SpecFailureException.

  • public ValidationResultSet validate(SpecDictionary dictionary, String path) throws SpecFailureException.

  • public ValidationResultSet validate(BSFNSpecSource dstSpecSource) throws SpecFailureException.

  • public ValidationResultSet validate(BSFNSpecSource dstSpecSource, String bsfnMethodName).

    Note: If the SpecImageConsole command line is used, the dynamic Java connector can validate only business function spec metadata from ImageBSFNSpecSource; custom business function spec sources cannot be validated.