Skip to content

Commit

Permalink
update merge
Browse files Browse the repository at this point in the history
  • Loading branch information
@EllenWehrle
EllenWehrle committed Sep 26, 2022
1 parent e2892e3 commit 6e0cbf5
Showing 1 changed file with 46 additions and 45 deletions.
91 changes: 46 additions & 45 deletions articles/sap-integration/env-variables-connection-refs.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,9 @@ description: Create an environment variable in Power Apps that contains all of y
author: EllenWehrle
ms.subservice: cloud-flow
ms.topic: article
ms.date: 09/19/2022
ms.tgt_pltfrm: na
ms.workload: na
ms.date: 09/23/2022
ms.author: ellenwehrle
ms.reviewer: ellenwehrle
search.app:
Expand All @@ -20,54 +22,53 @@ search.audienceType:

[This article is pre-release 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. You can create an environment variable in Power Apps that contains all of the SAP system information. Once the 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 again.

1. Sign in to [Power Apps](https://make.powerapps.com)
## Define the environment variable

1. [Create an environment variable in a solution](/power-apps/maker/data-platform/environmentvariables#create-an-environment-variable-in-a-solution).
:::image type="content" source="media/env-refs/env-var-panel.png" alt-text="The environment panel in Power Apps.":::

## Review connection references in flows

After you've imported the SAP integration solution into Power Apps and created environment variables with SAP connection parameters, you'll need to sign in to Power Automate to review your connectors in the cloud flows.

When you see the warning symbol in a connector, it means the environment variables didn't map to the connection. You'll need to add user and system connection references manually.

The following steps will walk you through this process:

1. Sign in to [Power Automate](https://make.powerautomate.com).

1. In the left navigation pane, select **Solutions**.

:::image type="content" source="media/env-refs/pauto-solutions.png" alt-text="Power Automate navigation panel with 'Solutions' selected." :::

1. Select the **SAP Integration** solution in the list. You will now go to a page that displays all of the solution's components.

1. In the left navigation pane, select **Cloud flows**.
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 name for the environment variable.
- **Name**. This is automatically generated, but you can change it.
- **Data Type**. Select **Text** (_do not_ select JSON).
- Enter a JSON blob with a combination of 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/solution-obj.png" alt-text="SAP Integration solution objects displayed. User selects, 'Cloud flows' to view the list of flows in the solution.":::

1. Select a flow from the list.

:::image type="content" source="media/env-refs/cloud-flow-select.png" alt-text="Image shows selecting a cloud flow from the list of solution flows.":::

1. Go to the command bar and select **Edit**. You'll be able to see the flow.

:::image type="content" source="media/env-refs/edit-flow.png" alt-text="Click the edit button to see the whole flow.":::

1. Select the connectors in the flow with the warning sign to add your user- and system-level connection references.

:::image type="content" source="media/env-refs/flow-connect-warning.png" alt-text="Flow with connection warning.":::

### Enter system information

You'll be asked to enter user and system information.

- Requested user-level connection reference data
:::image type="content" source="media/env-refs/user-auth.png" alt-text="Call SAP function box for user authentication.":::
:::image type="content" source="media/env-refs/env-var-panel.png" alt-text="The environment panel in Power Apps.":::

- Requested system-level connection reference data
:::image type="content" source="media/env-refs/system-auth.png" alt-text="Call SAP function box for system authentication.":::
### SAP Property Guidance

| Property | Description |
|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| AppServerHost | The hostname of the SAP Application Server. |
| AppServerService | The service name or port number of the specific SAP Application Server to connect to (Optional for connection type (Logon) A - Application Server). |
| Client | The SAP client ID to connect to the SAP system. The SAP backends' client (or 'Mandant') into which to log in. It is a number ranging from 000 to 999. |
| LogonGroup | The Logon Group for the SAP System, from which the Message Server shall select an Application Server (Only available if connection type (Logon) is B - Message Server (Group)). |
| LogonType | The type of logon to the SAP System, either Application Server Logon (Type A) or Group Logon (Type B aka Message Server). Allowed values: ApplicationServer, Group |
| MessageServerHost | The hostname of the SAP System's Message Server (central instance) aka R3 System Name (Mandatory if connection type (Logon) is B - Message Server (Group)). |
| MessageServerService | The Service Name (as defined in etc/services) or the Port Number under which the Message Server is listening for load-balancing requests (Mandatory if connection type (Logon) is B - Message Server (Group) and System ID is not present). |
| SncCertificate | X.509 certificate in Base64 encoded form, without the begin or end certificate tags. |
| SncMyName | The installed SNC solution usually knows its own SNC name. Only for solutions supporting 'multiple identities', you may need to specify the identity to be used for this destination/server (optional). |
| SncLibraryPath | Name or path of the SNC library to be used. With the OnPremises Data Gateway, the path can be an absolute or relative to the NCo library. |
| SncPartnerName | The backends' SNC name (Required when Logon Type is Application Server). |
| SncQop | Quality of Service to be used for SNC communication of this destination/server. Allowed values: Authentication, Integrity, Privacy, Default, Maximum |
| SncSso | The SNC SSO specifies whether to use SNC identity or credentials provided on RFC level. |
| SystemId | The SAP system's three-letter system ID (Mandatory if connection type (Logon) is B - Message Server (Group) and Message Server Service is not present). |
| SystemNumber | The SAP System's System Number. It is a number ranging from 00 to 99 (Mandatory if connection type (Logon) is A - Application Server). |
| UseSnc |
||

## Use the environment variable in a flow

Environment variables can be used in solution cloud flows since they are available in the dynamic content selector.

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

### Known issue

If an environment variable is updated after it has been used in a flow, the updated values will not be used the next time the flow runs. The _flow must be edited or re-saved_ for the updated values in the environment variable to take effect.

### See also

Expand Down

0 comments on commit 6e0cbf5

Please sign in to comment.