Skip to content

Commit

Permalink
Live publish
Browse files Browse the repository at this point in the history
  • Loading branch information
buck1ey authored Nov 21, 2022
2 parents a754f61 + 12e93e1 commit c1eefe8
Show file tree
Hide file tree
Showing 4 changed files with 91 additions and 71 deletions.
26 changes: 16 additions & 10 deletions articles/sap-integration/env-variables-connection-refs.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Create an environment variable with SAP connection parameters (preview)
description: Define an environment variable in Power Apps that contains all of your SAP system information then reuse it in your SAP flow actions.
description: Define an environment variable in Power Apps that contains all of your SAP system information, then reuse it in your SAP flow actions.
author: EllenWehrle
ms.subservice: cloud-flow
ms.topic: article
Expand All @@ -20,24 +20,30 @@ search.audienceType:
---
# Create an environment variable with SAP connection parameters (preview)

[This article is pre-release documentation and is subject to change.]
[This article is prerelease documentation and is subject to change.]

SAP has multiple connection parameters, and manually entering the parameters into each Power Automate cloud flow action can be time consuming. The preview SAP Integration solution available for [download](https://github.com/jongilman88/PowerPlatformSAPIntegration) includes an environment variable JSON string template for entering all of your SAP system information. Once your environment variable is defined, you can reuse it in your SAP actions without having to reenter it again.
SAP has multiple connection parameters, and manually entering the parameters into each Power Automate cloud flow action can be time-consuming. The preview SAP Integration solution available for [download](https://github.com/jongilman88/PowerPlatformSAPIntegration) includes an environment variable JSON string template for entering all of your SAP system information. Once your environment variable is defined, you can reuse it in your SAP actions without having to reenter it.

## Define the environment variable

1. Sign in to [Power Apps](https://make.powerapps.com) to [create an environment variable in a solution](/power-apps/maker/data-platform/environmentvariables#create-an-environment-variable-in-a-solution).

1. Select **Solutions** in the left navigation panel.

1. Open the **SAP Integration** solution.

1. On the command bar, select **New** > **More** > **Environment variable**.

1. Complete the fields in the Environment variable panel.
- **Display name**. Enter a display name for the environment variable.
- **Name**. This name is automatically generated as you enter the display name, but you can change it.
- **Data Type**. Select **Text** (_don't_ select JSON). Once selected, the value fields will appear.
- **Default Value**. Offers an environment variable template.
- **Current Value**. Update the JSON blob with SAP system's SAP properties. Not all properties are necessary—your SAP environment will determine which ones are applicable. Refer to the SAP property guidance.

:::image type="content" source="media/env-refs/env-var-panel.png" alt-text="The environment panel in Power Apps.":::
- **Display name**: Enter a display name for the environment variable.
- **Name**: This name is automatically generated as you enter the display name, but you can change it.
- **Data Type**: Select **Text** (_don't_ select JSON). Once selected, the value fields will appear.

- **Default Value**: Offers an environment variable template.
- **Current Value**: Update the JSON blob with the SAP system's SAP properties. Not all properties are necessary—your SAP environment will determine which ones are applicable. Refer to the SAP property guidance.

:::image type="content" source="media/env-refs/env-var-panel.png" alt-text="The environment panel in Power Apps.":::

### SAP property guidance

Expand Down Expand Up @@ -71,7 +77,7 @@ Environment variables are available in a flow's dynamic content selector. Go int

:::image type="content" source="media/env-refs/header-dynamic-content.png" alt-text="The header's dynamic content selector list in a solution-aware cloud flow.":::

Learn more at: [Use environment variables in Power Automate solution cloud flows](/power-apps/maker/data-platform/environmentvariables#use-environment-variables-in-power-automate-solution-cloud-flows)
Learn more: [Use environment variables in Power Automate solution cloud flows](/power-apps/maker/data-platform/environmentvariables#use-environment-variables-in-power-automate-solution-cloud-flows)

> [!IMPORTANT]
>
Expand Down
42 changes: 23 additions & 19 deletions articles/sap-integration/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,16 +21,16 @@ search.audienceType:

# Overview of SAP integration with Power Platform (preview)

[This article is pre-release documentation and is subject to change.]
[This article is prerelease documentation and is subject to change.]

SAP ERP is a centralized system of record that facilitates the management of data and business processes between many departments within an organization. SAP ERP, developed by SAP SE, serves as the primary enterprise resource planning application for many businesses worldwide.

The preview version of SAP integration with Microsoft Power Platform is built on a broad set of new functionality designed to make it easier for organizations that rely on SAP to digitally transform and automate their business processes. The enhancements include:

- Prebuilt SAP Integration solution
- Advanced SAP system connection support
- Updated On-premises data gateway
- New Logic Apps Functions
- Updated on-premises data gateway
- New Azure Logic Apps functions
- Updated SAP ERP connector

> [!IMPORTANT]
Expand Down Expand Up @@ -58,49 +58,53 @@ The Power Automate flows automate the business rules behind the scenes while the
> [!IMPORTANT]
> In preview, the focus is on testing the Order to Cash and Procure to Pay business processes.
## Advanced SAP system connections support
## Advanced SAP system connection support

Many enterprise organizations need to utilize advanced connection parameters to govern user sessions. SAP integration with Power Platform now supports:
Many enterprise organizations need to use advanced connection parameters to govern user sessions. SAP integration with Power Platform now supports:

- message servers that support load balancing between multiple SAP systems
- advanced SSO configurations
- Message servers that support load balancing between multiple SAP systems.
- Advanced SSO configurations.

Your SAP system's connection parameters are set up by following the established guidance:

- The JSON string template inside the solution's environment variable value field
- The SAP property guidance table
- The JSON string template inside the solution's environment variable value field.
- The SAP property guidance table.

Learn more at [Create an environment variable with SAP connection parameters](env-variables-connection-refs.md)
Learn more at [Create an environment variable with SAP connection parameters](env-variables-connection-refs.md).

## Updated on-premises data gateway

The on-premises data gateway acts as a bridge that provides secure data transfer between your on-premises SAP data and Microsoft's cloud services that include the Power Platform and Azure Logic Apps.

The most recent version of the on premises data gateway handles two SAP integration requirements:
The most recent version of the on-premises data gateway handles two SAP integration requirements:

- Backwards compatibility - customers utilizing the prior version of the SAP connector can still run their flows
- Enhanced SSO - Kerberos delegation now ensures that SSO is a seamless experience between Power Apps, Power Automate, and SAP.
- Backward compatibility: Customers using the prior version of the SAP connector can still run their flows.
- Enhanced SSO: Kerberos delegation now ensures that SSO is a seamless experience between Power Apps, Power Automate, and SAP.

Learn more at [On-premises data gateway documentation](/data-integration/gateway/)
Learn more at [On-premises data gateway documentation](/data-integration/gateway/).

## New Logic Apps functions

Power Automate's expression language is based on Logic Apps functions. New functions have been added to enable more efficient processing of SAP data.


<!-- In the isFloat description, is this correct? "... so that math can do math." -->


| Logic Apps function | Description |
|-|-|
| [isInt](/azure/logic-apps/workflow-definition-language-functions-reference#isint) | Returns true if a data attribute in an integer. This allows flow makers to determine if leading zeroes should be added to SAP data before sending to SAP APIs, or to remove from SAP data after retrieving records from SAP. |
| [chunk](/azure/logic-apps/workflow-definition-language-functions-reference#chunk) | Splits text areas, long string, or file contents into an array of fixed length strings for SAP's APIs. |
| [sort](/azure/logic-apps/workflow-definition-language-functions-reference#reverse) | Sorts an array of objects by a key found in each object. |
| [reverse](/azure/logic-apps/workflow-definition-language-functions-reference#reverse) | Reverse sorts an array of objects by a key found in each object. |
| [sort](/azure/logic-apps/workflow-definition-language-functions-reference#sort) | Sorts an array of objects by a key found in each object. |
| [reverse](/azure/logic-apps/workflow-definition-language-functions-reference#reverse) | Reverse-sorts an array of objects by a key found in each object. |
| [dateDifference](/azure/logic-apps/workflow-definition-language-functions-reference#datedifference) | Determines the difference between two dates and returns in the time unit specified in the function. This is especially useful for customers who use time-based billing. |
| [isFloat](/azure/logic-apps/workflow-definition-language-functions-reference#isfloat) | There's a unique edge case where some SAP APIs return currency strings in a user's localized format, which causes problems for mathematical operations. This function combined with float() removes the formatting so that math can do math. |
| [parseDateTime](/azure/logic-apps/workflow-definition-language-functions-reference#parsedatetime) | Converts the string representation of a timestamp to a standard ISO 8601 format. The output of this function can be used reliably to do additional operations on the timestamp like the functions defined in date and time functions. |
| [formatDateTime](/azure/logic-apps/workflow-definition-language-functions-reference#formatdatetime) | A new optional parameter locale has been added to the existing **formatDateTime**. If not specified, the default locale is used. |
| [nthIndexOf](/azure/logic-apps/workflow-definition-language-functions-reference#nthindexof) | Allows finding the **nth** occurrence of a substring. |
| [slice](/azure/logic-apps/workflow-definition-language-functions-reference#slice) | Provides a new way to extract a substring. The existing function substring already allows such capability by providing start index and length. |

Learn more at [Azure Logic Apps documentation](/azure/logic-apps/)
Learn more at [Azure Logic Apps documentation](/azure/logic-apps/).

## Updated SAP ERP connector

Expand Down Expand Up @@ -129,11 +133,11 @@ SAP integration with Power Platform will help your organization:

1. Assemble a team of IT administrators to [set up the SAP ERP integration with Power Platform](set-up-prepare.md).

1. Review and establish the necessary prerequisites before setting up SAP integration with the Power Platform.
1. Review and establish the necessary prerequisites before setting up SAP integration with Power Platform.

## Next steps

[Set up SAP integration with Power Platform (preview)](set-up-prepare.md)
[Set up SAP integration with Power Platform (preview).](set-up-prepare.md)

### See also

Expand Down
Loading

0 comments on commit c1eefe8

Please sign in to comment.