Micro Focus Content Manager SDK 9.3
HP.HPTRIM.SDK.LocationEAddress Class Reference

The LocEAddress object is a child object of the Location object. Once initialized, it represents one of the electronic objects associated with its parent Location object. This may be a photo, web or email address More...

Inheritance diagram for HP.HPTRIM.SDK.LocationEAddress:
HP.HPTRIM.SDK.TrimChildObject HP.HPTRIM.SDK.ITrimActiveDates HP.HPTRIM.SDK.ITrimDocument HP.HPTRIM.SDK.TrimObject HP.HPTRIM.SDK.TrimPropertySet

Public Member Functions

void SetEmailAddress (string emailAddressString, string emailName, string emailAddressType)
 Sets up this LocEAddress object as an email LocEAddress of the nominated email address, name and type (as used in MAPI systems). More...
 
void SetActiveDateRange (TrimDateTime validFromDate, TrimDateTime validToDate)
 Sets the date range for which this object is active. Note that only the date component of the date and time is relevant for active date ranges. More...
 
void SetDocument (string fromFileName)
 Set the document associated with this Trim object as a copy of the supplied file name More...
 
void LoadDocumentIntoClientCache ()
 Loads the document associated with this object into the client document cache, if one is available. More...
 
string GetDocumentPathInClientCache (HistoryTypes logAccessAs)
 Gets the path to a copy of the document associated with this object within the client document cache - logs access according to the supplied history log type. More...
 
string GetDocumentPathInWGSCache (HistoryTypes logAccessAs)
 
ExtractDocument GetExtractDocument ()
 
string Extract (string outputDocumentName)
 
- Public Member Functions inherited from HP.HPTRIM.SDK.TrimChildObject
void Delete ()
 Permanently removes this object and all its associated child objects from the database. More...
 
- Public Member Functions inherited from HP.HPTRIM.SDK.TrimObject
bool IsMandatory (FieldDefinition field)
 Gets a boolean value indication whether the specified field must have a non-NULL value for this object. More...
 
bool IsValidFor (int purpose)
 Call this method to determine if this object can be used for the nominated purpose. To determine what the valid purposes are, look in the derived class at the more type safe versions of this function. More...
 
bool IsValidFor (int purpose, TrimMainObject purposeExtraObject)
 Call this method to determine if this object can be used for the nominated purpose. To determine what the valid purposes are, look in the derived class at the more type safe versions of this function. The purposeExtraObject is necessary for some purpose types - once again, the derived class will have more information. More...
 
bool IsValidFor (int purpose, int purposeExtraEnumValue)
 Call this method to determine if this object can be used for the nominated purpose. To determine what the valid purposes are, look in the derived class at the more type safe versions of this function. The purposeExtraInformation is necessary for some purpose types - once again, the derived class will have more information. More...
 
bool HasPermission (GenericPermissions prm)
 Checks to see if the currently logged in user has permission to perform the generic action on this object More...
 
bool HasPropertyPermission (GenericPermissions prm, PropertyIds propId)
 Checks to see if the currently logged in user has permission to perform the generic action on the specified property of this object More...
 
- Public Member Functions inherited from HP.HPTRIM.SDK.TrimPropertySet
TrimIcon GetPropertyIcon (PropertyIds propertyId)
 Gets the icon value associated the a property of this object. More...
 
TrimMainObject GetPropertyTrimObject (PropertyIds dnPropId)
 
string GetPropertyString (PropertyIds dnPropId)
 
int GetPropertyLong (PropertyIds dnPropId)
 
long GetPropertyLong64 (PropertyIds dnPropId)
 
bool GetPropertyBool (PropertyIds dnPropId)
 
TrimDateTime GetPropertyDate (PropertyIds dnPropId)
 
TrimDecimal GetPropertyDecimal (PropertyIds dnPropId)
 
TrimCurrency GetPropertyCurrency (PropertyIds dnPropId)
 
