> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Adaptive Insights Connector

## Intro

Adaptive Insights, formerly Adaptive Planning, provides online software that allows users to replace multiple spreadsheets with an integrated system for consolidating data. To learn more about the Adaptive Insights API, log into Adaptive Insights and go to **Product Documents > Integration Guide**.

You connect to your Adaptive Insights account in the Data Center. This topic discusses the fields and menus that are specific to the Adaptive Insights connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

<table class="mt-responsive-table" data-aura-rendered-by="33:201;a">
  <tbody>
    <tr>
      <td class="mt-noheading" colspan="1" rowspan="1">
        <p>
          <b> Primary Use Cases </b>
        </p>
      </td>

      <td class="mt-noheading" colspan="1" rowspan="1">
        <p> This connector helps you answer these questions: </p>

        <ul>
          <li>
            <p> What are my current financial forecasts? </p>
          </li>

          <li>
            <p> How have these tracked to actuals? </p>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td class="mt-noheading" colspan="1" rowspan="1">
        <p>
          <b> Primary Metrics </b>
        </p>
      </td>

      <td class="mt-noheading" colspan="1" rowspan="1">
        <ul>
          <li>
            <p> Forecasted financials </p>
          </li>

          <li>
            <p> Actual financials (budgets, income, various P\&L line items) </p>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td class="mt-noheading" colspan="1" rowspan="1">
        <p>
          <b> Primary Company Roles </b>
        </p>
      </td>

      <td class="mt-noheading" colspan="1" rowspan="1">
        <ul>
          <li>
            <p> FP\&A analyst </p>
          </li>

          <li>
            <p> Financial analysis </p>
          </li>

          <li>
            <p> Director of finance </p>
          </li>

          <li>
            <p> CPO </p>
          </li>

          <li>
            <p> VP of finance </p>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td class="mt-noheading" colspan="1" rowspan="1">
        <p>
          <b> Average Implementation Time </b>
        </p>
      </td>

      <td class="mt-noheading" colspan="1" rowspan="1">
        {" "}

        Could be 40 hours or more, due to the complexity of Adaptive Insights' financial system{" "}
      </td>
    </tr>

    <tr>
      <td class="mt-noheading" colspan="1" rowspan="1">
        <p>
          <b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b>
        </p>
      </td>

      <td class="mt-noheading" colspan="1" rowspan="1">
        <p> 8 </p>
      </td>
    </tr>
  </tbody>
</table>

## Best Practices

If you need to unpivot data, you can do so using Magic's "Collapse Columns" action. For more information, see [ETL Actions: Edit Columns - Collapse Columns](/s/article/360043427353).

## Prerequisites

To connect to your Adaptive Insights account and create a DataSet, you must have the following:

* Your Adaptive Insights username and password.
* Your Adaptive Insights instance code. You can find this by logging into Adaptive Insights and navigating to
  **Admin > System > General Setup**. You can then find the code under **Setup Information**.

## Connecting to Your Adaptive Insights Account

This section enumerates the options in the **Credentials** and **Details** panes in the Adaptive Insights Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Adaptive Insights account. Based on the Authentication type selected, the fields vary,

