Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top
 


Panel
borderColor#0081C0
titleColor#0081C0

Support for external applications was removed from XperienCentral in version R29.3.


In This Topic

Table of Contents
maxLevel2
minLevel2
 

 


...


The external application functionality uses filters to integrate content from external sources. These filters perform tasks such as stripping away superfluous HTML from the source and replacing HTML tags with others in order to make it suitable to be displayed in XperienCentral using your design template,

There are four predefined filters for external applications in XperienCentral. Each is described in this section. To add a filter to an external application, select if from the drop-down list on the Filters tab. For example:

  Select filter from drop-down listImage Removed


Image Added



The filter is added to the external application. For example:
Filter added to the applicationImage Removed  

Image Added


Define the properties for the filter. See the applicable section below for complete information.

 


...

WmInclude Filter

The WmInclude filter is the filter most often used to integrate external applications. Define the following properties for the WMInclude filter:

 


PropertyDescription
ProxyName of the proxy server as defined on the Proxy servers tab Select the proxy server for this external application from the drop-down list.
ServerThe name of the application server as defined on the Application servers tab. Select the server for this external application from the drop-down list.
MethodThe available methods are "GET" (an HTTP GET request) and "POST" (an HTTP POST request. The method you use depends on the configuration of the application server on which the external application is running.
ProtocolSpecifies the protocol to use for the filter. The available protocols are "HTTP" and "HTTPS".
Relative URLThe part of the URL after the server name and/or port number. In the following example, XperienCentral.html is the relative URL:

http://connect.gxsoftware.com/XperienCentral

If you want to use the root of the URL as the source, add a forward slash to this field "/" (without quotes).
DebugSelect this option if you want debug messages to appear in the Tomcat log.
Debug contentSelect this option if you want log messages related to the content from the external application to appear in the Tomcat log.
Max redirectsSpecifies the maximum number of redirects to other applications. If this field is left blank, the maximum number is 10.
Error pageThe page the visitor will be redirected if an error occurs while accessing the external application. Click [Search] to select the page using Advanced Search.

 


Back to top

 


...

WMReplacementsFilter

The WMReplacements filter is used to replace or remove strings from the integrated external application. This makes it possible to modify the retrieved content in order to make it suitable for display in your own design template. The default replacements cover most of the common modifications that need to be performed on retrieved content. You can also create custom replacements that apply to your specific project.

PropertyDescription

Replacements

Select the replacements to act on the HTML from the external application and click [Apply]. The replacement is added. Repeat this step for each replacement you want to add. The replacements will be executed on the retrieved content in the order that they appear in the WMReplacements filter in the external application configuration on the External Applications tab. To change the order of the replacements, select a new value from the drop-down list for the filters you want to rearrange. For example:
Change replacement orderImage Removed

Image Added


and then click [Apply]. See Replacements for an explanation of the standard replacements available in XperienCentral.

Debug

Indicate whether debug information for this filter appears in the Tomcat log.

 


Back to top 


...

IncludeFileFilter

This filter displays the content from the specified file. This is useful for situations where the source for content is a file on disk as opposed to an external application. Enter the fully qualified path to the file including its extension. For example: IncludeFileFilterImage Removed


Image Added

 


Back to top 


...

XSLFilter

This filter converts XML to HTML so it can be rendered in XperienCentral.

PropertyDescription
XSL URLThe URL where the file containing the XML to HTML translation is located.
XSL FilenameThe name of the file located at the URL specified above that contains the XML to HTML translation.

 


Back to top 


...

Creating a Custom Filter

If the standard filters available in XperienCentral do not provide the functionality you need in order to integrate an external application, you can create a custom filter using the Integration API. When the custom filter is created, you can add it to the external application configuration.

For complete information on implementing a custom filter, please contact your GX XperienCentral consultant. 


Back to top

 

 

 

 

 

 

 

 

...