Verbinding maken naar SAP van werkstromen in Azure Logic Apps

  • Artikel

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Deze handleiding voor meerdere onderdelen laat zien hoe u toegang krijgt tot uw SAP-server vanuit een werkstroom in Azure Logic Apps met behulp van de SAP-connector. U kunt de bewerkingen van de SAP-connector gebruiken om geautomatiseerde werkstromen te maken die worden uitgevoerd wanneer ze worden geactiveerd door gebeurtenissen in uw SAP-server of in andere systemen en acties uitvoeren om resources op uw SAP-server te beheren.

Zowel de werkstromen voor de logische app Standard als het verbruik bieden de door SAP beheerde connector die wordt gehost en uitgevoerd in multitenant Azure. Standaardwerkstromen bieden ook de ingebouwde SAP-connector die wordt gehost en uitgevoerd in Azure Logic Apps met één tenant. Als u een werkstroom Verbruik maakt en host in een ISE (Integration Service Environment), kunt u ook de ISE-systeemeigen versie van de SAP-connector gebruiken. Zie Verbinding maken of technische naslaginformatie voor meer informatie.

SAP-compatibiliteit

De SAP-connector is compatibel met de volgende typen SAP-systemen:

  • On-premises en cloudgebaseerde SAP-systemen op basis van HANA, zoals S/4 HANA.

  • Klassieke on-premises SAP-systemen, zoals R/3 en ECC.

SAP moet de SAP-systeemversie ondersteunen die u wilt verbinden. Anders kunnen eventuele problemen die u ondervindt, mogelijk niet worden opgelost. Raadpleeg de SAP Product Availability Matrix (PAM) voor meer informatie over SAP-systeemversies en onderhoudsinformatie.

De SAP-connector ondersteunt de volgende typen bericht- en gegevensintegratie van sap NetWeaver-systemen:

  • Tussenliggend document (IDoc)

  • BAPI (Business Application Programming Interface)

  • Remote Function Call (RFC) en transactionele RFC (tRFC)

De SAP-connector maakt gebruik van de BIBLIOTHEEK SAP .NET Verbinding maken or (NCo).

Als u de bewerkingen van de SAP-connector wilt gebruiken, moet u eerst uw verbinding verifiëren en de volgende opties hebben:

U kunt SNC voor SAP NetWeaver-eenmalige aanmelding (SSO) of voor beveiligingsmogelijkheden van externe producten gebruiken. Als u ervoor kiest om SNC te gebruiken, controleert u de SNC-vereisten en de SNC-vereisten voor de ISE-connector.

Verbinding maken of technische naslaginformatie

De SAP-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.

Logische apps Omgeving Verbinding maken orversie
Verbruik Multitenant Azure Logic Apps Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Enterprise . Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde SAP-connectors
- Beheerde connectors in Azure Logic Apps
Verbruik Integratieserviceomgeving (ISE) Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Enterprise en de systeemeigen ISE-versie, die wordt weergegeven in de ontwerpfunctie met het ISE-label en andere berichtlimieten heeft dan de beheerde connector.

Opmerking: zorg ervoor dat u de systeemeigen ISE-versie gebruikt, niet de beheerde versie.

Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde SAP-connectors
- ISE-berichtlimieten
- Beheerde connectors in Azure Logic Apps
Standaard Azure Logic Apps en App Service Environment v3 met één tenant (alleen Windows-abonnementen) Beheerde connector, die wordt weergegeven in de connectorgalerie onder Runtime>Shared en de ingebouwde connector, die wordt weergegeven in de connectorgalerie onder Runtime>In-App en is gebaseerd op serviceproviders. De ingebouwde connector heeft rechtstreeks toegang tot virtuele Azure-netwerken met een verbindingsreeks zonder een on-premises gegevensgateway. Raadpleeg de volgende documentatie voor meer informatie:

- Naslaginformatie over beheerde SAP-connectors
- Naslaginformatie over de ingebouwde SAP-connector

- Beheerde connectors in Azure Logic Apps
- Ingebouwde connectors in Azure Logic Apps

Verbinding maken or verschillen

De ingebouwde SAP-connector verschilt aanzienlijk van de door SAP beheerde connector en sap ise-connector op de volgende manieren:

  • Voor on-premises verbindingen is geen on-premises gegevensgateway vereist.

    In plaats daarvan communiceert de ingebouwde SAP-connector rechtstreeks met uw SAP-server in het geïntegreerde virtuele netwerk, waardoor hops, latentie en storingspunten voor een netwerkgateway worden vermeden. Zorg ervoor dat u de niet-herdistribueerbare SAP-clientbibliotheken uploadt of implementeert met uw werkstroomtoepassing voor logische apps. Zie de vereisten in deze handleiding voor meer informatie.

  • Nettoladinggrootten tot 100 MB worden ondersteund, dus u hoeft geen blob-URI te gebruiken voor grote aanvragen.

  • Er zijn specifieke acties beschikbaar voor Call BAPI, Call RFC en Send IDoc. Deze speciale acties bieden een betere ervaring voor stateful BAPIs, RFC-transacties en IDoc-ontdubbeling en gebruiken niet het oudere WCF-berichtenmodel (SOAP Windows Communication Foundation).

    De actie BAPI aanroepen bevat maximaal twee antwoorden met de geretourneerde JSON, het XML-antwoord van de aangeroepen BAPI en het BAPI-doorvoer- of BAPI-terugdraaiantwoord en als u automatisch doorvoeren gebruikt. Met deze mogelijkheid wordt het probleem opgelost met de door SAP beheerde connector, waarbij het resultaat van de automatische doorvoer stil is en alleen kan worden waargenomen via logboeken.

  • Langere time-out op 5 minuten in vergelijking met beheerde connector en ISE-versie van connector.

    De ingebouwde SAP-connector maakt geen gebruik van de infrastructuur van de gedeelde of globale connector, wat betekent dat time-outs langer zijn dan 5 minuten in vergelijking met de door SAP beheerde connector (twee minuten) en de SAP ISE-connector (vier minuten). Langlopende aanvragen werken zonder dat u het langlopende op webhook gebaseerde aanvraagactiepatroon hoeft te implementeren.

  • Standaard zijn de ingebouwde SAP-connectorbewerkingen staatloos. U kunt echter stateful modus (affiniteit) inschakelen voor deze bewerkingen.

    In de stateful modus ondersteunt de ingebouwde SAP-connector hoge beschikbaarheid en horizontale uitschaalconfiguraties. Ter vergelijking: de beheerde SAP-connector heeft beperkingen met betrekking tot de on-premises gegevensgateway die is beperkt tot één exemplaar voor triggers en clusters alleen in de failovermodus voor acties. Zie voor meer informatie de beheerde SAP-connector: bekende problemen en beperkingen.

  • Standaardwerkstromen voor logische apps vereisen en gebruiken de SAP NCo 3.1-clientbibliotheek, niet de SAP NCo 3.0-versie. Zie Vereisten voor meer informatie.

  • Standaardwerkstromen voor logische apps bieden toepassingsinstellingen waar u een PERSONAL Security Environment (PSE) en PSE-wachtwoord kunt opgeven.

    Deze wijziging voorkomt dat u meerdere PSE-bestanden uploadt, wat niet wordt ondersteund en resulteert in SAP-verbindingsfouten. In werkstromen van logische apps voor verbruik kunt u deze waarden opgeven via verbindingsparameters, waardoor u meerdere PSE-bestanden kunt uploaden en niet wordt ondersteund, waardoor SAP-verbindingsfouten optreden.

  • Schemaactie genereren

    • U kunt kiezen uit meerdere bewerkingstypen, zoals BAPI, IDoc, RFC en tRFC, versus dezelfde actie in de door SAP beheerde connector, die gebruikmaakt van de parameter SapActionUris en een bestandssysteemkiezerervaring.

    • U kunt rechtstreeks een parameternaam opgeven als een aangepaste waarde. U kunt bijvoorbeeld de parameter RFC-naam opgeven uit de actie RFC aanroepen. Ter vergelijking moest u in de door SAP beheerde connector een complexe parameternaam voor de actie-URI opgeven.

    • Deze actie biedt standaard geen ondersteuning voor het genereren van meerdere schema's voor RFC's, BAP's of IDocs in uitvoering met één actie, die door de SAP beheerde connector wordt ondersteund. Deze mogelijkheidswijziging voorkomt nu dat pogingen om grote hoeveelheden inhoud in één aanroep te verzenden.

Parameters voor connector

