How to configure, import/export or reuse the extracts configuration in TIBCO BusinessWork ProcessMonitor (BWPM).

How to configure, import/export or reuse the extracts configuration in TIBCO BusinessWork ProcessMonitor (BWPM).

book

Article ID: KB0092557

calendar_today

Updated On:

Products Versions
TIBCO BusinessWorks ProcessMonitor -
Not Applicable -

Description

Description:
An Administrator wants to preconfigure not only the technical aspects of a TIBCO BusinessWorks ProcessMonitor (BWPM) Client, such as a JMS connection, but also the configure the functional extracts.

Issue/Introduction

How to configure, import/export or reuse the extracts configuration in TIBCO BusinessWork ProcessMonitor (BWPM).

Resolution

Options to configure extracts.

1). You can manually create extracts from the TIBCO BusinessWorks ProcessMonitor (BWPM) GUI. Extract configuration is stored in <ENGINE_NAME>_njams_config.xml located in the directory <TIBCO_DOMAIN_HOME>/applications/<APPLICATION_NAME>/resource .

2). Use the import/export option under Administration | Extracts. Import is useful when you have extracts defined in other environments for the same project/process and you want to reuse it in other/higher environments. Export the extracts from another setup and use that exported extract during import. 

3). Reuse the existing configuration file and then modify the same to reuse in a different project. Details follow.

To preconfigure the log level, traces and extracts, an Administrator can create an XML file containing the configuration of those features. An example XML configuration can look like the following. 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<config xmlns="http://www.faizsiegeln.com/schema/njams/extracts/2012-10-22/" lastdeploymenttime="1360749917379">
    <tracing/>
    <extracts>
        <extract activity="LogInfo" process="Process Definition.process">
            <extractionrules>
                <extractrule inout="out" rule="//ns0:LogID" ruleType="xpath" attribute="myID"/>
                <extractrule inout="in" rule="//ns0:Name" ruleType="xpath" attribute="businessService"/>
            </extractionrules>
        </extract>
        <extract activity="JMS Queue Receiver" process="Process Definition (1).process">
            <extractionrules>
                <extractrule rule="a" ruleType="regexp" attribute="businessService"/>
            </extractionrules>
        </extract>
            <extract activity="Start" process="Process Definition.process">
            <extractionrules>
                <extractrule inout="out" rule="//Job" ruleType="xpath" attribute="correlationlogid"/>
            </extractionrules>
        </extract>
    </extracts>
</config>

In order to preconfigure the BusinessWorks ProcessMonitor Client using this XML configuration file, the file name must be of this pattern: <ENGINE_NAME>_njams_config.xml and be located in this directory: <TIBCO_DOMAIN_HOME>/applications/<APPLICATION_NAME>/resource . When the TIBCO ActiveMatrix BusinessWorks (BW) engine starts and the BusinessWorks ProcessMonitor Client is in its initialization phase, it will look for and read this configuration file. Also, it will send information of any configuration update of the BWPM Client.

You have to modify the XML file and then restart the BW engine so it will send this configuration to the BWPM server. Note that you can define the extract (business object, business service) in the BWPM server and then check the file  <TIBCO_DOMAIN_HOME>/applications/<APPLICATION_NAME>/resource/<ENGINE_NAME>_njams_c onfig.xml so you can obtain exact exact tags for your requirements. You can set similar settings in the file <ENGINE_NAME>_njams_config.xml of different applications for which you want to configure the extract.