Package com.ptc.windchill.enterprise.doc.forms

Class DocAttributePopulator

java.lang.Object

com.ptc.core.components.forms.DefaultAttributePopulator

com.ptc.windchill.enterprise.doc.forms.DocAttributePopulator

All Implemented Interfaces:

com.ptc.core.components.forms.AttributePopulator, Externalizable, Serializable

public class DocAttributePopulator
extends DefaultAttributePopulator
implements Serializable

Populator class used for populating document attributes for the insert document action.

Supported API: true

Extendable: true

See Also:

• Serialized Form

Field Summary

Fields inherited from class com.ptc.core.components.forms.DefaultAttributePopulator

EXTERNALIZATION_VERSION_UID

Method Summary

Modifier and Type	Method	Description
List<String>	getAttributeList()	Retrieve the list of attributes which are to be processed.
TypeInstance	prePopulateAttributeDisplayValues(TypeInstance ti, NmCommandBean cb)	Prepopulate the TypeInstance of the Doc based on the search results.
void	processAttribute(WTDocumentMaster dm, String key, TypeInstance ti, AttributeIdentifier ai)	Method responsible for processing the specified attribute against the current change request and storing this attribute value in the TypeInstance.
protected void	setAttribute(TypeInstance ti, AttributeIdentifier ai, Object value)	Set the value specified against the attribute identifier in the TypeInstance.
void	setAttributeList(List<String> atts)	Set the attribute list to process.
TypeInstance	setAttributeValues(TypeInstance ti, NmCommandBean cb)	Prepopulate the TypeInstance of the Document based on the search results.

Methods inherited from class com.ptc.core.components.forms.DefaultAttributePopulator

attemptToSetAttrValueFromFormData, getAllValueChangedAttributes, getAttrValueFromFormData, getContainerRef, getContainerRef, getFolderFromLaunchContext, isContainerOverridable, readExternal, setAttributeState, writeExternal

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getAttributeList

public List<String> getAttributeList()

Retrieve the list of attributes which are to be processed.

Supported API: true

Returns:

List <String> The list of attributes which require processing.

setAttributeList

public void setAttributeList(List<String> atts)

Set the attribute list to process.

Supported API: true

Parameters:

atts - The attribute list to process

prePopulateAttributeDisplayValues

public TypeInstance prePopulateAttributeDisplayValues(TypeInstance ti,
 NmCommandBean cb)

Prepopulate the TypeInstance of the Doc based on the search results. If the launching point object is not a part master this method will return the unmodified TypeInstance.

The following fields will be propagated:

• Name
• Number
• docType

If additional fields are desired, the getAttributeList() and processAttribute() methods should be overloaded and provided with the additional implementation.

Supported API: true

Specified by:

prePopulateAttributeDisplayValues in interface com.ptc.core.components.forms.AttributePopulator

Overrides:

prePopulateAttributeDisplayValues in class DefaultAttributePopulator

Parameters:

ti - The type instance returned prior to creating attributes step.

cb - The current command bean.

Returns:

the modified type instance if the conditions above are satisfied.

processAttribute

public void processAttribute(WTDocumentMaster dm,
 String key,
 TypeInstance ti,
 AttributeIdentifier ai)
                      throws WTException

Method responsible for processing the specified attribute against the current change request and storing this attribute value in the TypeInstance. Overriding this method in a subclass can override the attributes which are propagated. Currently the name, description and needDate attributes are handled. The method setAttribute(TypeInstance,AttributeIdentifier,Object) is used to store the attribute in the type instance only if the current state of the attribute is State.UNITIALIZED or State.DEFAULT

Supported API: true

Parameters:

dm - The change request used to obtain the values

key - The attribute value.

ti - The TypeInstance to store the value in.

ai - The attribute identifer representing the attribute defined by the key

Throws:

WTException

setAttribute

protected void setAttribute(TypeInstance ti,
 AttributeIdentifier ai,
 Object value)
                     throws WTException

Set the value specified against the attribute identifier in the TypeInstance. The value will only be set if the state of the attribute in the TypeInstance is set to State.UNINITIALIZED or State.DEFAULT. Upon setting the value in the TypeInstance, the state of the attribute will be set to State.DEFAULT.

Supported API: true

Parameters:

ti - The type instance.

ai - The attribute to set in the type instance

value - The value to set to attribute in the type instance to.

Throws:

WTException

setAttributeValues

public TypeInstance setAttributeValues(TypeInstance ti,
 NmCommandBean cb)

Prepopulate the TypeInstance of the Document based on the search results. If the launching point object is not a Document master this method will return the unmodified TypeInstance.

The following fields will be propagated:

• Name
• Number

Supported API: true

Specified by:

setAttributeValues in interface com.ptc.core.components.forms.AttributePopulator

Overrides:

setAttributeValues in class DefaultAttributePopulator

Parameters:

ti - The type instance returned prior to creating attributes step.

cb - The current command bean.

Returns:

the modified type instance if the conditions above are satisfied.