Component Interface Map Definitions

The component interface map contains the list of component interfaces available to the adapter.

The interfaces object contains a list of component interfaces. If you have a custom component interface, you must define your own component interface definition in the map. Edit the PeopleSoft Component Interfaces Configuration object and add your definition as an additional Object into the <List> element under the <Attribute name=’interfaces’> element.

Each available component interface has its own definition. Key elements of a component interface definition include:

• name. The label of a component interface. It often matches the value of the componentInterface attribute, but this is not a requirement. The value will be displayed in the drop-down menu on the adapter’s Resource Parameters page.

• componentInterface attribute. The name of the component interface, as defined in PeopleSoft.

• getKey attribute. The name of the component interface property that is set when performing a PeopleSoft GET operation. If getKey is not defined, then the key attribute is used instead.

• findKey attribute. The name of the component interface property that is set when performing a PeopleSoft FIND operation. If findKey is not defined, then the key attribute is used instead.

• createKey attribute. The name of the component interface property that is set when performing a PeopleSoft CREATE operation. If createKey is not defined, then key attribute is used instead.

• key attribute. Deprecated. Use getKey, findKey, or createKey instead.

• properties attribute. A list of properties that can be read or set from the PeopleSoft component interface.

  Each Object in the properties list must have the following attribute:

  • name. The name of the property. This must match exactly with the name of a property exposed by the PeopleSoft component interface identified by the componentInterface property. The names of the properties are candidates to be listed as resource user attributes on the Account Attributes page.

    If this a collection property, then you must define additional attributes. A collection property defines its key property and its own nested set of simple and/or complex properties:

  • isCollection attribute. If the property is a collection, then set this to true.

  • key attribute. If the property is a collection, set this to the name of the property that uniquely identifies each item of the collection.

  • properties attribute. The list of properties that can be read/set for each item of the collection. To support arbitrary complexity, each member of this list is an Object with the same allowed attributes as the parent. That is, it can contain its own name, isCollection, key, and properties attributes.

  disableRule attribute. An Object that defines the logic to compute and set the user disable state. This attribute contains the following attributes

  • property attribute. The property to check. The value must be listed in the properties attribute for the componentInterface object.

  • trueValue attribute. A value that indicates the user is disabled.

  • falseValue attribute. A value that indicates the user is enabled.

  supportedObjectTypes attribute. A list of Waveset resource objects types that can be accessed through the adapter. Each object defines a set of features.

  • features attribute. A list supported features. Possible feature types include view, get, list, find, create, saveas, update, rename, and delete.

Default Component Interfaces Supported

The default Component Interface configuration object defines the following interfaces:

• USER_PROFILE. Performs create, read, and update actions.

• DELETE_USER_PROFILE. Deletes user accounts.

• ROLE_MAINT. Adds support for PeopleSoft roles.

USER_PROFILE Component Interface

The default USER_PROFLE component interface definition is used to perform create, read, and update actions. The key and findKey attributes are set to UserID, because the USER_PROFILE component interface assigns the UserID field for the GETKEYS and FINDKEYS keys.

The default definition for the USER_PROFILE component interface does not define all of the possible properties. It has been simplified to include those used in the sample user form. If you need to add more resource user attributes to the Account Attributes page, then the component interface definition must be updated first. A resource user attribute cannot be added to that page unless it is listed in the component interface definition.

Most properties are defined in USER_PROFILE are simple objects. However, the IDTypes and Roles objects are collections and can have multiple values. IDTypes contains a collection of its own, Attributes. These objects must include the isCollection attribute, the key name for the collection, and at least one property.

DELETE_USER_PROFILE Component Interface

The DELETE_USER_PROFILE component interface definition is used to delete user profile definitions. The OPRID key determines which user profile is to be deleted. Since the component interface does not have properties, none are listed in the definition.

ROLE_MAINT Component Interface

The ROLE_MAINT component interface definition is part of a sample implementation that illustrates how Waveset can be configured to list role resource objects. Other resource objects can be listed by following the general guidelines listed below and modifying the ROLE_MAINT example to match your requirements.

The PeopleSoft Component Interface adapter supports listing resource objects only. It does not support other object features, such as update, create, or delete.

The ROLE_MAINT component interface definition has the following characteristics of note:

• The findKey and getKey attributes are assigned to ROLENAME because ROLENAME is the primary key for FINDKEYS and GETKEYS.

• DESCR and ROLESTATUS are also keys in FINDKEYS, but since they are not primary keys, they are not listed as values for findKey. Instead, they are listed in the properties section.

• The supportedObjectTypes attribute defines the Role object. The Role object supports the find and get features.