com.evolveum.midpoint.xml.ns._public.model.model_1
Interface ModelPortType

All Known Implementing Classes:
ModelWebService

public interface ModelPortType

This class was generated by the JAX-WS RI. JAX-WS RI 2.1.3-b02- Generated source version: 2.1


Method Summary
 java.lang.String addObject(ObjectType object, javax.xml.ws.Holder<OperationResultType> result)
          Add new object.
 void deleteObject(java.lang.String oid, javax.xml.ws.Holder<OperationResultType> result)
          Deleted object with provided OID.
 ObjectType getObject(java.lang.String oid, PropertyReferenceListType resolve, javax.xml.ws.Holder<OperationResultType> result)
          Returns object for provided OID.
 PropertyAvailableValuesListType getPropertyAvailableValues(java.lang.String oid, PropertyReferenceListType properties, javax.xml.ws.Holder<OperationResultType> result)
          Returns list of available values for specified properties.
 EmptyType importFromResource(java.lang.String resourceOid, javax.xml.namespace.QName objectClass, javax.xml.ws.Holder<TaskType> task)
          TODO: update description Launch import task that will import all the accounts from the resource.
 UserType listAccountShadowOwner(java.lang.String accountOid, javax.xml.ws.Holder<OperationResultType> result)
          Returns the User object representing owner of specified account (account shadow).
 ObjectListType listObjects(java.lang.String objectType, PagingType paging, javax.xml.ws.Holder<OperationResultType> result)
          Returns all objects of specified type in the repository.
 ObjectListType listResourceObjects(java.lang.String resourceOid, javax.xml.namespace.QName objectType, PagingType paging, javax.xml.ws.Holder<OperationResultType> result)
          WARNING: This operation should not be here.
 ResourceObjectShadowListType listResourceObjectShadows(java.lang.String resourceOid, java.lang.String resourceObjectShadowType, javax.xml.ws.Holder<OperationResultType> result)
          Search for resource object shadows of a specified type that belong to the specified resource.
 void modifyObject(ObjectModificationType objectChange, javax.xml.ws.Holder<OperationResultType> result)
          Modifies object using relative change description.
 ObjectListType searchObjects(QueryType query, PagingType paging, javax.xml.ws.Holder<OperationResultType> result)
          Search for objects in the repository.
 void testResource(java.lang.String resourceOid, javax.xml.ws.Holder<OperationResultType> result)
          WARNING: This operation should not be here.
 

Method Detail

addObject

java.lang.String addObject(ObjectType object,
                           javax.xml.ws.Holder<OperationResultType> result)
                           throws FaultMessage
Add new object. The OID provided in the input message may be empty. In that case the OID will be assigned by the implementation of this method and it will be provided as return value. This operation should fail if such object already exists (if object with the provided OID already exists). The operation may fail if provided OID is in an unusable format for the storage. Generating own OIDs and providing them to this method is not recommended for normal operation. Should be atomic. Should not allow creation of two objects with the same OID (even if created in parallel). The operation may fail if the object to be created does not comform to the underlying schema of the storage system or the schema enforced by the implementation. Faults: any SystemFaultType ObjectAlreadyExistsFaultType IllegalArgumentFaultType: wrong OID format SchemaViolationFaultType: provided object violates datastore schema

Parameters:
result -
object -
Returns:
returns java.lang.String
Throws:
FaultMessage

getObject

ObjectType getObject(java.lang.String oid,
                     PropertyReferenceListType resolve,
                     javax.xml.ws.Holder<OperationResultType> result)
                     throws FaultMessage
Returns object for provided OID. Must fail if object with the OID does not exists. Reference resolution is SUPPORTED by this operation. Faults: any SystemFaultType IllegalArgumentFaultType: wrong OID format ObjectNotFoundFaultType: object with specified OID does not exists

Parameters:
result -
resolve -
oid -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.ObjectType
Throws:
FaultMessage

listObjects

ObjectListType listObjects(java.lang.String objectType,
                           PagingType paging,
                           javax.xml.ws.Holder<OperationResultType> result)
                           throws FaultMessage
Returns all objects of specified type in the repository. Not very practical, but good for now. Will be improved later. Faults: any SystemFaultType IllegalArgumentFaultType: wrong object type

Parameters:
result -
objectType -
paging -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.ObjectListType
Throws:
FaultMessage

searchObjects

ObjectListType searchObjects(QueryType query,
                             PagingType paging,
                             javax.xml.ws.Holder<OperationResultType> result)
                             throws FaultMessage
Search for objects in the repository. Searches through all object types. Returns a list of objects that match search criteria. Faults: any SystemFaultType IllegalArgumentFaultType: wrong object type SchemaViolationFaultType: unknown property used in search query

Parameters:
result -
query -
paging -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.ObjectListType
Throws:
FaultMessage

modifyObject

void modifyObject(ObjectModificationType objectChange,
                  javax.xml.ws.Holder<OperationResultType> result)
                  throws FaultMessage
Modifies object using relative change description. Must fail if user with provided OID does not exists. Must fail if any of the described changes cannot be applied. Should be atomic. If two or more modify operations are executed in parallel, the operations should be merged. In case that the operations are in conflict (e.g. one operation adding a value and the other removing the same value), the result is not deterministic. The operation may fail if the modified object does not comform to the underlying schema of the storage system or the schema enforced by the implementation. TODO: optimistic locking Faults: any SystemFaultType ObjectNotFoundFaultType: object with specified OID does not exists IllegalArgumentFaultType: wrong OID format InapplicableOperationFaultType: decribed change is not applicable SchemaViolationFaultType: resulting object would violate datastore schema

Parameters:
result -
objectChange -
Throws:
FaultMessage

deleteObject