Samen met eenvoudige tekenreeks- en nummerinvoer accepteert de SAP-connector de volgende tabelparameters (Type=ITAB invoer):

  • Parameters voor tabelrichting, zowel invoer als uitvoer, voor oudere SAP-releases.
  • Parameterwijzigingen, die de tabelrichtingparameters voor nieuwere SAP-releases vervangen.
  • Hiërarchische tabelparameters.

Bekende problemen en beperkingen

Door SAP beheerde connector

  • De SAP-connector biedt momenteel geen ondersteuning voor SAP-routerreeksen. De on-premises gegevensgateway moet bestaan in een virtueel netwerk waar de gateway rechtstreeks het SAP-systeem kan bereiken dat u wilt verbinden.

  • Over het algemeen biedt de SAP-trigger geen ondersteuning voor gegevensgatewayclusters. In sommige gevallen kan het gegevensgatewayknooppunt dat communiceert met het SAP-systeem afwijken van het actieve knooppunt, wat resulteert in onverwacht gedrag.

    • Voor scenario's voor het verzenden van berichten worden gegevensgatewayclusters in de failovermodus ondersteund.

    • Stateful SAP-acties bieden geen ondersteuning voor gegevensgatewayclusters in de taakverdelingsmodus. Stateful communicatie moet zich op hetzelfde clusterknooppunt van de gegevensgateway bevinden. Gebruik de gegevensgateway in de modus niet-cluster of in een cluster dat alleen is ingesteld voor failover. Deze acties omvatten bijvoorbeeld het volgende:

      • Alle acties die een waarde voor een sessie-id opgeven
      • [BAPI] Transactie doorvoeren
      • [BAPI] Terugdraaitransactie
      • [BAPI - RFC] Stateful sessie sluiten
      • [BAPI - RFC] Stateful sessie maken

  • In de actie [ BAPI] Call method in SAP, zal de functie voor automatisch doorvoeren de BAPI-wijzigingen niet doorvoeren als er ten minste één waarschuwing bestaat in het CallBapiResponse-object dat door de actie wordt geretourneerd. Als u BAPI-wijzigingen wilt doorvoeren ondanks eventuele waarschuwingen, voert u de volgende stappen uit:

    1. Maak een sessie expliciet met behulp van de actie [BAPI - RFC] Een stateful sessie maken.
    2. Schakel in de actie [ BAPI] Call method in SAP de functie voor automatisch doorvoeren uit.
    3. Roep in plaats daarvan de actie [BAPI] Doorvoertransactie aan.

IP-verbindingen met SAP Message Server (configuratie met gelijke taakverdeling)

Als u een IP-adres opgeeft om verbinding te maken met een SAP-berichtserver, bijvoorbeeld een load balancer, mislukt de verbinding mogelijk nog steeds met een foutbericht dat lijkt op 'hostnaam SAPDBSERVER01.example.com onbekend'. De berichtserver geeft de SAP-connector opdracht om een hostnaam te gebruiken voor de verbinding met de back-end SAP-toepassingsserver of de server achter de load balancer. Als DNS de hostnaam niet kan oplossen, mislukt de verbinding.

Voor dit probleem bestaan de volgende tijdelijke oplossingen of oplossingen:

  • Zorg ervoor dat de client die de verbinding maakt, zoals de computer met de on-premises gegevensgateway voor de SAP-connector of de ISE-connectorhost voor de OP ISE gebaseerde SAP-connector, de hostnamen kan oplossen die door de berichtserver worden geretourneerd.

  • Wijzig of voeg in de transactie met de naam RZ11 de SAP-instelling ms/lg_with_hostname=0 toe.

Probleemcontext of achtergrond

SAP heeft hun .NET-connector (NCo) bijgewerkt naar versie 3.1, waardoor de manier is gewijzigd waarop de connector verbindingen aanvraagt naar back-endservers van berichtservers. De connector maakt nu gebruik van een nieuwe API voor toepassingsserveromzetting door de berichtserver, tenzij u de connector dwingt om de vorige API te gebruiken via de instelling ms/lg_with_hostname=0'. Zie SAP KB Article 3305039 - SMLG IP Address setting not considered during loginn Group.

Vereisten

  • Een Azure-account en -abonnement. Als u nog geen Azure-abonnement hebt, meldt u zich aan voor een gratis Azure-account.

  • De SAP-toepassingsserver of SAP-berichtserver waartoe u toegang wilt krijgen vanuit Azure Logic Apps.

  • De werkstroom van de logische app van waaruit u toegang wilt krijgen tot uw SAP-server.

  • Standaard zijn de ingebouwde SAP-connectorbewerkingen staatloos. Zie Stateful modus inschakelen voor stateless ingebouwde connectors om deze bewerkingen uit te voeren in de stateful modus.

  • Als u de door SAP beheerde of ingebouwde connectortrigger wilt gebruiken met de naam Wanneer een bericht wordt ontvangen, voert u de volgende taken uit:

    • Stel uw SAP Gateway-beveiligingsmachtigingen of toegangsbeheerlijst (ACL) in. Open in het dialoogvenster Gateway Monitor (T-Code SMGW) waarin de secinfo - en reginfo-bestanden worden weergegeven, het menu Goto en selecteer Expert Functions>External Security>Maintenance of ACL Files.

      De volgende machtigingsinstelling is vereist:

      P TP=LOGICAPP HOST=<on-premises-gateway-server-IP-address> ACCESS=*

      Deze regel heeft de volgende indeling:

      P TP=<trading-partner-identifier-(program-name)-or-*-for-all-partners> HOST=<comma-separated-list-with-external-host-IP-or-network-names-that-can-register-the-program> ACCESS=<*-for-all-permissions-or-a-comma-separated-list-of-permissions>

      Als u de beveiligingsmachtigingen voor de SAP-gateway niet configureert, wordt mogelijk de volgende fout weergegeven:

      Registratie van tp Microsoft.PowerBI.EnterpriseGateway van hosthostnaam <> is niet toegestaan

      Raadpleeg SAP Note 1850230 - GW: 'Registratie van tp-programma-id is niet toegestaan' voor meer informatie.<>

    • Stel uw SAP Gateway-beveiligingslogboek in om problemen met toegangsbeheerlijsten (ACL) te vinden. Raadpleeg het HELP-onderwerp van SAP voor het instellen van logboekregistratie van gateways voor meer informatie.

    • Maak in het dialoogvenster RFC-Verbinding maken ions (T-Code SM59) een RFC-verbinding met het TCP/IP-type. Zorg ervoor dat het activeringstype is ingesteld op Geregistreerd serverprogramma. Stel het communicatietype van de RFC-verbinding met de waarde van het doelsysteem in op Unicode.

    • Als u deze SAP-trigger gebruikt met de parameter IDOC-indeling die is ingesteld op FlatFile , samen met de actie Flat File Decode, moet u de early_terminate_optional_fields eigenschap in het platte-bestandsschema gebruiken door de waarde truein te stellen op .

      Deze vereiste is nodig omdat de IDoc-gegevensrecord van het platte bestand dat door SAP wordt verzonden op de tRFC-aanroep IDOC_INBOUND_ASYNCHRONOUS , niet is opgevuld met de volledige lengte van het SDATA-veld. Azure Logic Apps biedt de oorspronkelijke IDoc-gegevens van het platte bestand zonder opvulling zoals ontvangen van SAP. Wanneer u deze SAP-trigger combineert met de actie Plat bestand decoderen , moet het schema dat aan de actie is opgegeven, overeenkomen.

    Notitie

    In verbruiks- en standaardwerkstromen gebruikt de door SAP beheerde trigger wanneer een bericht wordt ontvangen dezelfde URI-locatie om zowel een webhookabonnement te verlengen als af te melden. De verlengingsbewerking maakt gebruik van de HTTP-methode PATCH , terwijl de afmeldingsbewerking gebruikmaakt van de HTTP-methode DELETE . Dit gedrag kan ertoe leiden dat een verlengingsbewerking wordt weergegeven als een afmeldingsbewerking in de geschiedenis van uw trigger, maar de bewerking is nog steeds een verlenging omdat de trigger wordt gebruikt PATCH als de HTTP-methode, niet DELETE.

    In standaardwerkstromen gebruikt de ingebouwde SAP-trigger wanneer een bericht wordt ontvangen in plaats daarvan de Azure Functions-trigger en worden alleen de werkelijke callbacks van SAP weergegeven.

    • WEBSITE_PRIVATE_IP: Stel deze omgevingsvariabelewaarde in op 127.0.0.1 als het localhost-adres.
    • WEBSITE_PRIVATE_PORTS: Stel deze omgevingsvariabele in op twee vrije en bruikbare poorten op uw lokale computer, waarbij de waarden worden gescheiden door een komma (,), bijvoorbeeld 8080.8088.

  • De berichtinhoud die naar uw SAP-server moet worden verzonden, zoals een voorbeeld-IDoc-bestand. Deze inhoud moet de XML-indeling hebben en de naamruimte bevatten van de SAP-actie die u wilt gebruiken. U kunt IDocs verzenden met een plat bestandsschema door ze in een XML-envelop te verpakken.