TrimURI GetPropertyUri (PropertyIds dnPropId)
 
bool SetPropertyTrimObject (PropertyIds dnPropId, TrimMainObject newValue)
 
bool SetPropertyString (PropertyIds dnPropId, string newValue)
 
bool SetPropertyLong (PropertyIds dnPropId, int newValue)
 
bool SetPropertyLong64 (PropertyIds dnPropId, long newValue)
 
bool SetPropertyBool (PropertyIds dnPropId, bool newValue)
 
bool SetPropertyDate (PropertyIds dnPropId, TrimDateTime newValue)
 
bool SetPropertyCurrency (PropertyIds dnPropId, TrimCurrency newValue)
 
bool SetPropertyDecimal (PropertyIds dnPropId, TrimDecimal newValue)
 
bool SetPropertyDouble (PropertyIds dnPropId, double newValue)
 
bool SetPropertyUri (PropertyIds dnPropId, TrimURI newValue)
 
bool ClearProperty (PropertyIds dnPropId)
 
object GetProperty (PropertyIds propId)
 
bool SetProperty (PropertyIds propId, object newValue)
 
string GetPropertyAsString (PropertyIds propertyId, StringDisplayType propertyValueStringType, bool useHTMLEscapeChars)
 Gets a string representation of a property value in a format appropriate for a specific use. More...
 
bool IsMandatory (PropertyIds propertyId)
 Gets a boolean value indication whether the specified property must have a non-NULL value for this object. More...
 
bool VerifyProperty (PropertyIds propertyId, bool doMandatoryChecks)
 Verifies the value of a particular property, by cross checking it against other property values. The ErrorMessage property provides details if the verification fails. More...
 
bool CanModifyProperty (PropertyIds propertyId)
 Indicates whether the current user has the permission to modify the specified property. More...
 

Properties

string Description [get, set]
 Gets or sets a string corresponding to the Display Name field of the Electronic Address. More...
 
string ElectronicAddressData [get, set]
 Gets or sets the electronic address data for this LocEAddress. For example, the string contains the Web Page URL if the electronic address is a WebPage, the file path (set) or Electronic Store Reference (get) for the image file if the electronic address is a signature or an image, or the email address if the electronic address is an email. More...
 
EAddressType ElectronicAddressType [get, set]
 Gets or sets an etEAddressType enum value indicating the Electronic Address Type of this LocEAddress. For example etMail(email), etUrl(Web Page), etRdn (Signature) and etImage (Image). More...
 
string EmailAddressTypeString [get, set]
 Gets or sets the email Address Type of this LocEAddress, if it is an email. The valid string values are: 'SMTP' (Internet), 'MS' (Microsoft Mail Server for PC), 'CCMAIL' (Lotus cc:Mail), 'NGW' (GroupWise), 'EX' (Microsoft Exchange), 'NOTES' (Lotus Notes), and 'UNKNOWN' (Unknown). More...
 
ElectronicStore EStore [get]
 Gets an ElectronicStore object which is the Electronic Store where this LocEAddress is kept, if the LocEAddress is an image or a signature. More...
 
string EStoreId [get]
 Gets a string containing the ID of the Electronic Store where this LocEAddress is kept, if the LocEAddress is an image or a signature. More...
 
bool IsPreferred [get, set]
 Gets or sets a Boolean value indicating whether this LocEAddress is the preferred (default) Electronic Address of the Location. More...
 
new string Name [get]
 Gets a string corresponding to the Details field of the Electronic Address. More...
 
TrimDateTime DateActiveFrom [get]
 
TrimDateTime DateActiveTo [get]
 
string ActiveDateRangeDescription [get]
 
bool IsActive [get]
 
bool IsDocumentInClientCache [get]
 
string DocumentPathInClientCache [get]
 
string DocumentPathInWGSCache [get]
 
- Properties inherited from HP.HPTRIM.SDK.TrimChildObject
string Name [get]
 Gets a string name for this object which is a user-friendly way of displaying this object. For most TRIM objects the name is a unique string, although some times this is not the case (eg Location Names). More...
 
