> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sage 300

export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
  return <>
      <p>
        For more information about interactions between {siteName} and {datasource}, see{' '}
        <a href={`https://cdn.cdata.com/help/${advancedurl}${driverVersion}/synch/default.htm`}>
          {datasource} Connector for {siteName}
        </a>.
      </p>
    </>;
};

export const CommonDatasourceAddConnector = ({datasource = "the data source", title = "the connector", destination = false, siteNameShort = "Sync"}) => {
  return <>
      <p>
        To enable {siteNameShort} to use data from {datasource}, you first must add the
        connector, as follows:
      </p>
      <ol>
        <li>Open the <strong>Connections</strong> page of the {siteNameShort} dashboard.</li>
        <li>Click <strong>Add Connection</strong> to open the <strong>Select Connectors</strong> page.</li>
        <li>
          Click the <strong>{destination ? "Destinations" : "Sources"}</strong> tab and locate
          the <strong>{title}</strong> row.
        </li>
        <li>
          Click the <strong>Configure Connection</strong> icon at the end of that row to open
          the <strong>New Connection</strong> page. This action opens the{' '}
          <strong>Add Connection</strong> dialog box.
          <br />
          <strong>Note:</strong> If the <strong>Configure Connection</strong> icon is not
          available, click the <strong>Download Connector</strong> icon to install
          the {title} connector.
        </li>
        <li>Enter a name for your connection in the <strong>Add Connection</strong> dialog box.</li>
        <li>Click <strong>Add</strong> to open the <strong>Settings</strong> tab for your connector.</li>
      </ol>
      <p>
        For more information about installing new connectors, see{' '}
        <a href="../connections">Connections</a>.
      </p>
    </>;
};

export const CommonDatasourceIntroSource = ({datasource = "the data source", siteName = "CData Sync"}) => {
  return <p>
      You can use the {datasource} connector from the {siteName} application to capture data
      from {datasource} and move it to any supported destination. To do so, you need to add
      the connector, authenticate to the connector, and complete your connection.
    </p>;
};

export const driverVersion = "M";

export const siteNameShort = "Sync";

export const siteName = "CData Sync";

export const datasource = "Sage 300";
export const pageTitle = "Sage 300";
export const advancedurl = "GT";

<CommonDatasourceIntroSource datasource={datasource} siteName={siteName} />

## Prerequisites

Before you can use the {datasource} web API, some initial configuration is required. The authenticated user must have API access to one or more modules within the {datasource} environment. In {datasource}, each user is assigned to a security group, which defines their permissions for individual modules. As a best practice, you should use a dedicated user account (rather than the default ADMIN account) for API access. Using the ADMIN account involves additional configuration steps. Follow the instructions in the next sections to create a dedicated user and enable API access.

### Step 1: Create a User Account

<Note>Skip the following steps if you have already created a new user or if you want to use an existing account.</Note>

1. Open the {datasource} application, which is included in the {datasource} installation. Log in with the **ADMIN** account.
2. Select **Administrative Services > Users**. Enter the required information and click **Add**.

### Step2: Set up the Security Group

1. Open the {datasource} application, which is included in the {datasource} installation. Log in with the **ADMIN** account.

2. Select **Administrative Services > Security Groups**.

   The application contains all of the {datasource} application. The group identifier (Id) represents the security group that you want to modify.

3. Create a new security group by filling out the **Group ID** and **Group Description** fields.

4. Select any permissions you want for the group, including the {datasource} web API permission.

5. Click **Add** for each application that is required.

You can also select an existing security group (under **Group ID**) that you want to assign to the user. Make sure to select the {datasource} web API permission for each application that is required.

### Step 3: Assign a Security Group

After you create a security group, you can assign it to a user, as follows:

1. Open the {datasource} application, which is included in the {datasource} installation. Log in with the **ADMIN** account.
2. Select **Administrative Services > User Authorization**.
3. Under **User ID**, select your new or existing user.
4. For each application, assign the group ID that you created or modified.

After you complete these steps, ensure that the user account can access the web API by entering the URL for your {datasource} instance in the **URL** text box in the "Authenticate to {datasource}" section below.

## Add the Sage 300 Connector

<CommonDatasourceAddConnector datasource={datasource} title={pageTitle} destination={false} siteNameShort={siteNameShort} />

## Authenticate to Sage 300

After you add the connector, you need to set the required properties.

* **URL:** Enter the URL for the server that hosts your instance of {datasource} (for example, [http://localhost/Sage300WebApi/v1.0/-/](http://localhost/Sage300WebApi/v1.0/-/)).
* **User:** Enter the username that you use to authenticate to your {datasource} account.
* **Password:** Enter the password that you use to authenticate to your {datasource} account.

## Complete Your Connection

To complete your connection:

1. For **Company**, enter the name of the company from which you want to retrieve data.
2. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
3. Click **Create & Test** to create your connection.

## More Information

<CommonDatasourceMoreInformation datasource={datasource} advancedurl={advancedurl} siteName={siteName} driverVersion={driverVersion} />