Vereisten voor netwerkconnectiviteit

Voor het SAP-systeem is netwerkverbinding vereist van de host van de NCo-bibliotheek (SAP .NET Verbinding maken or):

  • Voor werkstromen van logische apps voor verbruik in multitenant Azure Logic Apps host de on-premises gegevensgateway de BIBLIOTHEEK SAP .NET Verbinding maken or (NCo). Als u een on-premises gegevensgatewaycluster gebruikt, hebben alle knooppunten van het cluster netwerkverbinding met het SAP-systeem nodig.

  • Voor standaardwerkstromen voor logische apps in Azure Logic Apps met één tenant host de resource van de logische app de BIBLIOTHEEK SAP .NET Verbinding maken or (NCo). De resource van de logische app zelf moet dus integratie van virtuele netwerken inschakelen en dat virtuele netwerk moet netwerkconnectiviteit hebben met het SAP-systeem.

  • Voor werkstromen van logische apps voor verbruik in een ISE fungeert het virtuele ISE-netwerk als host voor de BIBLIOTHEEK SAP .NET Verbinding maken or (NCo).

De voor het SAP-systeem vereiste netwerkconnectiviteit omvat de volgende servers en services:

  • SAP Application Server, Dispatcher-service (voor alle aanmeldingstypen)

    Uw SAP-systeem kan meerdere SAP-toepassingsservers bevatten. De host van de SAP .NET Verbinding maken or -bibliotheek (NCo) vereist toegang tot elke server en hun services.

  • SAP Message Server, Message-service (voor aanmeldingstypegroep)

    De Berichtenserver en -service worden omgeleid naar een of meer dispatcherservices van de toepassingsserver. De host van de SAP .NET Verbinding maken or -bibliotheek (NCo) vereist toegang tot elke server en hun services.

  • SAP Gateway Server, Gateway-service

  • SAP Gateway Server, beveiligde gatewayservice

    De voor het SAP-systeem vereiste netwerkconnectiviteit omvat ook deze server en service voor gebruik met SNC (Secure Network Communications).

Omleiding van aanvragen van Application Server, Dispatcher-service naar Gateway Server, gatewayservice vindt automatisch plaats in de SAP .NET-bibliotheek Verbinding maken or (NCo). Deze omleiding vindt plaats, zelfs als alleen de toepassingsserver, informatie over de dispatcher-service wordt opgegeven in de verbindingsparameters.

Als u een load balancer voor uw SAP-systeem gebruikt, moet u alle services omleiden naar hun respectieve servers. Raadpleeg de TCP/IP-poorten van alle SAP-producten voor meer informatie over SAP-services en -poorten.

Notitie

Zorg ervoor dat u netwerkconnectiviteit hebt ingeschakeld vanaf de host van de SAP .NET-bibliotheek Verbinding maken or (NCo) en dat de vereiste poorten zijn geopend op firewalls en netwerkbeveiligingsgroepen. Anders krijgt u fouten zoals partner die niet is bereikt vanuit het NI-onderdeel (netwerkinterface) en fouttekst zoals WSAECONNREFUSED: Verbinding maken ion geweigerd.

Vereisten voor SAP NCo-clientbibliotheek

Als u de SAP-connector wilt gebruiken, moet u de SAP Verbinding maken or NCo-clientbibliotheek voor Microsoft .NET 3.1 installeren. In de volgende lijst worden de vereisten voor de SAP NCo-clientbibliotheek beschreven, op basis van de werkstroom waarin u de SAP-connector gebruikt:

  • Versie:

  • Kopieer vanuit de standaardinstallatiemap van de clientbibliotheek de assemblybestanden (.dll) als volgt naar een andere locatie, op basis van uw scenario. Als u alleen de door SAP beheerde connector gebruikt, selecteert u global Assembly Cache-registratie wanneer u de SAP NCo-clientbibliotheek installeert. Het ISE zip-archief en de ingebouwde SAP-connector bieden momenteel geen ondersteuning voor GAC-registratie.

    • Voor een werkstroom Verbruik die wordt uitgevoerd in multitenant Azure Logic Apps en uw on-premises gegevensgateway gebruikt, kopieert u de volgende assemblybestanden (.dll) naar de installatiemap van de on-premises gegevensgateway, bijvoorbeeld C:\Program Files\On-Premises Data Gateway. De SAP NCo 3.0-clientbibliotheek bevat de volgende assembly's:

      • libicudecnumber.dll
      • rscp4n.dll
      • sapnco.dll
      • sapnco_utils.dll

      Zorg ervoor dat u de assemblybestanden naar de installatiemap van de gegevensgateway kopieert. Anders kan uw SAP-verbinding mislukken met het foutbericht. Controleer uw accountgegevens en/of machtigingen en probeer het opnieuw. U kunt verdere problemen oplossen met behulp van de logboekviewer voor .NET-assemblybindingen. Met dit hulpprogramma kunt u controleren of uw assemblybestanden zich op de juiste locatie bevinden.

    • Kopieer voor Standaardwerkstromen de volgende assemblybestanden (.dll) naar een locatie waar u ze kunt uploaden naar uw logische app-resource of project waar u uw werkstroom bouwt, respectievelijk in Azure Portal of lokaal in Visual Studio Code. De SAP NCo 3.1-clientbibliotheek bevat de volgende assembly's:

      • rscp4n.dll
      • sapnco.dll
      • sapnco_utils.dll

    • Voor een werkstroom Verbruik in een ISE volgt u in plaats daarvan de ISE-vereisten .

De volgende relaties bestaan tussen de SAP NCo-clientbibliotheek, .NET Framework, de .NET-runtime en de gegevensgateway:

  • De Microsoft SAP-adapter en de gatewayhostservice gebruiken beide .NET Framework 4.7.2.

  • De SAP NCo voor .NET Framework 4.0 werkt met processen die .NET Runtime 4.0 tot en met 4.8 gebruiken.

  • De SAP NCo voor .NET Framework 2.0 werkt met processen die gebruikmaken van .NET Runtime 2.0 tot 3.5, maar werkt niet meer met de nieuwste gateway.

Vereisten voor SNC

Voor verbruikswerkstromen in multitenant Azure Logic Apps die gebruikmaken van de on-premises gegevensgateway en eventueel SNC, moet u ook de volgende instellingen configureren.

  • Zorg ervoor dat de versie van uw SNC-bibliotheek en de bijbehorende afhankelijkheden compatibel zijn met uw SAP-omgeving. Als u compatibiliteitsproblemen met bibliotheken wilt oplossen, kunt u uw on-premises gegevensgateway- en gegevensgatewaylogboeken gebruiken.

  • Zorg ervoor dat u de volgende assemblybestanden (.dll) in de SAP NCo 3.0-clientbibliotheek hebt gekopieerd naar de installatiemap van de on-premises gegevensgateway, bijvoorbeeld C:\Program Files\On-Premises Data Gateway.

    • libicudecnumber.dll
    • rscp4n.dll
    • sapnco.dll
    • sapnco_utils.dll

  • Voor het SAPGENPSE-hulpprogramma moet u specifiek sapgenpse.exe gebruiken.

  • Als u een PERSONAL Security Environment (PSE) met uw verbinding opgeeft, hoeft u de PSE en SECUDIR niet te kopiëren en in te stellen voor uw on-premises gegevensgateway.

  • Als u SNC inschakelt via een extern beveiligingsproduct, zoals sapseculib, Kerberos of NTLM, controleert u of de SNC-bibliotheek op dezelfde computer bestaat als de installatie van uw gegevensgateway. Kopieer voor deze taak de binaire bestanden van de SNC-bibliotheek naar dezelfde map als de installatie van de gegevensgateway op uw lokale computer, bijvoorbeeld C:\Program Files\On-Premises Data Gateway.

    Notitie

    Stel op de computer met de installatie van de gegevensgateway en de SNC-bibliotheek de omgevingsvariabelen niet in voor SNC_LIB en SNC_LIB_64. Anders hebben deze variabelen voorrang op de SNC-bibliotheekwaarde die via de connector wordt doorgegeven.

  • Als u SNC wilt gebruiken met eenmalige aanmelding (SSO), moet u ervoor zorgen dat de data gateway-service wordt uitgevoerd als een gebruiker die is toegewezen aan een SAP-gebruiker. Als u het standaardaccount voor het gatewayserviceaccount wilt wijzigen, selecteert u Account wijzigen en voert u de gebruikersreferenties in.

    Schermopname van het installatieprogramma voor de on-premises gegevensgateway en de pagina Service Instellingen met de knop om het gatewayserviceaccount te wijzigen dat is geselecteerd.

