Understanding BCSAP

To integrate with a maintenance management system other than Maximo, such as SAP Plant Maintenance, the Asset Management Module provides a link program named BCSAP.exe. It can be used to open a web browser showing linked documents in Meridian Explorer from a command line using the asset parameters as input values.

BCSap.exe is configured by the file BCSAP.exe.config. These files are provided as-is and are not intended as a complete or finished integration solution. Professional services might be required to customize the source code of BCSAP.exe for a particular customer’s requirements. For assistance, please contact your BlueCielo Solution Partner or BlueCielo ECM Solutions Professional Services. For information about the BCSAP.exe.config file, see Configuring BCSAP.

The executable must be called from the maintenance management system user interface with up to five parameters separated by semicolons:

BCSap.exe <ObjectType>;<ArgumentValue0>;...<ArgumentValue3>

<ObjectType> specifies the object type that is selected in the maintenance management system and that is used for finding related documents. There are three possible values: FL (functional location), EQ (equipment), or WO (work order). A corresponding URL is provided in the configuration file for each value.

Each URL may contain place holders for up to 4 argument values:

<ArgumentValue0> corresponds to either placeholder {0} or LOC
<ArgumentValue1> corresponds to placeholder {1} or {EQ}
<ArgumentValue2> corresponds to placeholder {2}
<ArgumentValue3> corresponds to placeholder {3}

Following are examples based on sample values. By using other values, all aspects of the URL can be modified.

BCSAP.exe FL;1000

Resulting URL:

http://localhost/ExplorerClient/home.aspx?VIEWID=DOC_E91E5
&TAGFILTER=tagfab&DOCFILTER=docfab&LOC=1000&VIEWMODE=DETAILS

BCSAP.exe EQ;1000;EQ100

Resulting URL:

http://localhost/ExplorerClient/home.aspx?VIEWID=DOC_E91E5
&TAGFILTER=tagfab&DOCFILTER=docfab&LOC=1000&TAGNR=EQ100& VIEWMODE=DETAILS

BCSAP.exe WO;1000;EQ100;WO2

Resulting URL:

http://localhost/ExplorerClient/home.aspx?VIEWID=DOC_E91E5
&TAGFILTER=tagfab&DOCFILTER=docfab&LOC=1000&TAGNR=EQ100&WONUM=WO2&VIEWMODE=DETAILS

When the program is run, it opens Internet Explorer with an appropriate URL that shows the linked documents. For more information about the URL, see Composing view URLs.