Configuration

You can use the parameters provided here to configure the Tpae IF connector.

Base URLs
Use this parameter to specify a list of URLs to send messages to Tpae products. If Tpae is on the same system as IBM Security Directory Integrator, use http://localhost. Else, use the IP address of the Tpae server. Use the same port to login to the Tpae application. For example, use port 9080 if the login URL ishttp://192.168.80.128:9080/maximo/webclient/login/login.jsp. The list uses space as a separator between URLs.
Note: Using a list of URLs, instead of a single URL, is a high-availability requirement. If the first server on the list throws an exception, the second URL is used, and so on, until a server is valid. If the last URL is also invalid, an exception is thrown and the connection fails.
User ID
Use this parameter to specify a valid user ID to login to the Tpae application.
Password
Use this parameter to specify a valid password to login to the Tpae application.
Object Structure
Use this parameter to specify name of the Object Structure to be used for the integration. In the Configuration Editor, the Clear button is associated with the Object Structure parameter.
Clear
The Connector internally saves the schemas of all Object structures used to minimize the time needed to display the MBO list. Click the Clear button to remove all saved schemas. This operation is useful when the schema of an Object Structure is changed (XSD generation) and when you need to update the local representation of this schema. After the schema cache is cleared, the subsequent calls to the Get MBOs script for a different Operating System is delayed because each schema must be retrieved from the server again.
Note: The Clear button clears the schema cache used at design time. When the Configuration Editor runs the AssemblyLine on the server, another schema cache is created. The schema can be deleted by starting the clearSchemaCache() method in the Connector. For example, you can add the text to the After initialize hook in to clear the cache before using the Connector: thisConnector.connector.clearSchemaCache();.
Query criteria
Use this parameter to filter the result set of iteration. This parameter contains the selection criteria for the Iterator mode. Specify the queries in XML syntax. You can select records based on a single value or a range of values.
Note: The query criteria selects attributes from the top two levels of MBOs in the Object Structure.
The format of the query criteria parameter is: 
<MBO> 
  <FIELD1 operator="oper"> </FIELD1> 
  <FIELD2> </FIELD2>
  ...
</MBO>
where:

MBO - represents the business object to be searched.
FIELD - name of the MBO field.
oper - conditional operator for the search.

Page Size
Use this parameter to limit the number of records retrieved from Tpae. The connector makes several requests to get all the records selected by the query criteria.
Note: The page size applies only to the root MBO in the Object Structure.
For example, if Maximo® has 1000 assets in its database and the page size is defined as 100, a query against the predefined MXASSET Object Structure is accomplished by 10 requests.

The default value is 100.

Validate field size
Use this parameter to throw an error when a text field exceeds the maximum size. In the Configuration Editor, if the Validate field size check box is not selected, the text gets truncated.
XML Character Validation
Use this parameter to remove invalid Unicode characters from XML content before parsing it.
IF Version
Use this parameter to specify the version of IF that each message exchanged with the server must contain. The Configuration Editor provides a suitable default value.
Transaction Language
Use this parameter to specify the transaction language in which the content values for multi-language enabled fields are supplied. The default value is EN. For a complete list of the language acronyms, see the ISO 639-1 alpha-2 codes at http://www.loc.gov/standards/iso639-2/php/English_list.php.
The possible choices are:
  • DE - indicates German language
  • EN - indicates English language
  • ES - indicates Spanish language
  • FR - indicates French language
  • IT - indicates Italian language
  • KO - indicates Korean language
  • PT - indicates Portuguese language
  • ZH - indicates Chinese language
Timeout
Use this parameter to communicate with the IF server. If the timeout expires before establishing the connection or before reading the available data, the MxConnTimeoutException is thrown. A timeout of zero (default) is considered as an infinite timeout.
External System
Use this parameter to specify the name of the external system, which groups and exposes Enterprise Services for Create, Update, Delete, or Query operations, for the selected mode.
MAXOBJECT/MAXATTRIBUTE Object Structure
Use this parameter to specify the name of the Object Structure that exposes the MAXOBJECT and MAXATTRIBUTE MBOs. This Object Structure is used to obtain the metadata of complementary MBO such as the maximum allowed size for an attribute. The default value is MXOBJECTCFG.
MAXOBJECT/MAXATTRIBUTE QUERY Enterprise Service
Use this parameter to specify the name of Enterprise Service that performs Query operations on the MAXOBJECT Object Structure. This Object Structure is used to obtain the metadata of complementary MBO such as the maximum allowed size for an attribute.
Note: This parameter is enabled only when you specify the External System parameter.
The default value is MXMaxObjectQuery.
QUERY Enterprise Service
Use this parameter to specify the name of Enterprise Service that performs Query operations on the specified Object Structure.
Note: This parameter is enabled only when you specify the External System parameter.
SYNC Enterprise Service
Use this parameter to specify the name of Enterprise Service that performs Sync operations on the specified Object Structure. This service is used to Create, Update, and Delete operations on the specified Object Structure for the selected Connector mode.
Note: This parameter is enabled only when you specify the External System parameter.
Comment
Enter your own comments here. The comments are not considered during the operation of this component.
Detailed Log
If this parameter is checked, more detailed log messages are generated.
Parent topic: Tpae IF Connector