---
schema_version: "1"
id: 4b6eb37cd8dc8ef8ace9c66dd7cffecd390b28f45f2f258e5260e095a6cc1909
title: Using Anypoint Studio to Configure Microsoft .NET Connector 3.1
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/microsoft-dotnet-connector/latest/microsoft-dotnet-connector-studio.md
canonical_url: https://docs.mulesoft.com/microsoft-dotnet-connector/latest/microsoft-dotnet-connector-studio
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 1b9e3504e1f5f625d92393371fc762ab5a51caced60addaa9da56f1ef1ed13cf
description: MuleSoft Documentation Site
release: "3.1"
latest: true
---
---
product: Microsoft .NET Connector
version: 3.1
is-latest-version: true
---

# Using Anypoint Studio to Configure Microsoft .NET Connector 3.1

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Anypoint Studio (Studio) editors help you design and update your Mule applications, properties, and
configuration files.

To add and configure a connector in Studio:

1.  [Create a Mule project](#create-mule-project).

2.  [Add the connector to your Mule project](#add-connector-to-project).

3.  [Configure a source for the connector’s flow](#configure-input-source).

4.  [Add a connector operation to the flow](#add-connector-operation).

5.  [Configure a global element for the connector](#configure-global-element).

6.  [Configure the other connector fields](#configure-other-fields).

When you run the connector, you can view the app log to check for problems, as described in
[View the App Log](#view-app-log).

If you are new to configuring connectors in Studio, see
[Using Anypoint Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio).
If, after reading this topic, you need additional information about the connector fields, see the
[Reference](https://docs.mulesoft.com/microsoft-dotnet-connector/latest/microsoft-dotnet-connector-reference).

## Create a Mule Project

In Studio, create a new Mule project in which to add and configure the connector:

1.  In Studio, select **File > New > Mule Project**.

2.  Enter a name for your Mule project and click **Finish**.

## Add the Connector to Your Mule Project

Add Anypoint Connector for Microsoft .NET (Microsoft .NET Connector) to your Mule project to
automatically populate the XML code with the connector’s namespace and schema location and to add
the required dependencies to the project’s `pom.xml` file:

1.  In the **Mule Palette** view, click **(X) Search in Exchange**.

2.  In the **Add Dependencies to Project** window, type `microsoft.net` in the search field.

3.  Click **Microsoft .NET Connector** in **Available modules**.

4.  Click **Add**.

5.  Click **Finish**.

Adding a connector to a Mule project in Studio does not make that connector available to other
projects in your Studio workspace.

## Configure a Source

A source initiates a flow when a specified condition is met. You can configure one of these sources
to use with Microsoft .NET Connector:

- **HTTP Listener**

  Initiates a flow each time it receives a request on the configured host and port.

- **Scheduler**

  Initiates a flow when a time-based condition is met.

For example, to configure **HTTP Listener**, follow these steps:

1.  In the **Mule Palette** view, select **HTTP** > **Listener**.

2.  Drag **Listener** to the Studio canvas.

3.  On the **Listener** configuration screen, optionally change the value of the **Display Name**
    field.

4.  Specify a value for the **Path** field.

5.  Click the plus sign (**+**) next to the **Connector configuration** field to configure a global
    element that can be used by all instances of `HTTP Listener` in the app.

6.  On the **General** tab, specify connection information.

7.  On the **TLS** tab, optionally specify TLS information.

8.  On the **Advanced** tab, optionally specify reconnection information, including a reconnection
    strategy.

9.  Click **Test Connection** to confirm that Mule can connect with the specific server.

10. Click **OK**.

## Add a Connector Operation to the Flow

When you add a connector operation to your flow, you immediately define a specific operation for
that connector to perform.

To add an operation for Microsoft .NET, follow these steps:

1.  In the **Mule Palette** view, select **Microsoft DotNet** and then select the desired operation.

2.  Drag the operation onto the Studio canvas to the right of the source.

## Configure a Global Element for the Connector

When you configure a connector, it’s best to configure a global element that all instances of that
connector in the app can use. Configuring a global element requires you to provide the
authentication credentials the connector uses to access the target Microsoft .NET system.

To configure the global element for Microsoft .NET Connector, follow these steps:

1.  Select the name of the connector in the Studio canvas.

2.  In the configuration screen for the operation, click the plus sign (**+**) next to the
    **Connector configuration** field to access the global element configuration fields.

3.  On the **General** tab, complete these fields:

    ![Studio General tab for DotNet config](/mulesoft/current/en-us/microsoft-dotnet-connector/latest/_images/microsoft-dotnet-connection.png)

    - **Connection**

      Select a connection type.

    - **Scope**

      Select the connection scope:

      - **Singleton**

        Shares the same instance of the Microsoft .NET component across multiple calls. Use this
        option to store a shared state in class instance members across different calls.

      - **Transient**

        Creates a new instance of the Microsoft .NET component per request.

    - **Grant Full Trust to the .NET assembly**

      Microsoft .NET code can be executed in an application domain with restricted privileges to
      avoid the execution of malware code that can affect the stability of the Mule runtime engine.
      These restrictions include limited access to the file system, native code execution, network
      calls, registry access, and more. By default the Microsoft .NET connector is set to use full
      trust.

    - **Declared methods only**

      If the **Declared methods only** field is set to `true`, the metadata fetches only the
      declared methods from the .NET assembly and populates the **Method** field in the **Method
      Info** section with these methods. The default is `false`.

    - **Include auto generated code**

      If the **Include auto generated code** field is set to `false` (the default value), the
      metadata does not fetch the compiler-generated methods, so these methods won’t appear in the
      **Method** field.

4.  On the **Advanced** tab, optionally specify reconnection information, including a reconnection
    strategy.

5.  Click **Test Connection** to confirm that Mule can connect with the specified server.

6.  Click **OK**.

### Configure the External Connection Type

Use the **External** connection type to connect with an assembly external to the application.

In the **Connection** field, select **External**:

![External connection type with Assembly tab selected](/mulesoft/current/en-us/microsoft-dotnet-connector/latest/_images/microsoft-dotnet-external-assembly.png)

### Configure the Gac Connection Type

Use the **Gac** connection type to connect with an assembly installed in the GAC (Global Assembly
Cache):

1.  In the **Connection** field, select **Gac**.

2.  In the **Assembly Type** field, enter the fully qualified type name for the Gac connection type,
    for example, `Namespace.ClassName`.

    ![Global assembly cache connection type with Assembly tab selected](/mulesoft/current/en-us/microsoft-dotnet-connector/latest/_images/microsoft-dotnet-gac-assembly.png)

## Configure the Legacy Connection Type

Use the **Legacy** connection type for backward compatibility:

1.  In the **Connection** field, select **Legacy**.

2.  In the **Assembly Type** field, enter the fully qualified type name for the **Legacy**
    connection type, for example, `Namespace.ClassName`.

3.  In the **Assembly Path** field, enter the path of the Microsoft .NET assembly, for example,
    `C:\Projects\..dll`.

    ![Legacy connection type with Assembly configurations](/mulesoft/current/en-us/microsoft-dotnet-connector/latest/_images/microsoft-dotnet-legacy-assembly.png)

### Configure the Resource Connection Type

Use the **Resource** connection type to connect with an assembly embedded as a resource:

1.  In the **Connection** field, select **Resource**.

2.  In the **Path** field, specify the relative path to an executable .NET library in the resource
    folder.

    The default resources folder is `src/main/resources`.

    ![Resource connection type with Assembly tab selected](/mulesoft/current/en-us/microsoft-dotnet-connector/latest/_images/microsoft-dotnet-resource-assembly.png)

## Configure the Other Connector Fields

After you configure a global element for Microsoft .NET Connector, configure the other required
fields for the connector:

<table><colgroup><col> <col></colgroup><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td><p><strong>Table name</strong></p></td><td><div><div><p>Name of the table to create</p></div></div></td></tr><tr><td><p><strong>Attribute definitions</strong></p></td><td><div><div><p>Attributes that describe the key schema for the table and its indexes</p></div></div></td></tr><tr><td><p><strong>Key schemas</strong></p></td><td><div><div><p>Attributes that compose the primary key for a table or index</p></div></div></td></tr></tbody></table>

## View the App Log

To check for problems, you can view the app log as follows:

- If you’re running the app from Anypoint Platform, the output is visible in the Anypoint Studio
  console window.

- If you’re running the app using Mule from the command line, the app log is visible in your OS
  console.

Unless the log file path is customized in the app’s log file (`log4j2.xml`), you can also view the
app log in the default location `MULE_HOME/logs/<app-name>.log`.

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Microsoft .NET Connector Reference](https://docs.mulesoft.com/microsoft-dotnet-connector/latest/microsoft-dotnet-connector-reference)

- [Salesforce Help](https://help.salesforce.com)
