Resetting the data source binding for upgraded applications

When you upgrade, because of the new restriction to bind an entire application to a single data source, Studio binds all of your upgraded applications to the default data source, set using the df.defaultDataSource Framework Setting. The upgrade process does not immediately change the data source binding for individual components. After the upgrade, you must configure the data source binding for your applications and components.

Note that even if your application is already bound to the default data source, if any components in the application are bound to other data sources, you must still re-select the application data source, in order to reset the data source binding for the components.

Before updating the data source binding, make sure that you have updated your data sources to rename the datastoreName parameter to dataDomainName. See Renamed the datastoreName parameter of the data source definition.

To update the data source binding, you must either be an Application Administrator for the application, or a Studio administrator.

To bind an upgraded application and components to the correct data source:

  1. On the Discovery Applications page, click the application you want to update.

    The application is displayed.

  2. From the Studio menu, select Application Settings.

    The Application Settings page is displayed. The Application Configuration option is selected automatically.

  3. On the Application Configuration page, from the Data Source drop-down list, select the data source you want to use.
  4. Make sure to check the Maintain existing component preferences checkbox.
    Data source drop-down and Maintain component preferences checkbox
  5. Click Save.

    The application, and all of its components, are bound to the selected data source. Studio maintains as much of the component configuration as possible.

    Note that if you want to re-select the default data source, then in order to get the component configuration to reset correctly, you must first select a different data source. After saving that change, you can then re-select the default data source.

  6. If the selected data source has related data sources (is part of a hierarchy of parent/child data sources), then you can bind individual components to one of those related data sources.

    If there are related data sources, then the Application Settings page includes the Data Source Bindings page.

    To use the Data Source Bindings page to change the data source bound to individual components:

    1. In the Application Settings menu, click Data Source Bindings.

      The Data Source Bindings lists the pages and components in the application.

    2. Check the checkbox next to each component that you want to bind to a specific data source.
    3. From the Select a data source drop-down list, select the data source to bind to the selected components.
    4. Make sure to check the Maintain existing component preferences checkbox.
    5. To complete the change, click Update data source.