Create a Connection and Datasource for a File

Define a global or local connection and Datasource over a source data file in the Essbase Server file catalog.

  1. Upload the source data file to the file catalog on Essbase.

  2. If you need a sample source data file for this task flow, you can use UserDetails.csv from the gallery section of the file catalog. It is a repository of 22 users, with their associated countries, cost centers, currency, managers, company, business units, and offices.

  3. In the Essbase web interface, click Sources, then Connections.

    Or, to define the connection and Datasource at application level instead of globally, start on the Applications page instead of the Sources page. Click an application name, and then click Sources. The example used in this topic is an application level connection defined on Sample.

  4. Click Create Connection, and for the connection type, select File.

  5. Enter a name for the connection; for example, UserDetails.

  6. Browse to the catalog location of the source data file.

  7. Enter an optional description; for example, CSV file of user details

  8. Click Test to validate the connection, and if successful, click Create.


    Create connection dialog for creating connnection to a file in the Essbase Server catalog. Name: UserDetails, path to catalog file: /gallery/Technical/Filters/UserDetails.csv, Description: CSV file of user details

  9. Verify that the connection was created successfully and appears in the list of connections.

    Next, you will create a Datasource for the file connection.

  10. Click Datasources, and click Create Datasource.

  11. From the Connection drop-down box, select the name of the connection you just created; for example, UserDetails.

  12. Enter a name for the Datasource, and an optional description.

  13. Essbase detects and enters details about the source data; for example, whether it has a header row, and is comma-delimited. Click Next.


    Create Datasource dialog, General step, for creating Datasource to a file on the Essbase Server. Connection: SAMPLE.UserDetails, Name: userDetails_DS, Description: User details repository. Header Row is checked, because Essbase detected that the CSV has a header record. Delimiter is Comma, because Essbase detected that the file is comma delimited

  14. If the SQL statement was correct to query a table, the queried columns are populated. Change any numeric columns to Double, and click Next.


    Create Datasource dialog, Columns step. Column names and types are listed. You can change the type from String to a more appropriate data type as needed.

  15. If the preview looks correct, click Create to finish creating the Datasource.