com.ptc.windchill.esi.svc
Interface ESIService

All Known Implementing Classes:

StandardESIService

public interface ESIService

Defines the ESI methods that are available to remote clients.

Supported API: true

Extendable: false

Method Summary

void	assignTarget(Persistable object, ESITarget target) Assign an object to an ESITarget for ESI target system destination determination.
void	assignTarget(Persistable object, com.infoengine.object.factory.Group targets) Assign an object to an Infoengine group of ESITarget objects for ESI target system destination determination.
ESITarget	createTarget(String name, String description, String system) Creates an ESITarget from the arguments and saves the result in the database.
ESITarget	createTarget(String name, String description, String system, WTContainerRef containerRef) Creates and persists an ESITarget.
void	deleteTarget(ESITarget tgt) Deletes an ESITarget from the database.
Collection	findESITargets(Persistable anObject) Returns a collection of ESITargets for the given object.
ESITarget	getTarget(String system) Return the ESI Target whose system attribute matches the argument.
ESITransaction	getTransaction(String id) Return the ESITransaction whose idNumber attribute matches the argument.
boolean	isInRelease(Persistable obj) Returns true if the given releasable object or any releasable iteration for the given master has been published to ERP .
boolean	isWfLaunched(wt.lifecycle.LifeCycleManaged anObject) Check whether there is a workflow process with the status of OPEN_RUNNING for the given object.
void	removeTargetAssignment(com.infoengine.object.factory.Group ufids) Deletes from the database the ESITargetAssignmentLink objects that are identified by the argument.
void	removeTargetAssignment(Persistable object, ESITarget target) Remove the relationship between an ESITarget and a persistable object.
void	removeTargetAssignment(String ufid) Deletes from the database the ESITargetAssignmentLink that is identified by the argument.

Method Detail

assignTarget

void assignTarget(Persistable object,
                  com.infoengine.object.factory.Group targets)
                  throws com.ptc.windchill.esi.tgt.ESITargetAssignmentException,
                         WTException

Assign an object to an Infoengine group of ESITarget objects for ESI target system destination determination. Delegates all work to an instance of ESITargetUtility.

Supported API: true

Parameters:

object - The object to which the target is being assigned

targets - The Infoengine group of ESITarget objects to be assigned to the object argument.

Throws:

com.ptc.windchill.esi.tgt.ESITargetAssignmentException

WTException

assignTarget

void assignTarget(Persistable object,
                  ESITarget target)
                  throws com.ptc.windchill.esi.tgt.ESITargetAssignmentException,
                         WTException

Assign an object to an ESITarget for ESI target system destination determination. Delegates all work to an instance of ESITargetUtility.

Supported API: true

Parameters:

object - The object to which the target is being assigned

target - The ESITarget to be assigned to the object argument.

Throws:

com.ptc.windchill.esi.tgt.ESITargetAssignmentException

WTException

createTarget

ESITarget createTarget(String name,
                       String description,
                       String system)
                       throws WTException

Creates an ESITarget from the arguments and saves the result in the database. Delegates all work to an instance of ESITargetUtility.

Supported API: true

Parameters:

name - The value to supply to the ESITarget name attribute.

description - The value to supply to the ESITarget description attribute.

system - The value to supply to the ESITarget ssytem attribute.

Returns:

ESITarget

Throws:

WTException

createTarget

ESITarget createTarget(String name,
                       String description,
                       String system,
                       WTContainerRef containerRef)
                       throws WTException

Creates and persists an ESITarget.

Supported API: true

Parameters:

name - The value to supply to the ESITarget name attribute.

description - The value to supply to the ESITarget description attribute.

system - The value to supply to the ESITarget system attribute.

containerRef - The current container ESI target resided.

Returns:

ESITarget

Throws:

WTException

deleteTarget

void deleteTarget(ESITarget tgt)
                  throws WTException

Deletes an ESITarget from the database. Delegates all work to an instance of ESITargetUtility.

Supported API: true

Parameters:

tgt - The object to be deleted.

Throws:

WTException

findESITargets

Collection findESITargets(Persistable anObject)
                          throws com.ptc.windchill.esi.utl.ESIException,
                                 WTException

Returns a collection of ESITargets for the given object. If the object is a WTChangeOrder2, return the targets associated with the changeables on the change order.

Supported API: true

Parameters:

anObject - The object whose ESITarget associations are to be found.

Returns:

Collection

Throws:

com.ptc.windchill.esi.utl.ESIException

WTException

getTarget

ESITarget getTarget(String system)
                    throws WTException

Return the ESI Target whose system attribute matches the argument. Throw an ESIException if no matching ESITarget exists. Delegates all work to an instance of ESITargetUtility.

Supported API: true

Parameters:

system - The value of the ESITarget system attribute.

Returns:

ESITarget

Throws:

WTException

getTransaction

ESITransaction getTransaction(String id)
                              throws WTException

Return the ESITransaction whose idNumber attribute matches the argument. Throw an ESIException if no matching transaction exists. Delegates all work to an instance of ESITransactionUtility.

Supported API: true

Parameters:

id - The idNumber attribute value for and ESITransaction that is to be fetched.

Returns:

ESITransaction

Throws:

WTException

isWfLaunched

boolean isWfLaunched(wt.lifecycle.LifeCycleManaged anObject)
                     throws com.ptc.windchill.esi.utl.ESIException,
                            WTException

Check whether there is a workflow process with the status of OPEN_RUNNING for the given object.

Supported API: true

Parameters:

anObject - The object whose workflow status is to be determined.

Returns:

boolean

Throws:

com.ptc.windchill.esi.utl.ESIException

WTException

isInRelease

boolean isInRelease(Persistable obj)
                    throws com.ptc.windchill.esi.utl.ESIException,
                           WTException

Returns true if the given releasable object or any releasable iteration for the given master has been published to ERP . Otherwise returns false.

Supported API: true

Parameters:

obj - The persistable object.

Returns:

boolean

Throws:

com.ptc.windchill.esi.utl.ESIException

WTException

removeTargetAssignment

void removeTargetAssignment(Persistable object,
                            ESITarget target)
                            throws WTException

Remove the relationship between an ESITarget and a persistable object. Delegates the deletion to an instance of ESITargetUtility.

Supported API: true

Parameters:

object - The object whose target association is to be removed.

target - The ESITarget that is no longer to be associated with the persistable object in the object argument.

Throws:

WTException

removeTargetAssignment

void removeTargetAssignment(String ufid)
                            throws WTException

Deletes from the database the ESITargetAssignmentLink that is identified by the argument. Delegates all work to an instance of ESITransactionUtility.

Supported API: true

Parameters:

ufid - The UFID of an ESITargetAssignmentLink that is to be deleted.

Throws:

WTException

removeTargetAssignment

void removeTargetAssignment(com.infoengine.object.factory.Group ufids)
                            throws WTException

Deletes from the database the ESITargetAssignmentLink objects that are identified by the argument. Delegates all work to an instance of ESITransactionUtility. Uses a database transaction so that all objects are deleted or none of them are.

Supported API: true

Parameters:

ufids - An Info*Engine group of Element objects. Each element has an Att object that contains the UFID of an ESITargetAssignmentLink that is to be deleted.

Throws:

WTException