-
Notifications
You must be signed in to change notification settings - Fork 224
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #57 from looker-open-source/thjennifer-patch-1
Update README.md
- Loading branch information
Showing
1 changed file
with
2 additions
and
118 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,124 +1,8 @@ | ||
| <h1><span style="color:#2d7eea">Google Cloud Cortex Framework for SAP</span></h1> | ||
|
|
||
| <h2><span style="color:#2d7eea">What does this Looker Block do for me?</span></h2> | ||
|
|
||
| Gain faster insights into your Order to Cash, Finance, and Inventory data with these Dashboards and Explores based on the SAP Cortex Data Foundation. Leverage or customize this Looker model to: | ||
| Gain faster insights into your Order to Cash, Finance, and Inventory data with these Dashboards and Explores based on the [Google Cloud Cortex Framework](https://cloud.google.com/solutions/cortex#google-cloud-cortex-framework) for SAP. Leverage or customize this Looker model to: | ||
| * Identify trends and patterns in your data | ||
| * Spot potential problems early on | ||
| * Make better decisions faster | ||
|
|
||
| <h2><span style="color:#2d7eea">Included Dashboards by Subject Area</span></h2> | ||
|
|
||
| <h3> Order to Cash </h3> | ||
|
|
||
| - **Orders Fulfillment** - Monitor current delivery status, highlight late deliveries and compare pending deliveries with current stock. | ||
| - **Order Snapshot** - Monitor the health of the orders including product delivery efficiency. | ||
| - **Order Details** - See order details including status. | ||
| - **Sales Performance** - Review the sales performance of products, divisions, sales organizations and distribution channels. | ||
| - **Billing and Pricing** - Review price variations by customer and product. | ||
|
|
||
| <h3>Finance</h3> | ||
|
|
||
| - **Accounts Receivable** - Analyze total receivables, overdue receivables, days outstanding, and top companies with highest receivables. | ||
|
|
||
| - **Accounts Payable** - Find financial information such as accounts payable, accounts payable turnover, overdue payables, accounts payable aging, and cash discount utilization. | ||
|
|
||
| - **Vendor Performance** - Analyze vendor performance including delivery, lead time, price variance, purchase order status. | ||
|
|
||
| - **Spend Analysis** - Review Key Performance Indicators (KPIs) like total spend, active vendor count and cleared invoices. Breakdown spend by purchase organization, purchase group, vendor country, and material type. | ||
|
|
||
| - **Balance Sheet** - View the balance sheet as of a selected fiscal period. Compare it to the same period last year, the previous fiscal period, or a different fiscal period. And display multiple levels of the selected hierarchy for a user-specified chart of accounts and company. Two dashboards using different table styles are included. | ||
| ⚠️ Since [Google Cloud Cortex Framework 5.3](https://github.com/GoogleCloudPlatform/cortex-data-foundation). If using this block with the SAP Finance test harness data, only company code C006 balances to zero. This is expected. | ||
|
|
||
| - **Income Statement** - View the income statement for selected fiscal periods, individually or combined. Compare the timeframe to the same timeframe a year ago or the preceding fiscal timeframe, and display multiple levels of the GL Account hierarchy. Two dashboards using different table styles are included. | ||
| ⚠️ Since [Google Cloud Cortex Framework 5.4](https://github.com/GoogleCloudPlatform/cortex-data-foundation). If using this block with SAP Finance test harness data, company code C006 provides the best illustration of Income Statement. | ||
|
|
||
|
|
||
| <h3>Inventory</h3> | ||
|
|
||
| - **Inventory Management** - Review inventory value over time (in total and by material type). Highlight other important KPIs including: | ||
| * Inventory Turn | ||
| * Days of Supply | ||
| * Obsolete Inventory Value | ||
| * Slow Moving Inventory Value | ||
|
|
||
|
|
||
| <h2><span style="color:#2d7eea">Required Data</span></h2> | ||
|
|
||
| Get the required BigQuery datasets for this block by following the installation instructions for [Google Cloud Cortex Framework](https://github.com/GoogleCloudPlatform/cortex-data-foundation). | ||
|
|
||
| <h2><span style="color:#2d7eea">Installation Instructions</span></h2> | ||
|
|
||
| Manually install this LookML Model following one of the options below. | ||
|
|
||
| <h4><span style="color:#2d7eea">Option A: Marketplace Install via Git</span></h4> | ||
|
|
||
| Refer to the Looker documentation for [Installing a Tool from Marketplace](https://cloud.google.com/looker/docs/marketplace#installing_a_tool_from_a_git_url). Provide values for the required prompts as outlined in next section **Required Parameters**. | ||
|
|
||
| <h4><span style="color:#2d7eea">Option B: Manual Install via Fork of this Repository</span></h4> | ||
|
|
||
| * [Fork this GitHub repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository) | ||
| * [Create a blank LookML project](https://cloud.google.com/looker/docs/create-projects#creating_a_blank_project) with any name (e.g., cortex_sap_operational) | ||
| * [Connect the new LookML project to the forked repository](https://cloud.google.com/looker/docs/setting-up-git-connection) | ||
| * Update the values of constants in the `manifest.lkml` file as described in the next section **Required Parameters** | ||
| * [Commit and deploy changes to production](https://cloud.google.com/looker/docs/version-control-and-deploying-changes#getting_your_changes_to_production) | ||
|
|
||
| With the Looker project based on your forked repository, you can customize the LookML to fit your unique business needs. | ||
|
|
||
| <h2><span style="color:#2d7eea"> Required Parameters</span></h2> | ||
| > ⚠️ These required values are configured during the Marketplace Installation process, or if this Block was installed from a forked Git repository, you will update the values for these constants in the `manifest.lkml` file for the project. | ||
| - **Connection**: Value of the BigQuery CONNECTION_NAME allowing Looker to query the Cortex REPORTING dataset. Note, to use Balance Sheet reporting [Persistent Derived Tables](https://cloud.google.com/looker/docs/db-config-google-bigquery#persistent-derived-tables-on-a-connection) must be enabled. | ||
|
|
||
| - **GCP Project ID**: The GCP project where the SAP reporting dataset resides in BigQuery (i.e., GCP project ID). [Identifying Project ID](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects). | ||
|
|
||
| - **Reporting Dataset**: The deployed Cortex Data Foundation REPORTING dataset where the SAP views reside within the GCP BigQuery project. | ||
|
|
||
| - **Client**: The SAP Client number (mandt) to use for Reporting. | ||
|
|
||
| - **Sign Change**: For Profit and Loss/Income Statement reporting, revenue is generally displayed in general ledger as a negative number, which indicates a credit. By setting Sign Change value to 'yes', it's displayed as a positive number in income statement reports. | ||
|
|
||
|
|
||
|
|
||
| <h2><span style="color:#2d7eea"> Required User Attributes</span></h2> | ||
|
|
||
| Dashboards require several Looker [user attributes](https://cloud.google.com/looker/docs/admin-panel-users-user-attributes) to work properly. | ||
|
|
||
| A Looker Admin should create the following user attributes and set their default values. | ||
| > ⚠️ Name each user attribute exactly as listed below: | ||
| | **Required User Attribute Name** | **Label** | **Data Type** | **User Access** | **Hide Value** | **Default Value** | | ||
| |----------------------------------|--------------------------------------|---------------|-----------------|----------------|-------------------| | ||
| | locale | locale | String | View | No | en | | ||
| | default_value_currency_required | SAP Default Currency to Display | String | Edit | No | `USD` or _desired currency like EUR, CAD or JPY_ | | ||
| | client_id_rep | SAP Client Id (mandt) for Reporting | String | Edit | No | Enter your _SAP Client ID_ or `100` if using the provided test data | | ||
| | sap_use_demo_data | SAP: Use Demo Data (Yes or No) | String | Edit | No | Enter `Yes` if using the provided test data. Otherwise, enter `No` | | ||
| | sap_sql_flavor | SAP: SQL Flavor (ECC or S4) | String | View | No | Enter `ECC` or `S4` as required for your SAP system | | ||
|
|
||
| Each dashboard user can personalize the values of the editable user attributes by following these [instructions](https://cloud.google.com/looker/docs/user-account). | ||
|
|
||
| <h2><span style="color:#2d7eea">Language</span></h2> | ||
| SAP Explores filter language based on user's [locale](https://cloud.google.com/looker/docs/model-localization#assigning_users_to_a_locale) or use English as a fallback if no locale value is found. The Balance Sheet and Income Statement Explores further restrict the locale to those also found in the source tables, using English if there are no matches. | ||
|
|
||
| <h2><span style="color:#2d7eea">Report Table Visualization from Marketplace</span></h2> | ||
| The Balance Sheet and Income Statement dashboards come in two different styles: | ||
| 1. Looker's Table Visualization with subtotals | ||
| 2. Report Table Visualization from Looker Marketplace | ||
|
|
||
| The Report Table provides an easy-to-read table style designed especially for finance reports. A Looker Admin must install the visualization from marketplace to use this table style. Refer to Looker documentation for [Using Looker Marketplace](https://cloud.google.com/looker/docs/marketplace). | ||
|
|
||
| <h2><span style="color:#2d7eea">Other Considerations</span></h2> | ||
|
|
||
| - **Persistent Derived Tables**: Required for using Balance Sheet dashboards. And if using this block with production data, you may want to convert some derived tables to [Persistent Derived Tables (PDTs)](https://cloud.google.com/looker/docs/derived-tables#use_cases_for_pdts) to improve query performance. Ensure your BigQuery Connection has enabled PDTs, then update any derived table syntax with the desired [persistence strategy](https://cloud.google.com/looker/docs/derived-tables#persistence_strategies). | ||
|
|
||
| - **BI Engine Optimization**: Some calculations perform better with [BI Engine Optimization](https://cloud.google.com/blog/products/data-analytics/faster-queries-with-bigquery-bi-engine) enabled in BigQuery. | ||
|
|
||
| - **Liquid Templating Language**: Some constants, views, explores and dashboard use liquid templating language. For more information, see Looker's [Liquid Variable Reference](https://cloud.google.com/looker/docs/liquid-variable-reference) documentation. | ||
|
|
||
| - **(Optional) Unhide additional dimensions and measures**: Many dimensions and measures are hidden for simplicity. If you find anything valuable missing, update the field's `hidden` property value to **no** in the relevant views. | ||
|
|
||
| <h2><span style="color:#2d7eea">Additional Resources</span></h2> | ||
|
|
||
| To learn more about LookML and how to develop visit: | ||
| - [Looker Best Practices](https://cloud.google.com/looker/docs/best-practices/home) | ||
| - [Looker/Google Cloud Training](https://www.cloudskillsboost.google/catalog) | ||
| For detailed information including content and installation instructions, checkout the dedicated Looker Block for SAP [documentation](https://cloud.google.com/cortex/docs/looker-block-sap). |