2.72:IMAP (CMIS Binding): Difference between revisions

From Grooper Wiki
No edit summary
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOINDEX__
{{AutoVersion}}
[[image:1560372310707-590.png|frame]]
[[image:1560372310707-590.png|frame]]


<blockquote style="font-size:14pt">
<blockquote>{{#lst:Glossary|IMAP}}</blockquote>
The '''IMAP''' Connection Type is a CMIS Binding that connects Grooper to email messages through an email server.
</blockquote>


The mail server must use the IMAP (Internet Message Access Protocol) protocol to retrieve messages.  However, virtually all email clients support IMAP, including Gmail, Outlook and Yahoo! Mail.  Once connected, you can import, export, search, and browse inboxes from Grooper.
The mail server must use the IMAP (Internet Message Access Protocol) protocol to retrieve messages.  However, virtually all email clients support IMAP, including Gmail, Outlook and Yahoo! Mail.  Once connected, you can import, export, search, and browse inboxes from Grooper.


Messages will be imported as a .eml file.  Attachments can be extracted from the message using the **Expand Attachments** command.  This is accessible to a Batch Process by using the **Execute** activity.
Messages will be imported as a .eml file.  Attachments can be extracted from the message using the "Expand Attachments" command.  This is accessible to a Batch Process by using the "Execute" activity.


{|cellpadding="10" cellspacing="5"
{|cellpadding="10" cellspacing="5"
|-style="background-color:#36b0a7; color:white"
|-style="background-color:#36b0a7; color:white"
|'''FYI'''||If you use Outlook, the Exchange binding has increased functionality for importing and exporting via email.  You'll want to use that one over the IMAP binding.
|'''FYI'''||If you use Microsoft Outlook, the [[Exchange (CMIS Binding)|Exchange]] binding has increased functionality for importing and exporting via email using Microsoft Exchange servers.  You'll want to use that one over the IMAP binding.
|}
|}


== Version Differences ==
== Version Differences ==


Prior to version 2.72, connections to IMAP servers using the Mail Import and Mail Export providers.  The IMAP binding replaces the old Mail Import provider.  Mail Import is still available as a Legacy provider.  While these providers still exists in Grooper as Legacy Import and Legacy Export providers, they are depreciated components and no longer recommended for use.  For increased functionality in 2.72, create an IMAP Connection Type (or Exchange if connecting to an Outlook inbox) and utilize the new CMIS Import and CMIS Export capabilities.
Prior to version 2.72, connections to IMAP servers were made using the Mail Import and Mail Export providers.  The IMAP binding replaces the old Mail Import provider.  Mail Import is still available as a Legacy provider.  While these providers still exists in Grooper as Legacy Import and Legacy Export providers, they are depreciated components and no longer recommended for use.  For increased functionality in 2.72, create a CMIS Connection using IMAP Connection Type (or Exchange if connecting to an Outlook inbox) and utilize the new CMIS Import and CMIS Export capabilities.


== How To: Create a New IMAP Connection ==
== How To: Create a New IMAP Connection ==
Line 22: Line 23:
<tabs>
<tabs>
<tab name="Step 1">
<tab name="Step 1">
Expand the **Infrastructure** node.  Right click the **CMIS Connections** folder.  Mouse over **Add** and select **CMIS Connection...**.
Expand the "Infrastructure" node.  Right click the "CMIS Connections" folder.  Mouse over "Add" and select "CMIS Connection...".




Line 30: Line 31:
</tab>
</tab>
<tab name="Step 2">
<tab name="Step 2">
In the **Connection Properties** panel, select **IMAP** from the **Connection Type** drop down list.
In the "Connection Properties" panel, select "IMAP" from the "Connection Type" drop down list.




Line 38: Line 39:
</tab>
</tab>
<tab name="Step 3">
<tab name="Step 3">
Expand the **Connection Settings** heading.  Enter the mail server and the user name and password to access that server.
Expand the "Connection Settings" heading.  Enter the mail server and the user name and password to access that server.




Line 54: Line 55:
</tab>
</tab>
<tab name="Step 4">
<tab name="Step 4">
Press the **List Repositories** button to expose all possible email accounts.  Again if nothing is entered in the "Mailboxes" property.  Only the login email account will be visible.
Press the "List Repositories" button to expose all possible email accounts.  Again if nothing is entered in the "Mailboxes" property.  Only the login email account will be visible.





Latest revision as of 10:03, 5 August 2025


This article is about an older version of Grooper.

Information may be out of date and UI elements may have changed.

202520232.72

IMAP is a connection option for cloud CMIS Connections. It connects Grooper to email messages and folders through an IMAP email server for import and export operations.

The mail server must use the IMAP (Internet Message Access Protocol) protocol to retrieve messages.  However, virtually all email clients support IMAP, including Gmail, Outlook and Yahoo! Mail. Once connected, you can import, export, search, and browse inboxes from Grooper.

Messages will be imported as a .eml file.  Attachments can be extracted from the message using the "Expand Attachments" command.  This is accessible to a Batch Process by using the "Execute" activity.

FYI If you use Microsoft Outlook, the Exchange binding has increased functionality for importing and exporting via email using Microsoft Exchange servers.  You'll want to use that one over the IMAP binding.

Version Differences

Prior to version 2.72, connections to IMAP servers were made using the Mail Import and Mail Export providers. The IMAP binding replaces the old Mail Import provider. Mail Import is still available as a Legacy provider. While these providers still exists in Grooper as Legacy Import and Legacy Export providers, they are depreciated components and no longer recommended for use. For increased functionality in 2.72, create a CMIS Connection using IMAP Connection Type (or Exchange if connecting to an Outlook inbox) and utilize the new CMIS Import and CMIS Export capabilities.

How To: Create a New IMAP Connection

Expand the "Infrastructure" node.  Right click the "CMIS Connections" folder.  Mouse over "Add" and select "CMIS Connection...".



In the "Connection Properties" panel, select "IMAP" from the "Connection Type" drop down list.



Expand the "Connection Settings" heading. Enter the mail server and the user name and password to access that server.



Optionally, you can choose not to use SSL by turning that property to "False".

You can change the port number by editing the "Port No" property.

The "Folders" property allows you to choose which mailbox folders to expose. If nothing is selected, all will be visible.

Last, if you have permissions to access multiple mailboxes, you can list them using the Mailbox property. They will be exposed as individual repositories. If no mailboxes are listed, a single repository is exposed for the login email account.

Press the "List Repositories" button to expose all possible email accounts. Again if nothing is entered in the "Mailboxes" property. Only the login email account will be visible.



Select **Import Repository** to bring in these repositories for Grooper to import and export to the corresponding folders in the connected file system. The red circle on the upper right corner of the icon will go from red to green once the repository is imported.



Selecting the imported repository and switching the the Browse Repository tab, you can see all the folders within that mailbox you have access to. Note that only messages are visible using the IMAP connection. If you are connecting to an Exchange server, the Exchange binding can also access calendar, contact and task objects.