6 Generating the Schema for Your Opcodes

Learn how to generate the opcode schemas and flist specifications required for a default Oracle Communications Billing and Revenue Management (BRM) Web Services Manager integration.

Topics in this document:

If you customize a supported opcode or add support for a new opcode, generate the required XSD schema files.

Note:

  • Before you customize an existing opcode specification, ensure that you update the opcode specification in the BRM system.

  • After you customize web services, copy the customized schema files to the location specified by the webservices.schema.location entry in the BRM_home/apps/brm_wsm/config/Infranet.properties file, and package the customized WSDL files in the appropriate custom JAR file.

Generating the Schema for an Existing Opcode

To generate schema files for a customized opcode already supported by Web Services Manager:

  1. Modify the opcode's XML specification file. By default, the opcode specification XML files are installed in the BRM_home/apps/brm_wsm/opspecs directory, where BRM_home is the directory in which you installed the BRM components.

  2. For web services that take payloads as XML elements:

    1. Run the pin_opspec_to_schema_v2 script. See "Creating Opcode Specification Schema Files".

    2. Copy the customized XSD files to the location specified in the webservices.schema.location entry of the BRM_home/apps/brm_wsm/config/Infranet.properties file.

Creating Opcode Specification Schema Files

You must create opcode flist specification files for opcodes that you customize or add to Web Services Manager. To do so:

  1. Create the specification XML files according to the BRM_home/xsd/opspec.xsd file.

  2. For web services that take payloads as XML elements, convert the opcode flist specification XML files to XSD schema files.

    1. Specify the BRM installation directory in the pin_opspec_to_schema_v2 script by replacing $PIN_HOME with BRM_home.

    2. Go to the directory where you want to save the schema file and execute the command:

      pin_opspec_to_schema_v2 input_file

      where input_file specifies the name and location of the opcode's XML flist specification. By default, the utility looks for the file in the current directory.

      The utility creates an opcodeName.xsd file in the directory from which you run the utility.

Specifying the XSL Rules to Create the Opcode Schema

The pin_opspec_to_schema_v2 utility uses the BRM_home/xsd/pin_opspec_to_schema.xsl style sheet to generate the schema for BRM opcodes. If your opcode references custom fields, you must customize the style sheet to handle your custom fields.

For a list of the supported BRM data types, see "Understanding the BRM Data Types" in BRM Developer's Guide.