Anslut till SAP från arbetsflöden i Azure Logic Apps

Gäller för: Azure Logic Apps (Förbrukning + Standard)

Den här instruktionsguiden för flera delar visar hur du kommer åt DIN SAP-server från ett arbetsflöde i Azure Logic Apps med hjälp av SAP-anslutningsappen. Du kan använda SAP-anslutningsappens åtgärder för att skapa automatiserade arbetsflöden som körs när de utlöses av händelser i SAP-servern eller i andra system och köra åtgärder för att hantera resurser på SAP-servern.

Både standard- och förbrukningslogikapparbetsflöden erbjuder den SAP-hanterade anslutningsappen som finns och körs i Azure med flera klientorganisationer. Standardarbetsflöden erbjuder också den inbyggda SAP-anslutningsappen som finns och körs i Azure Logic Apps med en enda klientorganisation. Om du skapar och är värd för ett förbrukningsarbetsflöde i en integrationstjänstmiljö (ISE) kan du också använda SAP-anslutningsappens ISE-inbyggda version. Mer information finns i Anslut eller teknisk referens.

SAP-kompatibilitet

SAP-anslutningsappen är kompatibel med följande typer av SAP-system:

• Lokala och molnbaserade HANA-baserade SAP-system, till exempel S/4 HANA.

• Klassiska lokala SAP-system, till exempel R/3 och ECC.

SAP måste ha stöd för den SAP-systemversion som du vill ansluta till. Annars kanske eventuella problem som du kan stöta på inte kan lösas. Mer information om SAP-systemversioner och underhållsinformation finns i SAP Product Availability Matrix (PAM).

SAP-anslutningsappen stöder följande typer av meddelande- och dataintegrering från SAP NetWeaver-baserade system:

• Mellanliggande dokument (IDoc)

• Business Application Programming Interface (BAPI)

• Fjärrfunktionsanrop (RFC) och transaktionell RFC (tRFC)

SAP-anslutningsappen använder BIBLIOTEKET SAP .NET Anslut or (NCo).

Om du vill använda SAP Connector-åtgärderna måste du först autentisera anslutningen och ha följande alternativ:

• Du kan ange ett användarnamn och lösenord.

• SAP-anslutningsappen stöder autentisering med SAP Secure Network Communications (SNC).

Du kan använda SNC för enkel inloggning med SAP NetWeaver (SSO) eller för säkerhetsfunktioner från externa produkter. Om du väljer att använda SNC granskar du SNC-kraven och SNC-kraven för ISE-anslutningstjänsten.

Anslut eller teknisk referens

SAP-anslutningsappen har olika versioner, baserat på logikapptyp och värdmiljö.

Logikapp	Environment	Anslut ellerversion
Förbrukning	Azure Logic Apps med flera klientorganisationer	Hanterad anslutningsapp, som visas i designern under företagsetiketten. Mer information finns i följande dokumentation: - Referens för SAP-hanterad anslutningsapp - Hanterade anslutningsappar i Azure Logic Apps
Förbrukning	Integration Service Environment (ISE)	Hanterad anslutningsapp, som visas i designern under företagsetiketten, och den ISE-inbyggda versionen, som visas i designern med ISE-etiketten och har andra meddelandegränser än den hanterade anslutningsappen. Obs! Se till att använda den ISE-inbyggda versionen, inte den hanterade versionen. Mer information finns i följande dokumentation: - Referens för SAP-hanterad anslutningsapp - ISE-meddelandegränser - Hanterade anslutningsappar i Azure Logic Apps
Standard	Azure Logic Apps för en klientorganisation och App Service-miljön v3 (endast Windows-abonnemang)	Hanterad anslutningsapp, som visas i anslutningsgalleriet under Runtime>Shared och den inbyggda anslutningsappen, som visas i anslutningsgalleriet under Runtime>In-App och är tjänstleverantörsbaserad. Den inbyggda anslutningsappen kan komma åt virtuella Azure-nätverk direkt med en anslutningssträng utan en lokal datagateway. Mer information finns i följande dokumentation: - Referens för SAP-hanterad anslutningsapp - Referens för inbyggd SAP-anslutningsapp - Hanterade anslutningsappar i Azure Logic Apps - Inbyggda anslutningsappar i Azure Logic Apps

Anslut eller skillnader

Den inbyggda SAP-anslutningsappen skiljer sig avsevärt från den SAP-hanterade anslutningsappen och den SAP ISE-versionerade anslutningsappen på följande sätt:

• Lokala anslutningar kräver inte den lokala datagatewayen.

  I stället kommunicerar den inbyggda SAP-anslutningsappen direkt med SAP-servern i det integrerade virtuella nätverket, vilket undviker hopp, svarstid och felpunkter för en nätverksgateway. Se till att du laddar upp eller distribuerar de icke-omdistribuerbara SAP-klientbiblioteken med logikappens arbetsflödesprogram. Mer information finns i Krav i den här guiden.

• Nyttolaststorlekar på upp till 100 MB stöds, så du behöver inte använda en blob-URI för stora begäranden.

• Specifika åtgärder är tillgängliga för Call BAPI, Call RFC och Send IDoc. Dessa dedikerade åtgärder ger en bättre upplevelse för tillståndskänsliga BAPI:er, RFC-transaktioner och IDoc-deduplicering och använder inte den äldre soap Windows Communication Foundation-meddelandemodellen (WCF).

  Åtgärden Anropa BAPI innehåller upp till två svar med returnerad JSON, XML-svaret från det anropade BAPI och BAPI-inchecknings- eller BAPI-återställningssvaret samt om du använder automatisk incheckning. Den här funktionen åtgärdar problemet med den SAP-hanterade anslutningsappen där resultatet från den automatiska incheckningen är tyst och endast kan observeras via loggar.

• Längre timeout vid 5 minuter jämfört med hanterad anslutningsapp och ISE-version av anslutningsappen.

  Den inbyggda SAP-anslutningsappen använder inte den delade eller globala anslutningsinfrastrukturen, vilket innebär att tidsgränserna är längre på 5 minuter jämfört med den hanterade SAP-anslutningsappen (två minuter) och sap ISE-version av anslutningsappen (fyra minuter). Långvariga begäranden fungerar utan att du behöver implementera det långvariga webhook-baserade åtgärdsmönstret för begäranden.

• Som standard är de inbyggda SAP-anslutningsåtgärderna tillståndslösa. Du kan dock aktivera tillståndskänsligt läge (tillhörighet) för dessa åtgärder.

  I tillståndskänsligt läge stöder den inbyggda SAP-anslutningsappen hög tillgänglighet och horisontella utskalningskonfigurationer. Som jämförelse har DEN SAP-hanterade anslutningsappen begränsningar för den lokala datagatewayen som är begränsad till en enda instans för utlösare och till kluster endast i redundansläge för åtgärder. Mer information finns i SAP Managed Connector – Kända problem och begränsningar.

• Standardarbetsflöden för logikappar kräver och använder SAP NCo 3.1-klientbiblioteket, inte SAP NCo 3.0-versionen. Mer information finns i Förutsättningar.

• Standardarbetsflöden för logikappar innehåller programinställningar där du kan ange ett PSE-lösenord (Personal Security Environment) och PSE.

  Den här ändringen hindrar dig från att ladda upp flera PSE-filer, vilket inte stöds och resulterar i SAP-anslutningsfel. I arbetsflöden för förbrukningslogikappen kan du ange dessa värden via anslutningsparametrar, vilket gjorde att du kunde ladda upp flera PSE-filer och inte stöds, vilket orsakar SAP-anslutningsfel.

• Åtgärden Generera schema

  • Du kan välja mellan flera åtgärdstyper, till exempel BAPI, IDoc, RFC och tRFC, jämfört med samma åtgärd i den SAP-hanterade anslutningsappen, som använder parametern SapActionUris och en filsystemväljare.

  • Du kan ange ett parameternamn direkt som ett anpassat värde. Du kan till exempel ange parametern RFC-namn från åtgärden Anropa RFC . Som jämförelse var du tvungen att ange ett komplext åtgärds-URI-parameternamn i den hanterade SAP-anslutningsappen.

  • Den här åtgärden har avsiktligt inte stöd för att generera flera scheman för RFC:er, BAPI:er eller IDoc:er i en enda åtgärdskörning, som sap-hanterad anslutningsapp stöder. Den här funktionsändringen förhindrar nu försök att skicka stora mängder innehåll i ett enda anrop.

Anslutningsparametrar

Tillsammans med enkla sträng- och nummerindata accepterar SAP-anslutningsappen följande tabellparametrar (Type=ITAB indata):

• Tabellriktningsparametrar, både indata och utdata, för äldre SAP-versioner.
• Parameterändringar, som ersätter tabellriktningsparametrarna för nyare SAP-versioner.
• Hierarkiska tabellparametrar.

Kända problem och begränsningar

SAP-hanterad anslutningsapp

• SAP-anslutningsappen stöder för närvarande inte SAP-routersträngar. Den lokala datagatewayen måste finnas i ett virtuellt nätverk där gatewayen direkt kan nå det SAP-system som du vill ansluta till.

• I allmänhet stöder SAP-utlösaren inte datagatewaykluster. I vissa redundansfall kan den datagatewaynod som kommunicerar med SAP-systemet skilja sig från den aktiva noden, vilket resulterar i oväntat beteende.

  • För scenarier med skicka meddelanden stöds datagatewaykluster i redundansläge.

  • Tillståndskänsliga SAP-åtgärder stöder inte datagatewaykluster i belastningsutjämningsläge. Tillståndskänslig kommunikation måste finnas kvar på samma datagatewayklusternod. Använd antingen datagatewayen i icke-klusterläge eller i ett kluster som endast har konfigurerats för redundans. Dessa åtgärder omfattar till exempel följande:

    • Alla åtgärder som anger ett sessions-ID-värde
    • [BAPI] Checka in transaktion
    • [BAPI] Återställningstransaktion
    • [BAPI - RFC] Stäng tillståndskänslig session
    • [BAPI - RFC] Skapa tillståndskänslig session

