Real Time Information Director User Documentation

RTID Extensibility
Hewlett-Packard Company 20 529618 - 001
name to match with the file name.
3. Change the superclass from BaseDocumentDefinition to
SubstituteDocumentDefinition. For example:
public class Orders05v1 extends SubstituteDocumentDefinition {…}
Then remove the declaration of the DocumentRecord object, and remove the
object documentRecord from the call to the superclass. (Remember that the
documentRecord represents content metadata, and that a substitute document, by
definition, includes only format metadata.) For example, the Orders05v1 class
calls the superclass with one argument:
public Orders05v1() throws MetadataInconsistency, SQLException {
super(idocSegment);
}
4. Make the desired changes in the mapping.
5. Compile the new source file, for instance Orders05v1.java. Then test it, and
deploy the updated Java class files to the RTID runtime environment. Refer to the
instructions in the “Compiling Metadata” and “Deploying Metadata” sections of
this document.
To test inbound IDocs, use the Dispatch or Disassemble standalone program. To
test outbound IDocs, use the Dispatch standalone program. To test both inbound
and outbound IDocs, use the Reselect program. See “Testing the Metadata” for
information.
Dynamically Deploying Metadata
Whether you are deploying new or updated metadata, follow these steps to make the
metadata available to the Director without having to restart the server:
1. Copy the metadata class file to the NonStop server.
2. Use the management interface to request the Director server to load the new
metadata class. From this point on, the Director server will use the new mapping
and stop using any previous version of the mapping. If you’re running multiple
servers, deploy and reload the metadata for each server. For more details about
management, refer to the RTID Management module.
3. After deploying the new metadata on the Director server, monitor the server log to
see what errors, if any, have been generated. If you see error messages, you may
want to change the logging level to DEBUG to get more detailed information.
For more details about logging, refer to the RTID Management module.