The generic technology connector adapter is one of the connector objects created

20-10 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager

20.2.4 Developing Java Code Implementations of the Provider SPI Methods

Develop the Java code implementations of the SPI methods that are used during provider operations. As described earlier, these SPI methods are called at various stages of provider operations. See the Package com.thortech.xl.gc.spi page of the Javadocs for links to information about the SPI methods of each provider.

20.2.5 Developing Java Code for Logging and Exception Handling

Oracle recommends that you to incorporate logging in the Java code implementations of the value objects and SPI methods. By doing this, you can simplify troubleshooting errors that may occur when you use the providers. The logging modules for the generic technology connector framework are an extension of the logging functionality of Oracle Identity Manager. Table 20–2 lists the modules that are specific to the supported provider types. See Oracle Fusion Middleware Java API Reference for Oracle Identity Manager for information about incorporating exception handling in the custom provider.

20.2.6 Creating the Provider XML File

The provider XML file contains the data required to register the provider with the generic technology connector framework. You must create the provider XML file. Table 20–3 describes the elements that you can include in the provider XML files for custom providers. Reconciliation TargetRecord com.thortech.xl.gc.vo.runtime OIMRecord com.thortech.xl.gc.vo.runtime Note: You need not develop Java code implementations of SPI methods for the providers that you are not going to include in the generic technology connector. Table 20–2 Logging Modules Specific to the Supported Provider Types Logging Module Functional Module of the Generic Technology Connector Framework XELLERATE.GC.PROVIDER.PROVISIONINGFORMAT Provisioning format provider XELLERATE.GC.PROVIDER.PROVISIONINGTRANSPORT Provisioning transport provider XELLERATE.GC.PROVIDER.RECONCILIATIONTRANSPORT Reconciliation transport provider XELLERATE.GC.PROVIDER.RECONCILIATIONFORMAT Reconciliation format provider XELLERATE.GC.PROVIDER.TRANSFORMATION Transformation Provider XELLERATE.GC.PROVIDER.VALIDATION Validation Provider Note: You can use a single provider XML file to define any number of providers. Alternatively, you can create a provider XML file for each provider that you create. Table 20–1 Cont. Value Objects Used During Provider Operations Area of Use Value Object Javadocs Package Creating Custom Providers for Generic Technology Connectors 20-11 You must ensure that the provider XML file adheres to the schema definition provided in MDS. The locations for schema and provider definition XML files are as follows: PROVIDER_DEF_XSD_LOCATION = dbGTCSchema; PROVIDER_DEF_XML_LOCATION = dbGTCProviderDefinitions; Table 20–3 Elements of the Provider XML File Element Description Provider Root element of the provider XML file Reconciliation Parent element of the configuration elements that are used to describe reconciliation providers Provisioning Parent element of the configuration elements that are used to describe provisioning providers Transformation Parent element of the configuration elements that are used to describe transformation providers Validation Parent element of the configuration elements that are used to describe validation providers ReconTransportProvider Parent element of the configuration elements that are used to describe a reconciliation transport provider This element has the following attributes: name : Name of the provider class : Name of the Java class of the provider implementation ReconFormatProvider Parent element of the configuration elements that are used to describe a reconciliation format provider This element has the following attributes: name : Name of the provider class : Name of the Java class of the provider implementation ProvFormatProvider Parent element of the configuration elements that are used to describe a provisioning format provider This element has the following attributes: ■ name : Name of the provider ■ class : Name of the Java class of the provider implementation ProvTransportProvider Parent element of the configuration elements that are used to describe a provisioning transport provider This element has the following attributes: ■ name : Name of the provider ■ class : Name of the Java class of the provider implementation TransformationProvider Parent element of the configuration elements that are used to describe a transformation provider This element has the following attributes: ■ name : Name of the provider ■ class : Name of the Java class of the provider implementation ValidationProvider Parent element of the configuration elements that are used to describe a validation provider This element has the following attributes: ■ name : Name of the provider ■ class : Name of the Java class of the provider implementation