From 91f6cfb8e27ca7dd91996c0ea1e0eb747d7705b6 Mon Sep 17 00:00:00 2001 From: Jennifer Thomas Date: Thu, 17 Aug 2023 22:19:01 +0000 Subject: [PATCH 1/3] update readme with installation instructions --- README.md | 75 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 44 insertions(+), 31 deletions(-) diff --git a/README.md b/README.md index 4bf768ff..a593be4e 100644 --- a/README.md +++ b/README.md @@ -5,65 +5,78 @@

Data Foundation - Order to Cash

- **Orders Fulfillment Dashboard** - Monitor current delivery status, highlight late deliveries and compare pending deliveries with current stock. -- **Order Snapshot Dashboard** - To monitor the health of the orders and also how efficient our Orders vs Deliveries. -- **Order Details** - Find all the information about your order in one place and their status. +- **Order Snapshot Dashboard** - Monitor the health of the orders and also how efficient our Orders vs Deliveries. +- **Order Details** - See order details including status. - **Sales Performance** - Review the sales performance of Products, Division, Sales organization and Distribution channel. -- **Billing and Pricing** - All the information related to the customer and products focused on price variations. +- **Billing and Pricing** - Review price variations by customer and product.

Data Foundation - Finance

-- **Accounts Receivable Dashboard** - Find all the information regarding the companies' finance such as Accounts Receivable, Overdue Receivables, Day Sales Outstanding. -- **Accounts Payable Dashboard** - Find all the information regarding the companies' finance such as Accounts Payables, Accounts Payalable Turnover, Overdue Payables, Accounts Payable Aging and Cash Discount Utilization. -- **Vendor Performance Dashboard** - Find all the information regarding the Vendor Performance in terms of delivery and other important indicators like Vendor Lead time , Purchase price variance , Purchase Order status. -- **Spend Analysis Dashboard** - Find all the information regarding the major indicators like Total Spend, Spend Analysis, Total number of Suppliers to check spend across different Purchase orgs, Purchase groups, Vendor Countries, Material Types. +- **Accounts Receivable Dashboard** - Analyze total receivables, overdue receivables, days outstanding, and top companies with highest receivables. +- **Accounts Payable Dashboard** - Find financial information such as accounts payable, accounts payable turnover, overdue payables, accounts payable aging, and cash discount utilization. +- **Vendor Performance Dashboard** - Analyze vendor performance including delivery, lead time, price variance, purchase order status. +- **Spend Analysis Dashboard** - Review key kpis like total spend, active vendor count and cleared invoices. Breakdown spend by purchase organization, purchase group, vendor country, and material type. +

Data Foundation - Inventory

- **Inventory Management Dashboard** - This block gives the high level information to Inventory Manager about various stock categories and other important Key Performance Indicators including Inventory Turn, Days of Supply, Obsolete Inventory and Slow Moving Inventory. -

Setting up the dashboards for the first time

+

Required Data

