Meta Catalog preferences

You can access the Meta Catalog Preferences by choosing Window > Preferences and then selecting Progress OpenEdge > Meta Catalog.

The Meta Catalog preferences consist of the following pages:

Catalog list - A browse listing all the catalogs in your workspace.
Catalog Databases- A tab folder for viewing and editing catalog definitions.
Content Builders - A browse of all the content builders registered in your workspace.

Catalog List page

Meta Catalog browse	Lists all catalogs currently defined in the current workspace. Shows each catalog's name, its update mode, whether it is a local or master catalog, and whether it is configured to start automatically. Note: A master catalog always shows "false" in the Auto start column, because it does not start when you open your workspace. If the administrator has not started a database server for it, you cannot access it.
New	Launches the Create Meta Catalog wizard that steps you through creating a new local catalog to your workspace. Note: Each catalog must have a unique name.
Add Master	Launches the Add Meta Catalog wizard that steps you through adding connection information for a master catalog to your workspace. Note: You cannot define a master catalog with the same name as a local catalog.
Remove	Removes a catalog definition from your workspace. If you choose a local catalog, you can choose to also remove the physical database files. If you choose a master catalog, you can only remove the definition.
Import	Imports a set of catalog and content builder definitions into your workspace. Any current definitions are discarded, even if there is no matching entry in the imported definitions. If a matching database is not found for an imported local catalog definition, you are given the option to rebuild the missing databases. Note: All the designated content builders run to recreate the content from the source code. This can take some time depending on the number of catalogs being built and the number of resources from which data is extracted.
Export All	Exports the current set of catalog and content builder definitions to an XML file. By default, the definitions are stored in the catalog.xml file.
Rebuild	Rebuilds the selected catalog. This option is disabled for master catalogs. Note: This process deletes the physical database. All the designated content builders run to recreate the content from the source code. This can take some time if there are a lot of resources to extract data from.

Catalog Databases page

Main page	Catalog Name combo-box	The catalog definition to view or edit. The label to the right of the combo box indicates whether it is a local or master catalog.
	Update for open projects only toggle box	If selected, when a rebuild is launched for this catalog, only the resources in open projects are run through the content builders.
	Update catalog radio set	Method for updating a local catalog's content, as follows: On save of element - Appropriate content builders run each time a changed resource is saved. The data is written to all local catalogs whose definitions include the changed resource. This is the default setting. On rebuild - The catalog updates its contents only when it is rebuilt. You can do this with the Rebuild button on the Catalog List page or by using the command-line utility.
	Restore Defaults	Loads the last catalog definition that was saved.
	Apply	Saves any edits for the selected catalog to the internal version of the catalog.xml file in Progress Developer Studio for OpenEdge.
Database information	Local database toggle box	When selected, this indicates that the physical catalog database is on the local machine, rather than a remote machine. By default, local catalogs are assumed to be on the local machine.
	Meta Catalog database path	The full path of the physical catalog database, including the filename.
	Service/Port for server (-S)	The connection port or service name for the catalog's database server.
	Additional server parameters	Any necessary startup parameters for the database.
	Automatically start/stop server toggle box	Whether the catalog's server should automatically start or stop when you enter or leave this workspace.
Connection information	Host	Name of the host where the catalog is.
	Service/Port	The connection port or service for the catalog's database server.
	Database	The logical name of the database.
	User	The user name to use connecting to the database. Note: Because the catalog database is created with SQL, for local catalogs, you need to connect as a user with proper access to update the database.
	Password	The password to use connecting to the database.
Mapping of root path	Root path	The root path for a resource as it was originally read into the catalog. If you have resources on different paths loaded into the same catalog, each root path displays on a separate line of the browse.
	Local path	The path to your local copies of the resources in a master catalog.
	Edit	Launches a dialog box where you can map a root path to a local path. When there is a mismatch between your local path and a master catalog's root path for the same resource, setting this mapping between the paths produces the appropriate search results.
Content Builders	Code	Lists the codes for content builders that are defined in this workspace. Checking the toggle box beside a code indicates that the content builder supplies data to this catalog.
Content Builders	Description	The description of the content builder.
Projects	Project name	Lists the names of all projects in this workspace. Checking the toggle box beside a project indicates that data from that project's resources should be added to this catalog whenever an appropriate content builder runs.

Content Builders page

Code	The content builder's code.
Description	The description of the content builder.
Class	The Java class for the content builder.
Extensions	The file extensions against which the content builder should run.
New...	Launches a dialog for entering a new content builder definition.
Edit...	Launches a dialog for editing a content builder definition. For example, you might add a custom file extension to the existing extensions.
Remove	Removes a content definition from this workspace. This does not delete the content builder class file.
Restore Defaults	Deletes the current definitions and replaces them with the default definitions of the predefined content builders that ship with Progress Developer Studio for OpenEdge.
Apply	Saves any edits for the selected content builder to internal version of the catalog.xml file in Progress Developer Studio for OpenEdge.

Note: Changes to a content builder definition affect all catalogs in the workspace that use that content builder. You cannot change how a content builder behaves for a single catalog.