Zie SNC (Secure Network Communications) inschakelen voor meer informatie over het inschakelen van SNC.

Vereisten voor de Azure Logic Apps-omgeving

Voor een werkstroom Verbruik in multitenant Azure Logic Apps kan de met SAP beheerde connector worden geïntegreerd met SAP-systemen via een on-premises gegevensgateway. In scenario's waarin uw werkstroom bijvoorbeeld een bericht naar het SAP-systeem verzendt, fungeert de gegevensgateway als een RFC-client en stuurt de aanvragen die van uw werkstroom zijn ontvangen door naar SAP. In scenario's waarin uw werkstroom een bericht van SAP ontvangt, fungeert de gegevensgateway ook als een RFC-server die aanvragen van SAP ontvangt en deze doorstuurt naar uw werkstroom.

  1. Op een hostcomputer of virtuele machine die zich in hetzelfde virtuele netwerk bevindt als het SAP-systeem waarmee u verbinding maakt, downloadt en installeert u de on-premises gegevensgateway.

    Met de gegevensgateway hebt u veilig toegang tot on-premises gegevens en resources. Zorg ervoor dat u een ondersteunde versie van de gateway gebruikt. Als u een probleem ondervindt met uw gateway, voert u een upgrade uit naar de nieuwste versie, waaronder mogelijk updates om uw probleem op te lossen.

  2. Maak in Azure Portal een Azure-gatewayresource voor de installatie van uw on-premises gegevensgateway.

  3. Download en installeer op dezelfde lokale computer als de installatie van uw on-premises gegevensgateway de nieuwste SAP NCo-clientbibliotheek.

  4. Configureer voor de hostcomputer met de installatie van uw on-premises gegevensgateway de netwerkhostnamen en servicenamenomzetting.

    • Als u de hostnamen of servicenamen voor verbindingen van Azure Logic Apps wilt gebruiken, moet u naamomzetting instellen voor elke SAP-toepassing, elk bericht en elke gatewayserver, samen met hun services:

      • Stel in het bestand %windir%\System32\drivers\etc\hosts of op de DNS-server die beschikbaar is voor de hostcomputer voor de installatie van uw on-premises gegevensgateway de naamomzetting van de netwerkhost in.

      • Stel in het bestand %windir%\System32\drivers\etc\services de naamomzetting van de service in.

    • Als u niet van plan bent netwerkhostnamen of servicenamen voor de verbinding te gebruiken, kunt u in plaats daarvan host-IP-adressen en servicepoortnummers gebruiken.

    • Als u geen DNS-vermelding voor uw SAP-systeem hebt, ziet u in het volgende voorbeeld een voorbeeldvermelding voor het hosts-bestand:

      10.0.1.9           sapserver                   # SAP single-instance system host IP by simple computer name
10.0.1.9           sapserver.contoso.com       # SAP single-instance system host IP by fully qualified DNS name

      In de volgende lijst ziet u een voorbeeldset vermeldingen voor de servicesbestanden:

      sapdp00            3200/tcp              # SAP system instance 00 dialog (application) service port
sapgw00            3300/tcp              # SAP system instance 00 gateway service port
sapmsDV6           3601/tcp              # SAP system ID DV6 message service port

Secure Network Communications (SNC) inschakelen

Voor een verbruikswerkstroom die wordt uitgevoerd in Multitenant Azure Logic Apps, kunt u SNC inschakelen voor verificatie, wat alleen van toepassing is wanneer u de gegevensgateway gebruikt. Voordat u begint, moet u ervoor zorgen dat u aan alle vereiste vereisten en SNC-vereisten voldoet.

  1. Open in Azure Portal uw logische app voor verbruik en werkstroom in de ontwerpfunctie.

  2. Een bewerking voor een door SAP beheerde connector toevoegen of bewerken.

  3. Geef in het vak SAP-verbindingsgegevens de volgende vereiste informatie op. Het verificatietype dat u selecteert, wijzigt de beschikbare opties.

    Schermopname van SAP-verbindingsinstellingen voor Verbruik.

    Notitie

    De velden SAP-gebruikersnaam en SAP-wachtwoord zijn optioneel. Als u geen gebruikersnaam en wachtwoord opgeeft, gebruikt de connector het clientcertificaat dat in een latere stap is opgegeven voor verificatie.

  4. Als u SNC wilt inschakelen, geeft u in het vak SAP-verbindingsgegevens de volgende vereiste informatie op:

    Schermopname van SAP-verbindingsinstellingen voor SNC ingeschakeld voor Verbruik.

    Parameter Description
    SNC gebruiken Schakel het selectievakje in.
    SNC-bibliotheek Voer een van de volgende waarden in:

    - De naam voor uw SNC-bibliotheek, bijvoorbeeld sapsnc.dll
    - Het relatieve pad naar de NCo-installatielocatie, bijvoorbeeld .\security\sapsnc.dll
    - Het absolute pad naar de NCo-installatielocatie, bijvoorbeeld c:\security\sapsnc.dll
    Eenmalige aanmelding voor SNC Selecteer Aanmelden met behulp van de SNC-identiteit of aanmelding met de gebruikersnaam/het wachtwoord die is opgegeven op RFC-niveau.

    Normaal gesproken wordt de SNC-identiteit gebruikt om de beller te verifiëren. U kunt er in plaats daarvan voor kiezen om te verifiëren met een gebruikersnaam en wachtwoord, maar deze parameterwaarde is nog steeds versleuteld.
    SNC Mijn naam In de meeste gevallen kunt u deze waarde weglaten. De geïnstalleerde SNC-oplossing kent meestal zijn eigen SNC-naam. In het geval dat uw oplossing meerdere identiteiten ondersteunt, moet u mogelijk de identiteit opgeven die moet worden gebruikt voor deze specifieke bestemming of server.
    Naam van SNC-partner Voer de naam in voor de back-end-SNC, bijvoorbeeld p:CN=DV3, OU=LA, O=MS, C=US.
    SNC Quality of Protection Selecteer de kwaliteit van de service die moet worden gebruikt voor SNC-communicatie met deze specifieke bestemming of server. De standaardwaarde wordt gedefinieerd door het back-endsysteem. De maximale waarde wordt bepaald door het beveiligingsproduct dat voor SNC wordt gebruikt.
    SNC-certificaat Voer de met base64 gecodeerde openbare sleutel in voor het certificaat dat moet worden gebruikt voor het identificeren van uw client voor SAP.

    Opmerking: - Neem de PEM-kop- of voettekst niet op.

    - Voer hier niet de persoonlijke sleutel voor het clientcertificaat in. Uw PERSONAL Security Environment (PSE) moet de overeenkomende persoonlijke sleutel voor dit certificaat bevatten en kan andere persoonlijke certificaten bevatten. Raadpleeg de volgende parameter voor meer informatie.
    PSE Voer uw SNC Personal Security Environment (PSE) in als een met base64 gecodeerd binair bestand.

    - Uw PSE moet de persoonlijke sleutel voor het clientcertificaat bevatten waarbij de vingerafdruk overeenkomt met de openbare sleutel voor het clientcertificaat in de parameter SNC-certificaat .

    - Hoewel uw PSE meerdere clientcertificaten kan bevatten, kunt u in plaats daarvan afzonderlijke werkstromen maken om verschillende clientcertificaten te gebruiken.

    - Als u meer dan één SNC-clientcertificaat gebruikt voor uw resource voor de logische standaard-app, moet u dezelfde PSE opgeven voor alle verbindingen. Uw PSE moet de overeenkomende persoonlijke sleutel voor het clientcertificaat voor elk en alle verbindingen bevatten. U moet de parameter SNC-certificaat zo instellen dat deze overeenkomt met het specifieke privécertificaat voor elke verbinding.

  5. Selecteer Maken om de verbinding te voltooien.

    Als de parameters juist zijn, wordt de verbinding gemaakt. Als er een probleem is met de parameters, wordt in het dialoogvenster voor het maken van de verbinding een foutbericht weergegeven. Als u verbindingsparameterproblemen wilt oplossen, kunt u de installatie van de on-premises gegevensgateway en de lokale logboeken van de gateway gebruiken.

