Click or drag to resize

PFTask Methods

The PFTask type exposes the following members.

Methods
  NameDescription
Public methodAddItemRelation(Guid, PFItem)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(Guid, PFItemReference)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(String, PFItem)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(String, PFItemReference)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(ContentRelation, PFItem)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(ContentRelation, PFItemReference)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(String, Guid, PFItem)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(String, Guid, PFItemReference)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(String, String, PFItem)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAddItemRelation(String, String, PFItemReference)
Adds an item relation from this item to another.
(Inherited from PFItem.)
Public methodAttachFile(String, Byte, PFFieldFileHolder)
This will create and persist a file in database and then link it into the fileHolder field value. You will need to save this item to persist the value in database. Note : this is different from .Files.Add() that will only create a non-yet-persisted instance of a file.
(Inherited from PFItem.)
Public methodAttachFile(String, Byte, String)
This will create and persist a file in database and then link it into the fileHolder field value. You will need to save this item to persist the value in database. Note : this is different from .Files.Add() that will only create a non-yet-persisted instance of a file.
(Inherited from PFItem.)
Public methodAttachPdfFile(PFFile, PFFieldFileHolder)
This will create and persist a file in database and then link it into the fileHolder field value. You will need to save this item to persist the value in database. Note : this is different from .Files.Add() that will only create a non-yet-persisted instance of a file.
(Inherited from PFItem.)
Public methodAttachPdfFile(PFFile, String)
This will create and persist a file in database and then link it into the fileHolder field value. You will need to save this item to persist the value in database. Note : this is different from .Files.Add() that will only create a non-yet-persisted instance of a file.
(Inherited from PFItem.)
Public methodBaseSave
IMPORTANT : will not call overridden Save method! Saves item to database. Note: use transaction. If transaction already exists, will not commit it, but may rollback it if needed (then an exception is thrown).
(Inherited from PFItem.)
Public methodCanFieldBeModifiedByUser(String)
Checks if a field control mode is editable in the current context.
(Inherited from PFItem.)
Public methodCanFieldBeModifiedByUser(PFField)
Checks if a field control mode is editable in the current context.
(Inherited from PFItem.)
Public methodChangeApplicationContext
Will change the context of this item, of its parts items and of its tasks. You must have the permission to modify everything.
(Inherited from PFItem.)
Public methodChangeTaskDecision
Changes the chosen decision of a task.
Public methodCustomizeDefaultFileNameByTemplate
Allows to customize default file names proposed to users for each template.
(Inherited from PFItem.)
Public methodDelete
Flags this object as deleted.

If it fails, throws an error.

If the object could not be deleted because it does not yet exist in database, returns false.

If successful, returns true.

(Inherited from PFBaseObject.)
Public methodExternalConnection_Get
Gets the external connection having synchronized this item.
(Inherited from PFItem.)
Public methodExternalConnection_GetExternalData
Externals the connection_ get external data.
(Inherited from PFItem.)
Public methodExternalConnection_Synchronize
Synchronizes this item's data properties with its external content.

Note: this does NOT save the item.

(Inherited from PFItem.)
Public methodExternalConnection_SynchronizeAndSave
Synchronizes this item's data properties with its external content, then saves the item if the synchronization changed any value.
(Inherited from PFItem.)
Public methodExternalConnection_SynchronizeValidation
Checks if the item can be synchronized with its external source by the current user. Called for the method ExternalConnection_Synchronize in the batch action feature.
(Inherited from PFItem.)
Public methodGenerateHtmlMessage(Int32, String)
Generates a html message (subject and body) from a modeling message.
(Inherited from PFItem.)
Public methodGenerateHtmlMessage(String, String)
Generates a html message (subject and body) from a modeling message.
(Inherited from PFItem.)
Public methodGenerateHtmlMessage(ContentMessage, String)
Generates a html message (subject and body) from a modeling message.
(Inherited from PFItem.)
Protected methodGenerateReference

Returns a reference for the current item.

Is called by the Save method when the item is not yet created and the reference is empty.

(Inherited from PFItem.)
Protected methodGenerateTaskTitle

Used to initialize a task title in the current workflow state.

