Connection

Distributed Cache Connection

Overview

Distributed Cache Connection Manager is SSIS Connection Manager for establishing connections with Microsoft Windows Server AppFabric Cache. The connection manager is based and requires installation of Windows AppFabric client. Use the API to build components based on Distributed Cache Connection Manager.

Setup

Use the Distributed Cache Connection Manager dialog to specify properties for connecting to Windows AppFabric Cache service.

Server Options

Configuration file

Specify cache configuration file.

Cache name:

Specify cache name. This parameter is optional. If not specified, the manager will return the default cache.

Region:

Specify region inside cache. This parameter is optional.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

How to populate cache with data?

You can use Dictionary Destination script component to insert items in cache.

Dynamics AX Connection

Overview

Dynamics AX Connection Manager is SSIS Connection Manager for establishing Dynamics AX connections. The connection manager is based on Microsoft Dynamics AX .NET Business Connector. Use the API to build components based on Dynamics AX Connection Manager.

Setup

Use the Dynamics AX Connection Manager dialog to specify properties for connecting to Dynamics AX server.

Server Options

User name

Specify user name to access Dynamics AX server. Do not use the Microsoft Dynamics AX user name; use the NT alias that is connected to the Microsoft Dynamics AX account. This parameter is optional.

Domain

Specify the domain associated with the Windows user. This parameter is optional.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Advanced Options

Proxy User Name

Specify Business Connector Proxy user. This parameter is optional.

Proxy User Password

Specify Business Connector Proxy password. This parameter is optional.

Proxy Domain

Specify Business Connector domain. This parameter is optional.

Company

Specify company you want to select for the session. This parameter is optional.

Language

Specify language to use for Microsoft Dynamics AX labels. For example, "en-us". This parameter is optional.

Object Server

Specify Microsoft Dynamics AX Application Object Server (AOS) to connect to. For example, InstanceName@ServerName:PortNumber. This parameter is optional.

Configuration

Specify name of the Microsoft Dynamics AX configuration to use while logging on. This parameter is optional.

SharePoint Connection

Overview

SharePoint Connection Manager is SSIS Connection Manager for establishing SharePoint connections. Use the API to build components based on SharePoint Connection Manager.

Setup

Use the SharePoint Connection Manager dialog to specify properties for connecting to SharePoint service.

Server Options

Server

Specify the name or IP address of the SharePoint server.

User name

Specify user name to access SharePoint. If not specified, the connection will be established using Windows authentication.

Password

Specify password to access SharePoint.

Time-out (secs)

Specify the number of seconds before timing out session connect. The default value of this property is 100 seconds.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Proxy Options

Host

Specify the name or IP address of the proxy server. If not specified, proxy server is not used.

Port

Specify the port number on the proxy server to use for the connection.

User name

Specify user name to access the proxy server.

Password

Specify password to access the proxy server.

How to trace the web services calls in use?

You can use the regular .NET network tracing facilities to trace the web services calls. Follow these steps to enable tracing:

  1. Go to DTS\Binn folder and open DtsDebugHost.exe.config file in your favorite text editor.
  2. Include following settings inside configuration element:
        <system.diagnostics>
          <trace autoflush="true" />
          <sources>
            <source name="System.Net" maxdatasize="1024" tracemode="protocolonly">
              <listeners>
                <add name="MyTraceFile" />
              </listeners>
            </source>
          </sources>
          <sharedListeners>
            <add
              name="MyTraceFile"
              type="System.Diagnostics.TextWriterTraceListener"
              initializeData="c:\System.Net.trace.log" />
          </sharedListeners>
          <switches>
            <add name="System.Net" value="Verbose" />
          </switches>
        </system.diagnostics>
    

initializeData attribute controls where the trace log file is saved. Now when you execute a package inside Visual Studio, "c:\System.Net.trace.log" file will contain the web services tracing information. If you want to trace when you execute packages outside Visual Studio, include the settings above in DTExec.exe.config configuration file.

