Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions reporting-analytics/analytics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ In addition to OpenOps tables, OpenOps Analytics can connect to and visualize yo

To configure data visualizations, click **Analytics** on the main navigation bar in OpenOps. When the **Analytics** view opens, click **Admin Panel** to proceed to the Analytics admin portal that is separate from the main OpenOps application.

To sign in to the Analytics portal, use `admin` as the username and the password defined with the `OPS_ANALYTICS_ADMIN_PASSWORD` variable in the `.env` file in your OpenOps installation folder. (If you havent changed the password, the default is `please-change-this-password-1`.)
To sign in to the Analytics portal, use `admin` as the username and the password defined with the `OPS_ANALYTICS_ADMIN_PASSWORD` variable in the `.env` file in your OpenOps installation folder. (If you haven't changed the password, the default is `please-change-this-password-1`.)

<Note>
If you don't have access to the OpenOps installation folder:
Expand All @@ -31,6 +31,18 @@ Behind every OpenOps table, there is a Postgres database view that can be used t

When a new table is created in [OpenOps tables](/reporting-analytics/tables/), the system automatically creates a new database view with the naming convention _table name \_ table id \_ userfriendly_. You can use this view to create dashboards in OpenOps, as well as connect it to other BI systems.

## Running OpenOps without Analytics

OpenOps can run without the Analytics service.

If `OPS_ANALYTICS_PRIVATE_URL` is not set, OpenOps skips Analytics seeding.

## Demo dashboard seeding

OpenOps can seed a demo dashboard named **Homepage** in the analytics portal.

This seeding runs only when the `SHOW_DEMO_HOME_PAGE` flag is set. When the flag is not set, OpenOps skips seeding the demo dashboard.

## Building new charts

To configure a new chart based on an OpenOps table to display in the **Analytics** view in OpenOps, do the following:
Expand Down Expand Up @@ -59,7 +71,7 @@ Here's what you can do to connect OpenOps Analytics to external data sources suc
1. In the Analytics admin portal, in the top right corner, click **Settings**, then **Database Connections**.
<NarrowImage src="/images/analytics-external-menu.png" alt="Database connections settings" widthPercent={40} />
2. Click **+ Database** to connect to an external data source, such as your own Postgres instance or Google Sheets.
3. Once you have created a database connection, if youd like to upload CSVs to it, click the **Edit** icon for the database connection:
3. Once you have created a database connection, if you'd like to upload CSVs to it, click the **Edit** icon for the database connection:
![Editing a database connection](/images/analytics-edit-db-connection.png)
4. In the popup that displays, go to **Advanced > Security**, scroll down, and enable **Allow file uploads to database**.
<NarrowImage src="/images/analytics-database-allow-file-uploads.png" alt="Allowing file uploads" widthPercent={60} />
Expand Down
10 changes: 10 additions & 0 deletions reporting-analytics/tables.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,16 @@ To better understand how the two tables described above are used in real-life wo
* **Dismissed** if the owner has chosen to dismiss the opportunity.
* **Snoozed** if the owner has chosen to consider the opportunity later. The number of days to delay is reflected in the **Snoozed until** field.

## Multiple workspaces, databases, and tokens

OpenOps Tables setup expects a single workspace, database, and database token for the Tables admin user:

* If the Tables admin user has more than one workspace, OpenOps throws an error.
* If the workspace has more than one database, OpenOps throws an error.
* If the workspace has more than one database token, OpenOps throws an error.

This constraint exists because OpenOps uses that workspace, database, and token for creating and accessing the default OpenOps Tables database.

## Creating new tables

In addition to preconfigured tables, you can create your own. This is especially useful when you're developing original workflows that are not based on OpenOps templates and you want to set up a visual way to save data generated by the workflows.
Expand Down