Een binair PSE-bestand converteren naar een met base64 gecodeerde indeling

  1. Gebruik een PowerShell-script, bijvoorbeeld:

    Param ([Parameter(Mandatory=$true)][string]$psePath, [string]$base64OutputPath)
$base64String = [convert]::ToBase64String((Get-Content -path $psePath -Encoding byte))
if ($base64OutputPath -eq $null)
{
    Write-Output $base64String
}
else
{
    Set-Content -Path $base64OutputPath -Value $base64String
    Write-Output "Output written to $base64OutputPath"
}

  2. Sla het script op als een pseConvert.ps1-bestand en roep vervolgens het script aan, bijvoorbeeld:

    .\pseConvert.ps1 -psePath "C:\Temp\SECUDIR\request.pse" -base64OutputPath "connectionInput.txt"
Output written to connectionInput.txt

    Als u de parameter voor het uitvoerpad niet opgeeft, bevat de uitvoer van het script naar de console regeleinden. Verwijder de regeleinden in de met base 64 gecodeerde tekenreeks voor de verbindingsinvoerparameter.

IDocs vanuit SAP instellen en testen naar uw werkstroom

Volg deze stappen alleen voor het testen van uw SAP-configuratie met uw werkstroom voor logische apps. Voor productieomgevingen is extra configuratie vereist.

Als u IDocs van SAP naar uw werkstroom wilt verzenden, hebt u de volgende minimale configuratie nodig:

  1. Maak een RFC-doel.
  2. Maak een ABAP-verbinding.
  3. Maak een ontvangerpoort.
  4. Maak een afzenderpoort.
  5. Maak een logische systeempartner.
  6. Maak een partnerprofiel.
  7. Test het verzenden van berichten.

RFC-doel maken

Deze bestemming identificeert uw werkstroom voor logische apps als de ontvangerpoort.

  1. Open in SAP de instellingen voor RFC-Verbinding maken ions configureren. U kunt de sm59-transactiecode (T-Code) gebruiken met het voorvoegsel /n .

  2. Selecteer TCP/IP Verbinding maken ions>Maken.

  3. Maak een nieuwe RFC-bestemming met de volgende instellingen:

    1. Voer een naam in voor RFC-bestemming.

    2. Selecteer op het tabblad Technische Instellingen voor Activeringstype de optie Geregistreerd serverprogramma.

    3. Voer een waarde in voor programma-id. In uw SAP-server wordt de trigger van uw werkstroom geregistreerd met behulp van deze id.

      Belangrijk

      De SAP-programma-id is hoofdlettergevoelig. Zorg ervoor dat u consistent dezelfde case-indeling gebruikt voor uw programma-id wanneer u uw werkstroom en SAP-server configureert. Anders ontvangt u mogelijk de volgende fouten in de tRFC Monitor (T-Code SM58) wanneer u probeert een IDoc naar SAP te verzenden:

      • Functie IDOC_INBOUND_ASYNCHRONOUS niet gevonden
      • Niet-ABAP RFC-client (partnertype) wordt niet ondersteund

      Raadpleeg de volgende notities (aanmelding vereist) voor meer informatie van SAP:

    4. Selecteer Unicode op het tabblad Unicode voor communicatietype met doelsysteem.

      Notitie

      SAP .NET-clientbibliotheken ondersteunen alleen Unicode-tekencodering. Als de fout Non-ABAP RFC-client (partnertype) niet wordt ondersteund wanneer u een IDoc van SAP naar Azure Logic Apps verzendt, controleert u of het communicatietype met de doelsysteemwaarde is ingesteld op Unicode.

  4. Sla uw wijzigingen op.

  5. Registreer uw nieuwe programma-id bij Azure Logic Apps door een werkstroom voor logische apps te maken die begint met de door SAP beheerde trigger wanneer een bericht wordt ontvangen.

    Op die manier registreert Azure Logic Apps de programma-id op de SAP Gateway wanneer u uw werkstroom opslaat.

  6. Controleer in de triggergeschiedenis van uw werkstroom, indien van toepassing, de sap-adapterlogboeken van de on-premises gegevensgateway en de traceringslogboeken van de SAP Gateway de registratiestatus.

    In het SAP Gateway-monitorvak (T-Code SMGW), onder Aangemelde clients, wordt de nieuwe registratie weergegeven als Geregistreerde server.

  7. Als u de verbinding wilt testen, selecteert u onder uw nieuwe RFC-bestemming Verbinding maken ionTest.

ABAP-verbinding maken

Deze bestemming identificeert uw SAP-systeem als de afzenderpoort.

  1. Open in SAP de instellingen voor RFC-Verbinding maken ions configureren. U kunt de sm59-transactiecode (T-Code) gebruiken met het voorvoegsel /n .

  2. Selecteer ABAP Verbinding maken ions>Maken.

  3. Voer voor RFC-bestemming de id in voor uw test-SAP-systeem.

  4. Laat in Technical Instellingen de doelhost leeg om een lokale verbinding met het SAP-systeem te maken.

  5. Sla uw wijzigingen op.

  6. Selecteer Verbinding maken ion Test om de verbinding te testen.

Ontvangerpoort maken

  1. Open in SAP de poorten in IDOC-verwerkingsinstellingen . U kunt de we21-transactiecode (T-Code) gebruiken met het voorvoegsel /n .

  2. Selecteer Transactionele RFC-poorten>>maken.

  3. Selecteer een eigen poortnaam in het instellingenvak dat wordt geopend. Voer een naam in voor uw testpoort. Sla uw wijzigingen op.

  4. Voer in de instellingen voor de nieuwe ontvangerpoort, voor RFC-bestemming, de id in voor de RFC-testbestemming.

  5. Sla uw wijzigingen op.

Poort voor afzender maken

  1. Open in SAP de poorten in IDOC-verwerkingsinstellingen . U kunt de we21-transactiecode (T-Code) gebruiken met het voorvoegsel /n .

  2. Selecteer Transactionele RFC-poorten>>maken.

  3. Selecteer een eigen poortnaam in het instellingenvak dat wordt geopend.

  4. Voer voor uw testpoort een naam in die begint met SAP. Sla uw wijzigingen op.

    Alle poortnamen van de afzender moeten beginnen met de letters SAP, bijvoorbeeld SAPTEST.

  5. Voer in de instellingen voor uw nieuwe afzenderpoort voor RFC-bestemming de id in voor uw ABAP-verbinding.

  6. Sla uw wijzigingen op.

Logische systeempartner maken

  1. Open in SAP de wijzigingsweergave 'Logische systemen': Overzichtsinstellingen . U kunt de bd54-transactiecode (T-Code) gebruiken.

  2. Accepteer het volgende waarschuwingsbericht dat wordt weergegeven: Waarschuwing: de tabel is meerdere clients

  3. Selecteer nieuwe vermeldingen boven de lijst met bestaande logische systemen.

  4. Voer voor uw nieuwe logische systeem een Log.System-id en een korte beschrijving van de naam in. Sla uw wijzigingen op.

  5. Wanneer de prompt voor Workbench wordt weergegeven, maakt u een nieuwe aanvraag door een beschrijving op te geven of als u al een aanvraag hebt gemaakt, slaat u deze stap over.

  6. Nadat u de workbench-aanvraag hebt gemaakt, koppelt u die aanvraag aan de aanvraag voor het bijwerken van de tabel. Sla de wijzigingen op om te bevestigen dat de tabel is bijgewerkt.

Partnerprofielen maken

Voor productieomgevingen moet u twee partnerprofielen maken. Het eerste profiel is voor de afzender, namelijk uw organisatie en SAP-systeem. Het tweede profiel is voor de ontvanger. Dit is de resource en werkstroom van uw logische app.

  1. Open in SAP de instellingen voor partnerprofielen . U kunt de we20-transactiecode (T-Code) gebruiken met het voorvoegsel /n .

  2. Selecteer onder Partnerprofielen de optie Partnertype LS>Create.

  3. Maak een nieuw partnerprofiel met de volgende instellingen:

    Instelling Beschrijving
    Partner Nee. Voer de id van uw logische systeempartner in.
    Partn. Type Voer LS in.
    Agent Voer de id in voor het SAP-gebruikersaccount dat moet worden gebruikt wanneer u programma-id's registreert voor Azure Logic Apps of andere niet-SAP-systemen.

  4. Sla uw wijzigingen op.

    Als u de logische systeempartner nog niet hebt gemaakt, krijgt u de foutmelding: Voer een geldig partnernummer in.

  5. Selecteer in de instellingen van uw partnerprofiel onder Uitgaande parmtrs.de optie Uitgaande parameter maken.

  6. Maak een nieuwe uitgaande parameter met de volgende instellingen:

    • Voer uw berichttype in, bijvoorbeeld CREMAS.

    • Voer de id van de ontvangerpoort in.

    • Voer een IDoc-grootte in voor Pack. Grootte. Als u IDocs één voor één wilt verzenden vanuit SAP, selecteert u IDoc Onmiddellijk doorgeven.

  7. Sla uw wijzigingen op.