• I åtgärden [BAPI] Anropa metoden i SAP checkar inte funktionen för automatisk incheckning in BAPI-ändringarna om det finns minst en varning i CallBapiResponse-objektet som returneras av åtgärden. Följ dessa steg för att genomföra BAPI-ändringar trots varningar:

  1. Skapa en session explicit med hjälp av åtgärden [BAPI – RFC] Skapa tillståndskänslig session.
  2. I åtgärden [ BAPI] Anropa metoden i SAP inaktiverar du funktionen för automatisk incheckning.
  3. Anropa åtgärden med namnet [BAPI] Commit transaction i stället.

IP-baserade anslutningar till SAP Message Server (belastningsutjämningskonfiguration)

Om du anger en IP-adress för att ansluta till en SAP-meddelandeserver, till exempel en lastbalanserare, kan anslutningen fortfarande misslyckas med ett felmeddelande som liknar "värdnamnet SAPDBSERVER01.example.com okänt". Meddelandeservern instruerar SAP-anslutningsappen att använda ett värdnamn för anslutningen till serverdelens SAP-programserver eller servern bakom lastbalanseraren. Om DNS inte kan matcha värdnamnet misslyckas anslutningen.

För det här problemet finns följande lösningar:

• Kontrollera att klienten som upprättar anslutningen, till exempel datorn med den lokala datagatewayen för SAP-anslutningsappen eller ISE-anslutningsvärden för den ISE-baserade SAP-anslutningsappen, kan matcha värdnamnen som returneras av meddelandeservern.

• I transaktionen med namnet RZ11 ändrar eller lägger du till SAP-inställningen med namnet ms/lg_with_hostname=0.

Problemkontext eller bakgrund

SAP uppgraderade sin .NET-anslutningsapp (NCo) till version 3.1, vilket ändrade hur anslutningsappen begär anslutningar till serverdelsservrar från meddelandeservrar. Anslutningsappen använder nu ett nytt API för programservermatchning av meddelandeservern såvida du inte tvingar anslutningsappen att använda det tidigare API:et via inställningen ms/lg_with_hostname=0". Mer information finns i ARTIKELN om SAP KB 3305039 – SMLG IP-adressinställning som inte beaktas vid inloggning med inloggning i inloggningsgruppen.

Förutsättningar

• Ett Azure-konto och prenumeration. Om du inte har någon Azure-prenumeration än registrerar du dig för ett kostnadsfritt Azure-konto.

• DEN SAP-programserver eller SAP-meddelandeserver som du vill komma åt från Azure Logic Apps.

  • Konfigurera din SAP-server och ditt användarkonto för att tillåta användning av RFC.

    Mer information, som innehåller de typer av användarkonton som stöds och minsta nödvändiga auktorisering för varje åtgärdstyp (RFC, BAPI, IDoc), finns i följande SAP-kommentar: 460089 – Minsta auktoriseringsprofiler för externa RFC-program.

  • Ditt SAP-användarkonto behöver åtkomst till RFC_METADATA funktionsgruppen och respektive funktionsmoduler för följande åtgärder:

    Operationer	Åtkomst till funktionsmodul
    RFC-åtgärder	RFC_GROUP_SEARCH och DD_LANGU_TO_ISOLA
    BAPI-åtgärder	BAPI_TRANSACTION_COMMIT, BAPI_TRANSACTION_ROLLBACK, RPY_BOR_TREE_INIT, SWO_QUERY_METHODS, och SWO_QUERY_API_METHODS
    IDoc-åtgärder	IDOCTYPES_LIST_WITH_MESSAGES, IDOCTYPES_FOR_MESTYPE_READ, INBOUND_IDOCS_FOR_TID, OUTBOUND_IDOCS_FOR_TID, GET_STATUS_FROM_IDOCNR, och IDOC_RECORD_READ
    Läs SAP-tabellåtgärd	Antingen RFC BBP_RFC_READ_TABLE eller RFC_READ_TABLE
    Ge strikt minimiåtkomst till SAP-servern för din SAP-anslutning	RFC_METADATA_GET och RFC_METADATA_GET_TIMESTAMP

• Arbetsflödet för logikappen där du vill komma åt SAP-servern.

  • Ett arbetsflöde för förbrukning i Azure Logic Apps med flera klientorganisationer finns i Krav för flera klientorganisationer.

  • Ett Standard-arbetsflöde i Azure Logic Apps för en klientorganisation finns i Krav för en enda klientorganisation.

  • Ett arbetsflöde för förbrukning i en integrationstjänstmiljö på Premium-nivå (ISE) finns i KRAV för ISE.

    Kommentar

    När du använder en ISE på Premium-nivå använder du den ISE-inbyggda SAP-anslutningsappen, inte den SAP-hanterade anslutningsappen, som inte körs internt i en ISE. Mer information finns i förhandskraven för ISE.

• Som standard är de inbyggda SAP-anslutningsåtgärderna tillståndslösa. Information om hur du kör dessa åtgärder i tillståndskänsligt läge finns i Aktivera tillståndskänsligt läge för tillståndslösa inbyggda anslutningsappar.

• Utför följande uppgifter om du vill använda den SAP-hanterade eller inbyggda anslutningsutlösaren med namnet När ett meddelande tas emot:

  • Konfigurera säkerhetsbehörigheter för SAP-gatewayen eller åtkomstkontrollistan (ACL). I dialogrutan Gateway Monitor (T-Code SMGW), som visar filerna secinfo och reginfo, öppnar du Menyn Goto och väljer Expert Functions>External Security Maintenance of ACL Files (Externt säkerhetsunderhåll>av ACL-filer).

    Följande behörighetsinställning krävs:

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

    Den här raden har följande format:

    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>

    Om du inte konfigurerar säkerhetsbehörigheterna för SAP Gateway kan du få följande fel:

    Registrering av tp Microsoft.PowerBI.EnterpriseGateway från värdvärdnamn <> tillåts inte

    Mer information finns i SAP Note 1850230 – GW: "Registrering av tp-program-ID <> tillåts inte".

  • Konfigurera säkerhetsloggningen för SAP Gateway för att hitta problem med åtkomstkontrollistan (ACL). Mer information finns i sap-hjälpavsnittet för att konfigurera gatewayloggning.

  • I dialogrutan Konfiguration av RFC Anslut ions (T-Code SM59) skapar du en RFC-anslutning med TCP/IP-typen. Kontrollera att aktiveringstypenär inställd på Registrerat serverprogram. Ställ in RFC-anslutningens kommunikationstyp med värdet Målsystem till Unicode.

  • Om du använder den här SAP-utlösaren med parametern IDOC Format inställd på FlatFile tillsammans med åtgärden Flat File Decode måste du använda early_terminate_optional_fields egenskapen i ditt flata filschema genom att ange värdet till true.

    Det här kravet är nödvändigt eftersom den flata IDoc-dataposten som skickas av SAP på tRFC-anropet IDOC_INBOUND_ASYNCHRONOUS inte är vadderad till den fullständiga SDATA-fältlängden. Azure Logic Apps tillhandahåller originaldata för flatfil-IDoc utan utfyllnad som tagits emot från SAP. När du kombinerar den här SAP-utlösaren med åtgärden Flat File Decode måste det schema som anges för åtgärden matcha.

  Kommentar

  I arbetsflöden för förbrukning och standard använder den SAP-hanterade utlösaren med namnet När ett meddelande tas emot samma URI-plats för att både förnya och avbryta prenumerationen från en webhook-prenumeration. Förnyelseåtgärden använder HTTP-metoden PATCH , medan avprenumerationsåtgärden använder HTTP-metoden DELETE . Det här beteendet kan göra så att en förnyelseåtgärd visas som en avprenumerationsåtgärd i utlösarens historik, men åtgärden är fortfarande en förnyelse eftersom utlösaren använder PATCH som HTTP-metod, inte DELETE.

  I Standard-arbetsflöden använder den inbyggda SAP-utlösaren med namnet När ett meddelande tas emot Azure Functions-utlösaren i stället och visar endast de faktiska återanropen från SAP.

  • För den inbyggda SAP-anslutningsutlösaren med namnet När ett meddelande tas emot måste du aktivera integrering av virtuella nätverk och privata portar genom att följa artikeln i Aktivera inbyggda Anslutningsappar för Service Bus och SAP för tillståndskänsliga Logic Apps i Standard. Du kan också köra arbetsflödet i Visual Studio Code för att utlösa utlösaren lokalt. För installationskrav för Visual Studio Code och mer information, se Skapa ett standardarbetsflöde för logikappar i Azure Logic Apps med en enda klientorganisation med Visual Studio Code. Du måste också konfigurera följande miljövariabler på datorn där du installerar Visual Studio Code:
  • WEBSITE_PRIVATE_IP: Ange det här miljövariabelvärdet till 127.0.0.1 som localhost-adress.
  • WEBSITE_PRIVATE_PORTS: Ange det här miljövariabelvärdet till två lediga och användbara portar på den lokala datorn, vilket avgränsar värdena med kommatecken (,), till exempel 8080 8088.

• Meddelandeinnehållet som ska skickas till SAP-servern, till exempel en exempel-IDoc-fil. Det här innehållet måste vara i XML-format och innehålla namnområdet för den SAP-åtgärd som du vill använda. Du kan skicka IDocs med ett platt filschema genom att omsluta dem i ett XML-kuvert.

Krav för nätverksanslutning

SAP-systemet kräver nätverksanslutning från värden för SAP .NET Anslut or-biblioteket (NCo):

• För arbetsflöden för förbrukningslogikappar i Azure Logic Apps med flera klientorganisationer är den lokala datagatewayen värd för SAP .NET Anslut or-biblioteket (NCo). Om du använder ett lokalt datagatewaykluster kräver alla noder i klustret nätverksanslutning till SAP-systemet.

• För standardarbetsflöden för logikappar i Azure Logic Apps med en enda klientorganisation är logikappresursen värd för SAP.NET Anslut or-biblioteket (NCo). Därför måste själva logikappresursen aktivera integrering av virtuella nätverk och det virtuella nätverket måste ha nätverksanslutning till SAP-systemet.

• För arbetsflöden för förbrukningslogikappar i en ISE är det virtuella ISE-nätverket värd för SAP.NET Anslut or-biblioteket (NCo).

Sap-systemanslutna nätverksanslutningar innehåller följande servrar och tjänster:

• SAP Application Server, Dispatcher Service (för alla inloggningstyper)

  SAP-systemet kan innehålla flera SAP-programservrar. Värden för SAP .NET Anslut or-biblioteket (NCo) kräver åtkomst till varje server och deras tjänster.