void deleteObject(java.lang.String oid,
                  javax.xml.ws.Holder<OperationResultType> result)
                  throws FaultMessage
Deleted object with provided OID. Must fail if object with specified OID does not exists. Should be atomic. Faults: any SystemFaultType ObjectNotFoundFaultType: object with specified OID does not exists IllegalArgumentFaultType: wrong OID format

Parameters:
result -
oid -
Throws:
FaultMessage

getPropertyAvailableValues

PropertyAvailableValuesListType getPropertyAvailableValues(java.lang.String oid,
                                                           PropertyReferenceListType properties,
                                                           javax.xml.ws.Holder<OperationResultType> result)
                                                           throws FaultMessage
Returns list of available values for specified properties. The returned values can be used as valid values for properties of the specific object. The provided values can be used e.g. for listing them in GUI list boxes, for early validation (pre-validation), displaying help messages, auto-complete, etc. In case the list of available values is too big or it is not available, the empty list should be returned, setting the "closed" flag to false. This optional operation is SUPPORTED by this interface. Faults: any SystemFaultType UnsupportedObjectTypeFaultType: specified object type is not supported by the interface ObjectNotFoundFaultType: object with specified OID does not exists IllegalArgumentFaultType: wrong OID format

Parameters:
result -
oid -
properties -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.PropertyAvailableValuesListType
Throws:
FaultMessage

listAccountShadowOwner

UserType listAccountShadowOwner(java.lang.String accountOid,
                                javax.xml.ws.Holder<OperationResultType> result)
                                throws FaultMessage
Returns the User object representing owner of specified account (account shadow). May return (null?? empty??) object if there is no owner specified for the account. Implements the backward "owns" assosciation between account shadow and user. Forward assiciation is implemented by property "account" of user object. Faults: any SystemFaultType IllegalArgumentFaultType: wrong OID format ObjectNotFoundFaultType: object with specified OID does not exists

Parameters:
result -
accountOid -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.UserType
Throws:
FaultMessage

listResourceObjectShadows

ResourceObjectShadowListType listResourceObjectShadows(java.lang.String resourceOid,
                                                       java.lang.String resourceObjectShadowType,
                                                       javax.xml.ws.Holder<OperationResultType> result)
                                                       throws FaultMessage
Search for resource object shadows of a specified type that belong to the specified resource. Returns a list of such object shadows or empty list if nothing was found. Implements the backward "has" assosciation between resource and resource object shadows. Forward assiciation is implemented by property "resource" of resource object shadow. Faults: any SystemFaultType IllegalArgumentFaultType: wrong OID format ObjectNotFoundFaultType: object with specified OID does not exists

Parameters:
result -
resourceObjectShadowType -
resourceOid -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.ResourceObjectShadowListType
Throws:
FaultMessage

listResourceObjects

ObjectListType listResourceObjects(java.lang.String resourceOid,
                                   javax.xml.namespace.QName objectType,
                                   PagingType paging,
                                   javax.xml.ws.Holder<OperationResultType> result)
                                   throws FaultMessage
WARNING: This operation should not be here. It is in fact just a diagnostics methods from the provisioning interface that need to be accessed from GUI. Do not use it for anything serious. It will disappear eventually. Returns all objects of specified type that are available to the implementation. Returns empty list if object type is correct but there are no objects of that type. Should fail if object type is wrong (e.g. specified type is not part of resource schema). This method does NOT use any shadow objects for reference or any other business objects in the local repository. It goes directly to the resource. The returned objects (indirectly) complies with the resource schema, but it is returned re-formated in a form of detached shadow object. Although the form is the same as shadow object, this is NOT really a shadow object because it is not stored in the repository (it is detached). It does NOT have oid. The object is identified by whatever identification properties/attributes are defined by the resource schema. This method is not required to implement any form of caching, queueing, reference resolution or any other "smart" algorithm. any SystemFaultType IllegalArgumentFaultType: wrong object type ProvisioningFaultType: ??? Use of this method is not recommended if there is a way how to do the same using the standard "object access" methods. E.g. if accounts can be namipulated using account shadows, the shadows should be used. This method is provided only to support the rare case that an unknown resource object type should be used in business logic and for diagnostics reasons.

Parameters:
result -
resourceOid -
objectType -
paging -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.ObjectListType
Throws:
FaultMessage

testResource

void testResource(java.lang.String resourceOid,
                  javax.xml.ws.Holder<OperationResultType> result)
                  throws FaultMessage
WARNING: This operation should not be here. It is in fact just a diagnostics methods from the provisioning interface that need to be accessed from GUI. Do not use it for anything serious. It will disappear eventually. Test the resouce connection and basic resource connector functionality. This operation will NOT raise fault in case the resource connection fails. It such case it will indicate the failure in the return message, but the operation itself succeeds. The operations fails only if the provided arguments are wrong, in case of system error, system misconfiguration, etc. Faults: any SystemFaultType ObjectNotFoundFaultType: specified Resource definition does not exist

Parameters:
result -
resourceOid -
Throws:
FaultMessage

importFromResource

EmptyType importFromResource(java.lang.String resourceOid,
                             javax.xml.namespace.QName objectClass,
                             javax.xml.ws.Holder<TaskType> task)
                             throws FaultMessage
TODO: update description Launch import task that will import all the accounts from the resource. WARNING: This operation is not considered public. It is a temporary solution until we have full-featured task management. It may be removed any time without a warning. DO NOT USE IT unless you are really sure you know what you are doing. Faults: any SystemFaultType ObjectNotFoundFaultType: specified Resource definition does not exist

Parameters:
task -
resourceOid -
objectClass -
Returns:
returns com.evolveum.midpoint.xml.ns._public.common.common_1.EmptyType
Throws:
FaultMessage


Copyright © 2011 evolveum. All Rights Reserved.