Tamino XML Server Version 9.7
 —  X-Tension: Tamino Server Extensions  —

X-Tension Tools

The information in this section is broken down as follows:


Modifying the Public Java Classpath

You can modify the public classpath for Java server extensions. A modified classpath applies to all Java server extensions in all Tamino databases on this host. During execution of a Java server extension, the public classpath precedes the standard classpath setting.

To add all the JAR files in a directory (e.g. D:\X\Y) to the private classpath, you can specify the directory name followed by *.jar in the classpath (e.g. D:\X\Y\*.jar). Other expressions with wildcard characters are not supported.

Start of instruction setTo modify the public classpath

  1. Start the Tamino Manager.

    Select the X-Tension Tools node and choose X-Tension Settings from the context menu. The X-Tension Settings dialog appears:

    graphics/admin59.png

    You can either enter the new classpath in the Public Classpath field directly or select the Edit button, which opens the Modify Classpath dialog:

    graphics/modclasspath.png

  2. In the Modify Classpath dialog, you can use the Browse... button to navigate to the required location, then choose the Precede Path or Append Path button to add the location to the start or the end of the classpath.

    At this stage, the individual paths that make up the complete classpath are displayed on separate lines. The classpath is constructed by appending these paths in the order shown, starting from the top. You can change the position of any path in the list by selecting it and using the Move Up and Move Down buttons to move it to the required position. The part of the display in which the path names are listed cannot be scrolled horizontally, so path names that are wider than the available display area are not completely visible. In this case, you can select the path name, which then appears in the Selected Path field. This field can be scrolled horizontally.

    To delete a path name from the list, select it and use the Delete button. To delete all of the path names from the list, use the Delete all button.

    When you have defined the required list of paths, choose OK to return to the X-Tension Settings dialog.

  3. In the X-Tension Settings dialog, choose OK to save the public classpath definition.

Top of page

Analyzing Arbitrary Objects

If you have any DLL, EXE, TLB, CLASS, or JAR files that were not created by the Tamino X-Tension Builder and you want to determine whether they contain classes or methods that could be used as server extension functions, you can use the X-Tension Object Analyzer. If there are any suitable classes or methods, you can use the X-Tension Object Analyzer again to create a server extension package, which is what you need when you want to install a server extension into a database.

The X-Tension Object Analyzer is started from the Tamino Manager.

The X-Tension Object Analyzer must not be run more than once in parallel.

The typical steps to create a server extension package are:

A successfully analyzed object that does not satisfy your requirements can be deleted from the Tamino Manager.

Analyzing an Object

To find out whether a DLL, EXE, TLB, CLASS or JAR file contains code that could be used as a server extension function, the file must be analyzed.

Start of instruction setTo analyze an object

  1. Start the Tamino Manager.

  2. Select and expand the X-Tension Tools.

  3. Select the Object Analyzer.

  4. In the context menu, choose Analyze Object.

  5. The Analyze Object page appears:

    graphics/anobj1.png

    Enter the full path of the file to be analyzed (including the file name) in the File to analyze text box, or choose Browse... and select the drive, directory and file.

    In the Additional files text box you can specify more CLASS or DLL files by entering the full path of the file to be analyzed (including the file name), or by choosing Browse... and selecting the drive, directory and file.

    Choose Add to add the files you want. Note that a file that you have selected but not added to the list will not be included in the analyzed object. Repeat these steps as often as required. To delete a file from the list, select it and choose Remove.

    Choose OK to continue.

  6. If the specified file is a JAR file, the Analyze Java Class page appears:

    Select a file from the Class to analyze text box and choose OK to continue. Ensure that this file is the main or entry class.

    The Job Monitor page appears, informing you about success or failure of the analysis.

If the object was successfully analyzed, its name is now included under the expanded X-Tension Object Analyzer object in the Tamino Manager.

Entering Additional Information for a Server Extension Object

Additional information can be entered for a server extension object and its functions. You can modify the name of a server extension object, its description, the author and the external name of server extension functions.