Verzenden van berichten testen

  1. Open in SAP de instellingen voor testhulpprogramma voor IDoc-verwerking . U kunt de we19-transactiecode (T-Code) gebruiken met het voorvoegsel /n .

  2. Selecteer onder Sjabloon voor test de optie Via berichttype. Voer uw berichttype in, bijvoorbeeld CREMAS. Selecteer Maken.

  3. Bevestig het bericht Welk IDoc-type? door Doorgaan te selecteren.

  4. Selecteer het EDIDC-knooppunt . Voer de juiste waarden in voor de poorten van de ontvanger en de afzender. Selecteer Doorgaan.

  5. Selecteer Standaard uitgaande verwerking.

  6. Als u uitgaande IDoc-verwerking wilt starten, selecteert u Doorgaan.

    Wanneer het hulpprogramma klaar is met verwerken, wordt de IDoc die naar het SAP-systeem of het externe programmabericht is verzonden weergegeven.

  7. Als u wilt controleren op verwerkingsfouten, gebruikt u de sm58-transactiecode (T-Code) met het voorvoegsel /n .

Werkstromen maken voor algemene SAP-scenario's

Zie de volgende stappen voor de instructiegids voor het maken van werkstromen voor algemene SAP-integratieworkloads:

Werkstromen maken voor geavanceerde SAP-scenario's

Uitgebreide foutenlogboeken zoeken (alleen beheerde connector)

Als u de beheerde SAP-connector gebruikt, kunt u volledige foutberichten vinden door de uitgebreide logboeken van uw SAP-adapter te controleren. U kunt ook een uitgebreid logboekbestand voor de SAP-connector inschakelen.

  • Voor on-premises gegevensgatewayreleases van april 2020 en eerder zijn logboeken standaard uitgeschakeld.

  • Voor on-premises gegevensgatewayreleases van juni 2020 en hoger kunt u gatewaylogboeken inschakelen in de app-instellingen.

    • Het standaardniveau voor logboekregistratie is Waarschuwing.

    • Als u aanvullende logboekregistratie inschakelt in de diagnostische instellingen van de on-premises gegevensgateway-app, wordt het niveau voor logboekregistratie verhoogd naar Informatief.

    • Als u het logboekregistratieniveau wilt verhogen naar Uitgebreid, werkt u de volgende instelling in uw configuratiebestand bij. Normaal gesproken bevindt het configuratiebestand zich in C:\Program Files\On-premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.

      <setting name="SapTraceLevel" serializeAs="String">
   <value>Verbose</value>
</setting>

Uitgebreide SAP-logboekregistratie instellen in on-premises gegevensgateway (alleen beheerde connector)

Als u een on-premises gegevensgateway voor Azure Logic Apps gebruikt, kunt u een uitgebreid logboekbestand voor de SAP-connector configureren. U kunt uw on-premises gegevensgateway gebruiken om Gebeurtenissen traceren voor Windows-gebeurtenissen (ETW) om te leiden naar roterende logboekbestanden die zijn opgenomen in de logboekregistratie van uw gateway .zip bestanden.

U kunt alle configuratie- en servicelogboeken van uw gateway exporteren naar een .zip-bestand vanuit de instellingen van de gateway-app.

Notitie

Uitgebreide logboekregistratie kan van invloed zijn op de prestaties van uw werkstroom wanneer deze altijd is ingeschakeld. Als best practice schakelt u uitgebreide logboekbestanden uit nadat u klaar bent met het analyseren en oplossen van een probleem.

ETW-gebeurtenissen vastleggen

Als optionele geavanceerde logboekregistratietaak kunt u ETW-gebeurtenissen rechtstreeks vastleggen en vervolgens de gegevens in Azure Diagnostics in Event Hubs gebruiken of uw gegevens verzamelen naar Azure Monitor-logboeken. Raadpleeg de aanbevolen procedures voor het verzamelen en opslaan van gegevens voor meer informatie.

Als u met de resulterende ETL-bestanden wilt werken, kunt u PerfView gebruiken of uw eigen programma schrijven. In de volgende procedure wordt PerfView gebruikt:

  1. Selecteer Verzamelen verzamelen> in het menu PerfView om de gebeurtenissen vast te leggen.

  2. Voer in de parameter Aanvullende provider in *Microsoft-LobAdapter om de SAP-provider op te geven voor het vastleggen van SAP Adapter-gebeurtenissen. Als u deze informatie niet opgeeft, bevat uw trace alleen algemene ETW-gebeurtenissen.

  3. Behoud de andere standaardinstellingen. Desgewenst kunt u de bestandsnaam of locatie wijzigen in de parameter Gegevensbestand .

  4. Selecteer Verzameling starten om uw tracering te starten.

  5. Nadat u uw probleem hebt gereproduceerd of voldoende analysegegevens hebt verzameld, selecteert u Verzameling stoppen.

  6. Als u uw gegevens wilt delen met een andere partij, zoals ondersteuning voor Azure engineers, comprimeert u het ETL-bestand.

  7. De inhoud van uw tracering weergeven:

    1. Selecteer in PerfView Bestand>openen en selecteer het ETL-bestand dat u zojuist hebt gegenereerd.

    2. In de zijbalk PerfView, de sectie Gebeurtenissen onder uw ETL-bestand.

    3. Filter onder Filteren op Microsoft-LobAdapter om alleen relevante gebeurtenissen en gatewayprocessen weer te geven.

Uw werkstroom testen

Volg de bijbehorende stappen op basis van of u een werkstroom Verbruik hebt in multitenant Azure Logic Apps of een Standaardwerkstroom in Azure Logic Apps met één tenant:

  1. Als de resource van de logische app Verbruik nog niet is ingeschakeld, selecteert u Overzicht in het menu van de logische app. Selecteer Inschakelen op de werkbalk.

  2. Selecteer Op de werkbalk van de ontwerpfunctie de optie Triggeruitvoering> uitvoeren om uw werkstroom handmatig te starten.

  3. Als u uw werkstroom wilt activeren, verzendt u een bericht van uw SAP-systeem.

  4. Ga terug naar het deelvenster Overzicht van uw logische app. Zoek onder Uitvoeringsgeschiedenis eventuele nieuwe uitvoeringen voor uw werkstroom.

  5. Open de meest recente uitvoering, waarin een handmatige uitvoering wordt weergegeven. De sectie triggeruitvoer zoeken en controleren.

Logboekregistratie en tracering van SAP-clientbibliotheek (NCo) inschakelen (alleen ingebouwde connector)

Wanneer u problemen met dit onderdeel moet onderzoeken, kunt u aangepaste NCo-tracering op basis van tekstbestanden instellen, die sap- of Microsoft-ondersteuning van u kan aanvragen. Deze mogelijkheid is standaard uitgeschakeld omdat het inschakelen van deze trace mogelijk een negatieve invloed heeft op de prestaties en snel de opslagruimte van de toepassingshost verbruikt.

U kunt deze traceringsmogelijkheid op toepassingsniveau beheren door de volgende instellingen toe te voegen:

  1. Open uw resource voor de logische standaard-app in Azure Portal.

  2. Selecteer in het menu van de logische app, onder Instellingen, omgevingsvariabelen om de toepassingsinstellingen te controleren.

  3. Voeg op de pagina Omgevingsvariabelen op het tabblad App-instellingen de volgende toepassingsinstellingen toe:

    • SAP_RFC_TRACE_DIRECTORY: de map waar de NCo-traceringsbestanden moeten worden opgeslagen, bijvoorbeeld C:\home\LogFiles\NCo.

    • SAP_RFC_TRACE_LEVEL: Het NCo-traceerniveau met Level4 als de voorgestelde waarde voor uitgebreide logboekregistratie. SAP- of Microsoft-ondersteuning kan vragen om een ander traceringsniveau in te stellen.

      Notitie

      Voor standaardwerkstromen voor logische apps die gebruikmaken van runtimeversie 1.69.0 of hoger, kunt u logboekregistratie voor meerdere traceringsniveaus inschakelen door elk traceringsniveau te scheiden met een komma (,).

      Volg deze stappen om de runtimeversie van uw werkstroom te vinden:

      1. Selecteer Overzicht in azure Portal in het werkstroommenu.
      2. Zoek in de sectie Essentials de eigenschap Runtime-versie .

    • SAP_CPIC_TRACE_LEVEL: Het traceringsniveau Common Programming Interface for Communication (CPI-C) met Uitgebreid als de voorgestelde waarde voor typische uitgebreide logboekregistratie. SAP- of Microsoft-ondersteuning kan vragen om een ander traceringsniveau in te stellen.

    Zie Host- en app-instellingen bewerken voor standaardwerkstromen voor logische apps voor meer informatie over het toevoegen van toepassingsinstellingen.

  4. Sla uw wijzigingen op. Met deze stap wordt de toepassing opnieuw opgestart.

