Creating the Data Source Name
This section describes how to edit the DSN configuration and then authenticate and connect to Basecamp APIs.
Editing the DSN Configuration
You can use the Microsoft ODBC Data Source Administrator to edit the DSN configuration. Note that the DSN is created during the installation process, as described in Installing the Connector.
Complete the following steps to edit the DSN configuration:
- Select Start > Search, and enter ODBC Data Sources in the Search box.
- Choose the version of the ODBC Administrator that corresponds to the bitness of your Power BI Desktop installation (32-bit or 64-bit).
- Click the System DSN tab.
- Select the system data source and click Configure.
- Edit the information on the Connection tab and click OK.
Connecting to Basecamp
In addition to authenticating, set the following connection properties to access Basecamp tables.
- Schema: Set this to "V2" or "V3" to connect to a Basecamp 2 or Basecamp 3 account.
- ProjectId: This is a required parameter for most table operations. You can query the Projects table to obtain this value.
If you do not specify the ProjectId connection property, the connector will use the first project Id returned from the Projects table in your first authentication to Basecamp.
- AccountId: You can find the AccountId in the URL after you log in to Basecamp in a web browser:
Authenticating to Basecamp
Basecamp 2 uses basic or OAuth 2.0 authentication. You can use basic authentication to connect to your own account, or you can use OAuth to enable other users to log into their own accounts.
Basecamp 3 requires OAuth 2.0.
Authenticate via Basic Authentication
In basic authentication, you use your login credentials to connect. Set the following properties:
- User: This is the username you use to log in to Basecamp.
- Password: This is the password you use to log in to Basecamp.
Authenticate via OAuth Authentication
You can connect without setting any connection properties for your user credentials.
When you connect, the connector opens the Basecamp OAuth endpoint in your default browser. Log in and grant permissions to the connector. The connector then completes the following OAuth process:
See Using OAuth Authentication for other OAuth authentication flows.
See Getting Data for the next step, which is connecting to the data that you want to work with.