-There are 2 ways to setting up these dashboards: +Get the required datasets for this block by following the [Google Cloud Cortex Framework](https://github.com/GoogleCloudPlatform/cortex-data-foundation). -- Use "Install from Git URL" functionality from Looker Marketplace. See [instructions](https://cloud.google.com/looker/docs/marketplace#installing_a_tool_from_a_git_url). -- (Advanced) Use a Git connection. See [Instructions](https://cloud.google.com/looker/docs/setting-up-git-connection). +

Installation Instructions

-

Required Data

+Manually install this LookML Model following the one of the options below. + +

Option A: Marketplace Install via Git

+ +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**. -The datasets required by this block can be obtained by following the installation and configuration instructions for the [Google Cloud Cortex Framework](https://github.com/GoogleCloudPlatform/cortex-data-foundation) application. The related [Google Cloud Cortex Framework for SAP](https://github.com/llooker/cortex_data_foundation) LookML Block also leverages these same datasets. +

Option B: Manual Install via Fork of this Repository

+ - [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_demand_sensing) + - [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) -

Required Customizations

+

Required Parameters

+> ⚠️ 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. -

Constant Values

+- **Connection**: Value of the BigQuery CONNECTION_NAME allowing Looker to query the Cortex REPORTING dataset. -> ❕ Required Constant Values are configured during the Installation process. +- **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). -> ❕ This step is completed automatically if you use ["Install from Git URL" functionality](https://cloud.google.com/looker/docs/marketplace#installing_a_tool_from_a_git_url) from Looker Marketplace. +- **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. -- **Connection**: In the manifest.lkml file, update the value of the CONNECTION_NAME constant and Client ID. -- **GCP Project**: The GCP project name where the SAP reporting dataset resides in BigQuery (not project id). -- **Reporting Dataset**: The deployed Cortex Data Foundation _REPORTING dataset where the SAP views reside within the GCP BigQuery project. -- **ClientId/Constant**: The SAP Client number (mandt) the dashboards will utilize to display data. -

User Attributes

+

Required User Attributes

-> ❕ The dashboards will not load properly if any of the following required user attributes is not set. +Dashboards require two Looker [user attributes](https://cloud.google.com/looker/docs/admin-panel-users-user-attributes) to work properly. -- **Default Currency**: In the Looker User Profile, create and set the value of name = default_value_currency_required, label = "Default Value Currency Required" to the desired default currency. -- **Client Id Rep**: In the Looker User Profile, create and set the value of name = client_id_rep, label = "Default Value for Client Id Rep Required" to the desired default client_id_rep. +A Looker Admin should create the following user attributes and set their default values. +> ⚠️ Name each user attribute exactly as listed below: -

Other considerations

+| **Required User Attribute Name** | **Label** | **Data Type** | **User Access** | **Hide Value** | **Default Value** | +|----------------------------------|--------------------------------------|---------------|-----------------|----------------|-------------------| +| 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 | + +Each dashboard user can personalize these values by following these [instructions](https://cloud.google.com/looker/docs/user-account). + + +

Other Considerations

- **Persistent Derived Tables**: Enable Persistent Derived Tables using check box under CONNECTION settings accessible through Admin > Databases > Connections. - **Locale**: Each user's [Locale setting](https://cloud.google.com/looker/docs/model-localization#assigning_users_to_a_locale) in their Looker User Profile will be used to map to SAP language code and filter material text language for Sales Order, Vendor Performance and Inventory Metrics Overview views. See the [language_map](views/language_map.view.lkml) view for details on the mapping. -- **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) feature in Looker. +- **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) feature in Looker. - **(Optional) Unhide additional dimensions and measure**: Most dimensions and measures have been hidden to simplify reporting and data understanding. However should you find anything valuable missing, simply update the hidden parameters to No in the relevant views.

Additional Resources

To learn more about LookML and how to develop visit: - -- [Looker User Guide](https://looker.com/guide) -- [Looker Help Center](https://help.looker.com) -- [Looker University](https://training.looker.com/) +- [Looker Best Practices](https://cloud.google.com/looker/docs/best-practices/home) +- [Looker/Google Cloud Training](https://www.cloudskillsboost.google/catalog) From b75b45df47c31d65853db4e1dbc2990ca5767d47 Mon Sep 17 00:00:00 2001 From: Jennifer Thomas Date: Fri, 18 Aug 2023 17:55:05 +0000 Subject: [PATCH 2/3] updated other considerations section and dashboard descriptions --- README.md | 53 +++++++++++++++++++++++++++++++++++------------------ 1 file changed, 35 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index a593be4e..ac7102a3 100644 --- a/README.md +++ b/README.md @@ -2,33 +2,45 @@

What does this Looker Block do for me?

-

Data Foundation - Order to Cash

+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: +* Identify trends and patterns in your data +* Spot potential problems early on +* Make better decisions faster -- **Orders Fulfillment Dashboard** - Monitor current delivery status, highlight late deliveries and compare pending deliveries with current stock. -- **Order Snapshot Dashboard** - Monitor the health of the orders and also how efficient our Orders vs Deliveries. +

Included Dashboards by Subject Area

+ +

Order to Cash

+ +- **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, Division, Sales organization and Distribution channel. +- **Sales Performance** - Review the sales performance of products, divisions, sales organizations and distribution channels. - **Billing and Pricing** - Review price variations by customer and product. -

Data Foundation - Finance

+

Finance

-- **Accounts Receivable Dashboard** - Analyze total receivables, overdue receivables, days outstanding, and top companies with highest receivables. -- **Accounts Payable Dashboard** - Find financial information such as accounts payable, accounts payable turnover, overdue payables, accounts payable aging, and cash discount utilization. -- **Vendor Performance Dashboard** - Analyze vendor performance including delivery, lead time, price variance, purchase order status. -- **Spend Analysis Dashboard** - Review key kpis like total spend, active vendor count and cleared invoices. Breakdown spend by purchase organization, purchase group, vendor country, and material type. +- **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. -

Data Foundation - Inventory

+

Inventory

+ +- **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 -- **Inventory Management Dashboard** - This block gives the high level information to Inventory Manager about various stock categories and other important Key Performance Indicators including Inventory Turn, Days of Supply, Obsolete Inventory and Slow Moving Inventory.

Required Data

-Get the required datasets for this block by following the [Google Cloud Cortex Framework](https://github.com/GoogleCloudPlatform/cortex-data-foundation). +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).

Installation Instructions

-Manually install this LookML Model following the one of the options below. +Manually install this LookML Model following one of the options below.

Option A: Marketplace Install via Git

@@ -36,11 +48,13 @@ Refer to the Looker documentation for [Installing a Tool from Marketplace](https

Option B: Manual Install via Fork of this Repository

- [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_demand_sensing) + - [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. +

Required Parameters

> ⚠️ 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. @@ -70,10 +84,13 @@ Each dashboard user can personalize these values by following these [instruction

Other Considerations

-- **Persistent Derived Tables**: Enable Persistent Derived Tables using check box under CONNECTION settings accessible through Admin > Databases > Connections. -- **Locale**: Each user's [Locale setting](https://cloud.google.com/looker/docs/model-localization#assigning_users_to_a_locale) in their Looker User Profile will be used to map to SAP language code and filter material text language for Sales Order, Vendor Performance and Inventory Metrics Overview views. See the [language_map](views/language_map.view.lkml) view for details on the mapping. -- **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) feature in Looker. -- **(Optional) Unhide additional dimensions and measure**: Most dimensions and measures have been hidden to simplify reporting and data understanding. However should you find anything valuable missing, simply update the hidden parameters to No in the relevant views. +- **Persistent Derived Tables**: 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). + +- **Locale**: The Looker user [locale](https://cloud.google.com/looker/docs/model-localization#assigning_users_to_a_locale) setting (as seen in account profile) maps to SAP language code for _Materials_MD_, _Vendor Performance_, and _Inventory Metrics Overview_ views and determines material text language. See [language_map](views/language_map.view.lkml) for details. + +- **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. + +- **(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` parameter value **No** in the relevant views.

Additional Resources

From 7ea758229c8886597e51562477938bba131ed972 Mon Sep 17 00:00:00 2001 From: thjennifer Date: Fri, 18 Aug 2023 11:04:31 -0700 Subject: [PATCH 3/3] update bullet formatting --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index ac7102a3..1bb9d14a 100644 --- a/README.md +++ b/README.md @@ -47,11 +47,12 @@ Manually install this LookML Model following one of the options below. 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**.

Option B: Manual Install via Fork of this Repository

- - [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) + + * [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.