Working with user projects

You create shortcuts in user projects to the integration components you want to work with in one or more libraries. User projects provide a way for you to organize your view of components as an interface. You must add component shortcuts to a user project to deploy the components to a server from System Manager.

This section contains the following sections:

Configuring integration broker preferences for user projects

You can use System Manager to create user projects for multiple integration brokers. Do the following to enable System Manager for different integration brokers:

  1. Open the file named cwtools.cfg in ProductDir\bin in a text editor.
  2. To enable System Manager for WebSphere Application Server projects, set the Installed property in the WAS_PROJECT section to the value true.

    To enable System Manager for WebSphere MQ Integrator Broker projects, set the Installed property in the WMQI_PROJECT section to the value true.

    To enable System Manager for WebSphere InterChange Server projects, set the Installed property in the ICS_PROJECT section to the value true.

  3. Save and close the file.

Creating user projects

Note:
The following is a general description of how to create user projects. For specific instructions on creating a new message broker project, refer to Creating a message broker project.

Do the following to create a new user project in System Manager by using a wizard:

  1. Do one of the following to start the "New User Project" wizard:
  2. Type a name for the user project in the Project name field.

    Project names can only contain alphanumeric characters and underscores, and must be specified in English.

    It is recommended that you name this type of user project in such a way as to associate it with the server it corresponds to. For instance, if the server name is SERV420DEV, you might name the user project SERV420DEVUP.

  3. To have the folder for the user project created in the default location (your workspace) and with a name identical to the name specified for the user project, leave the Use default checkbox enabled in the "Project contents" pane.

    If you want to specify the name and location of the user project folder, do the following:

    1. Clear the Use default checkbox in the "Project contents" pane.
    2. Type the full path and name of the directory that you want to use for the user project in the Directory field, or click Browse to select an existing directory.
    Note:
    There is no way to create the folder for a user project in the path of the workspace other than to let System Manager do it by use of the Use default location checkbox.
  4. If you do not want to create shortcuts to existing integration components at this time, proceed to step 5.

    If you do want to create shortcuts to existing integration components, enable the checkbox next to an integration component library to create shortcuts to all of the components within it or expand an integration component library folder and enable the checkboxes next to component groups, or expand the folders for groups and enable the checkboxes for individual components.

    Note:
    If you select components with the same names from multiple integration component libraries you do not receive a prompt to inform you that there are duplicate references in your selection. In the event that you do select duplicate components, shortcuts are created for the component in the integration component library that was furthest down in the list of libraries when you made your selections in the wizard.

    Figure 30 shows the "New User Project" wizard.

    Figure 30. Creating a user project

  5. Click Finish to complete the wizard.

    System Manager creates a folder with the name you specified in the folder corresponding to the integration broker (Message broker Projects) in the User Projects folder.

Adding shortcuts to a user project

You add shortcuts to a user project to give yourself a view to an interface that you are working on. There are several ways to add shortcuts to a user project, described in the following sections:

Using the Dependency Tree

The "Dependency Tree" wizard is the most convenient interface for adding component shortcuts to a user project. User projects are primarily designed to represent interfaces, and interfaces are generally centered around a connector object. User projects, then, are generally centered around a connector object as well, and you can typically create the shortcuts you need for a user project by discovering the dependencies of the connector object.

For conceptual information about dependencies, see Dependencies and references.

Do the following to add shortcuts to a user project by using the "Dependency Tree" wizard:

  1. Right-click an integration component, such as a connector object, in a library and choose Show Dependencies from the context menu.
  2. Select the user project to which you would like shortcuts to be added from the Add to the project drop-down menu.
  3. Select components for which you would like to create shortcuts in the left-hand pane of the wizard.

    You can use keyboard shortcuts to facilitate the process, such as holding down Shift to select ranges of objects and holding down Ctrl to select single non-contiguous objects.

  4. Click the right-facing arrow to add the components to the right-hand pane of the wizard.

    Figure 31 shows the "Dependency Tree" wizard:

    Figure 31. Adding shortcuts to a user project by using the Dependency Tree

  5. Click OK.

    System Manager creates shortcuts to the selected components in the specified user project.

Using the Update Project wizard

The "Update Project" wizard provides an interface to add shortcuts to a user projects that is similar to the one displayed when you initially create a user project. Do the following to use the "Update Project" wizard:

  1. Right-click any user project in the WebSphere Business Integration System Manager view and choose Update project from the context menu.
  2. Enable the checkbox next to an integration component library to create shortcuts to all of the components within it or expand an integration component library folder and enable the checkboxes next to component groups, or expand the folders for groups and enable the checkboxes for individual components.
  3. Click Finish.

    If there are shortcuts in the user project to components with the same name as those you selected in the wizard, then the wizard displays a prompt that allows you to do the following:

    If you did not select any components with the same name as components for which shortcuts already exist in the user project, then shortcuts are added to the project and the wizard exits.

Dragging-and-dropping components

You can select components from integration component library folders and drag-and-drop them into a user project to add shortcuts to those components to the user project.

If there are no shortcuts in the folder of the user project currently then you must drag-and-drop the components onto the folder itself. Drag-and-drop the components onto the folder and release the mouse button when a square appears beneath the mouse pointer.

If there are already shortcuts in the folder of the user project then you cannot drag-and-drop components onto the folder. Drag-and-drop the components between existing shortcuts in the folder until a line appears and then release the mouse button.

Copyright IBM Corp. 1997, 2004