Default : "{Reference} : {State}"

(Inherited from PFItem.)
Public methodGenerateTextMessage(Int32, String)
Generates a html message (subject and body) from a modeling message.
(Inherited from PFItem.)
Public methodGenerateTextMessage(String, String)
Generates a html message (subject and body) from a modeling message.
(Inherited from PFItem.)
Public methodGenerateTextMessage(ContentMessage, String)
Generates a html message (subject and body) from a modeling message.
(Inherited from PFItem.)
Public methodGetConversationTitle
Defines the title of this item conversation for the specified user. Returns this item caption by default.
(Inherited from PFItem.)
Public methodGetFieldControlMode(String)
Gets the control mode of a field in the current context.
(Inherited from PFItem.)
Public methodGetFieldControlMode(PFField)
Gets the control mode of a field in the current context.
(Inherited from PFItem.)
Public methodGetFieldDisplayValue(String)
Gets display text (not html) of a field in this item.
(Inherited from PFItem.)
Public methodGetFieldDisplayValue(PFField)
Gets display text (not html) of a field in this item.
(Inherited from PFItem.)
Public methodGetGuid
Returns a Global Unique Identifier for the target.
(Inherited from PFItem.)
Public methodGetId
Returns an id representing the target.
(Inherited from PFItem.)
Public methodGetItemLocks
Gets current locks.

Note : will return an empty list if the object is not yet created.

(Inherited from PFItem.)
Public methodGetLocks
Gets current locks.
(Inherited from PFItem.)
Public methodGetMessagePlaceHolderHtml
Gets the html of a message placeholder (in a ContentMessage) in the specified language.
(Inherited from PFItem.)
Public methodGetMessagePlaceHolderText
Gets the text of a message placeholder (in a ContentMessage) in the specified language.
(Inherited from PFItem.)
Protected methodGetNewPermissionContext
Creates a new permission context based on current object type.
(Inherited from PFItem.)
Public methodGetObjectRelationByName
Gets a children entities relation by its name.
(Inherited from PFRelationalObject.)
Public methodGetParts
Gets items whose current item is the owner item.
(Inherited from PFItem.)
Public methodGetPartsAndTasksRecursively
Gets items whose current item is the owner item and recursively. Will also return tasks of each returned item.
(Inherited from PFItem.)
Public methodGetPartsRecursively
Gets items whose current item is the owner item and recursively.
(Inherited from PFItem.)
Public methodGetRelatedItems(Guid, PFQuery, PFItemRelationDirection, Boolean)
Gets items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItems(String, PFQuery, PFItemRelationDirection, Boolean)
Gets items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItems(String, Guid, PFQuery, PFItemRelationDirection, Boolean)
Gets items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItems(String, String, PFQuery, PFItemRelationDirection, Boolean)
Gets items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItems(ContentRelation, PFQuery, PFContentType, PFItemRelationDirection, Boolean)
Gets items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItemsByGroup(Guid, PFQuery, PFItemRelationDirection)
Gets aggregated items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItemsByGroup(String, PFQuery, PFItemRelationDirection)
Gets aggregated items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItemsByGroup(String, Guid, PFQuery, PFItemRelationDirection)
Gets aggregated items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItemsByGroup(String, String, PFQuery, PFItemRelationDirection)
Gets aggregated items linked inside a relation.
(Inherited from PFItem.)
Public methodGetRelatedItemsByGroup(ContentRelation, PFQuery, PFContentType, PFItemRelationDirection)
Gets aggregated items linked inside a relation.
(Inherited from PFItem.)
Public methodGetShownEventTagsInMessaging
Returns the values of Tag that should be included when displaying the messaging UI for this PFItem instance.
(Inherited from PFItem.)
Protected methodGetTasksDueDate
Computes the due date using modeling settings on current state and taken transition.
(Inherited from PFItem.)
Protected methodHasPendingModificationsOnSynchronizedColumns
Determines whether at least one synchronized (with the model) data has been modified. This will always return false for an item not being synchronized with the model.
(Inherited from PFItem.)
Public methodInheritFromOwnerItemApplicationContext
Gets the corresponding application context from the owner item and set in this item.
(Inherited from PFItem.)
Protected methodInitializeLogger
Use this method to override the way the logger is initialized.
(Inherited from PFBaseObject.)
Public methodIsFieldRequired