Make sure you comment or remove the tracing settings after you finish testing. Otherwise this may slow down your package execution speed considerably.

Excel Connection

Overview

Excel Connection Manager is SSIS Connection Manager for processing data in Microsoft Excel workbook. Use the API to build components based on Excel Connection Manager.

Setup

Use the Excel Connection Manager dialog to specify properties for opening Excel workbook.

Excel Options

File

Specify Excel workbook file to open.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Advanced Options

Format

Specify Excel workbook format. This property has the options listed in the following table.

Value Description
Automatic Automatically determines Excel workbook format from specified file extension (default).
Excel 97-2003 97-2003 Excel workbook.
Excel 2007 2007-2010 Excel workbook. Requires installation of .NET 3.0 or later.
Pocket Excel Pocket Excel.
Open Password

Specify password to open Excel workbook.

Modify Password

Specify password to modify Excel workbook.

Recalculate

Specify to recalculate and update external references in Excel workbook on open. This property has the options listed in the following table.

Value Description
True Excel workbook is recalculated on open.
False Excel workbook is not recalculated on open (default).

SMTP Connection

Overview

SMTP Connection Manager is SSIS Connection Manager for establishing connections with SMTP-enabled mail servers. Use the API to build components based on SMTP Connection Manager.

Setup

Use the SMTP Connection Manager dialog to specify properties to send mails.

Server Options

Connection Type

Specify connection type. This property has the options listed in the following table.

Value Description
Unsecure Unsecured SMTP connection.
ExplicitSSL Use Explicit SSL SMTP.
ImplicitSSL Use Implicit SSL SMTP.
ExplicitTLS Use Explicit TLS SMTP.
ImplicitTLS Use Implicit TLS SMTP.
Host

Specify the name or IP address of the SMTP server.

Port

Specify the port number on the SMTP server to use for the connection. The default value of this property is 25.

User name

Specify user name to access SMTP mail server. Optional.

Password

Specify password to access SMTP mail server. Optional.

Time-out (secs)

Specify the number of seconds before timing out session connect. The default value of this property is 100 seconds.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Advanced Options

Authentication

Specify authentication algorithm. This property has the options listed in the following table.

Value Description
Auto Automatically determines and uses the most secure available method.
Plain Uses TLS plain text authentication.
DigestMD5 Uses DIGEST-MD5 authentication.
CramMD5 Uses CRAM-MD5 authentication.
Login Uses login authentication.
Ntlm Uses NTLM authentication.
GssApi Uses GSSAPI/SSPI authentication.
NoAuthentication Authentication is not used. (1.5 SR-2)
Verbose log

Specify verbose log file name for investigating SMTP connection issues.

Proxy Options

Host

Specify the name or IP address of the proxy server. If not specified, proxy server is not used.

Port

Specify the port number on the proxy server to use for the connection.

User name

Specify user name to access the proxy server.

Password

Specify password to access the proxy server.

IMAP Connection

Overview

IMAP Connection Manager is SSIS Connection Manager for establishing connections with IMAP-enabled mail servers. Use the API to build components based on IMAP Connection Manager.

Setup

Use the IMAP Connection Manager dialog to specify properties for connecting to IMAP mail server.

Server Options

Connection Type

Specify connection type. This property has the options listed in the following table.

Value Description
Unsecure Unsecured IMAP connection.
ExplicitSSL Use Explicit SSL IMAP.
ImplicitSSL Use Implicit SSL IMAP.
ExplicitTLS Use Explicit TLS IMAP.
ImplicitTLS Use Implicit TLS IMAP.
Host

Specify the name or IP address of the IMAP server.

Port

Specify the port number on the IMAP server to use for the connection. The default value of this property is 143.

User name

Specify user name to access IMAP mail server.

Password

Specify password to access IMAP mail server.

Mailbox

Specify entry IMAP mailbox.

