Interface IExchangeItem
-
- All Known Subinterfaces:
IExchangeAppointment
,IExchangeContact
,IExchangeMessage
,IExchangeNote
,IExchangeTask
@Scriptable public interface IExchangeItem
Defines common properties and methods of an Exchange mailbox item.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
addAttachment(File p_file)
Adds an attachment to the item.void
addAttachment(File p_file, String p_strFileName, String p_strMimeType, boolean p_bDeleteAfter)
Adds an attachment to the item.void
addCategory(String p_strCategory)
Adds a category.void
delete()
Deletes the item from the mailbox (i.e.List<IAttachmentInfo>
getAttachments()
List<String>
getCategories()
Returns a list of category values.String
getFolderHref()
String
getHref()
String
getId()
String
getItemLink()
String
getPermanentUrl()
String
getSubject()
IValueHolder<?>
getUserDefinedFieldValue(String p_strColumnName)
Returns a user defined field value for the current item.void
removeAttachment(String p_strAttachmentId)
Removed an attachment from an item.void
removeCategory(String p_strCategory)
Removes a category from the list of categories.void
save()
Saves modified item properties in Exchange.void
setSubject(String p_strSubject)
Sets the subject.void
setUserDefinedFieldValue(String p_strColumnName, IValueHolder<?> p_vh)
Sets a user defined field value.
-
-
-
Method Detail
-
getId
String getId()
- Returns:
- The item ID.
-
getHref
String getHref()
- Returns:
- The item HREF.
-
getFolderHref
String getFolderHref()
- Returns:
- The item's folder HREF.
-
getSubject
String getSubject()
- Returns:
- The subject.
-
setSubject
void setSubject(String p_strSubject)
Sets the subject.- Parameters:
p_strSubject
- The subject.
-
getPermanentUrl
String getPermanentUrl()
- Returns:
- The item's permanent URL.
-
getItemLink
String getItemLink()
- Returns:
- An URL to open the item in OWA.
-
getAttachments
List<IAttachmentInfo> getAttachments()
- Returns:
- A list of attachments.
-
addAttachment
void addAttachment(File p_file) throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Adds an attachment to the item.- Parameters:
p_file
- The file to add as attachment.- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
- If operation fails.
-
addAttachment
void addAttachment(File p_file, String p_strFileName, String p_strMimeType, boolean p_bDeleteAfter) throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Adds an attachment to the item.- Parameters:
p_file
- The file to add as attachment.p_strFileName
- The name used as attachment file name.p_strMimeType
- The MIME type.p_bDeleteAfter
-True
if the file should be deleted after it has been attached.- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
- If operation fails.
-
removeAttachment
void removeAttachment(String p_strAttachmentId) throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Removed an attachment from an item.- Parameters:
p_strAttachmentId
- The attachment ID.- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
- If operation fails.
-
save
void save() throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Saves modified item properties in Exchange. In order to get the latest values of fields updated automatically by Exchange, it might be necessary to reload the item after it has been saved.- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
- If item could not be saved.
-
delete
void delete() throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Deletes the item from the mailbox (i.e. moves it to deleted items folder).- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
- If item could not be deleted.
-
getUserDefinedFieldValue
IValueHolder<?> getUserDefinedFieldValue(String p_strColumnName) throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Returns a user defined field value for the current item. This allows to get values of custom fields or fields not provided as properties in the concrete item class.- Parameters:
p_strColumnName
- The column name of the user defined field (e.g. 'IntrexxGuid').- Returns:
- The user defined field value for the current item.
- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
-
setUserDefinedFieldValue
void setUserDefinedFieldValue(String p_strColumnName, IValueHolder<?> p_vh) throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Sets a user defined field value. This allows to get values of custom fields or fields not provided as properties in the concrete item class.- Parameters:
p_strColumnName
- The column name of the user defined field (e.g. 'IntrexxGuid').p_vh
- The value holder for the user defined field value (must also define theIxDataType
of the field).- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
-
getCategories
List<String> getCategories() throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Returns a list of category values.- Returns:
- A list of category values.
- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
-
addCategory
void addCategory(String p_strCategory) throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Adds a category.- Parameters:
p_strCategory
- The category value.- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
-
removeCategory
void removeCategory(String p_strCategory) throws de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
Removes a category from the list of categories.- Parameters:
p_strCategory
- The category to remove.- Throws:
de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeUtilException
-
-