eCopy Connector for Microsoft Exchange

The eCopy connector for Microsoft Exchange enables a user to send scanned documents from an eCopy-enabled device as email attachments from a generic Microsoft Exchange account or from the user's personal Microsoft Exchange account. eCopy recommends that you create a generic Microsoft Exchange account for use by ShareScan.

While ShareScan always uses the ShareScan user account information to log on to the Exchange server and retrieve the Global Address List, it sends scanned documents from this account only if the Login As authentication option is selected.

To be able to use this connector with the Email and folder watching service, you need to create a profile in such a way that it does not require user interaction (express). To ensure that your connector profile is such:

  1. Choose the Login as authentication method for both storage protocols EWS and LDAP (in the Protocols tab of the Properties window).
  2. In the Sending options tab, choose Express to Default recipients or Hide form and send to self from the Display options list.
  3. Ensure that the Encryption connector setting has the User Modify parameter set to 'No' (clear the Yes check box).
  4. Ensure that the Document Name connector setting is configured as follows:
    • It is set to the Default File Name value, or
    • Its value is Specify name... with the User Modify option off (clear the Yes check box), or
    • Used Advanced File Naming..., where all fields have the User Modify option off (in the Field Editor dialog).

For the generic connector configuration options, see Configure connector profile.

About Exchange Environment connection protocols

The connector supports two combinations of connection protocols that can be used to connect to your Exchange server, depending on your environment. The Wizard automatically selects the protocol based on the Exchange environment information that you supply.

Protocol configuration

Microsoft Outlook required?

Suggested use

LDAP/EWS

No

EWS along with LDAP is recommended when your company employs a number of people, uses multiple Exchange servers, and you want to take advantage of the service URL autodiscover feature (administrator do not need to reconfigure ShareScan when the Exchange infrastructure is changed).

You can restrict LDAP queries with profile settings for the organizational unit which uses a particular scanning device; queries are executed faster, and result lists are considerably shorter. Our LDAP protocol implementation autodetects the Global Catalog server, and supports SSL communication as well. EWS also supports cross domain setups, so can be used when ShareScan and the target Exchange server exist within separate domains.

EWS/EWS

No

Recommended when the ShareScan Manager works outside of Active Directory domains (can be used within the domain as well), and simple firewall setup is a requirement. Also the best choice when your Exchange server is hosted in a Datacenter, and you want to access that via HTTPS.

EWS (Exchange Web Services) is based on SOAP/HTTPS, which transfers request and responses via TCP 443 port. EWS supports service URL autodiscovery, making it advantageous in environments where service endpoints change frequently.

Limitations: Search while typing during login has limited functionality.

Extras: Users can save new contacts into their Personal Contacts folder.

General settings

Allows you to set the generic settings of the Exchange connector.

Field Name

Description

Search Global Address List

Allows searching in the Global Address List.

Search Outlook contacts

Allows searching in the Outlook contacts.

Search recipients while typing

If checked, the hints appear at the client Send form as the user starts entering the recipient. If unchecked, the hints appear when the user presses the Search button next to the To or Cc field.

Enable user to manually enter email address

The client is allowed to enter email addresses manually.

Importance

Set the Importance of the mail message.

Delivery receipt

Set if you request a delivery receipt.

Sensitivity

Set the sensitivity of the message.

Read receipt

Set if you request a read receipt.

Add message to Sent Items folder

If this feature is enabled, the message sent successfully is copied to the named folder.

Protocol selector

Select the protocol combination to be used via this tab.

Field Name

Description

Protocol

Select the protocol composition you want to use.

User name

Enter the user name to be used.

Password

Enter the password to be used.

Domain

Enter the domain to be used.

Authentication

Select the authentication type:

  • Runtime: the client user is required to log on at the beginning of the workflow.
  • Login As: the provided credential is used for login at client side.

Search user names

Setting this combo box controls how the client side Authentication form manages the logon information:

  • Search while typing: The list of user names is queried as the user enters characters into the User name text box.
  • Search on demand: The query for the user names based on the entered few characters runs when the button with magnifier is pressed.
  • Disable search: The user is expected to enter the full user name, password and domain at client side.

The Global Address book provider runs the query for the hints. The method of searching depends on the provider.

Testing the connection

Clicking the Test button tests the connector with the current settings.

Protocol properties

The Protocol properties tab varies based on the selected protocol.

LDAP settings

Field Name

Description

Locate server at runtime

Click the Find button to locate the LDAP server during runtime.

Always use the following server

Specify the LDAP server manually.

Server requires SSL

Check if the server requires SSL connection. The default SSL port is 636.

LDAP port

Enter the port number to be used. The default is 389.

Credential type