uint Idx [get]
 Gets the position in the child object list that this child object occupies. More...
 
- Properties inherited from HP.HPTRIM.SDK.TrimObject
BaseObjectTypes TrimType [get]
 Gets a BaseObjectTypes enum value indicating the type of this object. More...
 
TrimURI Uri [get]
 Gets the unique row identifier for this object. Once an object has been committed to the database, typically by calling a Save method, this unique identifier is allocated. From that time on, the uri will remain constant and can never be changed. It is always unique across all objects of the same Type. More...
 
string URN [get]
 Gets the uniform resource name for this object. More...
 
string NameString [get]
 Gets a string name for this object which is a user-friendly way of displaying this object. For most TRIM objects the name is a unique string, although some times this is not the case (eg Location Names). More...
 
string NameStringExtra [get]
 Gets a more verbose description of this object, particularly when the name is perhaps a little cryptic or not enough to fully describe the object. More...
 
bool IsReadOnly [get]
 Gets a boolean parameter indicating if this object is "ReadOnly". This would generally indicate that none of the object's properties could be modified, in some cases there are exceptions that can be tested via CanModifyProperty method. More...
 
bool PossiblyHasSubordinates [get]
 Indicates if this object could possibly have child objects of the same type that can be displayed in a hierarchy. More...
 
- Properties inherited from HP.HPTRIM.SDK.TrimPropertySet
string ErrorMessage [get]
 All TRIM SDK objects have an ErrorMessage property which can be used to examine any error that may have occurred in the most recent method call. More...
 
TrimException Error [get]
 All TRIM SDK objects have an Error property which can be used to examine any error that may have occurred in the most recent method call. More...
 
Database Database [get]
 Gets the TRIM Database object in which this object resides. All TRIM objects live within a particular TRIM database and cannot be created without one. More...
 
virtual string Caption [get]
 Gets the user-defined caption that has been associated with all TrimPropertySets of this type. More...
 
virtual TrimIcon Icon [get]
 Gets the icon value associated this TrimPropertySet. More...
 
bool IsModified [get]
 Gets a boolean parameter indicating if any changes have been made to this object since it was first constructed, or last saved. More...
 
- Properties inherited from HP.HPTRIM.SDK.ITrimActiveDates
TrimDateTime DateActiveFrom [get]
 Gets the TrimDateTime property corresponding to when this object first became active. If the returned value is blank, it indicates that the item has always been active (until the DateActiveTo value). More...
 
TrimDateTime DateActiveTo [get]
 Gets the TrimDateTime property corresponding to when this object first became active. If the returned value is blank, it indicates that the item has always been active (until the DateActiveTo value). More...
 
string ActiveDateRangeDescription [get]
 Gets a string describing the period during which this object was active. More...
 
bool IsActive [get]
 Gets a boolean value indicating whether this object is currently active. More...
 
- Properties inherited from HP.HPTRIM.SDK.ITrimDocument
bool IsDocumentInClientCache [get]
 Gets a boolean value indicating whether the document associated with this object is currently inside the client document cache. More...
 
string DocumentPathInClientCache [get]
 Gets a String value representing the path to a copy of the document associated with this object within the client document cache. For records, access is logged as a 'View'. More...
 

Detailed Description

The LocEAddress object is a child object of the Location object. Once initialized, it represents one of the electronic objects associated with its parent Location object. This may be a photo, web or email address

Member Function Documentation

string HP.HPTRIM.SDK.LocationEAddress.Extract ( string  outputDocumentName)
string HP.HPTRIM.SDK.LocationEAddress.GetDocumentPathInClientCache ( HistoryTypes  logAccessAs)

Gets the path to a copy of the document associated with this object within the client document cache - logs access according to the supplied history log type.

Implements HP.HPTRIM.SDK.ITrimDocument.

