Copyright © Cloud Software Group, Inc. All Rights Reserved

Managing Repository Content

You can change the content of a repository in several ways, discussed in this section.

•	Exporting and Importing Repository Instances

•	Adding TIBCO Repository Directories and Objects

•	Advanced Repository Management

•	Advanced Repository Management

Exporting and Importing Repository Instances

TIBCO Designer functionality is in most cases sufficient and appropriate for making changes to a repository instance. In some cases, however, you may decide to export the repository to XML, make your changes, and import the file.

Exporting a repository instance means writing its contents to a TIBCO Repository XML file. Importing a repository means importing a file that was previously exported from TIBCO Repository into an existing repository.

During the import process, you have some control over rejecting or accepting import of duplicate repository directories or duplicate repository objects. You cannot control, however, whether a directory or object is imported that does not exist in the current repository instance. The RepoExport and RepoImport command line tools, available in TIBCO_HOME/tra/<version>/bin allow for more fine grained operations.

Exporting and importing are useful:

•	For diagnostics and troubleshooting. Viewing the XML file may help you pinpoint a problem.

•	For creating a copy of a repository instance in a different repository server.

•	For merging local repository instances into one remote repository instance.

You can use the RepoImport and RepoExport command line tools instead of TIBCO Designer. These tools allow you to use schema validation as part of your export process if desired.

Exporting an Instance

To export a repository instance, follow these steps:

1.	Select the repository instance.

2.	From the right-button menu, choose Export Repository Instance.

3.	Choose the location for the XML file, then click OK.

TIBCO Designer saves your repository to the specified location using TIBCO Repository XML format (generic format).

You can also use the Export icon to export a repository.

Importing an Instance

To import a repository instance, follow these steps:

1.	Select a repository instance that you want to overwrite, or create a new repository and select it.

2.	Right-click the repository and choose Import Repository Instance.

You are prompted for a file.

3.	Select an XML file that had previously been exported from a repository, either using TIBCO Designer or using the RepoExport command-line utility.

The system prompts you with the following dialog:

Figure 118 Confirm Directory Replacement Dialog Box

4.	Click Yes to replace the contents. In that case, TIBCO Designer first completely empties the existing repository instance and then imports all information from the file.

5.	Click No if you want to partially replace the existing repository. In that case, TIBCO Designer prompts you whether duplicates should be replaced:

−	If there are duplicate repository directories, you can replace or reject a whole directory and its contents.

−	If there are duplicate repository objects, you can replace or reject the object and its contents.

You can also use the Import icon to import a repository.

Adding TIBCO Repository Directories and Objects

In almost all cases, you do not modify a repository directly. Instead, you modify a project, then save the project as a repository. In some situations, however, modifying the repository directly might be appropriate. You do so using the Repository palette.

To add a directory and an object to a repository, follow these steps:

1.	Browse the repository to select the directory for which you want to add a subdirectory.

2.	From the repository palette, drag a directory resource template into the design panel.

3.	Rename the directory, then double-click it to open it.

4.	From the repository palette, drag an object resource template into the design palette.

You are adding an object to the newly created directory.

5.	Rename the object.

6.	If you want to add attributes to the object, you must first turn on the advanced editing and browsing options. See Advanced Repository Management.

You cannot delete the root node or add a root node. All repositories have exactly one root node and directories and objects can only be added below that root node.

Advanced Repository Management

The Advanced tab specifies information for both local and remote repositories.

You can specify a user and password, and turn on advanced browsing and editing to access and change attribute values. Follow these steps:

1.	Drag a Repository Finder into the design panel.

2.	With the Repository Finder selected, click the Advanced tab in the configuration panel.

Figure 119 Advanced Tab in Configuration Panel

 

Table 94 Advanced Tab

User	Name of the user that accesses the repository. The repository needs this information for keeping track of who currently uses a repository.
Password	Password to access the repository. This might be needed if the repository is stored in a database.
Advanced Browsing	If checked, you can view attribute and property information. The default, unchecked, is usually appropriate because low-level work should be done using the project view.
Advanced Editing	If checked, you can edit attribute and property information. The default, unchecked, is usually appropriate because low-level work should be done using the project view.

Viewing Attributes of Repository Objects

You can use repository finder to view the contents of repository objects. Follow these steps:

1.	Turn on Advanced Browsing.

2.	Select an object you want to view.

3.	Click the Advanced tab in the configuration panel.

Figure 120 Advanced Tab

TIBCO Designer displays the object and its attributes. Attributes usually have names, attribute types, and other properties. The value of each attribute is either a string or a global name. In the example above, the attribute with the name statusMsg has an attributeType that is a global name.

Modifying Attributes Inside Repository Objects

This section explains how to modify attributes of repository objects.

In almost all cases, it is preferable to modify the attributes as part of the resources in a project. However, if you are working with an adapter that has custom objects, you may need to use the Repository Finder capabilities.

Terminology

Keep in mind the following terminology used to describe repository content.

•	An object contains attributes.

•	An attribute is a named association list. As a result, you add an association list to an object, then name it and have an attribute.

•	The name:value pairs inside the association lists are called properties of the attribute. For example, name, attributeType, and isKey are properties of the attribute. Custom properties are also allowed.

Steps

To modify an attribute, follow these steps:

1.	Locate the repository in which you want to make changes. See Introduction.

2.	In the configuration panel, click Advanced, then select the Advanced Browsing and Advanced Editing check box and click Apply.

3.	In the project tree panel, find the repository object in which you want to add or change attributes.

4.	When you select the object

−	the object is displayed in the configuration panel

−	edit buttons for the configuration panel are displayed at the bottom of the panel (see below)

−	you can select the named association lists and their properties

5.	To change the value of a property inside an attribute, triple-click the property to select it, then type the new value into the edit field that opens. In the screen shot below, the defaultStartup property of the startup attribute is being edited.

Figure 121 Change Value of a Property

6.	If you want to add a new association list to an object or an association list, or add a property to an association list, use one of the icons shown in the following figure. See Table 95 for explanation.

Figure 122 Icons in Exteneded Prperties Editor

Table 95 Icons in Extended Properties Editor

Icon	Description
Association list icon	Click to add an association list below the current location.
Binary icon	Click the binary icon to add a property a byte array stored in a file. After you’ve added the binary, you can click the file => byte array or byte array => file icons
File => byte array	Loads a file into a byte array.
Byte array => File	Copies a byte array into a file (on disk) and saves the file. It does not remove the byte array value from the binary property.
Reference Icon	Add a reference to another object inside the repository. You can use this, for example, to point to a session you created in the public area of the project. The patch always starts with /tibco, for example, /tibco/public/session/.../mySession.
String	Adds a string property to the current association list.

You must click Commit to save changes before selecting another resource or your changes are lost. You can click Rollback to undo changes since the last commit.

You can also move properties by clicking the up/down icon, and delete them by clicking the delete icon.

Copyright © Cloud Software Group, Inc. All Rights Reserved