• SAP-meddelandeserver, meddelandetjänst (för inloggningstypgrupp)

  Meddelandeservern och tjänsten omdirigeras till en eller flera av programserverns Dispatcher-tjänster. Värden för SAP .NET Anslut or-biblioteket (NCo) kräver åtkomst till varje server och deras tjänster.

• SAP Gateway Server, Gateway-tjänst

• SAP Gateway Server, gateway-skyddad tjänst

  SAP-systemanslutna nätverksanslutningar omfattar även den här servern och tjänsten som ska användas med SNC (Secure Network Communications).

Omdirigering av begäranden från Application Server, Dispatcher-tjänsten till gatewayservern sker gatewaytjänsten automatiskt i SAP .NET Anslut or-biblioteket (NCo). Den här omdirigeringen sker även om endast programservern, dispatchertjänstinformation anges i anslutningsparametrarna.

Om du använder en lastbalanserare framför SAP-systemet måste du omdirigera alla tjänster till respektive servrar. Mer information om SAP-tjänster och -portar finns i TCP/IP-portarna för alla SAP-produkter.

Kommentar

Kontrollera att du har aktiverat nätverksanslutningen från värden för SAP .NET Anslut or-biblioteket (NCo) och att de portar som krävs är öppna i brandväggar och nätverkssäkerhetsgrupper. Annars får du fel som att partnern inte har nåtts från NI-komponenten (nätverksgränssnittet) och feltext som WSAECONNREFUSED: Anslut ion nekades.

Krav för SAP NCo-klientbibliotek

Om du vill använda SAP-anslutningsappen måste du installera SAP Anslut eller NCo-klientbiblioteket för Microsoft .NET 3.1. I följande lista beskrivs förutsättningarna för SAP NCo-klientbiblioteket, baserat på arbetsflödet där du använder SAP-anslutningsappen:

• Version:

  • För arbetsflöden för förbrukningslogikapp som använder den lokala datagatewayen kontrollerar du att du installerar den senaste 64-bitarsversionen, SAP Anslut eller för Microsoft .NET 3.1.3.0 för Windows 64-bitars (x64). Datagatewayen körs endast på 64-bitarssystem. Om du installerar den 32-bitarsversion som inte stöds resulterar det i ett "felaktig avbildningsfel" .

  • För standardarbetsflöden för logikappar kan du installera den senaste 64- eller 32-bitarsversionen för SAP Anslut or (NCo 3.1) för Microsoft .NET 3.1.3.0 som kompilerats med .NET Framework 4.6.2. Kontrollera dock att du installerar den version som matchar konfigurationen i standardlogikappresursen. Följ dessa steg för att kontrollera vilken version som används av logikappen:

    1. Öppna din standardlogikappresurs i Azure-portalen.

    2. På resursmenyn för logikappen går du till Inställningar och väljer Konfiguration.

    3. På sidan Konfiguration väljer du fliken Allmänna inställningar . Under Plattformsinställningar kontrollerar du om plattformsvärdet är inställt på 64 bitar eller 32 bitar.

    4. Se till att installera versionen av SAP Anslut or (NCo 3.1) för Microsoft .NET 3.1.3.0 som kompilerats med .NET Framework 4.6.2 som matchar din plattformskonfiguration.

• Från klientbibliotekets standardinstallationsmapp kopierar du sammansättningsfilerna (.dll) till en annan plats, baserat på ditt scenario enligt följande. Om du bara använder den hanterade SAP-anslutningsappen kan du också välja Registrering av global sammansättningscache när du installerar SAP NCo-klientbiblioteket. ISE zip-arkivet och den inbyggda SAP-anslutningsappen stöder för närvarande inte GAC-registrering.

  • För ett förbrukningsarbetsflöde som körs i Azure Logic Apps med flera klienter och använder din lokala datagateway kopierar du följande sammansättningsfiler (.dll) till installationsmappen för den lokala datagatewayen, till exempel C:\Program Files\On-Premises Data Gateway. SAP NCo 3.0-klientbiblioteket innehåller följande sammansättningar:

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

    Se till att du kopierar sammansättningsfilerna till datagatewayens installationsmapp. Annars kan SAP-anslutningen misslyckas med felmeddelandet. Kontrollera kontoinformationen och/eller behörigheterna och försök igen. Du kan felsöka ytterligare problem med loggvisaren för .NET-sammansättningsbindning. Med det här verktyget kan du kontrollera att sammansättningsfilerna är på rätt plats.

  • För Standard-arbetsflöden kopierar du följande sammansättningsfiler (.dll) till en plats där du kan ladda upp dem till din logikappresurs eller ditt projekt där du skapar arbetsflödet, antingen i Azure-portalen eller lokalt i Visual Studio Code. SAP NCo 3.1-klientbiblioteket innehåller följande sammansättningar:

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

  • För ett förbrukningsarbetsflöde i en ISE följer du kraven för ISE i stället.

Följande relationer finns mellan SAP NCo-klientbiblioteket, .NET Framework, .NET-körningen och datagatewayen:

• Både Microsoft SAP Adapter och gateway-värdtjänsten använder .NET Framework 4.7.2.

• SAP NCo för .NET Framework 4.0 fungerar med processer som använder .NET Runtime 4.0 till 4.8.

• SAP NCo för .NET Framework 2.0 fungerar med processer som använder .NET runtime 2.0 till 3.5, men som inte längre fungerar med den senaste gatewayen.

SNC-krav

Förbrukning

För förbrukningsarbetsflöden i Azure Logic Apps med flera klientorganisationer som använder den lokala datagatewayen, och eventuellt SNC, måste du också konfigurera följande inställningar.

• Kontrollera att SNC-biblioteksversionen och dess beroenden är kompatibla med DIN SAP-miljö. Om du vill felsöka eventuella problem med bibliotekskompatibilitet kan du använda dina lokala datagateway- och datagatewayloggar.

• Kontrollera att du kopierade följande sammansättningsfiler (.dll) i SAP NCo 3.0-klientbiblioteket till installationsmappen för den lokala datagatewayen, till exempel C:\Program Files\On-Premises Data Gateway.

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

• För SAPGENPSE-verktyget måste du specifikt använda sapgenpse.exe.

• Om du anger en personlig säkerhetsmiljö (PSE) med din anslutning behöver du inte kopiera och konfigurera PSE och SECUDIR för din lokala datagateway.

• Om du aktiverar SNC via en extern säkerhetsprodukt, till exempel sapseculib, Kerberos eller NTLM, kontrollerar du att SNC-biblioteket finns på samma dator som din datagatewayinstallation. För den här uppgiften kopierar du SNC-bibliotekets binära filer till samma mapp som installationen av datagatewayen på den lokala datorn, till exempel C:\Program Files\On-Premises Data Gateway.

  Kommentar

  Ange inte miljövariablerna för SNC_LIB och SNC_LIB_64 på datorn med installation av datagatewayen och SNC-biblioteket. I annat fall har dessa variabler företräde framför SNC-biblioteksvärdet som skickas via anslutningsappen.

• Om du vill använda SNC med enkel inloggning (SSO) kontrollerar du att datagatewaytjänsten körs som en användare som är mappad till en SAP-användare. Om du vill ändra standardkontot för gatewaytjänstkontot väljer du Ändra konto och anger autentiseringsuppgifterna för användaren.

  

Mer information om hur du aktiverar SNC finns i Aktivera säker nätverkskommunikation (SNC).

Standard

Den inbyggda SAP-anslutningsappen stöder endast SNC X.509-autentisering, inte SSO-autentisering (enkel inloggning). Se till att du installerar SNC och vanliga kryptobibliotekssammansättningar som en del av dina krav för en enda klientorganisation och krav på nätverksanslutning. Mer information om hur du aktiverar SNC finns i Aktivera säker nätverkskommunikation (SNC).

För SNC från SAP måste du ladda ned följande filer och ha dem redo att laddas upp till din logikappresurs.

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

Du behöver också följande filer från CommonCryptoLib.sar-paketet som är tillgängligt från SAP for Me, Software Download Center (SAP-inloggning krävs). Mer information finns i Ladda ned CommonCryptoLib.sar.

• sapcrypto.dll
• sapgenpse.exe
• slcryptokernal.dll

Kommentar

Om du använder en annan SNC-implementering kan dessa biblioteksfiler ha olika namn. I vilket fall som helst krävs sapgenpse.exe för att använda SNC med den inbyggda SAP-anslutningsappen.

Ladda ned CommonCryptoLib.sar

För att hämta de nödvändiga sammansättningarna och andra filer för SNC från SAP hittar du dessa filer i CommonCryptoLib.sar-paketet som är tillgängligt från SAP for Me, Software Download Center (SAP-inloggning krävs). Du kan använda valfri CommonCryptoLib-biblioteksimplementering som stöds, baserat på kompatibla versioner som är specifika för din SAP-miljö. Microsoft rekommenderar dock att du använder den senaste versionen för CommonCryptoLib-biblioteket som är tillgängligt från SAP, förutsatt att den versionen är kompatibel med din SAP-miljö.

Följ dessa steg för att ladda ned det aktuella CommonCryptoLib-paketet :

1. Logga in på SAP for Me, Software Download Center.

2. På sidan Ladda ned programvara väljer du fliken Installation och uppgraderingar, expanderarEfter alfabetiskt index (A-Z) och väljer fliken C SAP Cryptographic Software Downloads tab SapCryptoLib>Downloads tab >CommonCryptoLib 8>Downloads (Fliken Nedladdningar av C>SAP Cryptographic Software>Downloads).>

3. I listan Objekt som är tillgängliga för nedladdning väljer du Windows på x64 64Bit eller Windows Server på IA32 x32-bitars, beroende på vilket som matchar standardkonfigurationen för logikappplattformen.

   Microsoft rekommenderar 64-bitarsversionen.

4. I listan väljer du korrigeringen på den högsta nivån.

   Det aktuella korrigeringsnumret varierar beroende på den valda Windows-versionen.

