Package com.thortech.xl.gc.spi
Interface ProvisioningFormatProvider
public interface ProvisioningFormatProvider
This interface should be implemented by a layer that incorporates provisioning
functionalities with a particular type of target application, to be used by a connector
created through the generic technology connector.
The implementation layer should mainly deal with data format generation and conversion of
provisioning data, initially present in Oracle Identity Manager-compatible format (
OIMSchema
) to
a structure according to relevant TargetSchema
while provisioning.
Examples of the implementation for this layer would be the
SPML provider, XML Provider (w.r.t a specific schema), E-Mail provider (w.r.t a specific template),
etc. The output of this layer needs to be passed to the corresponding implementation of the
ProvisioningTransportProvider
interface, which would then parse the extracted data/metadata.
All the methods of this interface throw ProviderException
. The implementations of this
interface should utilize this fact to wrap all possible exceptions ultimately in an instance
of ProviderException. Rich provider implementation layers are expected to be modular with
the main implementation methods calling a number of methods, which would be internally invoking
more internal layers of business logic. In such a case
it is recommended that you wrap all the possible Exceptions from all internal layers in instances
of ProvisioningFormatException
. The main methods of the implementation (which
are actually the ones defined in this interface) would then just have the try-catch blocks
with the catch portions for only ReconciliationTransportException and this exception instance
could then be wrapped in a ProviderException.- Version:
- 1.6, Oracle Identity Manager 9.1
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionformatData
(OIMRecord provData, OIMOperation operation, AssignmentTarget assignedTo, ArrayList list) This method parses the target records and convert them into a structure that Oracle Identity Manager understands.void
initialize
(Provider providerdata) This method initializes the providerparseMetadata
(TargetSchema schema) This method parses the target schema and return a schema understandable by OIM.
-
Method Details
-
initialize
This method initializes the provider- Parameters:
providerdata
- A value object that represents a provider instance. It can also be considered as a collection of provider parameter specifications. Provider parameters, runtime as well as design could be obtained from this value object instance. Check the API documentation forProvider
for more details.- Throws:
ProviderException
-
parseMetadata
This method parses the target schema and return a schema understandable by OIM. It is invoked by the generic technology connector framework while metadata detection, and its input is fed by the output ofProvisioningTransportProvider.defineMetadata()
. The point to be kep into consideration is metadata detection feature of the generic technology connector gives more priority to an implementation provided by Reconciliation providers (combination ofReconTransportProvider.getMetadata()
andReconFormatProvider.parseMetadata(TargetSchema)
). Therefore, if a reconciliation and provisioning connector is created, then the metadata detection implementation offered by reconciliation providers will be invoked first. Only if the invoked implementation does not return any metadata definition, then the provisioning providers metadata definition implementation would be invoked for further utilization.- Parameters:
schema
- A value object that represents the schema of an identity record in the target system. Check the API documentation forTargetSchema
for more details.- Returns:
- A value object that represents the schema of an identity record in Oracle Identity Manager.
Check the API documentation for
OIMSchema
for more details. - Throws:
ProviderException
- See Also:
-
formatData
TargetOperation formatData(OIMRecord provData, OIMOperation operation, AssignmentTarget assignedTo, ArrayList list) throws ProviderException This method parses the target records and convert them into a structure that Oracle Identity Manager understands. It is invoked by the generic technology connector framework while reconciliation execution, and its input is fed by the output ofReconTransportProvider.getFirstPage(int, String)
orReconTransportProvider.getNextPage(int)
.- Parameters:
provData
- Instance of a value object that represent an identity record in Oracle Identity Manager, to be provisioned to the target application.Check the API documentation forOIMRecord
for more details.operation
- Instance of a value object that represent an identity provisioning operation in Oracle Identity Manager Check the API documentation forOIMOperation
for more details.assignedTo
- Instance of a value object that represent the task assignment of an identity provisioning operation. Check the API documentation forAssignmentTarget
for more details.list
- For an operation that has been invoked on parent data, this ArrayList would be a collection of the fields of the "Account" dataset of "Provisioning Staging". Each member of this ArrayList would be an instance ofAttributeWithSource
. For an operation that has been invoked on a child table data, this ArrayList would be a collection of the fields of the relevant child dataset of "Provisioning Staging".- Returns:
- Instance of a value object that conforms to the data format in which target system expects input for
provisioning operations. Check the API documentation for
TargetOperation
for more details. - Throws:
ProviderException
- See Also:
-