string HP.HPTRIM.SDK.LocationEAddress.GetDocumentPathInWGSCache ( HistoryTypes  logAccessAs)
ExtractDocument HP.HPTRIM.SDK.LocationEAddress.GetExtractDocument ( )
void HP.HPTRIM.SDK.LocationEAddress.LoadDocumentIntoClientCache ( )

Loads the document associated with this object into the client document cache, if one is available.

Implements HP.HPTRIM.SDK.ITrimDocument.

void HP.HPTRIM.SDK.LocationEAddress.SetActiveDateRange ( TrimDateTime  validFromDate,
TrimDateTime  validToDate 
)

Sets the date range for which this object is active. Note that only the date component of the date and time is relevant for active date ranges.

Implements HP.HPTRIM.SDK.ITrimActiveDates.

void HP.HPTRIM.SDK.LocationEAddress.SetDocument ( string  fromFileName)

Set the document associated with this Trim object as a copy of the supplied file name

Implements HP.HPTRIM.SDK.ITrimDocument.

void HP.HPTRIM.SDK.LocationEAddress.SetEmailAddress ( string  emailAddressString,
string  emailName,
string  emailAddressType 
)

Sets up this LocEAddress object as an email LocEAddress of the nominated email address, name and type (as used in MAPI systems).

Property Documentation

string HP.HPTRIM.SDK.LocationEAddress.ActiveDateRangeDescription
get
TrimDateTime HP.HPTRIM.SDK.LocationEAddress.DateActiveFrom
get
TrimDateTime HP.HPTRIM.SDK.LocationEAddress.DateActiveTo
get
string HP.HPTRIM.SDK.LocationEAddress.Description
getset

Gets or sets a string corresponding to the Display Name field of the Electronic Address.

string HP.HPTRIM.SDK.LocationEAddress.DocumentPathInClientCache
get
string HP.HPTRIM.SDK.LocationEAddress.DocumentPathInWGSCache
get
string HP.HPTRIM.SDK.LocationEAddress.ElectronicAddressData
getset

Gets or sets the electronic address data for this LocEAddress. For example, the string contains the Web Page URL if the electronic address is a WebPage, the file path (set) or Electronic Store Reference (get) for the image file if the electronic address is a signature or an image, or the email address if the electronic address is an email.

EAddressType HP.HPTRIM.SDK.LocationEAddress.ElectronicAddressType
getset

Gets or sets an etEAddressType enum value indicating the Electronic Address Type of this LocEAddress. For example etMail(email), etUrl(Web Page), etRdn (Signature) and etImage (Image).

string HP.HPTRIM.SDK.LocationEAddress.EmailAddressTypeString
getset

Gets or sets the email Address Type of this LocEAddress, if it is an email. The valid string values are: 'SMTP' (Internet), 'MS' (Microsoft Mail Server for PC), 'CCMAIL' (Lotus cc:Mail), 'NGW' (GroupWise), 'EX' (Microsoft Exchange), 'NOTES' (Lotus Notes), and 'UNKNOWN' (Unknown).

ElectronicStore HP.HPTRIM.SDK.LocationEAddress.EStore
get

Gets an ElectronicStore object which is the Electronic Store where this LocEAddress is kept, if the LocEAddress is an image or a signature.

string HP.HPTRIM.SDK.LocationEAddress.EStoreId
get

Gets a string containing the ID of the Electronic Store where this LocEAddress is kept, if the LocEAddress is an image or a signature.

bool HP.HPTRIM.SDK.LocationEAddress.IsActive
get
bool HP.HPTRIM.SDK.LocationEAddress.IsDocumentInClientCache
get
bool HP.HPTRIM.SDK.LocationEAddress.IsPreferred
getset

Gets or sets a Boolean value indicating whether this LocEAddress is the preferred (default) Electronic Address of the Location.

new string HP.HPTRIM.SDK.LocationEAddress.Name
get

Gets a string corresponding to the Details field of the Electronic Address.