Real Time Information Director User Documentation

RTID Extensibility
Hewlett-Packard Company 14 529618 - 001
Updating Metadata Mappings for an IDoc
The metadata you initially define for an IDoc might not map all the IDoc elements to
database columns. The decision to map some but not others would be based on business
requirements. But business requirements change, and so you might some day need to
capture additional elements; this might mean adding columns or even new tables to the
data model.
To map additional elements to the data store, you must
• Analyze the information you need to capture
• Change the data model to accommodate this additional information
• Create appropriate mappings to store the data in the data store.
More generally, if any of the mappings in the baseline are not applicable to your
implementation, you can update the metadata to match your requirements. As always you
need to
• Analyze your business needs and understand the mappings required
• Make changes to the data model if required to support the change
This section applies only to metadata deployed in a development or integration and test
system, because the deployment steps assume that the Director server can be restarted.
For operational systems where the Director server cannot be restarted, follow the steps in
the dynamic deployment section of this document.
Changing Existing Metadata
Once you have the mapping information you need, follow these steps to change your
metadata.
1. Open the Java source file that contains the document definition for the IDoc. For
example, if you were updating the metadata for the ORDERS05 document, you
would edit the file com\hp\rtsc\documents\Orders05.java.
For each element in the IDoc for which you want to change the mapping, locate
the Java object that relates to that element and make the necessary changes. For
example:
• To map the element to a different column in the database table, update the
field name that is mapped to the IDoc element.
• To change a SegmentQualifier for a given element, update the
SegmentQualifier with the new qualifier.
• To add a new SegmentQualifier, locate the QualifiedSegment associated with
the SegmentQualifier and add the new SegmentQualifier to it.
For a detailed description of the metadata syntax, refer to the RTID Metadata
Language module.