Start of instruction setTo enter additional information for a server extension object

  1. Start the Tamino Manager.

    Select and expand the Object Analyzer to display the analyzed server extension objects in the tree view.

  2. Select the server extension object for which you want to enter additional information.

  3. Choose Modify Extension.

  4. The Modify Server Extension page appears.

    The Extension Name text field contains the name of the object. This name can be changed if required. If you enter a new name for the object, this name will be valid after packaging the object.

    In the Description text field you can enter a brief description of the server extension. The descriptions of CLASS and JAR files that were not developed with the current X-Tension Builder can be changed; the descriptions of DLL files cannot be changed.

    In the Author text field you can enter the name of the developer of the server extension.

    In the Function Name text field you can enter the external name of the server extension function.

    XML metacharacters such as "&", "<" and ">" are not allowed in the fields Extension Name, Author, Description and Function name.

    Choose OK to save the entries.

    The Job Monitor page appears, informing you about success or failure of the modifications.

If the message reports success, you must select a function from the server extension object before you can create a server extension package.

Entering Additional Information for a Direct Server Extension Object

Additional information can be entered for a server extension object and its functions, and the name of a server extension object can be modified. Help files that you specify here are included in the server extension package.

Start of instruction setTo enter additional information for a Direct server extension object

  1. Start the Tamino Manager.

    Select and expand the Object Analyzer to display the analyzed server extension objects in the tree view.

  2. Select the Direct server extension object for which you want to enter additional information.

  3. Choose Edit Details.

  4. The Edit Details of Object page appears.

    The path of the object is displayed in the Object pathname text field. The path cannot be changed from this dialog.

    The Extension name text field contains the name of the object. This name can be changed if required. If you enter a new name for the object, this name will be valid after packaging the object.

    In the Short description text field you can enter a brief description of the server extension. The description can be changed in the case of EXE files, but not in the case of DLL files.

    In the Author name text field you can enter the name of the developer of the server extension.

    XML metacharacters such as "&", "<" and ">" are not allowed in the fields Author name and Short description.

    If known, enter the full path of the object's help file (including the file name) in the Help file text box; otherwise, choose Browse... and select the drive, directory and file. Help files must be of type HTM, HTML, XML or TXT.

    If there are other help files associated with the object, enter the full path name of the file (including the file name) in the Additional help file text box or choose Browse... and select the drive, directory and file. Choose Add to add the help file to the list of additional help files. Note that a file you have selected but not added to the list will not be included in the analyzed object. Repeat these steps as often as required. To delete a help file from the list, select the file and choose Remove.

    Choose OK to save the entries.

    The Job Monitor page appears, informing you about success or failure of the modifications and the help file specifications.

If the message reports success, you must select a function from the server extension object before you can create a server extension package.

Entering Additional Information for a Java Server Extension Object

Additional information can be entered for a server extension object and its functions, and the name of a server extension object can be modified. Help files that you specify here are included in the server extension package.

Start of instruction setTo enter additional information for a Java server extension object

  1. Start the Tamino Manager.

    Select and expand the Object Analyzer to display the analyzed server extension objects in the tree view.

  2. Select the Java server extension object for which you want to enter additional information.

  3. Choose Edit Details.

  4. The Edit Details of Object page appears.

    The path of the object is displayed in the Object pathname text field. The path cannot be changed from this dialog.

    The Extension name text field contains the name of the object. This name can be changed if required. If you enter a new name for the object, it will be valid after packaging the object.

    In the Short description text field you can enter a brief description of the server extension. The descriptions of CLASS and JAR files that were not developed with the current X-Tension Builder can be changed; the descriptions of DLL files cannot be changed.

    In the Author name text field you can enter the name of the developer of the server extension.

    XML metacharacters such as "&", "<" and ">" are not allowed in the fields Extension name, Author name and Short description.

    The value of the private classpath can be changed in the Private Classpath field. You can use the Edit button to open a subdialog in which you can specify the private classpath. See the section Dialog for Setting the Private Classpath for usage details.

    If known, enter the full path of the object's help file (including the file name) in the Help file text box; otherwise, choose Browse... and select the drive, directory and file. Help files must be of type HTM, HTML, XML or TXT.

    If there are other help files associated with the object, enter the full path name of the file (including the file name) in the Additional help file text box, or choose Browse... and select the drive, directory and file. Choose Add to add the help file to the list of additional help files. Note that a file you have selected but not added to the list will not be included in the analyzed object. Repeat these steps as often as required. To delete a help file from the list, select it and choose Remove.

    Choose OK to save the entries.

    The Job Monitor page appears, informing you about success or failure of the modifications and the help file specifications.