Time-out (secs)

Specify the number of seconds before timing out session connect. The default value of this property is 100 seconds.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Advanced Options

Authentication

Specify authentication algorithm. This property has the options listed in the following table.

Value Description
Auto Automatically determines and uses the most secure available method.
Plain Uses TLS plain text authentication.
DigestMD5 Uses DIGEST-MD5 authentication.
CramMD5 Uses CRAM-MD5 authentication.
Login Uses login authentication.
ClearText Uses clear text USER/PASS authentication.
Ntlm Uses NTLM authentication.
External Uses external authentication.
GssApi Uses GSSAPI/SSPI authentication.
Verbose log

Specify verbose log file name for investigating IMAP connection issues.

Proxy Options

Host

Specify the name or IP address of the proxy server. If not specified, proxy server is not used.

Port

Specify the port number on the proxy server to use for the connection.

User name

Specify user name to access the proxy server.

Password

Specify password to access the proxy server.

POP3 Connection

Overview

POP3 Connection Manager is SSIS Connection Manager for establishing connections with POP3-enabled mail servers. Use the API to build components based on POP3 Connection Manager.

Setup

Use the POP3 Connection Manager dialog to specify properties for connecting to POP3 mail server.

Server Options

Connection Type

Specify connection type. This property has the options listed in the following table.

Value Description
Unsecure Unsecured POP3 connection.
ExplicitSSL Use Explicit SSL POP3.
ImplicitSSL Use Implicit SSL POP3.
ExplicitTLS Use Explicit TLS POP3.
ImplicitTLS Use Implicit TLS POP3.
Host

Specify the name or IP address of the POP3 server.

Port

Specify the port number on the POP3 server to use for the connection. The default value of this property is 110.

User name

Specify user name to access POP3 mail server.

Password

Specify password to access POP3 mail server.

Time-out (secs)

Specify the number of seconds before timing out session connect. The default value of this property is 100 seconds.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Advanced Options

Authentication

Specify authentication algorithm. This property has the options listed in the following table.

Value Description
Auto Automatically determines and uses the most secure available method.
Plain Uses TLS plain text authentication.
DigestMD5 Uses DIGEST-MD5 authentication.
CramMD5 Uses CRAM-MD5 authentication.
Login Uses login authentication.
ClearText Uses clear text USER/PASS authentication.
Apop Uses APOP authentication.
Ntlm Uses NTLM authentication.
GssApi Uses GSSAPI/SSPI authentication.
Verbose log

Specify verbose log file name for investigating POP3 connection issues.

Proxy Options

Host

Specify the name or IP address of the proxy server. If not specified, proxy server is not used.

Port

Specify the port number on the proxy server to use for the connection.

User name

Specify user name to access the proxy server.

Password

Specify password to access the proxy server.

Dynamics CRM Connection

Overview

Dynamics CRM Connection Manager is SSIS Connection Manager for establishing Dynamics CRM connections. Use the API to build components based on Dynamics CRM Connection Manager.

Setup

Use the Dynamics CRM Connection Manager dialog to specify properties for connecting to Dynamics CRM service.

Server Options

Deployment Type

Specify deployment type. This property has the options listed in the following table.

Value Description
Premise Connect to on-premise Dynamics CRM server.
Live Connect to Dynamics CRM Live service.
Hosted Connect to hosted Dynamics CRM.
CRM 3.0 Connect to Dynamics CRM 3.0.
Server

Specify the name or IP address of the Dynamics CRM server.

User name

Specify user name to access Dynamics CRM.

Password

Specify password to access Dynamics CRM.

Organization

Select organization name. Note: Not available in CRM 3.0

Time-out (secs)

Specify the number of seconds before timing out session connect. The default value of this property is 100 seconds.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
LiveUrl (1.5 SR-2)

Specify the regional URL address of the Live CRM service. This property can be one of the options listed in the following table.

