diff --git a/articles/TOC.yml b/articles/TOC.yml index 07d2ffd97..d6f47c68c 100644 --- a/articles/TOC.yml +++ b/articles/TOC.yml @@ -703,7 +703,7 @@ href: gateway-manage.md - name: Understand gateways href: gateway-reference.md - - name: SAP integration + - name: SAP integration (preview) items: - name: Overview href: ./sap-integration/overview.md diff --git a/articles/sap-integration/action-screen.md b/articles/sap-integration/action-screen.md index 90245aa50..419ea1df4 100644 --- a/articles/sap-integration/action-screen.md +++ b/articles/sap-integration/action-screen.md @@ -1,5 +1,5 @@ --- -title: Understand the different action screens when integrating SAP with Power Platform. +title: Understand the different action screens when integrating SAP with Power Platform (preview) description: Learn about the different action screens, and the configuration parameters for the available action screens when integrating SAP with Power Platform. services: '' suite: flow @@ -26,51 +26,17 @@ contributors: - tapanm-msft --- -**Cloud Flows – New Action for Complex APIs** +# Understand the different action screens when integrating SAP with Power Platform (preview) -  - -**ADO IDs: **[Epic 13029270](https://dev.azure.com/msazure/One/_workitems/edit/13029270) - -**Owner:** [Jon Gilman](mailto:jongilman@microsoft.com), [David Galitsky](mailto:dgalitsy@microsoft.com) - -**Design, Research & XR Timelines:** Not applicable. - -  - -**Why?**  +[This article is pre-release documentation and is subject to change.] Enterprise software systems like SAP and Oracle EBS have very complex APIs, often with 30-50 arguments and several hundred fields per argument. In some cases, an API can have 2,000 – 4,000 fields in the definition. The current flow maker throws an exception for such APIs and the maker then needs to manually research and fill the arguments in raw JSON. The goal of this enhancement is to dramatically improve this user experience. -**Who?** - -We are targeting makers of PA flows at large enterprises. - -**Pre-Requisites** - -13029271 - New Data Sources Page - -**What?** - -The following screens are in scope for this enhancement: - -[Add Action Screen 2](add-action-screen.md) - -[Function Detail – Blank Screen 2](#_Toc1440640701) - -[Function Detail – Select System 2](#function-detail-–-select-system) - -[Function Detail – Select API 3](#function-detail-–-select-api) - -[Function Detail – Load API 3](#function-detail-–-load-api) - -[Function Detail – Select Parameter 5](#function-detail-–-select-parameter) - -[Function Detail – Enter Value 6](#function-detail-–-enter-value) - -[Function Detail – Completed State 7](#function-detail-–-completed-state) +> [!IMPORTANT] +> - This is a preview feature. +> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)] -# Add Action Screen +## Add Action Screen For the initial rollout of the Complex API screen, we would like it to be launched when the maker clicks Add Action and selects one of the following: @@ -94,13 +60,13 @@ The new function detail screen will initially be blank with 4 main areas of user ![](media/action-screen/image2.png) -# Function Detail – Select System +## Function Detail – Select System When selecting the System, show a drop down containing the systems that have been configured on the Systems page per [13029271 - New Systems Page](https://microsoft.sharepoint.com/:w:/r/teams/prosipart/_layouts/15/Doc.aspx?sourcedoc=%7BCD9ACC94-CB5D-400F-B11C-DF766A5479FF%7D&file=13029271%20-%20New%20Systems%20Page.docx&action=default&mobileredirect=true&cid=ed822f63-007e-486a-a905-409ad5c202a0): ![](media/action-screen/image3.png) -# Function Detail – Select API +## Function Detail – Select API Similar to the way Call SAP Function works today, display a list of APIs matching the user's text input after they have entered at least 3 characters. Depending on the system of record, use the following logic: @@ -110,7 +76,7 @@ Similar to the way Call SAP Function works today, display a list of APIs matchin ![](media/action-screen/image4.png) -# Function Detail – Load API +## Function Detail – Load API Once the user has selected the API, the definition of the API should be queried and the required Input and Output parameters should be loaded by default, as shown in the screen mockup below. Depending on the system of record, use the following logic: @@ -178,7 +144,7 @@ Value ![](media/action-screen/image5.png) -# Function Detail – Select Parameter +## Function Detail – Select Parameter When the user clicks into the Add New Parameter… drop down, display a list of valid parameters for the API, filtering out parameters that have already been added to the table. Depending on the system of record, use the following logic: @@ -188,7 +154,7 @@ When the user clicks into the Add New Parameter… drop down, display a list of ![](media/action-screen/image6.png) -# Function Detail – Enter Value +## Function Detail – Enter Value Within the Value column, the user needs to have the ability to use expressions, static values, dynamic values, and the following data operations: @@ -200,7 +166,7 @@ Within the Value column, the user needs to have the ability to use expressions, ![](media/action-screen/image7.png) -# Function Detail – Completed State +## Function Detail – Completed State The following example shows a state where a user has selected all the parameters needed to invoke the complex API: diff --git a/articles/sap-integration/data-sources-pane.md b/articles/sap-integration/data-sources-pane.md index 6eef8b7e2..31c4af5da 100644 --- a/articles/sap-integration/data-sources-pane.md +++ b/articles/sap-integration/data-sources-pane.md @@ -1,5 +1,5 @@ --- -title: Understand the Data sources pane in Power Automate for SAP integration +title: Understand the Data sources pane in Power Automate for SAP integration (preview) description: Learn about the Data sources pane in Power Automate to configure SAP integration services: '' suite: flow @@ -22,39 +22,17 @@ search.audienceType: - enduser --- -**New Data Sources Page** +[This article is pre-release documentation and is subject to change.] -  - -**ADO IDs: **[Epic 13029271](https://dev.azure.com/msazure/One/_workitems/edit/13029271) - -**Owner:** [Jon Gilman](mailto:jongilman@microsoft.com), [David Galitsky](mailto:dgalitsy@microsoft.com) - -**Design, Research & XR Timelines:** Not applicable. - -  - -**Why?**  +# Understand the Data sources pane in Power Automate for SAP integration (preview) Currently, connections in Power Automate are attached to specific users and cannot be shared across Flow makers. This makes it difficult for large organizations who have several Flow makers accessing the same enterprise systems. Additionally, when adding a new SAP data connection, many of the key connection parameters are missing for enterprise customers. In order to support Single Sign On and load balanced connections, some changes will need to be made. We are proposing a new page called Data Sources that allows IT admins to configure connection attributes as environment variables that can be shared across many Flow makers. -**Who?** - -We are targeting makers of PA flows at large enterprises. - -**What?** - -3 pages within the Data menu of Power Apps and Power Automate: - -[Navigation Menu 2](navigation-menu.md) - -[Data Sources Page 2](#data-sources-page) - -[Data Source Detail Page 3](#data-source-detail-page) - -[Merging Connection Parameters at Run-Time 4](#merging-connection-parameters-at-run-time) +> [!IMPORTANT] +> - This is a preview feature. +> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)] -# Navigation Menu +## Navigation Menu Add a sub-menu item beneath the Data menu item called Data Sources. On click of the menu item, the user should be navigated to the Data Sources page, where environment variables matching the following conditions will be displayed: @@ -62,7 +40,7 @@ Add a sub-menu item beneath the Data menu item called Data Sources. On click of ![](media/data-sources-pane/image1.png) -# Data Sources Page +## Data Sources Page Create a new Data Sources page that mirrors the layout of the Connections page, but with some key differences: @@ -82,7 +60,7 @@ Create a new Data Sources page that mirrors the layout of the Connections page, ![](media/data-sources-pane/image2.png) -# Data Source Detail Page +## Data Source Detail Page Copy the Connection Detail page but add some additional features: @@ -96,7 +74,7 @@ Copy the Connection Detail page but add some additional features: When the user clicks Create or Save, the data from the System Detail Page should be saved to a JSON-type environment variable. -# Merging Connection Parameters at Run-Time +## Merging Connection Parameters at Run-Time Depending on the type of authentication used by an SAP customer, there will be session variables passed from Power Apps that need to be merged with the server-side connection parameters at run-time: diff --git a/articles/sap-integration/overview.md b/articles/sap-integration/overview.md index a31a101cd..21e950d23 100644 --- a/articles/sap-integration/overview.md +++ b/articles/sap-integration/overview.md @@ -1,5 +1,5 @@ --- -title: Overview of SAP integration with Power Platform +title: Overview of SAP integration with Power Platform (preview) description: Learn about the SAP integration with Power Platform, and the capabilities of the SAP connector working with Power Automate. services: '' suite: flow @@ -22,11 +22,11 @@ search.audienceType: - enduser --- -# Overview of SAP integration with Power Platform +# Overview of SAP integration with Power Platform (preview) -Microsoft Power Platform will be introducing enhanced integration capabilities into complex systems of record, like SAP and Oracle E-Business Suite. The enhanced integrations into Power Apps, Power Automate, and Azure Logic Apps will empower organizations to interact with complex systems of record more easily and build better end-to-end business solutions. +[This article is pre-release documentation and is subject to change.] -## Overview +Microsoft Power Platform will be introducing enhanced integration capabilities into complex systems of record, like SAP and Oracle E-Business Suite. The enhanced integrations into Power Apps, Power Automate, and Azure Logic Apps will empower organizations to interact with complex systems of record more easily and build better end-to-end business solutions. During this private preview, we will assign a Power Automate contact to work with you to set up a new prebuilt SAP solution for either purchase orders or sales orders and connect to your SAP development environment to validate functionality. Your feedback will enable our team to gain more insights to make further improvements. Specifically, the goal is to set up and test the following: @@ -38,7 +38,11 @@ During this private preview, we will assign a Power Automate contact to work wit - Azure Logic Apps functions -## Resources  +> [!IMPORTANT] +> - This is a preview feature. +> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)] + +## Resources Secure the following resources to assist with the configuration of the different environments:  @@ -67,4 +71,3 @@ Our team has set up the following to make sharing and collaboration efficient: - A sales order or purchase order template—let your power automate contact know which template you prefer.  - More, as needed.  - diff --git a/articles/sap-integration/set-up-prepare.md b/articles/sap-integration/set-up-prepare.md index 26da06b35..fbc617e43 100644 --- a/articles/sap-integration/set-up-prepare.md +++ b/articles/sap-integration/set-up-prepare.md @@ -1,5 +1,5 @@ --- -title: Prepare and set up SAP integration with Power Platform +title: Prepare and set up SAP integration with Power Platform (preview) description: Learn about the requirements to configure SAP integration, and prepare your on-premises SAP infrastructure to connect with Power Platform. services: '' suite: flow @@ -22,7 +22,9 @@ search.audienceType: - enduser --- -# Prepare and set up SAP integration with Power Platform +# Prepare and set up SAP integration with Power Platform (preview) + +[This article is pre-release documentation and is subject to change.] The following requirements need to be established before testing can begin. Please let your Power Automate contact know if you need any assistance. @@ -40,6 +42,10 @@ The following requirements need to be established before testing can begin. Plea Work with your Power Automate contact through the following steps:  +> [!IMPORTANT] +> - This is a preview feature. +> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)] + ## Install the private preview OPDG  Your Power Automate contact will share a private preview version of the OPDG to be installed. There can only be one OPDG installed on a Windows machine and nothing else should be on the machine. You can choose to do one of the following:  diff --git a/articles/sap-integration/solutions.md b/articles/sap-integration/solutions.md index b4aea91d8..e78c950b3 100644 --- a/articles/sap-integration/solutions.md +++ b/articles/sap-integration/solutions.md @@ -1,5 +1,5 @@ --- -title: Solutions available for integrating SAP with Power Platform +title: Solutions available for integrating SAP with Power Platform (preview) description: Learn about the different solutions available for SAP integration with Power Platform. services: '' suite: flow @@ -22,10 +22,16 @@ search.audienceType: - enduser --- -# Solutions available for integrating SAP with Power Platform +# Solutions available for integrating SAP with Power Platform (preview) + +[This article is pre-release documentation and is subject to change.] You can integrate SAP with your existing Power Platform solutions that consist of such as canvas apps, model-driven apps created using Power Apps, and flows created using Power Automate. While such solutions can be custom built from scratch, there are several solutions available for you to choose from that allow a faster and effective integration of your existing SAP deployments with Power Platform. +> [!IMPORTANT] +> - This is a preview feature. +> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)] + | Placeholder table with solutions | Description | | - | - | | Solution 1 | Description 1| \ No newline at end of file diff --git a/articles/sap-integration/test-setup.md b/articles/sap-integration/test-setup.md index a727e9301..888b8031b 100644 --- a/articles/sap-integration/test-setup.md +++ b/articles/sap-integration/test-setup.md @@ -1,5 +1,5 @@ --- -title: Test and verify SAP integration with Power Platform +title: Test and verify SAP integration with Power Platform (preview) description: Learn about how to test and verify Power Platform integration with SAP services: '' suite: flow @@ -22,12 +22,19 @@ search.audienceType: - enduser --- -# Test and verify SAP integration with Power Platform +# Test and verify SAP integration with Power Platform (preview) + +[This article is pre-release documentation and is subject to change.] The newest version of Power Platform's SAP connector has enhanced functionalities. It enables Message Server support and allows for easier entering of parameters needed when connecting to SAP. +> [!IMPORTANT] +> - This is a preview feature. +> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)] + There is a minimum of two required fields for this action to begin: - SAP System: This is a JSON string containing all the necessary SAP connection parameters. For a complete list of all the available properties, refer to the "SAP property guidance" table. The JSON string can be manually entered or chosen from an existing environment variable within a solution. - RFC name: The name of the remote call function (RFC) you would like to call. + diff --git a/articles/sap-integration/tutorial.md b/articles/sap-integration/tutorial.md index 28f95101b..9fd3c01ed 100644 --- a/articles/sap-integration/tutorial.md +++ b/articles/sap-integration/tutorial.md @@ -1,5 +1,5 @@ --- -title: "Tutorial: Integrate SAP with Power Platform using a sample solution" +title: "Tutorial: Integrate SAP with Power Platform using a sample solution (preview" description: Learn about how to integrate SAP with Power Platform using a sample solution that contains Power Apps and Power Automate components services: '' suite: flow @@ -22,8 +22,14 @@ search.audienceType: - enduser --- -# Tutorial: Integrate SAP with Power Platform using a sample solution +# Tutorial: Integrate SAP with Power Platform using a sample solution (preview) + +[This article is pre-release documentation and is subject to change.] Step-by-step with screenshots for sample solution -Updates during discussions \ No newline at end of file +> [!IMPORTANT] +> - This is a preview feature. +> - [!INCLUDE[cc_preview_features_definition](../includes/cc-preview-features-definition.md)] + +Content to follow \ No newline at end of file