Applies To: ■ PoliteMail Desktop ■ PoliteMail Online □ PoliteMail O365
Version: ■ 4.9 ■ 5.0 ■ 5.05
PoliteMail can use one of three different expansion methods to expand distribution lists: Exchange Web Services (EWS), Graph, and the Messaging Application Program Interface (MAPI).
Versions 4.954 and higher of PoliteMail can "fall back" to other methods if a mailing list fails to expand with the primary method. For example, if your organization uses Graph, and the list fails to expand with Graph, it will fall back to EWS on the server side for expansion. If that fails, list expansion will attempt to expand the list on the client side using Graph, then EWS, and then finally MAPI.
In PoliteMail version 5+, this setting is under 'Enabling List Expansion', whereas earlier versions refer to this as Fallback Expansion.
Enabling List Expansion / Fallback Expansion
To enable List Expansion, go to POLITEMAIL > Account (Account Settings in version 4.9x) > Preferences.
There are 3 expansion methods - Graph, EWS, and MAPI. If your organization is not utilizing a particular method, it will appear grayed out and will not be available for selection.
If the mailing list fails to expand, list expansion will rely on the next method on the server side. For example, if your organization uses Graph, and the list fails to expand with Graph, it will fall back to EWS on the server side for expansion. If that fails, list expansion will attempt to expand the list on the client side using Graph, then EWS, and then finally MAPI.
Refer to this chart for list type and compatibility with the current preferred method. Group definitions can be found below.
|Local Contact Group||View Membership||n/a||n/a|
|Mailbox Contact Group||View Membership||View Membership||View Membership|
|Security Group||View Membership||View Membership||View Membership|
|Universal Group||View Membership||View Membership||View Membership|
|Dynamic Exchange Group||Count||View Membership||n/a|
|O365 Dynamic Group||n/a||n/a||View Membership|
|O365 Group||n/a||View Membership||View Membership|
|Distribution Groups with hidden membership||n/a||n/a||View Membership|
Contact Lists: Local to the Outlook Client, not managed by Exchange typically
Distribution Lists (DL): Static List of Membership, may contain Nested DLs
Dynamic Distribution List (DDL): Membership is generated based on a Query
Query Dynamic Distribution Lists (QDL): A DDL where the membership is pulled at send time
There are a number of reasons why your mailing list has failed to expand and your message hasn't been sent. Here are a few examples and their solutions:
Expanding Dynamic Distribution List with Graph and MAPI only enabled.
- Configure EWS to expand your Dynamic Distribution lists
- Convert the Dynamic Distribution list to an Office 365 Dynamic Group
Expanding Distribution Group with members marked as hidden on exchange
Suggested Solution: Setup and Enable Graph as an additional expansion mode