5. Om du inte har SAPCAR verktyget för att extrahera .sar-filen följer du dessa steg:

   1. På sidan Hämta programvara i SAP for Me, Software Download Center, väljer du fliken Supportpaket och korrigeringar, expanderar Efter alfabetiskt index (A-Z) och väljer fliken S>SAPCAR-nedladdningar.>

   2. I listan Objekt som är tillgängliga för nedladdning väljer du ditt operativsystem och den sapcar.exe filen för SAPCAR-verktyget.

   Dricks

   Om du inte känner till SAPCAR-verktyget kan du läsa följande SAP-blogginlägg: Extrahera enkelt SAR-filer.

   Följande batchfil är en förbättrad version som extraherar arkiv till en underkatalog med samma namn:

   @echo off
   cd %~dp1
   mkdir %~n1
   sapcar.exe -xvf %~nx1 -R %~n1
   pause
   

6. Inkludera alla extraherade .dll- och .exe-filer, som visas i följande lista för det aktuella SAP CommonCryptoLib-paketet :

   • sapcrypto.dll
   • sapgenpse.exe
   • slcryptokernal.dll

ISE

DEN ISE-versionerade SAP-anslutningsappen stöder SNC X.509, inte SSO-autentisering (enkel inloggning). Om du tidigare använde SAP-anslutningsappen utan SNC kan du aktivera SNC för ISE-inbyggda SAP-anslutningar.

Innan du distribuerar om en SAP-anslutning för att använda SNC, eller om du distribuerade SAP-anslutningsappen utan SNC- eller SAPGENPSE-biblioteken, måste du ta bort alla tidigare befintliga SAP-anslutningar och sedan SAP-anslutningsappen. Flera arbetsflöden för logikappar kan använda samma SAP-anslutning. Se därför till att du tar bort alla tidigare befintliga SAP-anslutningar från alla arbetsflöden för logikappar i din ISE.

När du har tagit bort SAP-anslutningarna måste du ta bort SAP-anslutningsappen från DIN ISE. Du kan fortfarande behålla logikappens arbetsflöden som använder den här anslutningsappen. När du har distribuerat om anslutningsappen kan du sedan autentisera den nya anslutningen i arbetsflödets SAP-åtgärder.

1. Om du vill ta bort befintliga SAP-anslutningar följer du någon av sökvägarna:

   • Öppna varje logikappresurs och arbetsflöde i Azure-portalen för att ta bort SAP-anslutningarna.

     1. Öppna arbetsflödet för logikappen i designern.

     2. På logikappmenyn går du till Utvecklingsverktyg och väljer API-anslutningar.

     3. På sidan API-anslutningar väljer du din SAP-anslutning.

     4. Välj Ta bort på anslutningens sidmeny.

     5. Acceptera bekräftelseprompten för att ta bort anslutningen.

     6. Vänta tills portalmeddelandet om att anslutningen har tagits bort.

   • Öppna DIN ISE-resurs i Azure-portalen för att ta bort SAP-anslutningarna.

     1. Välj API-anslutningar under Inställningar på ISE-menyn.

     2. På sidan API-anslutningar väljer du din SAP-anslutning.

     3. Välj Ta bort på anslutningens sidmeny.

     4. Acceptera bekräftelseprompten för att ta bort anslutningen.

     5. Vänta tills portalmeddelandet om att anslutningen har tagits bort.

2. Ta bort SAP-anslutningsappen från din ISE. Du måste ta bort alla anslutningar till den här anslutningsappen i alla arbetsflöden för logikappen innan du kan ta bort anslutningsappen. Om du inte redan har tagit bort alla anslutningar läser du föregående steg.

   1. Öppna din ISE-resurs i Azure-portalen.

   2. På ISE-menyn går du till Inställningar och väljer Hanterade anslutningsappar.

   3. På sidan Hanterade anslutningsappar markerar du kryssrutan för SAP-anslutningsappen.

   4. Välj Ta bort i verktygsfältet.

   5. Acceptera bekräftelseprompten för att ta bort anslutningsappen.

   6. Vänta tills portalmeddelandet om att anslutningsappen har tagits bort.

3. Distribuera eller distribuera om SAP-anslutningsappen i din ISE.

   1. Förbered en ny zip-arkivfil som ska användas i distributionen av SAP-anslutningsappen. Du måste inkludera SNC-biblioteket och SAPGENPSE-verktyget.

      • Du måste använda 64-bitars SNC-biblioteket. Det finns inget 32-bitars stöd.

      • Ditt SNC-bibliotek och beroenden måste vara kompatibla med DIN SAP-miljö. För att kontrollera kompatibiliteten krävs det för ISE.

   2. Kopiera alla SNC-, SAPGENPSE- och NCo-bibliotek till rotmappen i zip-arkivet. Placera inte dessa binärfiler i en undermapp.

   3. Följ distributionsstegen i ISE-krav för ditt nya zip-arkiv.

4. För varje arbetsflöde som använder den ISE-inbyggda SAP-anslutningsappen skapar du en ny SAP-anslutning som aktiverar SNC.

Certifikatrotation

1. Uppdatera den base64-kodade binära PSE för alla anslutningar som använder SAP ISE X.509 i din ISE.

2. Importera de nya certifikaten i din kopia av PSE.

3. Koda PSE-filen som en base64-kodad binär fil.

4. Redigera sap-anslutningsinformationen och spara den nya PSE-filen där.

   Anslutningsappen identifierar PSE-ändringen och uppdaterar sin egen kopia under nästa anslutningsbegäran.

Miljökrav för Azure Logic Apps

Förbrukning

För ett förbrukningsarbetsflöde i Azure Logic Apps med flera klientorganisationer integreras den HANTERADE SAP-anslutningsappen med SAP-system via en lokal datagateway. I scenarier där arbetsflödet till exempel skickar ett meddelande till SAP-systemet fungerar datagatewayen som en RFC-klient och vidarebefordrar de begäranden som tas emot från arbetsflödet till SAP. I scenarier där arbetsflödet tar emot ett meddelande från SAP fungerar datagatewayen på samma sätt som en RFC-server som tar emot begäranden från SAP och vidarebefordrar dem till ditt arbetsflöde.

1. På en värddator eller virtuell dator som finns i samma virtuella nätverk som DET SAP-system som du ansluter till laddar du ned och installerar den lokala datagatewayen.

   Datagatewayen hjälper dig att på ett säkert sätt komma åt lokala data och resurser. Se till att använda en version av gatewayen som stöds. Om det uppstår ett problem med din gateway kan du prova att uppgradera till den senaste versionen, som kan innehålla uppdateringar för att lösa problemet.

2. I Azure-portalen skapar du en Azure Gateway-resurs för din lokala datagatewayinstallation.

3. På samma lokala dator som din lokala datagatewayinstallation laddar du ned och installerar det senaste SAP NCo-klientbiblioteket.

4. För värddatorn med din lokala datagatewayinstallation konfigurerar du nätverksvärdnamnen och lösningen för tjänstnamn.

   • Om du vill använda värdnamnen eller tjänstnamnen för anslutningar från Azure Logic Apps måste du konfigurera namnmatchning för varje SAP-program, meddelande- och gatewayserver tillsammans med deras tjänster:

     • I filen %windir%\System32\drivers\etc\hosts eller på DEN DNS-server som är tillgänglig för värddatorn för installationen av den lokala datagatewayen konfigurerar du nätverksvärdens namnmatchning.

     • I filen %windir%\System32\drivers\etc\services konfigurerar du namnmatchningen för tjänsten.

   • Om du inte tänker använda nätverksvärdnamn eller tjänstnamn för anslutningen kan du använda värd-IP-adresser och tjänstportnummer i stället.

   • Om du inte har någon DNS-post för DITT SAP-system visar följande exempel en exempelpost för värdfilen:

     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
     

     I följande lista visas en exempeluppsättning med poster för tjänstfilerna:

     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
     

Standard

För ett Standard-arbetsflöde i Azure Logic Apps med en enda klient använder du den inbyggda SAP-anslutningsappen för att få direkt åtkomst till resurser som skyddas av ett virtuellt Azure-nätverk . Du kan också använda andra inbyggda anslutningsappar som gör att arbetsflöden kan komma åt lokala resurser direkt utan att behöva använda den lokala datagatewayen.

1. Om du vill använda SAP-anslutningsappen måste du ladda ned följande filer och låta dem läsas för att ladda upp till din standardlogikappresurs. Mer information finns i krav för SAP NCo-klientbibliotek:

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

2. För SNC från SAP måste du ladda ned följande filer och ha dem redo att laddas upp till din logikappresurs. Mer information finns i SNC-krav:

   • sapcrypto.dll
   • sapgenpse.exe
   • slcryptokernal.dll

Ladda upp sammansättningar till Azure-portalen

1. Öppna din standardlogikappresurs i Azure-portalen.

2. På logikappmenyn går du till Arbetsflöden och väljer Sammansättningar.

3. I verktygsfältet för sidan Sammansättningar väljer du Lägg till.

4. När fönstret Lägg till sammansättning öppnas väljer du Klient/SDK-sammansättning (.NET Framework) för Sammansättningstyp.

5. Under Ladda upp filer lägger du till de tidigare beskrivna nödvändiga filerna som du laddade ned:

   SAP NCo

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

   CommonCryptoLib

   • sapcrypto.dll
   • sapgenpse.exe
   • slcryptokernal.dll

6. När du är klar väljer du Ladda upp filer.

   Om sammansättningsfilen är 4 MB eller mindre kan du antingen bläddra och välja eller dra och släppa filen. Följ dessa steg i stället för filer som är större än 4 MB:

   1. På logikappmenyn går du till Utvecklingsverktyg och väljer Avancerade verktyg.

   2. På sidan Avancerade verktyg väljer du Gå.

   3. I Verktygsfältet Kudu går du till menyn Felsökningskonsol och väljer CMD.

   4. Öppna följande mappar: webbplats>wwwroot

   5. I verktygsfältet mappstruktur väljer du plustecknet (+) och väljer sedan Ny mapp.

   6. Skapa följande mapp och undermappar: lib>builtinOperationSdks>net472

   7. Ladda upp sammansättningsfilerna som är större än 4 MB i mappen net472 .

ISE

För ett förbrukningsarbetsflöde i en ISE ger ISE åtkomst till resurser som skyddas av ett virtuellt Azure-nätverk och erbjuder andra ISE-inbyggda anslutningsappar som gör att arbetsflöden kan komma åt lokala resurser direkt utan att behöva använda den lokala datagatewayen.

Viktigt!

