.NET API Reference for Oracle Identity Connector Framework 11.1.2
E41516-01
Runs a script in the same JVM or .Net Runtime as the
 Copy imageCopy
Connector
.

Namespace: Org.IdentityConnectors.Framework.Api.Operations
Assembly: Framework (in Framework.dll) Version: 1.4.0.0 (1.4.0.0)

Syntax

C#
public interface ScriptOnConnectorApiOp : APIOperation

Remarks

That is, if you are using a local framework, the script will be run in your JVM. If you are connected to a remote framework, the script will be run in the remote JVM or .Net Runtime.

This API allows an application to run a script in the context of any connector. (A connector need not implement any particular interface in order to enable this.) The minimum contract to which each connector must adhere is as follows:

  1. Script will run in the same classloader/execution environment as the connector, so the script will have access to all the classes to which the connector has access.
  2. Script will have access to a
     Copy imageCopy
    "connector"
    variable that is equivalent to an initialized instance of a connector. Thus, at a minimum the script will be able to access [!:Connector.getConfiguration() the configuration of the connector].
  3. Script will have access to any ScriptArguments passed in by the application.

A connector that implements ScriptOnConnectorOp may provide more variables than what is described above. A connector also may perform special processing for OperationOptions specific to that connector. Consult the javadoc of each particular connector to find out what additional capabilities, if any, that connector exposes for use in scripts.

NOTE: A caller who wants to execute scripts on a connector should assume that a script must not use any method of the connector beyond the minimum contract described above, unless the connector explicitly documents that method as "for use by connector script". The primary function of a connector is to implement the SPI in the context of the Connector framework. In general, no caller should invoke Connector methods directly --whether by a script or by other means.

See Also