Project Pane

The View - Panes - Project pane lists all components in the project and provides the primary interface for organizing and using components.  By default, the Project pane appears with the Contents pane in a tab strip to the right of the Manifold desktop.

 

tabs_project_contents_panes00.png

 

If the Contents pane is in the foreground, click on the Project pane tab to bring the Project pane forward.   The Project pane can be switched off and on from the main menu by using View - Panes - Project.

 

Alt-click the Project pane's tab to undock the Project pane.   Alt-click the title bar to dock it again.   An undocked project pane can be resized and moved anywhere on our Windows desktop.  See the User Interface Basics topic.

 

i_project_pane01_00.png

 

The toolbar at the top provides the usual Windows Cut, Copy, Paste and Delete commands, which are enabled when we click or Ctrl-click a component to highlight it.  

 

With the focus on the Project pane, keyboarding the first few letters of a desired component will highlight that component.

 

i_project_pane01_00a.png   i_project_pane01_00b.png

 

For example, with the AutoLookup query selected as seen above, if we keyboard the letters cus the highlighting will jump to the first component beginning with those letters, the Customer List query.

Filtering what the Project Pane Shows

Projects can have hundreds of components, so it helps to be able to keep the project pane organized (use folders) and to filter what the project pane shows.

 

i_project_pane01_01.png

 

A filter box allows us to enter text by which to filter the contents of the pane so we can more easily find components when projects are very large.    

 

i_project_pane01_01a.png

 

The Project pane will show only those components that have in their names the text entered (case not significant) into the filter box, as illustrated above using the text emplo to show components that have Employee in their name.

 

btn_filter.pngA Filter button to the right specifies what types of components are displayed and how they are sorted for display, by Name or by Type.   By default the Project pane displays components sorted alphabetically by their name.  We can choose to show only one type of component, for example, choosing the Tables option to show only tables.   The Filter button will display the icon for whatever component type has been chosen to alert us the Project pane is showing a filtered view.

 

i_project_pane01_01b.png   i_project_pane01_01c.png

Create a New Component

i_project_pane01_02.png

We can create a new component by right-clicking into white space in the Project pane and choosing the component desired from the resulting context menu.   We can also launch the creation menu from the main menu by choosing File - Create.    The context menu will have choices on it depending on which component was right-clicked, for example, adding a ! Run command if a query or script is right-clicked.

 

i_project_pane01_03.png

Copy and Paste

The Project pane uses classic Windows moves to manipulate components.   For example, we can click on a component to highlight it and then press the Copy icon to copy it.  Pressing the Paste icon then pastes a copy of the component into the Project pane.   If we have two Manifold sessions open Copy and Paste work between them.

 

The usual Windows moves work as expected:  Ctrl-click to toggle whether a component has been highlighted, so by Ctrl-clicking on several different components we can highlight them each.   Ctrl-click to highlight a component and then a Shift-click on another component will highlight all components in between.

 

Cut and Moving Components

We can move components, for example, into a folder, by using Cut and then Pasting the components into the folder, or we can use drag and drop.

 

i_project_pane01_04.png

 

For example, if we want to move several components we can click on the first one to highlight it and then Shift-click on the last and all the components in between will be highlighted as well.

 

i_project_pane01_05.png

 

We can then drag and drop the highlighted components into a folder.

 

i_project_pane01_06.png

 

Folders are a great way to keep a large project organized.   We can click on the + icon box by a folder to open it and to see what is inside.

 

i_project_pane01_07.png

Renaming Components

To rename a component we slowly double-click it to open it for editing.

 

 

i_project_pane01_08.png

 

We can then change the name as desired.

 

i_project_pane01_09.png

 

Press Enter to accept the edits.  Press Esc to abandon the edits.

 

i_project_pane01_10.png

 

 

Filter Button Examples

The Filter button specifies what type of components are displayed and the sort order used.

 

i_project_pane01_11.png

 

 

By default all types of components are displayed.

 

i_project_pane01_12.png

 

If we use the Filter button to choose Tables then only tables will be displayed.

 

i_project_pane01_13.png

 