Checks if a field is required before any Save of this item.

By default, returns True if the field is marked as required or if the transition requires this field, if the transition is specified.

Note : will return false for all FileHolder fields before creation.

(Inherited from PFItem.)
Public methodIsUserOwner
Checks if a user has the owner privilege on this item.
(Inherited from PFItem.)
Protected methodIsVisibleToEveryone
Override this method if you want to force-open this item's visibility to everyone.
(Inherited from PFItem.)
Public methodOnAfterCreateNotification
Raises the [E:BeforeSendingNotification] event.
(Inherited from PFItem.)
Public methodOnBeforeCreateNotification
Raises the [E:BeforeSendingNotification] event.
(Inherited from PFItem.)
Public methodOnFileBinding
Raises the [E:FileOpened] event.
(Inherited from PFItem.)
Public methodOnFileDownloaded
Raises the [E:FileDownloaded] event.
(Inherited from PFItem.)
Public methodOnFileDownloading
Raises the [E:FileDownloading] event.
(Inherited from PFItem.)
Protected methodOnInitialized
Raises the [E:Initialized] event.
(Inherited from PFItem.)
Public methodPreInitOwnerItem
Initializes owner item before creation.

This allows the item to have access to the OwnerItem property before its creation and obviously before the relation exists.

Important: an exception is thrown if the owner item is invalid or already initialized or if the item is already created in the database.