The following table describes what is needed for each field when the **Authentication Type** is selected as **Authenticate through Adaptive Planning**:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a">
  <thead>
    <tr>
      <th colspan="1" rowspan="1">
        <p>
          <span class="s1"> Field </span>
        </p>
      </th>

      <th colspan="1" rowspan="1">
        <p>
          <span class="s1"> Description </span>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Username{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Enter your Adaptive Insights username.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Password{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Enter your Adaptive Insights password.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Instance{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Enter your Adaptive Insights instance code. To learn how to find your code, see "Prerequisites," above.{" "}
      </td>
    </tr>
  </tbody>
</table>

The following table describes what is needed for each field when the **Authentication Type** is selected as **Authenticate through Workday**::

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a">
  <thead>
    <tr>
      <th colspan="1" rowspan="1">
        <p>
          <span class="s1"> Field </span>
        </p>
      </th>

      <th colspan="1" rowspan="1">
        <p>
          <span class="s1"> Description </span>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Client ID{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Enter the client ID you obtained after registering a Workday API Client.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Integration System User Id{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        This ID should start with <b> PublicAPIISU\_ </b>.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Private Key{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Enter the private key that matches the public key you uploaded in Workday{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Token Endpoint{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Enter the token endpoint obtained when registering a Workday API Client.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        REST Endpoint:{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Enter the REST endpoint obtained when registering a Workday API Client.{" "}
      </td>
    </tr>
  </tbody>
</table>

Once you have entered valid Adaptive Insights credentials, you can use the same account any time you go to create a new Adaptive Insights DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a">
  <thead>
    <tr>
      <th colspan="1" rowspan="1">
        <p> Menu </p>
      </th>

      <th colspan="1" rowspan="1">
        <p> Description </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td colspan="1" rowspan="1">
        <p> Report </p>
      </td>

      <td colspan="1" rowspan="1">
        <p> Select the Adaptive Insights report you want to run. The following reports are available: </p>

        <table border="1" cellpadding="1" cellspacing="1">
          <tbody>
            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Accounts{" "}
              </td>

              <td colspan="1" rowspan="1">
                <span> Retrieves metadata for the complete list of all accounts in the system. </span>
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Active Currencies{" "}
              </td>

              <td colspan="1" rowspan="1">
                <span> Retrieves metadata for the complete list of all currencies configured in the system. </span>
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Attributes{" "}
              </td>

              <td colspan="1" rowspan="1">
                <span> Returns the list of attributes. </span>
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                <p class="DatasetsPaper_title_3bKfQ"> Export Data </p>
              </td>

              <td colspan="1" rowspan="1">
                <span> Retrieves a set of data from the requested version in the requested instance. </span>
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Export Data from Modeled and Cube Sheet{" "}
              </td>

              <td colspan="1" rowspan="1">
                {" "}

                Retrieves data for the accounts, dimensions and levels that correspond to the selected sheet.{" "}
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                <p class="DatasetsPaper_title_3bKfQ"> Customize data export </p>
              </td>

              <td colspan="1" rowspan="1">
                <span> Retrieves data for the accounts, dimensions and levels specified. </span>
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                <p class="DatasetsPaper_title_3bKfQ"> Dimensions Structure </p>
              </td>

              <td colspan="1" rowspan="1">
                <span> Retrieves metadata about custom dimensions in the system preserving their structure. </span>
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                <p class="DatasetsPaper_title_3bKfQ"> Dimensions with Attributes </p>
              </td>

              <td colspan="1" rowspan="1">
                <span>
                  {" "}

                  Represents a single member value of a custom dimension being returned in the response to an exportDimensions
                  Call with Attributes passed in the request.{" "}
                </span>
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Instances{" "}
              </td>

              <td colspan="1" rowspan="1">
                {" "}

                Retrieves metadata about the instances a user has access to, if the user has access to multiple instances.{" "}
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Levels{" "}
              </td>

              <td colspan="1" rowspan="1">
                {" "}

                Retrieves metadata about organization levels in the system.{" "}
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Roles{" "}
              </td>

              <td colspan="1" rowspan="1">
                {" "}

                Retrieves metadata about roles in the system.{" "}
              </td>
            </tr>

            <tr>
              <td colspan="1" rowspan="1">
                {" "}

                Versions{" "}
              </td>

              <td colspan="1" rowspan="1">
                {" "}

                Retrieves metadata about versions in the system.{" "}
              </td>
            </tr>
          </tbody>
        </table>

        <p>
          {" "}

          Standard sheets are not available directly through the API. You have two options for retrieving standard sheet
          data:{" "}
        </p>

        <ul>
          <li> Export data from Custom and Assumption Groups. </li>
          <li> Export data from accounts that can be used to reproduce a standard sheet. </li>
        </ul>

        <p>
          <b> To reproduce a standard sheet, </b>
        </p>

        <ol>
          <li>
            <p> Log into your Adaptive Insights account. </p>
          </li>

          <li>
            <p>
              {" "}

              Go to <b> Model Management > Sheets </b>.{" "}
            </p>
          </li>

          <li>
            <p> Locate the sheet you want to reproduce. </p>
          </li>

          <li>
            <p>
              {" "}

              Click on <b> Account Groups </b>.{" "}
            </p>
          </li>

          <li>
            <p> In the connector UI in Domo, select the accounts that are showing in Adaptive Insights. </p>
          </li>
        </ol>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Roll Up Values?{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Select whether you want to retrieve rolled up values.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Date Filtering{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Select whether you want to filter by dates.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Duration </p>
      </td>

      <td colspan="1" rowspan="1">
        <p> Select whether you want to pull data for a specific date or a date range. </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Report Date </p>
      </td>

      <td colspan="1" rowspan="1">
        <p> Select whether the report data is for a specific date or for a relative number of days back from today. </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Select Specific Date </p>
      </td>

      <td colspan="1" rowspan="1">
        <p> Select the date for the report. </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Days Back </p>
      </td>

      <td colspan="1" rowspan="1">
        <p> Enter the number of past days that should appear in the report. </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Start Date </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          {" "}

          Specify whether the first date in your date range is a specific or relative date. You select the last date in your
          range in <b> End Date </b>.{" "}
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> End Date </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          {" "}

          Specify whether the second date in your date range is a specific or relative date. You select the first date in
          your range in <b> Start Date </b>.{" "}
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Select Specific Start Date </p>
      </td>

      <td colspan="1" rowspan="1">
        <p> Select the first date in your date range. </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Select Specific End Date </p>
      </td>

      <td colspan="1" rowspan="1">
        <p> Select the second date in your date range. </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Days Back to Start From </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          {" "}

          Enter the number of the farthest day back that should be represented in the report. Combine with

          <b>
            {" "}

            Days Back to End At{" "}
          </b>

          to create a range of represented days.{" "}
        </p>

        <p>
          {" "}

          For example, if you entered
          <span class="mt-font-courier-new"> 10
          </span> for

          <b>
            {" "}

            Days Back to Start From{" "}
          </b>

          and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain
          data for 10 days ago up until 5 days ago.{" "}
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        <p> Days Back to End At </p>
      </td>

      <td colspan="1" rowspan="1">
        <p>
          {" "}

          Enter the number of the most recent day back that should be represented in the report. Combine with

          <b>
            {" "}

            Days Back to Start From{" "}
          </b>

          to create a range of represented days.{" "}
        </p>

        <p>
          {" "}

          For example, if you entered
          <span class="mt-font-courier-new"> 10
          </span> for

          <b>
            {" "}

            Days Back to Start From{" "}
          </b>

          and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain
          data for 10 days ago up until 5 days ago.{" "}
        </p>
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Data Version{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Select the version of the data you want to retrieve data for.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Currency{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Select whether to retrieve data for US dollars, your local currency, or the currency used by your corporation.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Data Sheet{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Select the sheet you want to retrieve data for.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Accounts{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Select all of the accounts you want to retrieve data for.{" "}
      </td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1">
        {" "}

        Dimension Name{" "}
      </td>

      <td colspan="1" rowspan="1">
        {" "}

        Select the dimension you want to retrieve data for.{" "}
      </td>
    </tr>
  </tbody>
</table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## FAQ

<AccordionGroup>
  <Accordion title="How often can the data be updated?">
    As often as needed,
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    No.
  </Accordion>
</AccordionGroup>

## Troubleshooting for Consulting/Support

Confirm that the customer instance is correct.