If we use the Filter button to choose Images then only images will be displayed.

 

i_project_pane01_14.png

 

Changing the setting of the Filter button will not open up folders.   It simply changes the display of whatever folders are already open.   

 

i_project_pane01_15.png

 

Filter Box Examples

When any text is entered into the filter box only those components which contain the text will be displayed.  Case is not significant.

 

eg_project_pane01_01.png

 

We start with a project containing tables and queries.    The moment we enter a c character in the box only those components which contain a c character anywhere in their name will be displayed.

 

eg_project_pane01_02.png

 

As we continue by adding an a character only those components which contain the two-character sequence ca anywhere in their names will be displayed.

 

eg_project_pane01_03.png

 

All that matters is that the sequence exists in the name of the component and not whether it is in the beginning, middle or end of the name.   For example, entering the two-character sequence og will cause only the component named Catalog to appear.

 

eg_project_pane01_04.png

Portals to Other Worlds

When we add a data source to a project we create, in effect, a portal to a different world.   When we open the data source to show the hierarchy within, the Project pane is giving us a view into the different world of that data source, where the rules that apply are the rules of that world.    For example, if we create a read-only data source, then we can open the hierarchy within that data source and view what is in it, but we cannot add components within that world and we cannot change components within that world.

 

il_portal_other_worlds01_01.png

 

Consider the above illustration, a section of a screenshot shown in the Example: Create a Drawing from Read-Only Geocoded CSV File topic.   The portion of the hierarchy shown within the read-only data source is read-only.  We cannot create any new components in that portion of the Project pane because that portion resides in the different world of a read-only data source that links in a read-only .csv file.  We can open the Dots table and read data from it and the table can participate in queries by providing data, but we cannot change anything in that table.  For example, we cannot change the schema of the table by adding fields or indexes to it and we cannot edit values within records in that table.  

 

The region bordered in green and marked Read / Write is part of the world of the local project.   We can do whatever we like in that region, such as right-clicking there and using Create - New Drawing to create a new drawing in the project.

 

il_portal_other_worlds01_02.png

 

Consider the above illustration, a section of a screenshot shown in the Example: Create a Data Source within an Existing Data Source topic.  It shows worlds within worlds.  The hierarchy within the Europe data source is a world within the .map file called Europe.map that was linked in as a data source into our Project.   The hierarchy our Project pane shows is a window into the world of that other .map file.    It shows that within the Europe map file's world there are yet three more worlds, a linked in data source called England and two more linked in data sources called France and Germany, all of them linked in from other .map files.  

 

One of the worlds, that is, data sources, has been expanded so we can see a window into that world as well, the world of the Germany.map file.    In the above illustration all of the linked in worlds are themselves Manifold Release 9 .map files that have been linked in without any read-only restrictions, so we can work with them with full Manifold capabilities.    The rules which apply within those worlds are the same as the rules which apply in the local project, since Manifold is seamless in that way.  

 

However, if the world of, say, the Germany data source was that of a database such as SQL Server or PostgreSQL, then whatever rules which such databases apply within their own projects, for example, what data types are available,  would apply within that hierarchy.

 

Notes

MFD_ is reserved - All names starting with mfd_ (case not significant) are reserved for use by the system.  Names for fields, indexes, constraints, tables, components other than tables, properties... everything. Do not name anything beginning with mfd_ or MFD_ or in any upper or lower case combination of those characters.   mfd_id is a reserved name for a field in tables, to be used only for the identity field that Manifold maintains as an automatically unique value field.

 

Deletions are Confirmed - Deleting components in the Project pane displays a confirmation dialog. The default button in the confirmation dialog is set to Cancel.  If we do not want to see the confirmation dialog, we can check the Never show this again box.    Another way to eliminate the confirmation dialog is to uncheck the Confirm deleting components box in the Tools - Options dialog.

See Also

Getting Started

 

User Interface Basics

 

View - Panes - Info

 

Example: Project Pane Tutorial - In this example we take an extended tour of the Project pane, engaging in a variety of simple but typical moves that are illustrated step by step.