# Mappings

###### Identifier:

org.eclipse.datatools.connectivity.sqm.core.mappings

###### Since:

DTP 1.7, June 2009

###### Description:

Provides a metadata-driven way to map a connection profile provider ID or a vendor/version combination to a driver category ID.

EXPERIMENTAL. This class or interface has been added as part of a work in progress. There is no guarantee that this API will work or that it will remain the same. Please do not use this API without consulting with the DTP Connectivity team.

###### Configuration Markup:

<!ELEMENT extension (providerIDtoDriverCategoryID)*>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT providerIDtoDriverCategoryID EMPTY>

<!ATTLIST providerIDtoDriverCategoryID

providerID CDATA #REQUIRED

driverCategoryID CDATA #REQUIRED>

Map a connection profile provider ID to a driver category ID. If mapped for a particular provider ID, this will override the mapping used in the wizard page and property page classes used for the ExtensibleProfileDetailsWizardPage and ExtensibleProfileDetailsWizardPage

- providerID - Connection Profile Provider ID. This maps to the provider ID defined in the connection profile extension point.
- driverCategoryID - Driver Category ID maps to the category id specified in the driver templates extension.

###### Examples:

An example of use of this mapping can be seen in the org.eclipse.datatools.connectivity.ui plug-in in the o.e.d.connectivity.ui.wizards package for the ExtensibleProfileDetailsPropertyPage and ExtensibleProfileDetailsWizardPage.

###### API Information:

Currently this can be accessed from the SQMServices (o.e.d.connectivity.sqm.core.SQMServices) via the method: public static ProviderIDMappingRegistry getProviderIDMappingRegistry(); From there you can access the Provider ID in a number of ways: public String getCategoryIDforProviderID ( String providerID ); public String getProviderIDforDriverCategoryID ( String driverCategoryID ); public String getProviderIDforVendorVersion ( String vendor, String version); So you'll be able to get a driver category ID for a connection profile provider ID, a connection profile provider ID from a driver category ID, and a connection profile provider ID from a vendor/version.

Copyright 2009 Sybase, Inc. and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html