Skip to Content
Author's profile photo Former Member

Using Folders in PI 7.1

With the development tools in NW PI 7.1, folders are introduced. Folders can be used as an additional option to organize projects and interfaces.

In this blog, I will discuss how folders are used, and their pros and cons.

Folders are available in both the Enterprise Service Repository (ESR) and the Integration Directory (ID). Yes, ESR is the replacement for what we have been used to as the Integration Repository in PI 7.0 and XI 3.0. ESR contains many enhancements and additions, one of which is the use of folders. Other features of the ESR will be discussed in other blogs.

I will discuss the use of folders in 2 different sections: ESR and ID

  1. Enterprise Service Repository.

    In the ESR, the use of folders can easily be adopted. It is very much similar to what we have been used to in working with the Windows File Explorer. It is an additional way to allow us to organize our projects and interfaces. However, there is a minor difference of how the objects will be displayed, with and wihout using folders.

    Folders can be created under a namespace. As you will notice, mulitple folders can be created under the same namespace. And, folders can be created within folders.


    As you can see in the above, A contains ESR objects created within a folder. B contains ESR objects created without a folder.

    The obvious difference is that without using a folder, ESR objects are organized under specific object groups, e.g. Data Types, Message Types, Service Interfaces (evolved from Message Interfaces). This is identical to what we are used to in PI 7.0.

    When a folder is used, the objects created within the folder are no longer organized within object groups. We must use either the icons or our own naming convention to identify the object type, or we can create folders to group the different object types.

    One convenience of using folders is that when we wish to delete the objects inside a folder, we can just delete the folder.


    • It is not necessary for us to use folders, especially for those of us who are starting out with PI development and are still relying on the grouping of the objects to facilitate our development smoothly. In most cases, we have been doing fine by organizing our projects by using SWCVs and namespaces.
    • For those cases where the interfaces for scenario become complex, and we wish to more logically separate the objects to ease our development and support tasks (e.g. to separate source and target interfaces), then folders can be very helpful. It is also very useful when we want to create many different test interfaces during development and do not wish to create additional SWCVs and namespaces. Many times by lumping all the test interfaces under the same namespace can be very confusing.
    • Need to control authorization to specific objects. By using Folders, we can easily control access to view and change the design objects based on groups assigned to userids.
  2. Integration Directory.

    The affect of using folders in the ID is much more dramatic. I think the advantages and disadvantages will be debated for many moons to come.

    Before we get into folders, let us talk about Scenarios first. I think they are somewhat related, as they both help us to organize our applications.

    In PI 7.0 and XI 3.0, we organize our end-to-end integration processes using “Configuration Scenarios”. Within each Scenario, we can include configurations for Communication Channels, Sender and Receiver Agreements, Receiver Determinations, etc. The scenarios are also used for transports between the landscapes. The scenario allows us to see only those relevant objects we need for our integration application.

    First, let us take a look at a Scenario in PI 7.0.


    There is a Scenarios tab. And, under each Scenario, we can find all the configuration objects for that scenario. The objects inside each Scenario are logical pointers to the actual objects in the Objects tab, therefore, if an object is used in multitple Scenarios, then that object can show up in everyone of them.

    Now, let us take a look at Scenario in PI 7.1.


    If you notice, the “Scenarios” tab is gone. Scenario is now under Objects, as a header for a grouping of Scenarios. Also, you cannot expand a scenario on the left panel to see all the relevant objects, as in PI 7.0. You can only see those objects on the right panel, after double-clicking on the scenario. Of course, you can then detach the panel or form to simulate the prior functionality.

    From usability perspective, this is probably a “take-away”. Of course, this is probably where Folder can come in and replace that feature. Then, if so, why do we still have Scenarios? So, let’s continue.

    Below is a screenshot of folders in PI 7.1.


    Similarly to ESR, folders can have more folders, this is very much like directories and subdirectories in File Explorer. The objects in a folder can be displayed just as in PI 7.0’s Scenarios. And, when you double-click on an object, the object will be opened on the right panel.

    However, there is one big difference between Folders in PI 7.1 and Scenarios in PI 7.0. The objects in Folders are not logical pointers to “actual” objects, as in Scenarios. This means that when an object is contained in one folder, this object cannot be present (or shown) in another folder. And, if you move that object to another folder, it will physically be moved. The original folder will no longer contain that object. This is just like files in directories. For example, if a folder contains a Business System, then this Business System will not, and cannot, be shown in any other place. This makes very difficult to determine whether a Business System has already been assigned to the ID, or if a Communication Channel has already been configured, because they might exist (or hidden) in a folder created by someone else (or moved by someone else to his own folder). You will not be able to see all the Communication Channels for a Business System in one place, because they may be spread across many folders. You will have to use the Search tool to find them, or turn off the Folder view (see below).

    As a result, using Folders can be risky, because you may end up either creating duplicate objects, or have to spend time looking for an object. Consequently, we must plan very carefully and agree upon standards or rules when using Folders.

    The main benefit of Folders is that you can create access authorizations to folders, e.g. this can prevent access by just anyone to see or change the configurations of an integration process or specific objects.


    • Use Folders when you need to control access to objects in the ID.
    • Plan and establish rules and standards when using folders, such as create a shared folder to contain all the shared objects, e.g. Business Systems and Communication Channels.
    • Continue to use Scenarios, even though the usability may have been decreased.

    Incidently, you can go back to the “old” view, without seeing any folders, by filtering it out.


Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Former Member
      Former Member
      It is nice feature but need to be used very carefully to group common objects and logical groupings.


      Author's profile photo Bhavesh Kantilal
      Bhavesh Kantilal

      The folders option under Namespaces make a lot of sense in the IR. We have seen cases, when Namespace's have actually pointed to a Business Scenario in a project and each of these Namespace, in the true XI sense actually contained many objects used across interfaces.

      Having the folders under a Namespace provides for one more level of classification and this sure does help.

      Integration Directory, am still not sure as to how things will work and hence will wait till I actually start using.

      On a different note, when will 7.1 be available for Partners?Can't wait to get my hands dirty on the same!


      Author's profile photo Former Member
      Former Member
      Blog Post Author
      The current plan is that PI 7.1 will be available for ramp-up in December, 2007.  There are several weblogs on 7.1 already.  Udo Paltzer has an overview of new features.  You can do a search of "7.1" for Weblogs.

      This year's TechEd sessions will also focus on 7.1, including the hands-on sessions.

      Folder is built into the UI framework from which ESR and ID are based.  Even though it might make more sense for ESR, but since ID is also using the same framework, so folder is also available in it.


      Author's profile photo Former Member
      Former Member
      but 've to wait until this year end
      Author's profile photo Former Member
      Former Member
      Hi Bill,

         I tried to use folders and it worked for most part but Message Types didn't show up when I tried to do message mapping. But when they were moved out of the folder they showed up. Am not sure if this is a bug or I am doing something wrong.