| Step Details | |
| Introduced in Version | 4.0.0 |
| Last Modified in Version | 7.12.0 |
| Location | Integration > Exchange Web Services |
The Search Emails step is used to search through received emails to find an email specified by the Step's inputs.
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 used.
Properties
Inputs
| Property | Description | Data Type |
|---|---|---|
| Exchange Server | The server and authentication used. | ExchangeServerDefinition |
| Offset | The number of results to skip. Use 0 to retrieve results from the start of the results. This parameter is used to allow pages of results to be retrieved. | Int32 |
| Page Size | The maximum number of results to return. | Int32 |
| Search String | Text to search for in the Inbox. This parameter supports a subset of Microsoft's Advanced Query Syntax, as documented here: QueryString | Microsoft Docs | String |
Outputs
| Property | Description | Data Type |
|---|---|---|
| Output | Outputs a list of the retrieved emails. | List of ExchangeEmail |
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 Search Emails 1[SearchEmails] in flow [Step Library Flow]: Exception invoking method SearchEmails on class ExchangeEmailSteps
---> DecisionsFramework.LoggedException: Exception invoking method SearchEmails on class ExchangeEmailSteps
---> System.Exception: Search Exchange Email error. Search String: test.
---> System.AggregateException: One or more errors occurred. (The parameter queryString is only valid for Exchange Server version Exchange2010 or a later version.)
---> Microsoft.Exchange.WebServices.Data.ServiceVersionException: The parameter queryString is only valid for Exchange Server version Exchange2010 or a later version. at Microsoft.Exchange.WebServices.Data.FindRequest`1.Validate()
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.FindItems(FolderId parentFolderId, String queryString, ViewBase view)
--- 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.ExchangeEmailSteps.SearchEmails(ExchangeServerDefinition ExchangeServer, String SearchString, Int32 PageSize, Int32 Offset)
--- End of inner exception stack trace --- at Decisions.Exchange.ExchangeEmailSteps.SearchEmails(ExchangeServerDefinition ExchangeServer, String SearchString, Int32 PageSize, Int32 Offset)
at InvokeStub_ExchangeEmailSteps.SearchEmails(Object, Span`1)
at System.Reflection.MethodBaseInvoker.InvokeWithFewArgs(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
--- End of inner exception stack trace --- at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data)
at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData)
at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
--- End of inner exception stack trace ---Related Information