Den 31 augusti 2024 dras ISE-resursen tillbaka på grund av dess beroende av Azure Cloud Services (klassisk) som dras tillbaka samtidigt. Före slutdatumet exporterar du alla logikappar från din ISE till standardlogikappar så att du kan undvika avbrott i tjänsten. Standardarbetsflöden för logikappar körs i Azure Logic Apps med en enda klientorganisation och ger samma funktioner plus mer.

Från och med den 1 november 2022 kan du inte längre skapa nya ISE-resurser. Ise-resurser som finns före detta datum stöds dock till och med 31 augusti 2024. Mer information finns i följande resurser:

• ISE Pension - vad du behöver veta
• Miljö för en klientorganisation jämfört med flera klienter och integreringstjänst för Azure Logic Apps
• Prissättning för Azure Logic Apps
• Exportera ISE-arbetsflöden till en standardlogikapp
• Integration Services Environment dras tillbaka den 31 augusti 2024 – övergång till Logic Apps Standard
• Distributionsmodellen för Cloud Services (klassisk) upphör den 31 augusti 2024

1. Om du inte redan har ett Azure Storage-konto med en blobcontainer skapar du en container med antingen Azure-portalen eller Azure Storage Explorer.

2. På den lokala datorn laddar du ned och installerar det senaste SAP NCo-klientbiblioteket. Du bör ha följande sammansättningsfiler (.dll):

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

3. Från rotmappen skapar du en .zip fil som innehåller dessa sammansättningsfiler. Ladda upp paketet till din blobcontainer i Azure Storage.

   Kommentar

   Använd inte en undermapp i .zip-filen. Endast sammansättningar i arkivets rotmapp distribueras med SAP-anslutningsappen i DIN ISE.

   Om du använder SNC inkluderar du även SNC-sammansättningar och binärfiler i samma .zip fil i roten. Mer information finns i SNC-kraven för ISE.

4. I Antingen Azure-portalen eller Azure Storage Explorer bläddrar du till containerplatsen där du laddade upp .zip-filen.

5. Kopiera URL:en för containerplatsen. Se till att inkludera SAS-token (Signatur för delad åtkomst), så att SAS-token är auktoriserad. Annars misslyckas distributionen för SAP ISE-anslutningsappen.

6. Installera och distribuera SAP-anslutningstjänsten i DIN ISE. Mer information finns i Lägg till ISE-anslutningsappar.

   1. I Azure-portalen letar du upp och öppnar din ISE.

   2. På ISE-menyn väljer du Hanterade anslutningsappar>Lägg till. I listan över anslutningsappar letar du upp och väljer SAP.

   3. I fönstret Lägg till en ny hanterad anslutningsapp i rutan SAP-paket klistrar du in URL:en för den .zip fil som har SAP-sammansättningarna. Se återigen till att inkludera SAS-token.

   4. Välj Skapa för att slutföra skapandet av ISE-anslutningsappen.

7. Om din SAP-instans och ISE finns i olika virtuella nätverk måste du även peer-koppla dessa nätverk så att de är anslutna. Granska SNC-kraven för ISE.

8. Hämta IP-adresserna för de SAP-program-, meddelande- och gatewayservrar som du planerar att använda för att ansluta från arbetsflödet. Nätverksnamnmatchning är inte tillgängligt för SAP-anslutningar i en ISE.

9. Hämta portnumren för de SAP-program-, meddelande- och gatewaytjänster som du planerar att använda för att ansluta från arbetsflödet. Lösning av tjänstnamn är inte tillgänglig för SAP-anslutningar i en ISE.

Aktivera säker nätverkskommunikation (SNC)

Förbrukning

För ett förbrukningsarbetsflöde som körs i Azure Logic Apps med flera klientorganisationer kan du aktivera SNC för autentisering, vilket endast gäller när du använder datagatewayen. Innan du börjar kontrollerar du att du uppfyller alla nödvändiga krav och SNC-krav.

1. Öppna logikappen och arbetsflödet för förbrukning i designern i Azure-portalen.

2. Lägg till eller redigera en SAP-hanterad anslutningsåtgärd.

3. I rutan SAP-anslutningsinformation anger du följande information som krävs. Den autentiseringstyp som du väljer ändrar de tillgängliga alternativen.

   

   Kommentar

   Fälten SAP-användarnamn och SAP-lösenord är valfria. Om du inte anger ett användarnamn och lösenord använder anslutningsappen klientcertifikatet som angavs i ett senare steg för autentisering.

4. Om du vill aktivera SNC anger du följande nödvändig information i rutan SAP-anslutningsinformation i stället:

   

   Parameter	Description
   Använda SNC	Markera kryssrutan.
   SNC-bibliotek	Ange något av följande värden: – Namnet på ditt SNC-bibliotek, till exempel sapsnc.dll – Den relativa sökvägen till NCo-installationsplatsen, till exempel .\security\sapsnc.dll – Den absoluta sökvägen till NCo-installationsplatsen, till exempel c:\security\sapsnc.dll
   SNC SSO	Välj antingen Inloggning med hjälp av SNC-identiteten eller Inloggning med användarnamnet/lösenordet som anges på RFC-nivå. Vanligtvis används SNC-identiteten för att autentisera anroparen. Du kan välja att autentisera med ett användarnamn och lösenord i stället, men det här parametervärdet är fortfarande krypterat.
   SNC Mitt namn	I de flesta fall kan du utelämna det här värdet. Den installerade SNC-lösningen känner vanligtvis till sitt eget SNC-namn. Om din lösning stöder flera identiteter kan du behöva ange den identitet som ska användas för det här specifika målet eller servern.
   SNC-partnernamn	Ange namnet på serverdelens SNC, till exempel p:CN=DV3, OU=LA, O=MS, C=US.
   SNC-skydd	Välj vilken tjänstkvalitet som ska användas för SNC-kommunikation med det här specifika målet eller servern. Standardvärdet definieras av serverdelssystemet. Maximivärdet definieras av säkerhetsprodukten som används för SNC.
   SNC-certifikat	Ange den base64-kodade offentliga nyckeln för certifikatet som ska användas för att identifiera klienten till SAP. Obs! – Inkludera inte PEM-sidhuvud eller sidfot. – Ange inte den privata nyckeln för klientcertifikatet här. Din personliga säkerhetsmiljö (PSE) måste innehålla den matchande privata nyckeln för det här certifikatet och kan innehålla andra privata certifikat. Mer information finns i nästa parameter.
   PSE	Ange din SNC Personal Security Environment (PSE) som en base64-kodad binär fil. – Din PSE måste innehålla den privata nyckeln för klientcertifikatet där tumavtrycket matchar den offentliga nyckeln för klientcertifikatet i SNC-certifikatparametern . – Även om din PSE kan innehålla flera klientcertifikat kan du skapa separata arbetsflöden i stället om du vill använda olika klientcertifikat. – Om du använder mer än ett SNC-klientcertifikat för standardlogikappresursen måste du ange samma PSE för alla anslutningar. Din PSE måste innehålla den matchande privata nyckeln för klientcertifikatet för var och en av anslutningarna. Du måste ange SNC-certifikatparametern så att den matchar det specifika privata certifikatet för varje anslutning.

5. Om du vill slutföra skapandet av anslutningen väljer du Skapa.

   Om parametrarna är korrekta skapas anslutningen. Om det uppstår ett problem med parametrarna visas ett felmeddelande i dialogrutan för att skapa anslutningen. Om du vill felsöka problem med anslutningsparametern kan du använda installationen av den lokala datagatewayen och gatewayens lokala loggar.

Standard

För ett Standard-arbetsflöde som körs i Azure Logic Apps med en enda klientorganisation kan du aktivera SNC för autentisering. Innan du börjar kontrollerar du att du uppfyller alla nödvändiga krav och SNC-krav för en enda klientorganisation.

1. Öppna din standardlogikappresurs i Azure-portalen.

2. Följ dessa steg om du vill ange lösenordet för SNC Personal Security Environment (PSE) och PSE:

   1. På resursmenyn för logikappen går du till Inställningar och väljer Miljövariabler.

   2. På fliken Appinställningar kontrollerar du om inställningarna med namnet SAP_PSE och SAP__PSE_Password redan finns. Om de inte finns måste du lägga till varje inställning i slutet av inställningslistan, ange följande nödvändig information och välja Använd för varje inställning:

      Name	Värde	beskrivning
      SAP_PSE	<PSE-värde>	Ange din SNC Personal Security Environment (PSE) som en base64-kodad binär fil. – Din PSE måste innehålla den privata nyckeln för klientcertifikatet där tumavtrycket matchar den offentliga nyckeln för klientcertifikatet i SNC-certifikatparametern . – Även om din PSE kan innehålla flera klientcertifikat kan du skapa separata arbetsflöden i stället om du vill använda olika klientcertifikat. - PSE får inte ha någon PIN-kod. Om det behövs anger du PIN-koden till tom med hjälp av SAPGENPSE-verktyget. – Om du använder mer än ett SNC-klientcertifikat för din ISE måste du ange samma PSE för alla anslutningar. Din PSE måste innehålla den matchande privata nyckeln för klientcertifikatet för var och en av anslutningarna. Du måste ange att SNC-certifikatet ska matcha det specifika privata certifikatet för varje anslutning.
      SAP_PSE_Password	<PSE-lösenord>	Lösenordet, även kallat PIN-kod, för din PSE

3. Skapa eller öppna det arbetsflöde som du vill använda i designern. På resursmenyn för logikappen går du till Arbetsflöden och väljer Arbetsflöden.

4. I designern lägger du till eller redigerar en inbyggd SAP-anslutningsåtgärd.

5. I rutan SAP-anslutningsinformation anger du följande information som krävs. Den autentiseringstyp som du väljer ändrar de tillgängliga alternativen.

   

6. Om du vill aktivera SNC anger du den information som krävs i stället i rutan SAP-anslutningsinformation.

   

   Parameter	Description
   Autentiseringstyp	Välj Logga in med SNC.
   SNC-partnernamn	Ange namnet på serverdelens SNC, till exempel p:CN=DV3, OU=LA, O=MS, C=US.
   SNC-skydd	Välj vilken tjänstkvalitet som ska användas för SNC-kommunikation med det här specifika målet eller servern. Standardvärdet definieras av serverdelssystemet. Maximivärdet definieras av säkerhetsprodukten som används för SNC.
   SNC-typ	Välj den SNC-autentisering som ska användas.
   SNC-certifikat	Ange SNC-klientens offentliga certifikat i base64-kodat format. Obs! – Inkludera inte PEM-sidhuvud eller sidfot. – Ange inte det privata certifikatet här eftersom PSE kan innehålla flera privata certifikat. Den här SNC-certifikatparametern identifierar dock de certifikat som den här anslutningen måste använda.