If the message reports success, you must select a function from the server extension object before you can create a server extension package.

Selecting Server Extension Functions

To be able to create a server extension package, at least one function must have been selected from the analyzed object. You can choose from one of the following options:

Selecting a Server Extension Function with Defaults;

Selecting and Modifying a Server Extension Function;

Selecting all Server Extension Functions;

Modifying a Server Extension Function and Parameters.

Selecting a Server Extension Function with Defaults

Start of instruction setTo select a server extension function with default settings for a server extension object

  1. Start the Tamino Manager.

    Select and expand the X-Tension Tools.

    Select and expand the Object Analyzer.

  2. Expand a server extension object to display the associated server extension functions in the tree view.

  3. Select the server extension function for which you want the default settings.

  4. Choose Select with Defaults.

    The Select function ... page appears, showing whether selecting the function was successful.

Selecting and Modifying a Server Extension Function

Start of instruction setTo select and modify a server extension function

  1. Start the Tamino Manager.

    Select and expand the X-Tension Tools.

    Select and expand the Object Analyzer.

  2. Expand a server extension object to display the associated server extension functions in the tree view.

  3. Select the server extension function that you want to modify.

  4. Choose Select and Modify.

  5. The Select and Modify Function page appears.

    The Function name text field contains the name of the function. It cannot be changed.

    Select the appropriate type for the function from the Function type drop-down list box.

    In the Short description text field you can enter a brief description of the server extension function.

    XML metacharacters such as "&", "<" and ">" are not allowed in the field Short Description.

    If known, enter the full path of the object's help file (including the file name) in the Help file text box; otherwise, choose Browse... and select the drive, directory and file. Help files can be of any type, but HTM, HTML, XML or TXT is recommended.

    If there are other help files associated with the function, enter the full path name of the file (including the file name) in the Additional help file text box or choose Browse... and select the drive, directory and file, then choose Add to add the help file to the list of additional help files. Note that a file you have selected but not added to the list will not be included in the analyzed object. Repeat these steps as often as required. To delete a help file from that list, select the file and choose Remove.

    Choose OK to save the entries and to select the function automatically.

    The Job Monitor page appears, informing you about success or failure.

Selecting all Server Extension Functions

Start of instruction setTo select all Server Extension functions

  1. Start the Tamino Manager.

    Select and expand X-Tools.

    Select and expand the Object Analyzer to display the analyzed server extension objects in the tree view.

  2. Select the server extension object whose functions you want to select.

  3. Choose Select all Functions.

    The Job Monitor page appears, informing you about success or failure of the selection.

Modifying a Server Extension Function and Parameters

In the Modifying a Server Extension Function and Parameters dialog, the external name, the description of a server extension function and the XML data types of function parameters can be changed.

Start of instruction setTo modify a server extension function and parameters

  1. Start the Tamino Manager.

    Select and expand the X-Tension Tools.

    Select and expand the Object Analyzer.

  2. Expand a server extension object to display its associated server extension functions in the tree view.

  3. Select the server extension function that you want to modify.

  4. Choose Modify Function.

  5. The Modify Function page appears.

    The Name text field contains the name of the function. It cannot be changed.

    In the External Name text field you can enter the external name of the server extension function.

    In the Description text field you can enter a brief description of the server extension function.

    XML metacharacters such as "&", "<" and ">" are not allowed in the field Description.

    The parameter name can be changed for Java class files.

    The XML data type of a parameter can be changed if a list box is displayed.

    Choose OK to save the entries and to select the function automatically.

    The Job Monitor page appears, informing you about success or failure.