Beschikbare traceringsniveaus

NCo-traceringsniveaus

Weergegeven als Beschrijving
Level1 Het niveau voor het traceren van externe functie-aanroepen.
Level2 Het niveau voor het traceren van externe functie-aanroepen en openbare API-methode-aanroepen.
Level3 Het niveau voor het traceren van externe functie-aanroepen, openbare API-methode-aanroepen en interne API-methode-aanroepen.
Level4 Het niveau voor het traceren van externe functie-aanroepen, openbare API-methode-aanroepen, interne API-methode-aanroepen, hexdumps voor het RFC-protocol en netwerkgerelateerde informatie.
Vergrendelen Hiermee schrijft u gegevens naar de traceringsbestanden die worden weergegeven wanneer threads vergrendelingen aanvragen, verkrijgen en vrijgeven voor objecten.
Metagegevens Traceert de metagegevens die zijn betrokken bij een externe functie-aanroep voor elke aanroep.
Geen Het niveau voor het onderdrukken van alle traceringsuitvoer.
ParameterData Traceert de containergegevens die worden verzonden en ontvangen tijdens elke externe functie-aanroep.
Prestaties Schrijft gegevens naar de traceringsbestanden die kunnen helpen bij het analyseren van prestatieproblemen.
PublicAPI Traceert de meeste methoden van de openbare API, met uitzondering van getters, setters of gerelateerde methoden.
InternalAPI Traceert de meeste methoden van de interne API, met uitzondering van getters, setters of gerelateerde methoden.
RemoteFunctionCall Traceert externe functie-aanroepen.
RfcData Traceert de verzonden en ontvangen bytes tijdens elke externe functie-aanroep.
SessionProvider Traceert alle methoden van de momenteel gebruikte implementatie van ISessionProvider.
Waardeinstellen Schrijft informatie naar de traceringsbestanden met betrekking tot waarden die zijn ingesteld voor parameters van functies, of velden van structuren of tabellen.

CPIC-traceringsniveaus

Weergegeven als Beschrijving
Uit Geen logboekregistratie
Basis Basislogboekregistratie
Uitgebreid Uitgebreide logboekregistratie
VerboseWithData Uitgebreide logboekregistratie met alle serverantwoorddump

De tracering weergeven

  1. Selecteer Geavanceerde hulpprogramma's go in het resourcemenu van de standaard logische app onder Ontwikkelhulpprogramma's>.

  2. Selecteer op de Kudu-werkbalk CMD voor foutopsporingsconsole>.

  3. Blader naar de map voor de toepassingsinstelling met de naam $SAP_RFC_TRACE_DIRECTORY.

    Een nieuwe map met de naam NCo of de mapnaam die u hebt gebruikt, wordt weergegeven voor de waarde van de toepassingsinstelling C :\home\LogFiles\NCo, die u eerder hebt ingesteld.

  4. Open de map $SAP_RFC_TRACE_DIRECTORY , die het volgende bevat:

    • NCo-traceerlogboeken: een bestand met de naam dev_nco_rfc.log, een of meerdere bestanden met de naam nco_rfc_NNNN.log en een of meerdere bestanden met de naam nco_rfc_NNNN.trc-bestanden waarbij NNNN een thread-id is.

    • CPIC-traceerlogboeken: een of meerdere bestanden met de naam nco_cpic_NNNN.trc-bestanden waarbij NNNN thread-id is.

  5. Als u de inhoud in een logboek- of traceringsbestand wilt weergeven, selecteert u de knop Bewerken naast een bestand.

    Notitie

    Als u een logboek- of traceringsbestand downloadt dat de werkstroom van uw logische app is geopend en momenteel in gebruik is, kan uw download resulteren in een leeg bestand.

Tracering van SAP Common Crypto Library (CCL) inschakelen (alleen ingebouwde connector)

Als u problemen met de cryptobibliotheek moet onderzoeken tijdens het gebruik van SNC-verificatie, kunt u aangepaste CCL-tracering op basis van een tekstbestand instellen. U kunt deze CCL-logboeken gebruiken om problemen met SNC-verificatie op te lossen of deze te delen met Microsoft- of SAP-ondersteuning, indien aangevraagd. Deze mogelijkheid is standaard uitgeschakeld omdat het inschakelen van deze trace mogelijk een negatieve invloed heeft op de prestaties en snel de opslagruimte van de toepassingshost verbruikt.

U kunt deze traceringsmogelijkheid op toepassingsniveau beheren door de volgende instellingen toe te voegen:

  1. Open uw resource voor de logische standaard-app in Azure Portal.

  2. Selecteer Geavanceerde hulpprogramma's go in het resourcemenu van de standaard logische app onder Ontwikkelhulpprogramma's>.

  3. Selecteer op de Kudu-werkbalk CMD voor foutopsporingsconsole>.

  4. Blader naar een locatie onder C:\home\site\wwwroot en maak een tekstbestand, bijvoorbeeld: CCLPROFILE.txt.

    Zie SAP NOTE traceren> 2338952 voor meer informatie over logboekregistratieparameters. Het volgende voorbeeld bevat een voorbeeld van een traceringsconfiguratie:

    ccl/trace/directory=C:\home\LogFiles\CCLLOGS
ccl/trace/level=4
ccl/trace/rotatefilesize=10000000
ccl/trace/rotatefilenumber=10

  5. Selecteer in het menu van de logische app, onder Instellingen, omgevingsvariabelen om de toepassingsinstellingen te controleren.

  6. Voeg op de pagina Omgevingsvariabelen op het tabblad App-instellingen de volgende toepassingsinstelling toe:

    CCL_PROFILE: de map waarin CCLPROFILE.txt is gemaakt, bijvoorbeeld C:\home\site\wwwroot\CCLPROFILE.txt.

  7. Sla uw wijzigingen op. Met deze stap wordt de toepassing opnieuw opgestart.

De tracering weergeven

  1. Selecteer Geavanceerde hulpprogramma's go in het resourcemenu van de standaard logische app onder Ontwikkelhulpprogramma's>.

  2. Selecteer op de Kudu-werkbalk CMD voor foutopsporingsconsole>.

  3. Blader vanuit CCLPROFILE.txt naar de map voor de parameter met de naam $ccl/trace/directory.

    Meestal worden de traceringsbestanden sec-Microsoft.Azure.Work-$processId.trc en sec-sapgenpse.exe-$processId.trc genoemd.

    Uw werkstroom voor logische apps voert SNC-verificatie uit als een proces in twee stappen:

    1. Uw werkstroom voor logische apps roept sapgenpse.exe aan om een cred_v2-bestand te genereren op basis van het PSE-bestand.

      U vindt de traceringen die betrekking hebben op deze stap in een bestand met de naam sec-sapgenpse.exe-$processId.trc.

    2. Uw werkstroom voor logische apps verifieert de toegang tot uw SAP-server door het gegenereerde cred_v2-bestand te gebruiken, waarbij de SAP-clientbibliotheek de algemene cryptobibliotheek aanroept.

      U vindt de traceringen die betrekking hebben op deze stap in een bestand met de naam sec-Microsoft.Azure.Work-$processId.trc.

SAP-telemetrie verzenden voor on-premises gegevensgateway naar Azure-toepassing Insights

Met de update van augustus 2021 voor de on-premises gegevensgateway kunnen SAP-connectorbewerkingen telemetriegegevens verzenden vanuit de SAP NCo-clientbibliotheek en traceringen van de Microsoft SAP-adapter naar Application Insights. Dit is een mogelijkheid in Azure Monitor. Deze telemetrie bevat voornamelijk de volgende gegevens:

  • Metrische gegevens en traceringen op basis van sap NCo-metrische gegevens en monitors.

  • Traceringen van Microsoft SAP Adapter.