7. Om du vill slutföra skapandet av anslutningen väljer du Skapa.

ISE

För ett förbrukningsarbetsflöde som körs i en ISE kan du aktivera SNC för autentisering. Innan du börjar kontrollerar du att du uppfyller alla nödvändiga krav och SNC-krav för ISE.

1. Öppna ditt ISE-resurs- och logikapparbetsflöde i designern i Azure-portalen.

2. Lägg till eller redigera en SAP-anslutningsåtgärd med ISE-version . Kontrollera att SAP-anslutningsåtgärden visar ISE-etiketten.

3. I rutan SAP-anslutningsinformation anger du följande information som krävs. Den autentiseringstyp som du väljer ändrar de tillgängliga alternativen.

   

   Kommentar

   Fälten SAP-användarnamn och SAP-lösenord är valfria. Om du inte anger ett användarnamn och lösenord använder anslutningsappen klientcertifikatet som angavs i ett senare steg för autentisering.

4. Om du vill aktivera SNC anger du följande nödvändig information i rutan SAP-anslutningsinformation i stället:

   

   Parameter	Description
   Använda SNC	Markera kryssrutan.
   SNC-bibliotek	Ange namnet på ditt SNC-bibliotek, till exempel sapcrypto.dll.
   SNC-partnernamn	Ange namnet på serverdelens SNC, till exempel p:CN=DV3, OU=LA, O=MS, C=US.
   SNC Mitt namn och SNC-skydd	Valfritt: Ange dessa värden efter behov.
   SNC-certifikat	Ange SNC-klientens offentliga certifikat i base64-kodat format med följande vägledning: – Ta inte med PEM-sidhuvud eller sidfot. – Ange inte det privata certifikatet här eftersom PSE (Personal Security Environment) kan innehålla flera privata certifikat. Den här SNC-certifikatparametern identifierar dock de certifikat som den här anslutningen måste använda. Mer information finns i nästa parameter.
   PSE (personlig säkerhetsmiljö)	Ange din SNC PSE som en base64-kodad binär fil med följande vägledning: – PSE måste innehålla det privata klientcertifikatet där tumavtrycket matchar det offentliga klientcertifikat som du angav i föregående steg. – Även om PSE kan innehålla flera klientcertifikat. om du vill använda olika klientcertifikat skapar du separata arbetsflödesappar i stället. - PSE får inte ha någon PIN-kod. Om det behövs anger du PIN-koden till tom med hjälp av SAPGENPSE-verktyget. – Om du använder mer än ett SNC-klientcertifikat för din ISE måste du ange samma PSE för alla anslutningar. PSE måste innehålla klientens privata certifikat för varje och alla anslutningar. Du måste ange den offentliga certifikatparametern för klienten så att den matchar det specifika privata certifikatet för varje anslutning som används i din ISE.

5. Om du vill slutföra skapandet av anslutningen väljer du Skapa.

   Om parametrarna är korrekta skapas anslutningen. Om det uppstår ett problem med parametrarna visas ett felmeddelande i dialogrutan för att skapa anslutningen. Om du vill felsöka problem med anslutningsparametern kan du använda en lokal datagateway och gatewayens lokala loggar.

Konvertera en binär PSE-fil till base64-kodat format

1. Använd ett PowerShell-skript, till exempel:

   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. Spara skriptet som en pseConvert.ps1-fil och anropa sedan skriptet, till exempel:

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

   Om du inte anger parametern för utdatasökväg innehåller skriptets utdata till konsolen radbrytningar. Ta bort radbrytningarna i den grundläggande 64-kodade strängen för anslutningsindataparametern.

Konfigurera och testa att skicka IDocs till arbetsflödet från SAP

Följ endast de här stegen för att testa DIN SAP-konfiguration med logikappens arbetsflöde. Produktionsmiljöer kräver ytterligare konfiguration.

Om du vill skicka IDocs från SAP till arbetsflödet behöver du följande minsta konfiguration:

1. Skapa ett RFC-mål.
2. Skapa en ABAP-anslutning.
3. Skapa en mottagarport.
4. Skapa en avsändarport.
5. Skapa en logisk systempartner.
6. Skapa en partnerprofil.
7. Testa att skicka meddelanden.

Skapa RFC-mål

Det här målet identifierar logikappens arbetsflöde som mottagarport.

1. Öppna konfigurationen av RFC-Anslut ionsinställningar i SAP. Du kan använda sm59-transaktionskoden (T-Code) med prefixet /n .

2. Välj TCP/IP-Anslut ions>Skapa.

3. Skapa ett nytt RFC-mål med följande inställningar:

   1. För RFC-mål anger du ett namn.

   2. På fliken Teknisk Inställningar väljer du För Aktiveringstyp väljer du Registrerat serverprogram.

   3. För Program-ID anger du ett värde. I SAP-servern registreras arbetsflödets utlösare med hjälp av den här identifieraren.

      Viktigt!

      SAP-program-ID :t är skiftlägeskänsligt. Se till att du konsekvent använder samma skiftlägesformat för program-ID:t när du konfigurerar arbetsflödet och SAP-servern. Annars kan du få följande fel i tRFC Monitor (T-Code SM58) när du försöker skicka en IDoc till SAP:

      • Funktionen IDOC_INBOUND_ASYNCHRONOUS hittades inte
      • Icke-ABAP RFC-klient (partnertyp ) stöds inte

      Mer information från SAP finns i följande anteckningar (inloggning krävs):

      • https://launchpad.support.sap.com/#/notes/2399329
      • https://launchpad.support.sap.com/#/notes/353597

   4. På fliken Unicode väljer du Unicode för Kommunikationstyp med målsystem.

      Kommentar

      SAP .NET-klientbibliotek stöder endast Unicode-teckenkodning. Om du får felet Icke-ABAP RFC-klient (partnertyp) som inte stöds när du skickar en IDoc från SAP till Azure Logic Apps kontrollerar du att värdet Kommunikationstyp med målsystem är inställt på Unicode.

4. Spara dina ändringar.

5. Registrera ditt nya program-ID med Azure Logic Apps genom att skapa ett arbetsflöde för logikappen som börjar med den SAP-hanterade utlösaren med namnet När ett meddelande tas emot.

   På så sätt registrerar Azure Logic Apps program-ID :t på SAP Gateway när du sparar arbetsflödet.

6. I arbetsflödets utlösarhistorik kontrollerar du registreringsstatusen för den lokala datagatewayens SAP-adapterloggar, om tillämpligt, och SAP Gateway-spårningsloggarna.

   I rutan SAP Gateway-övervakare (T-Code SMGW) visas den nya registreringen som registrerad server under Inloggade klienter.

7. Om du vill testa anslutningen väljer du Anslut ionstest under ditt nya RFC-mål.

Skapa ABAP-anslutning

Det här målet identifierar DITT SAP-system som avsändarport.

1. Öppna konfigurationen av RFC-Anslut ionsinställningar i SAP. Du kan använda sm59-transaktionskoden (T-Code) med prefixet /n .

2. Välj ABAP Anslut ions>Skapa.

3. För RFC-mål anger du identifieraren för ditt TEST SAP-system.

4. I Technical Inställningar lämnar du målvärden tom för att skapa en lokal anslutning till SAP-systemet.

5. Spara dina ändringar.

6. Om du vill testa anslutningen väljer du Anslut ionstest.

Skapa mottagarport

1. Öppna inställningarna för portar i IDOC-bearbetning i SAP. Du kan använda we21-transaktionskoden (T-Code) med prefixet /n .

2. Välj Portar>Transaktions-RFC>Skapa.

3. I inställningsrutan som öppnas väljer du eget portnamn. För testporten anger du ett Namn. Spara dina ändringar.

4. I inställningarna för den nya mottagarporten för RFC-målet anger du identifieraren för ditt RFC-testmål.

5. Spara dina ändringar.

Skapa avsändarport

1. Öppna inställningarna för portar i IDOC-bearbetning i SAP. Du kan använda we21-transaktionskoden (T-Code) med prefixet /n .

2. Välj Portar>Transaktions-RFC>Skapa.

3. I inställningsrutan som öppnas väljer du eget portnamn.

4. För testporten anger du ett namn som börjar med SAP. Spara dina ändringar.

   Alla avsändarportnamn måste börja med bokstäverna SAP, till exempel SAPTEST.

5. I inställningarna för den nya avsändarporten för RFC-målet anger du identifieraren för din ABAP-anslutning.

6. Spara dina ändringar.

Skapa en logisk systempartner

1. I SAP öppnar du ändringsvyn "Logiska system": Översiktsinställningar . Du kan använda bd54-transaktionskoden (T-Code).

2. Acceptera följande varningsmeddelande som visas: Varning: Tabellen är korsklient

3. Ovanför listan som visar dina befintliga logiska system väljer du Nya poster.

4. För det nya logiska systemet anger du en Log.System-identifierare och en kort namnbeskrivning . Spara dina ändringar.

5. När Prompt for Workbench visas skapar du en ny begäran genom att ange en beskrivning, eller om du redan har skapat en begäran hoppar du över det här steget.

6. När du har skapat workbench-begäran länkar du den begäran till tabelluppdateringsbegäran. Spara ändringarna för att bekräfta att tabellen har uppdaterats.

Skapa partnerprofiler

För produktionsmiljöer måste du skapa två partnerprofiler. Den första profilen är för avsändaren, som är din organisation och DITT SAP-system. Den andra profilen är för mottagaren, som är logikappens resurs och arbetsflöde.

1. Öppna inställningarna för Partnerprofiler i SAP. Du kan använda we20-transaktionskoden (T-Code) med prefixet /n .

2. Under Partnerprofiler väljer du Partnertyp LS>Skapa.

3. Skapa en ny partnerprofil med följande inställningar:

   Inställning	beskrivning
   Partnernr	Ange din logiska systempartners identifierare.
   Partn. Typ	Ange LS.
   Handläggare	Ange identifieraren för DET SAP-användarkonto som ska användas när du registrerar programidentifierare för Azure Logic Apps eller andra icke-SAP-system.