Deselecting Server Extension Functions

If selected functions are not needed, you can deselect all functions, or you can deselect individual functions.

Deselecting all Server Extension Functions

Start of instruction setTo deselect all server extension functions

  1. Start the Tamino Manager.

    Select and expand X-Tools.

    Select and expand the Object Analyzer to display the analyzed server extension objects in the tree view.

  2. Select the server extension object whose functions you want to deselect.

  3. Choose Deselect all Functions.

    The Job Monitor page appears, informing you about success or failure of the deselection.

Deselecting Individual Server Extension Functions

Start of instruction setTo deselect one server extension function

  1. Start the Tamino Manager.

    Select and expand X-Tools.

    Select and expand the Object Analyzer.

  2. Expand a server extension object to display the associated server extension functions in the tree view.

  3. Select the server extension function that you want to deselect.

  4. Choose Deselect Function.

    The Job Monitor page appears, informing you about success or failure of the deselection.

Modifying Function Parameters

When a server extension function has been selected, its parameters can be modified.

Start of instruction setTo modify a function parameter

  1. Start the Tamino Manager.

    Select and expand X-Tension Tools.

    Select and expand the Object Analyzer.

  2. Expand one of the displayed server extension objects.

  3. Expand a selected server extension function to display the associated parameters in the tree view.

  4. Select the parameter that you want to modify.

  5. Choose Modify Parameter.

  6. The Modify Parameter page appears:

    The internal name of the parameter is displayed in the Parameter Name text box. This can be changed in the case of Java parameters.

    The other parameters such as the host language type (the example shows the host language type to be "Java") and direction are displayed but they cannot be changed. The XML data type can be changed if a list box is displayed.

    For Init functions, the default values must be specified in the Default Value text field.

    Choose OK to modify the parameter.

    The Job Monitor page appears, indicating whether the modification was successful or not.

Creating a Server Extension Package

When you have analyzed an object, selected the functions you want, and made any modifications you want, you can create a server extension package.

Start of instruction setTo create a server extension package

  1. Start the Tamino Manager.

    Select and expand X-Tension tools.

    Select and expand the Object Analyzer.

  2. Select the server extension object that you want to pack.

  3. Choose Pack Extension.

  4. The Pack Server Extension page appears.

    The Destination directory text box contains the full path of the directory in which the server extension package will be created. The default directory is ...\Tamino\Server Extensions\Pack. You can change the directory by entering a path or choosing Browse... to select a drive and directory.

    Tick the Overwrite existing package check box if you want to overwrite an existing package with the same name.

    Choose OK to create the server extension package.

    The Job Monitor page appears, informing you about success or failure of the creation of the package file.

The package file (your-file.sxp) can be installed in a Tamino database as described in the section Installing a Tamino Server Extension.

Deleting a Server Extension Object

If you discover that a server extension object that was successfully analyzed is not useful for your purpose, you can delete it.

Start of instruction setTo delete a server extension object

  1. Start the Tamino Manager.

    Select and expand X-Tools.

    Select and expand the Object Analyzer object.

  2. Select the server extension object that you want to delete.

  3. Choose Forget Object to delete it.

    The Job Monitor page appears, informing you about success or failure of the deletion.

Top of page

Viewing a Package File

Start of instruction setTo find out whether a package contains valid code that is useful for your purpose

  1. Start the Tamino Manager.

    Select and expand X-Tension Tools.

    Select and expand Package Viewer.

    In the context menu, choose Analyze Object.

  2. The View Package page appears:

    graphics/view1.png

    Browse to an *.sxp file and select it. Choose OK.

    The name of the server extension package appears in the tree view. Here the package can be expanded and viewed, just like any other server extension object. After viewing, the package file is automatically deleted when the Package Viewer tree is collapsed.

    If the package is useful, you can install the *.sxp file in the database.

Top of page