Metrische gegevens en traceringen uit de SAP NCo-clientbibliotheek

Metrische gegevens op basis van SAP NCo zijn numerieke waarden die gedurende een bepaalde periode kunnen variëren, op basis van het gebruik en de beschikbaarheid van resources op de on-premises gegevensgateway. U kunt deze metrische gegevens gebruiken om de systeemstatus beter te begrijpen en waarschuwingen te maken over de volgende activiteiten:

  • Systeemstatus weigeren.
  • Ongebruikelijke gebeurtenissen.
  • Zware systeembelasting.

Deze informatie wordt verzonden naar de Application Insights-tabel met de naam customMetrics. Metrische gegevens worden standaard verzonden met intervallen van 30 seconden.

SAP NCo-traceringen bevatten tekstinformatie die wordt gebruikt met metrische gegevens. Deze informatie wordt verzonden naar de Application Insights-tabel met de naam traceringen. Traceringen worden standaard met intervallen van 10 minuten verzonden.

SAP NCo-metrische gegevens en traceringen zijn gebaseerd op SAP NCo-metrische gegevens, met name de volgende NCo-klassen:

  • RfcDestinationMonitor.
  • Rfc Verbinding maken ionMonitor.
  • RfcServerMonitor.
  • RfcRepositoryMonitor.

Zie de SAP NCo-documentatie (aanmelding vereist) voor meer informatie over de metrische gegevens die elke klasse biedt.

SAP-telemetrie instellen voor Application Insights

Voordat u SAP-telemetrie kunt verzenden voor de installatie van uw gateway naar Application Insights, moet u uw Application Insights-resource hebben gemaakt en ingesteld. Raadpleeg de volgende documentatie voor meer informatie:

Voer de volgende stappen uit om het verzenden van SAP-telemetrie naar Application Insights in te schakelen:

  1. Download het NuGet-pakket voor Microsoft.ApplicationInsights.EventSourceListener.dll vanaf deze locatie: https://www.nuget.org/packages/Microsoft.ApplicationInsights.EventSourceListener/2.14.0.

  2. Voeg het gedownloade bestand toe aan de installatiemap van uw on-premises gegevensgateway, bijvoorbeeld C:\Program Files\On-Premises Data Gateway.

  3. Controleer in de installatiemap van uw on-premises gegevensgateway of het Microsoft.ApplicationInsights.dll bestand hetzelfde versienummer heeft als het Microsoft.ApplicationInsights.EventSourceListener.dll-bestand dat u hebt toegevoegd. De gateway gebruikt momenteel versie 2.14.0.

  4. Voeg in het applicationInsights.config-bestand uw Application Insights-instrumentatiesleutel toe door de opmerking bij het <InstrumentationKey></InstrumentationKey> element ongedaan te maken. Vervang de tijdelijke aanduiding your-Application-Insights-instrumentation-key door uw sleutel, bijvoorbeeld:

    <?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights schemaVersion="2014-05-30" xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
   <!-- Uncomment this element and insert your Application Insights key to receive ETW telemetry about your gateway <InstrumentationKey>*your-instrumentation-key-placeholder*</InstrumentationKey> -->
   <TelemetryModules>
      <Add Type="Microsoft.ApplicationInsights.Extensibility.Implementation.Tracing.DiagnosticsTelemetryModule, Microsoft.ApplicationInsights">
         <IsHeartbeatEnabled>false</IsHeartbeatEnabled>
      </Add>
      <Add Type="Microsoft.ApplicationInsights.EventSourceListener.EventSourceTelemetryModule, Microsoft.ApplicationInsights.EventSourceListener">
         <Sources>
            <Add Name="Microsoft-LobAdapter" Level="Verbose" />
         </Sources>
      </Add>
   </TelemetryModules>
</ApplicationInsights>

  5. In het bestand ApplicationInsights.config kunt u de vereiste traceringen Level voor uw SAP-connectorbewerkingen wijzigen, bijvoorbeeld:

    <Add Type="Microsoft.ApplicationInsights.EventSourceListener.EventSourceTelemetryModule, Microsoft.ApplicationInsights.EventSourceListener">
   <Sources>
      <Add Name="Microsoft-LobAdapter" Level="Verbose" />
   </Sources>
</Add>

    Raadpleeg de volgende documentatie voor meer informatie:

  6. Nadat u de wijzigingen hebt toegepast, start u de on-premises gegevensgatewayservice opnieuw op.

Metrische gegevens controleren in Application Insights

Nadat uw SAP-bewerkingen zijn uitgevoerd in uw werkstroom voor logische apps, kunt u de telemetrie bekijken die naar Application Insights is verzonden.

  1. Open uw bron in deAzure Portal Application Insights .

  2. Selecteer Logboeken in het resourcemenu onder Bewaking.

    In de volgende schermopname ziet u de Azure-portal met Application Insights, dat is geopend in het deelvenster Logboeken :

    Schermopname van Azure Portal met Application Insights geopend in het deelvenster Logboeken voor het maken van query's.

  3. In het deelvenster Logboeken kunt u een query maken met behulp van de Kusto-querytaal (KQL) die is gebaseerd op uw specifieke vereisten.

    U kunt een querypatroon gebruiken dat vergelijkbaar is met de volgende voorbeeldquery:

    customMetrics
| extend DestinationName = tostring(customDimensions["DestinationName"])
| extend MetricType = tostring(customDimensions["MetricType"])
| where customDimensions contains "RfcDestinationMonitor"
| where name contains "MaxUsedCount"

  4. Nadat u de query hebt uitgevoerd, controleert u de resultaten.

    In de volgende schermopname ziet u de resultatentabel met metrische gegevens van de voorbeeldquery:

    Schermopname van Application Insights met de tabel met metrische resultaten.

    • MaxUsedCount is 'Het maximale aantal clientverbindingen dat gelijktijdig door de bewaakte bestemming is gebruikt', zoals beschreven in de SAP NCo-documentatie (aanmelding vereist). U kunt deze waarde gebruiken om inzicht te hebben in het aantal gelijktijdig geopende verbindingen.

    • In de kolom valueCount wordt 2 weergegeven voor elke leesbewerking, omdat metrische gegevens worden gegenereerd met intervallen van 30 seconden. Application Insights voegt deze metrische gegevens per minuut samen.

    • De kolom DestinationName bevat een tekenreeks die een interne microsoft SAP-adapternaam is.

      Als u meer inzicht wilt krijgen in deze RFC-bestemming (Remote Function Call), gebruikt u deze waarde met tracesbijvoorbeeld:

      customMetrics
| extend DestinationName = tostring(customDimensions["DestinationName"])
| join kind=inner (traces
   | extend DestinationName = tostring(customDimensions["DestinationName"]),
   AppServerHost = tostring(customDimensions["AppServerHost"]),
   SncMode = tostring(customDimensions["SncMode"]),
   SapClient = tostring(customDimensions["Client"])
   | where customDimensions contains "RfcDestinationMonitor"
   )
   on DestinationName , $left.DestinationName == $right.DestinationName
| where customDimensions contains "RfcDestinationMonitor"
| where name contains "MaxUsedCount"
| project AppServerHost, SncMode, SapClient, name, valueCount, valueSum, valueMin, valueMax

U kunt ook metrische grafieken of waarschuwingen maken met behulp van deze mogelijkheden in Application Insights, bijvoorbeeld:

Schermopname van Application Insights met de resultaten in grafiekindeling.

Traceringen van Microsoft SAP Adapter

U kunt traceringen gebruiken die vanuit Microsoft SAP-adapter worden verzonden voor problemen na analyse en om eventuele bestaande interne systeemfouten te vinden die al dan niet afkomstig zijn van SAP-connectorbewerkingen. Deze traceringen zijn message ingesteld "n\a" omdat ze afkomstig zijn van een eerder gebeurtenisbronframework dat voorafgaat aan Application Insights, bijvoorbeeld:

traces
| where message == "n/a"
| where severityLevel > 0
| extend ActivityId = tostring(customDimensions["ActivityId"])
| extend fullMessage = tostring(customDimensions["fullMessage"])
| extend shortMessage = tostring(customDimensions["shortMessage"])
| where ActivityId contains "8ad5952b-371e-4d80-b355-34e28df9b5d1"

In de volgende schermopname ziet u de resultatentabel traceringen van de voorbeeldquery:

Schermopname van Application Insights met de resultatentabel traceringen.

Volgende stappen