4. Spara dina ändringar.

   Om du inte har skapat den logiska systempartnern får du felet Ange ett giltigt partnernummer.

5. Välj Skapa utgående parameter under Utgående parmtrs under Utgående parmtrs i partnerprofilens inställningar.

6. Skapa en ny utgående parameter med följande inställningar:

   • Ange din meddelandetyp, till exempel CREMAS.

   • Ange mottagarportens identifierare.

   • Ange en IDoc-storlek för Pack. Storlek. Om du vill skicka IDocs en i taget från SAP väljer du Skicka IDoc omedelbart.

7. Spara dina ändringar.

Testa att skicka meddelanden

1. Öppna inställningarna för testverktyget för IDoc-bearbetning i SAP. Du kan använda we19-transaktionskoden (T-Code) med prefixet /n .

2. Under Mall för test väljer du Via meddelandetyp. Ange din meddelandetyp, till exempel CREMAS. Välj Skapa.

3. Bekräfta meddelandet Vilken IDoc-typ? genom att välja Fortsätt.

4. Välj EDIDC-noden. Ange lämpliga värden för mottagar- och avsändarportarna. Välj Fortsätt.

5. Välj Standard Utgående bearbetning.

6. Om du vill starta utgående IDoc-bearbetning väljer du Fortsätt.

   När verktyget har slutfört bearbetningen visas det IDoc som skickas till SAP-systemet eller ett externt programmeddelande .

7. Om du vill söka efter bearbetningsfel använder du sm58-transaktionskoden (T-Code) med prefixet /n .

Skapa arbetsflöden för vanliga SAP-scenarier

Anvisningar för hur du skapar arbetsflöden för vanliga SAP-integreringsarbetsbelastningar finns i följande steg:

• Ta emot meddelande från SAP
• Ta emot IDoc-paket från SAP
• Skicka IDocs till SAP
• Generera scheman för artefakter i SAP

Skapa arbetsflöden för avancerade SAP-scenarier

• Ändra språkrubriker för att skicka data till SAP
• Bekräfta transaktionen separat och undvik duplicerade IDocs

Hitta utökade felloggar (endast hanterad anslutningsapp)

Om du använder DEN SAP-hanterade anslutningsappen kan du hitta fullständiga felmeddelanden genom att kontrollera SAP-adapterns utökade loggar. Du kan också aktivera en utökad loggfil för SAP-anslutningsappen.

• För lokala datagatewayversioner från april 2020 och tidigare inaktiveras loggarna som standard.

• För lokala datagatewayversioner från juni 2020 och senare kan du aktivera gatewayloggar i appinställningarna.

  • Standardloggningsnivån är Varning.

  • Om du aktiverar Ytterligare loggning i diagnostikinställningarna för den lokala datagatewayappen ökas loggningsnivån till Informational.

  • Om du vill öka loggningsnivån till Utförlig uppdaterar du följande inställning i konfigurationsfilen. Konfigurationsfilen finns vanligtvis på C:\Program Files\On-premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.

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

Konfigurera utökad SAP-loggning i lokal datagateway (endast hanterad anslutningsapp)

Om du använder en lokal datagateway för Azure Logic Apps kan du konfigurera en utökad loggfil för SAP-anslutningsappen. Du kan använda din lokala datagateway för att omdirigera händelsespårning för Windows-händelser (ETW) till roterande loggfiler som ingår i gatewayens loggning .zip filer.

Du kan exportera alla konfigurations- och tjänstloggar för din gateway till en .zip fil från gatewayappens inställningar.

Kommentar

Utökad loggning kan påverka arbetsflödets prestanda när den alltid är aktiverad. Vi rekommenderar att du inaktiverar utökade loggfiler när du är klar med att analysera och felsöka ett problem.

Samla in ETW-händelser

Som en valfri avancerad loggningsuppgift kan du direkt samla in ETW-händelser och sedan använda data i Azure Diagnostics i Event Hubs eller samla in dina data till Azure Monitor-loggar. Mer information finns i metodtipsen för att samla in och lagra data.

Om du vill arbeta med de resulterande ETL-filerna kan du använda PerfView eller skriva ett eget program. Följande genomgång använder PerfView:

1. På PerfView-menyn väljer du Samla in>för att samla in händelserna.

2. I parametern Ytterligare provider anger du *Microsoft-LobAdapter för att ange SAP-providern för att samla in SAP Adapter-händelser. Om du inte anger den här informationen innehåller spårningen endast allmänna ETW-händelser.

3. Behåll de andra standardinställningarna. Om du vill kan du ändra filnamnet eller platsen i parametern Datafil .

4. Välj Starta samling för att påbörja spårningen.

5. När du har återskapat problemet eller samlat in tillräckligt med analysdata väljer du Stoppa insamling.

6. Om du vill dela dina data med en annan part, till exempel Azure-supporttekniker, komprimerar du ETL-filen.

7. Så här visar du innehållet i spårningen:

   1. I PerfView väljer du Öppna fil>och väljer den ETL-fil som du nyss genererade.

   2. I sidofältet PerfView går du till avsnittet Händelser under din ETL-fil.

   3. Under Filtrera filtrerar du Microsoft-LobAdapter efter för att endast visa relevanta händelser och gatewayprocesser.

Testa arbetsflödet

Baserat på om du har ett förbrukningsarbetsflöde i Azure Logic Apps med flera klienter eller ett Standard-arbetsflöde i Azure Logic Apps med en enda klient följer du motsvarande steg:

Förbrukning

1. Om din förbrukningslogikappresurs inte redan är aktiverad väljer du Översikt på logikappmenyn. I verktygsfältet väljer du Aktivera.

2. I designerverktygsfältet väljer du Kör utlösarkörning> för att starta arbetsflödet manuellt.

3. Om du vill utlösa arbetsflödet skickar du ett meddelande från SAP-systemet.

4. Gå tillbaka till logikappens översiktsfönster. Under Körningshistorik hittar du alla nya körningar för arbetsflödet.

5. Öppna den senaste körningen, som visar en manuell körning. Leta upp och granska avsnittet utdata för utlösare.

Standard

1. Om standardlogikappresursen har stoppats eller inaktiverats går du till resursnivån för logikappen från arbetsflödet och väljer Översikt. I verktygsfältet väljer du Start.

2. Återgå till arbetsflödesnivån. På arbetsflödesmenyn väljer du Översikt. I verktygsfältet väljer du Kör>kör för att starta arbetsflödet manuellt.

3. Om du vill utlösa arbetsflödet skickar du ett meddelande från SAP-systemet.

4. Gå tillbaka till arbetsflödets översiktsfönster. Under Körningshistorik hittar du alla nya körningar för arbetsflödet.

5. Öppna den senaste körningen, som visar en manuell körning. Leta upp och granska avsnittet utdata för utlösare.

ISE

Se stegen för SAP-loggning för förbrukningslogikappar i arbetsflöden med flera klientorganisationer.

Aktivera loggning och spårning av SAP-klientbibliotek (NCo) (endast inbyggd anslutningsapp)

När du måste undersöka eventuella problem med den här komponenten kan du konfigurera anpassad textfilbaserad NCo-spårning, som SAP eller Microsoft-supporten kan begära från dig. Som standard är den här funktionen inaktiverad eftersom aktivering av den här spårningen kan påverka prestandan negativt och snabbt förbruka programvärdens lagringsutrymme.

Du kan styra den här spårningsfunktionen på programnivå genom att lägga till följande inställningar:

1. Öppna din standardlogikappresurs i Azure-portalen.

2. På logikappmenyn under Inställningar väljer du Miljövariabler för att granska programinställningarna.

3. Lägg till följande programinställningar på fliken Appinställningar på sidan Miljövariabler:

   • SAP_RFC_TRACE_DIRECTORY: Katalogen där NCo-spårningsfilerna ska lagras, till exempel C:\home\LogFiles\NCo.

   • SAP_RFC_TRACE_LEVEL: NCo-spårningsnivån med Level4 som föreslaget värde för typisk utförlig loggning. SAP- eller Microsoft-supporten kan begära att du anger en annan spårningsnivå.

     Kommentar

     För standardarbetsflöden för logikappar som använder körningsversion 1.69.0 eller senare kan du aktivera loggning för flera spårningsnivåer genom att avgränsa varje spårningsnivå med kommatecken (,).

     Följ dessa steg för att hitta arbetsflödets körningsversion:

     1. I Azure-portalen går du till arbetsflödesmenyn och väljer Översikt.
     2. I avsnittet Essentials hittar du egenskapen Runtime Version .

   • SAP_CPIC_TRACE_LEVEL: Spårningsnivån Common Programming Interface for Communication (CPI-C) med Verbose som föreslaget värde för typisk utförlig loggning. SAP- eller Microsoft-supporten kan begära att du anger en annan spårningsnivå.

   Mer information om hur du lägger till programinställningar finns i Redigera värd- och appinställningar för standardarbetsflöden för logikappar.

4. Spara dina ändringar. Det här steget startar om programmet.

Tillgängliga spårningsnivåer

NCo-spårningsnivåer

Värde	beskrivning
Level1	Nivån för spårning av fjärrfunktionsanrop.
Level2	Nivån för spårning av fjärrfunktionsanrop och offentliga API-metodanrop.
Level3	Nivån för spårning av fjärrfunktionsanrop, offentliga API-metodanrop och interna API-metodanrop.
Level4	Nivån för spårning av fjärrfunktionsanrop, offentliga API-metodanrop, interna API-metodanrop, hexdumpar för RFC-protokollet och nätverksrelaterad information.
Låsning	Skriver data till spårningsfilerna som visar när trådar begär, hämtar och släpper lås på objekt.
Metadata	Spårar metadata som ingår i ett fjärrfunktionsanrop för varje anrop.
Ingen	Nivån för att utelämna alla spårningsutdata.
ParameterData	Spårar containerdata som skickas och tas emot under varje fjärrfunktionsanrop.
Prestanda	Skriver data till spårningsfilerna som kan hjälpa dig att analysera prestandaproblem.
PublicAPI	Spårar de flesta metoder i det offentliga API:et, förutom getters, setters eller relaterade metoder.
InternalAPI	Spårar de flesta metoder i det interna API:et, förutom getters, setters eller relaterade metoder.
RemoteFunctionCall	Spårar fjärrfunktionsanrop.
RfcData	Spårar de byte som skickas och tas emot under varje fjärrfunktionsanrop.
SessionProvider	Spårar alla metoder för den för närvarande använda implementeringen av ISessionProvider.
SetValue	Skriver information till spårningsfilerna om värden som angetts för parametrar för funktioner eller fält i strukturer eller tabeller.