Select the credential type:

  • Use the default credential: specified on the Protocol selector tab.
  • Connect anonymously.
  • Use User defined credential: Specify the user DN and the password manually.

User DN

Only valid if Use User defined credential is specified.

Password

Only valid if Use User defined credential is specified.

LDAP search

Allows you to specify the attributes of the LDAP searches.

The available settings are:

  • Base DN: Determines the LDAP search starts when typing in the LDAP authentication form or the Send form. Empty base DN prompts an error.
  • Search scope: Can be set to All levels below starting point or One level below starting point.
  • Search on: Allows defining the attributes to be searched on.
  • Max results: Sets the amount of results returned. The default value is 200.

Testing the connection

Clicking the Test button tests the connector with the current settings.

Web Services

Field Name

Description

Use the following service URL

Enter a valid full URL.

Use Exchange Online with Modern Authentication

Select this setting to use Exchange Online web service with modern authentication. When selected, specify the username on the Protocols tab in the DOMAIN\username format.

Autodiscover Service URL with usage of the email address below

Enter an email address to be used during the Autodiscovery process.

Redirection during discovery to these servers is allowed

Enter the URLs to which redirection is allowed.

Use EWS Impersonation

If checked, you can specify an account to be used for sending emails when using this connector.

This option is highly recommended when using Bypass Session Logon (no authentication) along with Cost Recovery or ID Services. The EWS Impersonation allows users to simply swipe their card when on the Session Logon screen, and the credentials entered under this option are used.

Note that this function is only supported when using EWS protocol.

Testing the connection

Clicking the Test button tests the connector with the current settings.

Sending options

This dialog tab provides control for the administrator over the default content of the mail – recipients, subject and note – and allows setting the express mode client workflow.

Field Name

Description

Display options

Manages the client side workflow.

  • Display form
  • Display form without CC
  • Express to Default recipients
  • Hide form and send to self

Default recipients

Allows you to specify default email recipients for a connector. Use the Add button to populate the list. Click the Remove button to delete the selected entry.

You can use the list to configure the data publishing behavior, selecting from the following options:

  • None: Default recipients
  • Data publishing
  • Default recipients and Data publishing

For a practical example of configuring the Data Publishing with a connector, click here.

Send copy to sender

Using this option, the recipient list can be extended with the logged on user dynamically.

Default message

Allows you to specify the default Subject and default note for the connector, by editing the relevant fields:

  • Default Subject
  • Default Note: use the Manage Content button to specify a default note.

You can also define notes and subjects to be received from data publishing by using $$NOTE$$ and $$SUBJECT$$ in the Note and Subject fields.

Exchange connector profile settings

The Edit Profile window enables administrators who are more familiar with Exchange server environments to fine-tune the settings without relying on the Wizard. eCopy recommends that you use the Wizard to initially configure a connector profile. You can set the following:

  • Protocol to be used
  • Protocol properties
  • Generic settings
  • Sending options

Exchange Connector properties

The Properties window enables administrators who are more familiar with Exchange server environments to fine-tune the settings without relying on the Wizard. eCopy recommends that you use the Wizard to initially configure a connector profile. The Properties settings that are available depend on the connection protocols supported by your environment.

Local address book

The Local address book tab enables you to configure the local address books that store Internet email addresses entered at the device, addresses that are not in the Global address list or in the Contacts folder. For information about creating and configuring address books, see Configuring support for Local address books.

When you select the Enable user to manually enter addresses when sending email option on the General settings tab and you enable the Internet address book option on the Local address book tab, the system displays a Save recipient form, where you can save the email address. Saving the email address is not required; you can send the message without that.

Exchange Profile Wizard settings

The Profile wizard helps the administrator to setup a basic protocol composite containing one or two protocols. The additional settings are set up with their defaults; any further tuning of the setting can be done by editing Properties.

Configuring via the Wizard follows the steps below:

  1. Select protocol composite:

    Field Name

    Description

    Protocol

    Select the protocol combination to be used.

    User name

    Enter the user name.

    Password

    Enter the password.

    Domain

    Enter the selected domain name.

    Authentication

    Select the type of authentication to be used.

    Search user names

    Turn the Search while typing function on or off.

  2. Configure selected composite. The components of this page differ according to the selected protocol combination.

    Field Name

    Description

    LDAP settings

    The following options can be set via the LDAP settings page:

    • Locate server at runtime: allows you to select an LDAP server during runtime.
    • Always use the following server: allows you to set an LDAP server to be used.
    • LDAP port: set the LDAP port here. The default port number is 389.
    • Server requires SSL: check this to enable SSL connection.

    Exchange Web Services settings

    The following option can be set via the Exchange Web Services settings:

    • Use the following service URL: allows you to enter a predefined service URL
  3. Review Summary.