Value Description
crm.dynamics.com Use for Live CRM service in North America (default).
crm4.dynamics.com Use for Live CRM service in EMEA.
crm5.dynamics.com Use for Live CRM service in APAC.

Note: This property is not visible in the connection manager dialog.

Test Connection

Confirm connection manager configuration by clicking Test Connection.

Proxy Options

Host

Specify the name or IP address of the proxy server. If not specified, proxy server is not used.

Port

Specify the port number on the proxy server to use for the connection.

User name

Specify user name to access the proxy server.

Password

Specify password to access the proxy server.

How to trace the web services calls in use?

You can use the regular .NET network tracing facilities to trace the web services calls. Follow these steps to enable tracing:

  1. Go to DTS\Binn folder and open DtsDebugHost.exe.config file in your favorite text editor.
  2. Include following settings inside configuration element:
        <system.diagnostics>
          <trace autoflush="true" />
          <sources>
            <source name="System.Net" maxdatasize="1024" tracemode="protocolonly">
              <listeners>
                <add name="MyTraceFile" />
              </listeners>
            </source>
          </sources>
          <sharedListeners>
            <add
              name="MyTraceFile"
              type="System.Diagnostics.TextWriterTraceListener"
              initializeData="c:\System.Net.trace.log" />
          </sharedListeners>
          <switches>
            <add name="System.Net" value="Verbose" />
          </switches>
        </system.diagnostics>
    

initializeData attribute controls where the trace log file is saved. Now when you execute a package inside Visual Studio, "c:\System.Net.trace.log" file will contain the web services tracing information. If you want to trace when you execute packages outside Visual Studio, include the settings above in DTExec.exe.config configuration file.

Make sure you comment or remove the tracing settings after you finish testing. Otherwise this may slow down your package execution speed considerably.

Salesforce Connection

Overview

Salesforce Connection Manager is SSIS Connection Manager for establishing Salesforce connections. Use the API to build components based on Salesforce Connection Manager.

Setup

Use the Salesforce Connection Manager dialog to specify properties for connecting to Salesforce service.

Server Options

User name

Specify user name in email-like format.

Password

Specify password to access Salesforce service.

Time-out (secs)

Specify the number of seconds before timing out session connect. The default value of this property is 60 seconds.

RetainSameConnection

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection (default).
False Every client use different connection.
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Advanced Options (1.4 SR-1)

Server URL (1.4 SR-1)

Specify Salesforce service URL. This property should be explicitly specified when doing sandbox testing. Sample URLs:

Proxy Options (1.4 SR-3)

Host (1.4 SR-3)

Specify the name or IP address of the proxy server. If not specified, proxy server is not used.

Port (1.4 SR-3)

Specify the port number on the proxy server to use for the connection.

User name (1.4 SR-3)

Specify user name to access the proxy server.

Password (1.4 SR-3)

Specify password to access the proxy server.

How to trace the web services calls in use?

You can use the regular .NET network tracing facilities to trace the web services calls. Follow these steps to enable tracing:

  1. Go to DTS\Binn folder and open DtsDebugHost.exe.config file in your favorite text editor.
  2. Include following settings inside configuration element:
        <system.diagnostics>
          <trace autoflush="true" />
          <sources>
            <source name="System.Net" maxdatasize="1024" tracemode="protocolonly">
              <listeners>
                <add name="MyTraceFile" />
              </listeners>
            </source>
          </sources>
          <sharedListeners>
            <add
              name="MyTraceFile"
              type="System.Diagnostics.TextWriterTraceListener"
              initializeData="c:\System.Net.trace.log" />
          </sharedListeners>
          <switches>
            <add name="System.Net" value="Verbose" />
          </switches>
        </system.diagnostics>
    

initializeData attribute controls where the trace log file is saved. Now when you execute a package inside Visual Studio, "c:\System.Net.trace.log" file will contain the web services tracing information. If you want to trace when you execute packages outside Visual Studio, include the settings above in DTExec.exe.config configuration file.