CPIC-spårningsnivåer

Värde	beskrivning
Av	Ingen loggning
Grundläggande	Grundläggande loggning
Utförlig	Utförlig loggning
VerboseWithData	Utförlig loggning med alla serversvarsdumpar

Visa spårningen

1. På resursmenyn standardlogikapp går du till Utvecklingsverktyg och väljer Avancerade verktyg>Gå.

2. I Verktygsfältet Kudu väljer du Felsök konsol-CMD>.

3. Bläddra till mappen för programinställningen med namnet $SAP_RFC_TRACE_DIRECTORY.

   En ny mapp med namnet NCo, eller det mappnamn som du använde, visas för programmets inställningsvärde, C:\home\LogFiles\NCo, som du angav tidigare.

4. Öppna mappen $SAP_RFC_TRACE_DIRECTORY, som innehåller följande :

   • NCo-spårningsloggar: En fil med namnet dev_nco_rfc.log, en eller flera filer med namnet nco_rfc_NNNN.log och en eller flera filer med namnet nco_rfc_NNNN.trc-filer där NNNN är en trådidentifierare.

   • CPIC-spårningsloggar: En eller flera filer med namnet nco_cpic_NNNN.trc-filer där NNNN är trådidentifierare.

5. Om du vill visa innehållet i en logg eller spårningsfil väljer du knappen Redigera bredvid en fil.

   Kommentar

   Om du laddar ned en logg- eller spårningsfil som logikappens arbetsflöde har öppnats och används för närvarande kan nedladdningen resultera i en tom fil.

Aktivera spårning av SAP Common Crypto Library (CCL) (endast inbyggd anslutningsapp)

Om du behöver undersöka eventuella problem med kryptobiblioteket när du använder SNC-autentisering kan du konfigurera anpassad textfilbaserad CCL-spårning. Du kan använda dessa CCL-loggar för att felsöka problem med SNC-autentisering eller dela dem med Microsoft- eller SAP-support om det begärs. Som standard är den här funktionen inaktiverad eftersom aktivering av den här spårningen kan påverka prestandan negativt och snabbt förbruka programvärdens lagringsutrymme.

Du kan styra den här spårningsfunktionen på programnivå genom att lägga till följande inställningar:

1. Öppna din standardlogikappresurs i Azure-portalen.

2. På resursmenyn standardlogikapp går du till Utvecklingsverktyg och väljer Avancerade verktyg>Gå.

3. I Verktygsfältet Kudu väljer du Felsök konsol-CMD>.

4. Bläddra till en plats under C:\home\site\wwwroot och skapa en textfil, till exempel: CCLPROFILE.txt.

   Mer information om loggningsparametrar finns i Spåra> SAP NOTE-2338952. Följande exempel innehåller ett exempel på spårningskonfiguration:

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

5. På logikappmenyn under Inställningar väljer du Miljövariabler för att granska programinställningarna.

6. Lägg till följande programinställning på fliken Appinställningar på sidan Miljövariabler:

   CCL_PROFILE: Katalogen där CCLPROFILE.txt skapades, till exempel C:\home\site\wwwroot\CCLPROFILE.txt.

7. Spara dina ändringar. Det här steget startar om programmet.

Visa spårningen

1. På resursmenyn standardlogikapp går du till Utvecklingsverktyg och väljer Avancerade verktyg>Gå.

2. I Verktygsfältet Kudu väljer du Felsök konsol-CMD>.

3. Bläddra till mappen för parametern $ccl/trace/directory, som kommer från CCLPROFILE.txt-filen.

   Vanligtvis heter spårningsfilerna sec-Microsoft.Azure.Work-$processId.trc och sec-sapgenpse.exe-$processId.trc.

   Arbetsflödet för logikappen utför SNC-autentisering som en tvåstegsprocess:

   1. Arbetsflödet för logikappen anropar sapgenpse.exe för att generera en cred_v2 fil från PSE-filen.

      Du hittar de spårningar som är relaterade till det här steget i en fil med namnet sec-sapgenpse.exe-$processId.trc.

   2. Arbetsflödet för logikappen autentiserar åtkomsten till SAP-servern genom att använda den genererade cred_v2-filen , med SAP-klientbiblioteket som anropar det gemensamma kryptobiblioteket.

      Du hittar spårningarna som är relaterade till det här steget i en fil med namnet sec-Microsoft.Azure.Work-$processId.trc.

Skicka SAP-telemetri för lokal datagateway till Azure Application Insights

Med uppdateringen från augusti 2021 för den lokala datagatewayen kan SAP-anslutningsåtgärder skicka telemetridata från SAP NCo-klientbiblioteket och spårningar från Microsoft SAP Adapter till Application Insights, vilket är en funktion i Azure Monitor. Den här telemetrin innehåller främst följande data:

• Mått och spårningar baserat på SAP NCo-mått och övervakare.

• Spårningar från Microsoft SAP Adapter.

Mått och spårningar från SAP NCo-klientbiblioteket

SAP NCo-baserade mått är numeriska värden som kanske eller kanske inte varierar under en tidsperiod, baserat på användningen och tillgängligheten av resurser på den lokala datagatewayen. Du kan använda dessa mått för att bättre förstå systemets hälsa och skapa aviseringar om följande aktiviteter:

• Systemhälsan minskar.
• Ovanliga händelser.
• Tung systembelastning.

Den här informationen skickas till tabellen Application Insights med namnet customMetrics. Som standard skickas mått med 30 sekunders intervall.

SAP NCo-baserade spårningar innehåller textinformation som används med mått. Den här informationen skickas till tabellen Application Insights med namnet traces. Som standard skickas spårningar med 10 minuters intervall.

SAP NCo-mått och -spårningar baseras på SAP NCo-mått, särskilt följande NCo-klasser:

• RfcDestinationMonitor.
• Rfc Anslut ionMonitor.
• RfcServerMonitor.
• RfcRepositoryMonitor.

Mer information om de mått som varje klass tillhandahåller finns i SAP NCo-dokumentationen (inloggning krävs).

Konfigurera SAP-telemetri för Application Insights

Innan du kan skicka SAP-telemetri för gatewayinstallationen till Application Insights måste du ha skapat och konfigurerat Application Insights-resursen. Mer information finns i följande dokumentation:

• Skapa en Application Insights-resurs (klassisk)

• Arbetsytebaserade Application Insights-resurser

Följ dessa steg för att aktivera sändning av SAP-telemetri till Application Insights:

1. Ladda ned NuGet-paketet för Microsoft.ApplicationInsights.EventSourceListener.dll från den här platsen: https://www.nuget.org/packages/Microsoft.ApplicationInsights.EventSourceListener/2.14.0.

2. Lägg till den nedladdade filen i installationskatalogen för din lokala datagateway, till exempel C:\Program Files\On-Premises Data Gateway.

3. I installationskatalogen för den lokala datagatewayen kontrollerar du att filen Microsoft.ApplicationInsights.dll har samma versionsnummer som den Microsoft.ApplicationInsights.EventSourceListener.dll fil som du lade till. Gatewayen använder för närvarande version 2.14.0.

4. I filen ApplicationInsights.config lägger du till instrumentationsnyckeln för Application Insights genom att avkommentera raden med elementet<InstrumentationKey></InstrumentationKey>. Ersätt platshållaren, your-Application-Insights-instrumentation-key, med din nyckel, till exempel:

   <?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. I filen ApplicationInsights.config kan du ändra det nödvändiga spårningsvärdet Level för dina SAP-anslutningsåtgärder, enligt dina behov, till exempel:

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

   Mer information finns i följande dokumentation:

   • Level values: EventLevel Enum

   • EventSource-spårning

   • EventSource-händelser

6. När du har tillämpat ändringarna startar du om den lokala datagatewaytjänsten.

Granska mått i Application Insights

När SAP-åtgärderna har körts i logikappens arbetsflöde kan du granska telemetrin som skickades till Application Insights.

1. I Azure-portalen öppnar du din Application Insights resurs.

2. På resursmenyn går du till Övervakning och väljer Loggar.

   Följande skärmbild visar Azure-portalen med Application Insights, som är öppen för fönstret Loggar :

   

3. I fönstret Loggar kan du skapa en fråga med hjälp av den Kusto-frågespråk (KQL) som baseras på dina specifika krav.

   Du kan använda ett frågemönster som liknar följande exempelfråga:

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

4. När du har kört frågan granskar du resultatet.

   Följande skärmbild visar exempelfrågans resultattabell för mått:

   

   • MaxUsedCount är "Det maximala antalet klientanslutningar som användes samtidigt av det övervakade målet." enligt beskrivningen i SAP NCo-dokumentationen (inloggning krävs). Du kan använda det här värdet för att förstå antalet samtidiga öppna anslutningar.

   • Kolumnen valueCount visar 2 för varje läsning eftersom mått genereras med 30 sekunders intervall. Application Insights aggregerar dessa mått per minut.

   • Kolumnen DestinationName innehåller en teckensträng som är ett internt microsoft SAP-kortnamn.

     För att bättre förstå det här RFC-målet (Remote Function Call) använder du det här värdet med traces, till exempel:

     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
     

Du kan också skapa måttdiagram eller aviseringar med hjälp av dessa funktioner i Application Insights, till exempel:

Spårningar från Microsoft SAP Adapter

Du kan använda spårningar som skickas från Microsoft SAP Adapter för problem efter analys och för att hitta eventuella befintliga interna systemfel som kanske eller kanske inte dyker upp från SAP-anslutningsåtgärder. Dessa spårningar har message angetts till "n\a" eftersom de kommer från ett tidigare ramverk för händelsekällor som föregår Application Insights, till exempel:

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"

Följande skärmbild visar exempelfrågans resultattabell för spårningar:

Nästa steg

• Skapa exempelarbetsflöden för vanliga SAP-scenarier