Merge pull request #86 from oracle-devrel/lift-analytics-artifacts

lift-analytics-Maps using Json files

Author: AlexanderHodicke

data-platform/analytics/oac-map-extensions/LICENSE

@@ -0,0 +1,36 @@
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+The Universal Permissive License (UPL), Version 1.0
+
+Subject to the condition set forth below, permission is hereby granted to any
+person obtaining a copy of this software, associated documentation and/or data
+(collectively the "Software"), free of charge and under any and all copyright
+rights in the Software, and any and all patent rights owned or freely
+licensable by each licensor hereunder covering either (i) the unmodified
+Software as contributed to or provided by such licensor, or (ii) the Larger
+Works (as defined below), to deal in both
+
+(a) the Software, and
+(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
+one is included with the Software (each a "Larger Work" to which the Software
+is contributed by such licensors),
+
+without restriction, including without limitation the rights to copy, create
+derivative works of, display, perform, and distribute the Software and make,
+use, sell, offer for sale, import, export, have made, and have sold the
+Software and the Larger Work(s), and to sublicense the foregoing rights on
+either these or other terms.
+
+This license is subject to the following condition:
+The above copyright notice and either this complete permission notice or at
+a minimum a reference to the UPL must be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data-platform/analytics/oac-map-extensions/README.md

@@ -0,0 +1,37 @@
+# OAC extensions for Maps using Json files
+
+Oracle Analytics platform is a cloud-native service that provides the capabilities required to address the entire analytics process including data ingestion and modeling, data preparation and enrichment, and visualization and collaboration, without compromising security and governance. 
+Oracle Analytics Extensions expand and enhance your Oracle Analytics deployment with custom extensions to further your visualization capabilities.
+
+The purpose of Map Extension functionality is to provide consumers and business intelligence analysts with the functionality to analyze the data in map views. With this artifact, you can add maps for different countries shared and display data on maps in different formats. 
+This geo JSON can create maps to visualize data such as sales by city and country, and products purchased in a specific region, and determine where you might need to add sales resources.
+
+Owner: Shriya Kastwar
+
+## When to use this asset?
+
+Map Extensions should be considered when some important decision needs to be taken by the management to deploy the resources. Its primary focus is on maintaining profit for the business along with the effective performance of the resources.
+
+The Map Extension for various countries will be helpful for implementing maps for different Europe countries easily for any data model. It enables you to quickly use the JSON files provided with your data and create meaningful insights.
+
+This asset will provide the following key features and benefits:
+
+1) Extension to the basic map functionality.
+2) Interacts with the data.
+3) Decision-Making Strategies.
+4) Meaningful Insights.
+5) More detailed Reports.
+
+
+## How to use this asset?
+
+Here is an overview of how to use this asset:
+
+You can upload these JSON files using the below steps in Oracle Analytics Cloud and use them:
+
+Step 1: On the Home page click Navigator, and then click Console.
+Step 2: Click Maps, click Map Layers, and click Custom Map Layers.
+Step 3: Click on Add Custom Map and upload the JSON files provided.
+Step 4: Add a custom uploaded Map to the Report by selecting the report and clicking on the Map Layer.
+
+You will be able to view the data in the report across the selected maps.

data-platform/analytics/oac-map-extensions/THIRD_PARTY_LICENSES

@@ -0,0 +1,14 @@
+
+Copyright 2010-2023 Mike Bostock
+ 
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+ 
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

data-platform/analytics/oac-map-extensions/files/images/Figure 1.png

@@ -0,0 +1,73 @@
+# Introduction
+
+Oracle Analytics platform is a cloud native service that provides the capabilities required to address the entire analytics process including data ingestion and modeling, data preparation and enrichment, and visualization and collaboration, without compromising security and governance. Oracle Analytics Extensions expand and enhance your Oracle Analytics deployment with custom extensions to further your visualization capabilities.
+
+Map Extension functionality can be used by Oracle Analytics Cloud consumers and business intelligence analysts. 
+
+## Pre-requisites:
+
+In order to enable this solution, the following must be available:
+
+- Operating system (64 bits): Linux, Solaris x86-64, SPARC, Windows, AIX, HP-UX, Linux.
+- Oracle Analytics Cloud: Enterprise Edition.
+- Oracle Cloud Infrastructure Account: You will need an active Oracle Cloud Infrastructure account. 
+- IAM User: You need to create an Identity and Access Management (IAM) user in your OCI tenancy with the required permissions to access Oracle Cloud.
+  
+### Main Features:
+
+- Report for Revenue Analysis.
+- Custom Map Extension.
+- JSON Files for different countries.
+
+## Business Value
+The customer is required to get their data columns modeled to be displayed on maps. They can configure the map data and then analyze it in map views.
+Map views allow them to display data on maps in different formats and to interact with data. They can create maps to visualize data such as sales by city and country, and products purchased in a specific region, and determine where you might need to add sales resources.
+
+## Use Case 
+
+When a custom map extension is used, customers can visualize the data by countries/cities.
+The custom map extension adds more value to the data by representing it from the least to the most ranges in different colors and highlighting meaningful insights. This solution shows how custom maps can be updated in the Oracle Analytics Cloud and used in a map graph representing revenue by country.
+
+The implemented solution satisfies below functional requirements:
+
+- Be able to do Revenue analysis.
+- Visualize sales data.
+- Drill down reports to sales by country and city.
+- Product purchased in a specific region.
+- Insights to highlight turnover performance by country.
+- Represent Net profit by country/city.
+
+### Update Custom Map Layers:
+
+1.	On the Home page click Navigator, and then click Console.
+
+
+![Alt text](<images/Figure 1.png>)
+
+Figure 1.  Representation of navigation for uploading custom map in Oracle Analytics Cloud.
+
+2.	Click Maps, click Map Layers, and click Custom Map Layers.
+
+![Alt text](<images/Figure 2.png>)
+
+Figure 2.  Representation of selection of map extension functionality in Oracle Analytics Cloud.
+
+3.	Add Custom Map.
+
+
+![Alt text](<images/Figure 3.png>)
+
+Figure 3. Representation of uploading geo json files in Oracle Analytics Cloud.
+
+4.	Adding custom uploaded Map to the Report.
+
+![Alt text](<images/Figure 4.png>)
+
+Figure 4. Representation of adding uploaded custom Maps to the Analytics Report.
+
+5.	Report Output
+
+![Alt text](<images/Figure 5.png>)
+
+
+Figure 5. Representation of Revenue Analysis within Europe.