| Step Details | |
| Introduced in Version | 4.0.0 |
| Last Modified in Version | 7.12.0 |
| Location | Integration > Exchange Web Services |
The Get Unread Exchange Emails step is used to retrieve unread exchange emails from a given Exchange server.
Prerequisites
- This step requires the Exchange Web Services module to be installed before it will be available in the toolbox.
- A dependency must be created after installing the module in order for the Step to be properly used.
Properties
Inputs
| Property | Description | Data Type |
|---|---|---|
| Exchange Server | The server and authentication used. | Exchange Server Definition |
| Offset | Alters how far down the list the step begins pulling emails from. | Int32 |
| Page Size | Alters how many unread emails appear per page. | Int32 |
Outputs
| Property | Description | Data Type |
|---|---|---|
| Output | Outputs list of unread exchange emails. | List of ExchangeEmail |
Example Inputs and Outputs
| Exchange Server | Offset | Page Size | Output |
|---|---|---|---|
| (ExchangeServerSettings) | 0 | 3 | 0: Email 1 1: Email 2 2: Email 3 |
| (ExchangeServerSettings) | 2 | 5 | 0: Email 3 1: Email 4 2: Email 5 3: Email 6 4: Email 7 |
Common Errors
The Remote Server Returned an Error
If the remote server address is improperly entered, the step will cause an error.
To correct this, input a URL that is properly spelled to effectively connect to the designated server.
Error Message:
DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Delete Exchange Calendar Item 1[DeleteExchangeCalendarItem] in flow [Step Library Flow]: Exception invoking method DeleteExchangeCalendarItem on class CalendarSteps
---> DecisionsFramework.LoggedException: Exception invoking method DeleteExchangeCalendarItem on class CalendarSteps
---> System.Exception: Delete Exchange Calendar Item error. ID: 24357865648936
---> System.AggregateException: One or more errors occurred. (The request failed. The remote server returned an error: (403) Forbidden.)
---> Microsoft.Exchange.WebServices.Data.ServiceRequestException: The request failed. The remote server returned an error: (403) Forbidden.
---> System.Net.WebException: The remote server returned an error: (403) Forbidden. at System.Net.HttpWebRequest.EndGetResponse(IAsyncResult asyncResult)
at System.Threading.Tasks.TaskFactory`1.FromAsyncCoreLogic(IAsyncResult iar, Func`2 endFunction, Action`1 endAction, Task`1 promise, Boolean requiresSynchronization) --- End of stack trace from previous location --- at System.Net.WebRequest.GetResponseAsync()
at Microsoft.Exchange.WebServices.Data.EwsHttpWebRequest.Microsoft.Exchange.WebServices.Data.IEwsHttpWebRequest.GetResponse()
at Microsoft.Exchange.WebServices.Data.ServiceRequestBase.GetEwsHttpWebResponse(IEwsHttpWebRequest request)
--- End of inner exception stack trace --- at Microsoft.Exchange.WebServices.Data.ServiceRequestBase.GetEwsHttpWebResponse(IEwsHttpWebRequest request)
at Microsoft.Exchange.WebServices.Data.ServiceRequestBase.ValidateAndEmitRequest()
at Microsoft.Exchange.WebServices.Data.SimpleServiceRequestBase.InternalExecuteAsync()
at Microsoft.Exchange.WebServices.Data.MultiResponseServiceRequest`1.ExecuteAsync()
at Microsoft.Exchange.WebServices.Data.ExchangeService.BindToItem(ItemId itemId, PropertySet propertySet)
at Microsoft.Exchange.WebServices.Data.ExchangeService.BindToItem[TItem](ItemId itemId, PropertySet propertySet)
--- End of inner exception stack trace --- at System.Threading.Tasks.Task.ThrowIfExceptional(Boolean includeTaskCanceledExceptions)
at System.Threading.Tasks.Task`1.get_Result()
at Decisions.Exchange.CalendarSteps.DeleteExchangeCalendarItem(ExchangeServerDefinition ExchangeServer, String CalendarItemId)
--- End of inner exception stack trace --- at Decisions.Exchange.CalendarSteps.DeleteExchangeCalendarItem(ExchangeServerDefinition ExchangeServer, String CalendarItemId)
at System.RuntimeMethodHandle.InvokeMethod(Object target, Void** arguments, Signature sig, Boolean isConstructor)
at System.Reflection.MethodBaseInvoker.InvokeDirectByRefWithFewArgs(Object obj, Span`1 copyOfArgs, BindingFlags invokeAttr)
--- End of inner exception stack trace --- Related Information