(Inherited from PFItem.)
Protected methodProcessPermissions
Compute permissions from permission context and set in data properties.
(Inherited from PFBaseObject.)
Public methodReleaseLock
Releases the lock of a given user, if found.
(Inherited from PFItem.)
Public methodRemoveItemRelation(Guid, PFItem)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(Guid, PFItemReference)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(String, PFItem)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(String, PFItemReference)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(ContentRelation, PFItem)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(ContentRelation, PFItemReference)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(String, Guid, PFItem)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(String, Guid, PFItemReference)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(String, String, PFItem)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodRemoveItemRelation(String, String, PFItemReference)
Removes an item relation between this item and another.
(Inherited from PFItem.)
Public methodResetOwnerItemCache
Resets owner item cache, for example if the owner item could have changed.
(Inherited from PFItem.)
Public methodRunInTransactionArea
Runs a code with a transaction on object connection. If there is no current transaction and if the code succeed, transaction is committed. If an exception is thrown, transaction is rollback.
(Inherited from PFBaseObject.)
Public methodSave
Applies the data of this object in the database.
(Overrides PFItemSave.)
Public methodSaveAsPartOf(String, PFItem, Boolean, Boolean)
Saves this item and directly link it to an owner item through a relation.
(Inherited from PFItem.)
Public methodSaveAsPartOf(ContentRelation, PFItem, Boolean, Boolean)
Saves this item and directly link it to an owner item through a relation.
(Inherited from PFItem.)
Protected methodSaveObjectsInDataCollection
Saves data loaded from temp specialized object in data properties collection before save or check hasPendingChanges.
(Inherited from PFItem.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodTriggerNotification(String, ListPFUser)
Triggers a notification based on a name.
(Inherited from PFItem.)
Public methodTriggerNotification(PFNotificationTriggerType, ListPFUser)
Triggers a notification type for this item.

IMPORTANT : This method does not support TaskAssigned as a trigger type, use TaskAssignedOnly or TaskReassignedOnly instead.

(Inherited from PFItem.)
Public methodTryGetLock
Tries to get a lock for a given user.
(Inherited from PFItem.)
Public methodTryToGetVersionEditedByUser
The edited version is a backup of the item's data when the user started to edit this item. This allows to set his changes to the same item version

This method tries to get this item's version, if it exists.

(Inherited from PFItem.)
Public methodUpdateVersionEditedByUser
The edited version is a backup of the item's data when the user started to edit this item. This allows to set his changes to the same item version

This method updates that version to the current metadata, it upgrades it.

(Inherited from PFItem.)
Public methodUserHasPrivilege
Checks if a user has a given privilege on this item.
(Inherited from PFItem.)
Public methodValidateRequiredFields
Checks if all required fields are currently filled.

Will throw a PFMissingItemValuesException if not.

Will throw a ValidationException is one or more required fields entry are missing in the data collection.

Note : this method is called at the beginning of the Save method.

(Inherited from PFItem.)
Public methodWorkflow_Enact

Moves the workflow (if possible).

Ensures tasks (if enacted).

Saves item to database (in any case).

Note: uses transaction. If transaction already exists,

will not commit it, but may rollback it if needed (then an exception is thrown).
(Inherited from PFItem.)
Public methodWorkflow_Enact(Int32)

Moves the workflow (if possible).

Ensures tasks (if enacted).

Saves item to database (in any case).

Note: uses transaction. If transaction already exists,

will not commit it, but may rollback it if needed (then an exception is thrown).
(Inherited from PFItem.)
Public methodWorkflow_Enact(State)

Moves the workflow (if possible).

Ensures tasks (if enacted).

Saves item to database (in any case).

Note: uses transaction. If transaction already exists,

will not commit it, but may rollback it if needed (then an exception is thrown).
(Inherited from PFItem.)
Public methodWorkflow_Enact(Transition)

Moves the workflow (if possible).

Ensures tasks (if enacted).

Saves item to database (in any case).

Note: uses transaction. If transaction already exists,

will not commit it, but may rollback it if needed (then an exception is thrown).
(Inherited from PFItem.)
Public methodWorkflow_EnsureTasks
Cancels tasks of previous state instances and ensure tasks for current state instance.
(Inherited from PFItem.)
Public methodWorkflow_GetCurrentTaskForUser
Gets the task of a given user in the current state instance, if found.

If multiple instance tasks are available for the user, active task (if any) is returned first.

(Inherited from PFItem.)
Public methodWorkflow_GetRequiredFieldsForTransition
Gets the required fields for a given transition.
(Inherited from PFItem.)
Public methodWorkflow_ReassignTask
Reassigns a specific task of this workflow to another user.
(Inherited from PFItem.)
Protected methodWorkflow_ResolveTransitionConflict
If multiple transitions are possible; the conflict must be resolved. By default, takes top most transition based on Transition Priority and then on participation count.
(Inherited from PFItem.)
Top
Extension Methods
  NameDescription
Public Extension MethodAsT
Casts an object to another type. Returns default(T) if the object is null.
(Defined by Utils_Other.)
Public Extension MethodEqualsAll
Checks that this object is equal to every object in parameters.
(Defined by Utils_Other.)
Public Extension MethodEqualsAny
Checks that this object is equal to at least one of the parameters.
(Defined by Utils_Other.)
Public Extension MethodGetReferenceOverloaded.
Gets a object referencing the item.
(Defined by PFItemExtensions.)
Public Extension MethodGetReference(String)Overloaded.
Gets a object referencing the item. The Text of the reference will be the value of the specified field.
(Defined by PFItemExtensions.)
Public Extension MethodGetString
Converts an object to String using ToString() method, else returns String.Empty.
(Defined by Utils_Other.)
Public Extension MethodIsGenericListOverloaded.
Checks if this object is a System.Collections.Generic.List.
(Defined by Utils_Linq.)
Public Extension MethodIsGenericList(Type)Overloaded.
Checks if this object is a System.Collections.Generic.List using type as T.
(Defined by Utils_Linq.)
Public Extension MethodSerializeOverloaded.
Serializes an object into an XML document.
(Defined by Utils_Xml.)
Public Extension MethodSerialize(String)Overloaded.
Serializes an object into an XML document.
(Defined by Utils_Xml.)
Public Extension MethodSerializeJsonOverloaded.
Serializes an object using a DataContractJsonSerializer.
(Defined by Utils_String.)
Public Extension MethodSerializeJson(ListType)Overloaded.
Serializes an object using a DataContractJsonSerializer.
(Defined by Utils_String.)
Public Extension MethodSerializeJson(DataContractJsonSerializerSettings)Overloaded.
Serializes an object using a DataContractJsonSerializer.
(Defined by Utils_String.)
Top
See Also