Make sure you comment or remove the tracing settings after you finish testing. Otherwise this may slow down your package execution speed considerably.

FTPS Connection

Overview

FTPS Connection Manager is SSIS Connection Manager for establishing FTP over SSL connections. Use the API to build components based on FTPS Connection Manager.

Setup

Use the FTPS Connection Manager dialog to specify properties for connecting to an FTP over SSL server. The configuration dialog has server and proxy settings.

Server Options

Connection Type

Specify connection type. This property has the options listed in the following table.

Value Description
Unsecure Unsecured FTP connection.
ExplicitSSL Use Explicit SSL FTPS.
ImplicitSSL Use Implicit SSL FTPS.
ExplicitTLS (1.3 SR-1) Use Explicit TLS FTPS.
ImplicitTLS (1.3 SR-1) Use Implicit TLS FTPS.
Host

Specify the name or IP address of the FTPS server.

Port

Specify the port number on the FTPS server to use for the connection. The default value of this property is 21.

User name

Specify user name to access the FTPS server.

Password

Specify password to access the FTPS server. Specify arbitrary value for anonymous account.

Time-out (secs)

Specify the number of seconds before timing out session connect. The default value of this property is 60 seconds.

RetainSameConnection (1.3 SR-5)

Specify if all clients should use the same connection. This property has the options listed in the following table.

Value Description
True All clients use same connection.
False Every client use different connection (default).
Test Connection

Confirm connection manager configuration by clicking Test Connection.

Advanced Options (1.3 SR-5)

Password Protection (1.3 SR-2)

Note: Starting from 1.4 SR-3 this option is no longer needed because it is automatically determined.

Specify OTP S/Key password protection. This property has the options listed in the following table.

Value Description
None No password protection.
MD4 MD4 password protection.
MD5 MD5 password protection.
Certificate file (1.3 SR-5)

Select client certificate file.

Certificate password (1.3 SR-5)

Select client certificate password.

Data transfer passive mode (1.3 SR-5)

Specify what mode to use for data connections. This property has the options listed in the following table.

Value Description
True Use passive mode for data connections (default).
False Use active mode for data connections.
Ignore server IP in passive mode (1.4 SR-2)

Specify if the reported server address in passive mode is ignored. This property has the options listed in the following table.

Value Description
True The reported server address is ignored. Use this setting when when the IP address is unroutable.
False The reported server address is not ignored (default).
Verbose log (1.5)

Specify verbose log file name for investigating FTPS connection issues.

Use binary transfer (1.5)

Specify to use binary mode for file transfers.

Clear Command Channel (1.5)

Specify to use clear command channel, after authenticating to the remote server. The data connections are still encrypted. Use this option when you have introspecting firewall, which dynamically opens data ports required by the FTPS.

BackendVersion (1.5)

Specify FTPS backend engine in use. This property has the options listed in the following table.

Value Description
1 Use legacy FTPS backend engine.
2 Use new 1.5 FTPS backend engine (default).

Note: This property is not visible in the connection manager dialog.

Proxy Options

Proxy:

Specify proxy type. This property has the options listed in the following table.

Value Description
None Proxy not specified
SOCKS4 Use SOCKS4 proxy type.
SOCKS5 Use SOCKS5 proxy type.
HTTP Use HTTP proxy type.
FTPSite Use FTP w/ SITE proxy type. Available only for unsecured connection type.
FTPOpen Use FTP w/ OPEN proxy type. Available only for unsecured connection type.
FTPUser (1.3 SR-1) Use FTP w/ USER proxy type. Available only for unsecured connection type.
Host

Specify the name or IP address of the proxy server.

Port

Specify the port number on the proxy server to use for the connection. The default value of this property is 80.

User name

Specify user name to access the proxy server.

Password

Specify password to access the proxy server.

Syndicate content