Bagikan melalui

Menyambungkan ke SAP dari alur kerja di Azure Logic Apps

  • Artikel

Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)

Panduan cara multibagian ini menunjukkan cara mengakses server SAP Anda dari alur kerja di Azure Logic Apps menggunakan konektor SAP. Anda dapat menggunakan operasi konektor SAP untuk membuat alur kerja otomatis yang berjalan saat dipicu oleh peristiwa di server SAP Anda atau di sistem lain dan menjalankan tindakan untuk mengelola sumber daya di server SAP Anda.

Alur kerja aplikasi logika Standar dan Konsumsi menawarkan konektor terkelola SAP yang dihosting dan dijalankan di Azure multipenyewa. Alur kerja standar juga menawarkan konektor bawaan SAP yang dihosting dan dijalankan di Azure Logic Apps penyewa tunggal. Jika Anda membuat dan menghosting alur kerja Konsumsi di lingkungan layanan integrasi (ISE), Anda juga dapat menggunakan versi asli ISE konektor SAP. Untuk informasi selengkapnya, lihat Referensi teknis konektor.

Kompatibilitas SAP

Konektor SAP kompatibel dengan jenis sistem SAP berikut:

  • Sistem SAP berbasis HANA berbasis lokal dan cloud, seperti S/4 HANA.

  • Sistem SAP lokal klasik, seperti R/3 dan ECC.

SAP harus mendukung versi sistem SAP yang ingin Anda sambungkan. Jika tidak, masalah apa pun yang mungkin Anda temui mungkin tidak dapat diselesaikan. Untuk informasi selengkapnya tentang versi sistem SAP dan informasi pemeliharaan, tinjau SAP Product Availability Matrix (PAM).

Konektor SAP mendukung jenis integrasi data dan pesan berikut dari sistem berbasis SAP NetWeaver:

  • Dokumen Perantara (IDoc)

  • Antarmuka Pemrograman Aplikasi Bisnis (BAPI)

  • Panggilan Fungsi Jarak Jauh (RFC) dan RFC Transaksional (tRFC)

Konektor SAP menggunakan pustaka SAP .NET Connector (NCo).

Untuk menggunakan operasi konektor SAP, Anda harus terlebih dahulu mengautentikasi koneksi Anda dan memiliki opsi berikut:

Anda dapat menggunakan SNC untuk akses menyeluruh (SSO) SAP NetWeaver atau untuk kemampuan keamanan dari produk eksternal. Jika Anda memilih untuk menggunakan SNC, tinjau prasyarat SNC dan prasyarat SNC untuk konektor ISE.

Referensi teknis konektor

Konektor SAP memiliki versi yang berbeda, berdasarkan jenis aplikasi logika dan lingkungan host.

Aplikasi logika Lingkungan Versi konektor
Consumption Azure Logic Apps multipenyewa Konektor terkelola, yang muncul di perancang di bawah label Enterprise . Untuk informasi selengkapnya, tinjau dokumentasi berikut:

- Referensi konektor terkelola SAP
- Konektor terkelola di Azure Logic Apps
Consumption Lingkungan layanan integrasi (ISE) Konektor terkelola, yang muncul di perancang di bawah label Enterprise , dan versi asli ISE, yang muncul di perancang dengan label ISE dan memiliki batas pesan yang berbeda dari konektor terkelola.

Catatan: Pastikan untuk menggunakan versi ISE-native, bukan versi terkelola.

Untuk informasi selengkapnya, tinjau dokumentasi berikut:

- Referensi konektor terkelola SAP
- Batas pesan ISE
- Konektor terkelola di Azure Logic Apps
Standard Azure Logic Apps penyewa tunggal dan Lingkungan App Service v3 (hanya paket Windows) Konektor terkelola, yang muncul di galeri konektor di bawah Runtime>Shared, dan konektor bawaan, yang muncul di galeri konektor di bawah Runtime>In-App dan berbasis penyedia layanan. Konektor bawaan dapat langsung mengakses jaringan virtual Azure dengan string koneksi tanpa gateway data lokal. Untuk informasi selengkapnya, tinjau dokumentasi berikut:

- Referensi konektor terkelola SAP
- Referensi konektor bawaan SAP

- Konektor terkelola di Azure Logic Apps
- Konektor bawaan di Azure Logic Apps

Perbedaan konektor

Konektor bawaan SAP secara signifikan berbeda dari konektor terkelola SAP dan konektor versi ISE SAP dengan cara berikut:

  • Koneksi lokal tidak memerlukan gateway data lokal.

    Sebagai gantinya, konektor bawaan SAP berkomunikasi langsung dengan server SAP Anda di jaringan virtual terintegrasi, yang menghindari hop, latensi, dan titik kegagalan untuk gateway jaringan. Pastikan Anda mengunggah atau menyebarkan pustaka klien SAP yang tidak dapat didistribusikan ulang dengan aplikasi alur kerja aplikasi logika Anda. Untuk informasi selengkapnya, lihat Prasyarat dalam panduan ini.

  • Ukuran payload hingga 100 MB didukung, jadi Anda tidak perlu menggunakan URI blob untuk permintaan besar.

  • Tindakan tertentu tersedia untuk Call BAPI, Call RFC, dan Send IDoc. Tindakan khusus ini memberikan pengalaman yang lebih baik untuk BAPI stateful, transaksi RFC, dan deduplikasi IDoc, dan tidak menggunakan model olahpesan SOAP Windows Communication Foundation (WCF) yang lebih lama.

    Tindakan Panggil BAPI mencakup hingga dua respons dengan JSON yang dikembalikan, respons XML dari BAPI yang disebut, dan respons penerapan BAPI atau putar kembali BAPI juga dan jika Anda menggunakan penerapan otomatis. Kemampuan ini mengatasi masalah dengan konektor terkelola SAP di mana hasil dari penerapan otomatis diam dan diamati hanya melalui log.

  • Batas waktu yang lebih lama pada 5 menit dibandingkan dengan konektor terkelola dan konektor versi ISE.

    Konektor bawaan SAP tidak menggunakan infrastruktur konektor bersama atau global, yang berarti batas waktu lebih lama pada 5 menit dibandingkan dengan konektor terkelola SAP (dua menit) dan konektor versi ISE SAP (empat menit). Permintaan jangka panjang berfungsi tanpa Anda harus menerapkan pola tindakan permintaan berbasis webhook yang berjalan lama.

  • Secara default, operasi konektor bawaan SAP tidak memiliki status. Namun, Anda dapat mengaktifkan mode stateful (afinitas) untuk operasi ini.

    Dalam mode stateful, konektor bawaan SAP mendukung ketersediaan tinggi dan konfigurasi peluasan skala horizontal. Sebagai perbandingan, konektor terkelola SAP memiliki batasan mengenai gateway data lokal terbatas pada satu instans untuk pemicu dan ke kluster hanya dalam mode failover untuk tindakan. Untuk informasi selengkapnya, lihat Konektor terkelola SAP - Masalah dan batasan yang diketahui.

  • Alur kerja aplikasi logika standar memerlukan dan menggunakan pustaka klien SAP NCo 3.1, bukan versi SAP NCo 3.0. Untuk informasi selengkapnya, lihat Prasyarat.

  • Alur kerja aplikasi logika standar menyediakan pengaturan aplikasi tempat Anda dapat menentukan Lingkungan Keamanan Pribadi (PSE) dan kata sandi PSE.

    Perubahan ini mencegah Anda mengunggah beberapa file PSE, yang tidak didukung dan menghasilkan kegagalan koneksi SAP. Dalam alur kerja aplikasi logika Konsumsi, konektor terkelola SAP memungkinkan Anda menentukan nilai-nilai ini melalui parameter koneksi, yang memungkinkan Anda mengunggah beberapa file PSE dan tidak didukung, menyebabkan kegagalan koneksi SAP.

  • Hasilkan tindakan Skema

    • Anda dapat memilih dari beberapa jenis operasi, seperti BAPI, IDoc, RFC, dan tRFC, versus tindakan yang sama dalam konektor terkelola SAP, yang menggunakan parameter SapActionUris dan pengalaman pemilih sistem file.

    • Anda dapat langsung memberikan nama parameter sebagai nilai kustom. Misalnya, Anda dapat menentukan parameter Nama RFC dari tindakan Panggil RFC . Sebagai perbandingan, di konektor terkelola SAP, Anda harus memberikan nama parameter URI Tindakan yang kompleks.

    • Secara desain, tindakan ini tidak mendukung pembuatan beberapa skema untuk RFC, BAPI, atau IDoc dalam eksekusi tindakan tunggal, yang didukung konektor terkelola SAP. Perubahan kemampuan ini sekarang mencegah upaya untuk mengirim konten dalam jumlah besar dalam satu panggilan.

Parameter konektor

Bersama dengan input untai dan angka sederhana, konektor SAP menerima parameter tabel berikut (input Type=ITAB):

  • Parameter arah tabel, baik input maupun output, untuk rilis SAP yang lebih lama.
  • Perubahan parameter, yang menggantikan parameter arah tabel untuk rilis SAP yang lebih baru.
  • Parameter tabel hierarkis.

Masalah dan batasan yang diketahui

Konektor terkelola SAP

  • Konektor SAP saat ini tidak mendukung untai router SAP. Gateway data lokal harus ada di jaringan virtual tempat gateway dapat langsung mencapai sistem SAP yang ingin Anda sambungkan.

  • Secara umum, pemicu SAP tidak mendukung kluster gateway data. Dalam beberapa kasus kegagalan, simpul gateway data yang berkomunikasi dengan sistem SAP mungkin berbeda dari simpul aktif, yang menghasilkan perilaku yang tidak terduga.

    • Untuk skenario kirim pesan, kluster gateway data dalam mode failover didukung.

    • Tindakan SAP stateful tidak mendukung kluster gateway data dalam mode penyeimbangan beban. Komunikasi yang bersifat stateful harus tetap berada pada simpul kluster gateway data yang sama. Gunakan gateway data dalam mode non-kluster atau dalam kluster yang disiapkan hanya untuk failover. Misalnya, tindakan ini mencakup yang berikut ini:

      • Semua tindakan yang menentukan nilai ID Sesi
      • [BAPI] Terapkan transaksi
      • [BAPI] Gulung balik transaksi
      • [BAPI - RFC] Tutup sesi stateful
      • [BAPI - RFC] Buat sesi stateful

  • Dalam tindakan bernama [BAPI] Metode panggilan di SAP, fitur penerapan otomatis tidak akan melakukan perubahan BAPI jika setidaknya ada satu peringatan di objek CallBapiResponse yang dikembalikan oleh tindakan. Untuk menerapkan perubahan BAPI meskipun ada peringatan, ikuti langkah-langkah berikut:

    1. Buat sesi secara eksplisit menggunakan tindakan bernama [BAPI - RFC] Buat sesi stateful.
    2. Dalam tindakan bernama [BAPI] Metode panggilan di SAP, nonaktifkan fitur penerapan otomatis.
    3. Panggil tindakan bernama [BAPI] Terapkan transaksi sebagai gantinya.

Koneksi berbasis IP ke Server Pesan SAP (konfigurasi seimbang beban)

Jika Anda menentukan alamat IP untuk menyambungkan ke Server Pesan SAP, misalnya, load balancer, koneksi mungkin masih gagal dengan pesan kesalahan yang mirip dengan "nama host SAPDBSERVER01.example.com tidak diketahui". Server pesan menginstruksikan konektor SAP untuk menggunakan nama host untuk koneksi ke Server Aplikasi SAP backend, atau server di belakang penyeimbang beban. Jika DNS tidak dapat mengatasi nama host, koneksi gagal.

Untuk masalah ini, solusi atau solusi berikut ada:

  • Pastikan klien membuat koneksi, seperti komputer dengan gateway data lokal untuk konektor SAP atau host konektor ISE untuk konektor SAP berbasis ISE, dapat menyelesaikan nama host yang dikembalikan oleh server pesan.

  • Dalam transaksi bernama RZ11, ubah atau tambahkan pengaturan SAP bernama ms/lg_with_hostname=0.

Konteks atau latar belakang masalah

SAP meningkatkan konektor .NET (NCo) mereka ke versi 3.1, yang mengubah cara konektor meminta koneksi ke server backend dari server pesan. Konektor sekarang menggunakan API baru untuk resolusi server aplikasi oleh server pesan kecuali Anda memaksa konektor untuk menggunakan API sebelumnya melalui pengaturan bernama ms/lg_with_hostname=0'. Untuk informasi selengkapnya, lihat Artikel SAP KB 3305039 - Pengaturan Alamat IP SMLG yang tidak dipertimbangkan selama login Grup Masuk.

Prasyarat

  • Akun dan langganan Azure. Jika Anda belum berlangganan Azure, daftarkan akun Azure secara gratis.

  • Server Aplikasi SAP atau server Pesan SAP yang ingin Anda akses dari Azure Logic Apps.

    • Siapkan server SAP dan akun pengguna Anda untuk mengizinkan penggunaan RFC.

      Untuk informasi selengkapnya, yang mencakup jenis akun pengguna yang didukung dan otorisasi minimum yang diperlukan untuk setiap jenis tindakan (RFC, BAPI, IDoc), tinjau catatan SAP berikut: 460089 - Profil otorisasi minimum untuk program RFC eksternal.

    • Akun pengguna SAP Anda memerlukan akses ke RFC_METADATA grup fungsi dan modul fungsi masing-masing untuk operasi berikut:

      Operasional Akses ke modul fungsi
      Tindakan RFC RFC_GROUP_SEARCH dan DD_LANGU_TO_ISOLA
      Tindakan BAPI BAPI_TRANSACTION_COMMIT, , BAPI_TRANSACTION_ROLLBACKRPY_BOR_TREE_INIT, SWO_QUERY_METHODS, danSWO_QUERY_API_METHODS
      Tindakan IDoc IDOCTYPES_LIST_WITH_MESSAGES, IDOCTYPES_FOR_MESTYPE_READ, INBOUND_IDOCS_FOR_TID, OUTBOUND_IDOCS_FOR_TID, GET_STATUS_FROM_IDOCNR, dan IDOC_RECORD_READ
      Membaca tindakan tabel SAP Baik RFC BBP_RFC_READ_TABLE atau RFC_READ_TABLE
      Memberikan akses minimum yang ketat ke server SAP untuk koneksi SAP Anda RFC_METADATA_GET dan RFC_METADATA_GET_TIMESTAMP

  • Alur kerja aplikasi logika dari tempat Anda ingin mengakses server SAP Anda.

    • Untuk alur kerja Konsumsi di Azure Logic Apps multipenyewa, lihat Prasyarat multipenyewa.

    • Untuk alur kerja Standar di Azure Logic Apps penyewa tunggal, lihat Prasyarat penyewa tunggal.

    • Untuk alur kerja Konsumsi di lingkungan layanan integrasi tingkat Premium (ISE), lihat prasyarat ISE.

      Catatan

      Saat Anda menggunakan ISE tingkat Premium, gunakan konektor SAP asli ISE, bukan konektor terkelola SAP, yang tidak dijalankan secara asli dalam ISE. Untuk informasi selengkapnya, tinjau prasyarat ISE.

  • Secara default, operasi konektor bawaan SAP tidak memiliki status. Untuk menjalankan operasi ini dalam mode stateful, lihat Mengaktifkan mode stateful untuk konektor bawaan stateless.

  • Untuk menggunakan pemicu konektor terkelola atau bawaan SAP bernama Saat pesan diterima, selesaikan tugas berikut:

    • Siapkan izin keamanan gateway SAP Anda atau menemukan Daftar Microsoft Azure Access Control (ACL). Dalam kotak dialog Gateway Monitor (T-Code SMGW), yang memperlihatkan file secinfo dan reginfo, buka menu Goto, dan pilih Pemeliharaan Keamanan>Eksternal Fungsi>Ahli file ACL.

      Pengaturan izin berikut diperlukan:

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

      garis Ini memiliki format berikut:

      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>

      Jika Anda tidak mengonfigurasi izin keamanan gateway SAP, Anda mungkin menerima kesalahan berikut:

      Pendaftaran tp Microsoft.PowerBI.EnterpriseGateway dari <host-name> tidak diizinkan

      Untuk informasi lainnya, tinjau Catatan SAP 1850230 - GW:”Pendaftaran tp <ID program> tidak diizinkan”.

    • Siapkan pengelogan keamanan gateway SAP Anda untuk membantu menemukan masalah Daftar Microsoft Azure Access Control (ACL). Untuk informasi selengkapnya, tinjau topik bantuan SAP untuk menyiapkan pengelogan gateway.

    • Di Konfigurasi Koneksi RFC kotak dialog (T-Code SM59), buat koneksi RFC dengan tipe TCP/IP. Pastikan bahwa Tipe Aktivasi diatur ke Program Server Terdaftar. Ubah nilai koneksi RFC Tipe komunikasi dengan Sistem Target ke Unicode.

    • Jika Anda menggunalan pemicu SAP ini dengan Format IDOC parameter ubah ke FlatFile bersama dengan tindakan Dekode Flat File, anda harus menggunakan properti early_terminate_optional_fields di skema flat file anda dengan mengubah nilainya menjadi true.

      Persyaratan ini diperlukan karena rekaman data IDoc file datar yang dikirim oleh SAP pada panggilan tRFC IDOC_INBOUND_ASYNCHRONOUS tidak ditambahkan ke panjang bidang SDATA penuh. Azure Logic Apps menyediakan data asli IDoc file datar tanpa padding seperti yang diterima dari SAP. Selain itu, ketika Anda menggabungkan pemicu SAP ini dengan tindakan Dekode File Datar, skema yang disediakan untuk tindakan harus cocok.

    Catatan

    Dalam alur kerja Konsumsi dan Standar, pemicu terkelola SAP bernama Saat pesan diterima menggunakan lokasi URI yang sama untuk memperbarui dan berhenti berlangganan dari langganan webhook. Operasi perpanjangan menggunakan metode HTTP PATCH, sementara operasi berhenti berlangganan menggunakan metode HTTP DELETE. Perilaku ini mungkin membuat operasi perpanjangan muncul sebagai operasi berhenti berlangganan dalam riwayat pemicu Anda, tetapi operasi masih merupakan pembaruan karena pemicu menggunakan PATCH sebagai metode HTTP, bukan DELETE.

    Di Alur kerja Standar, pemicu bawaan SAP bernama Saat pesan diterima menggunakan pemicu Azure Functions sebagai gantinya, dan hanya menampilkan panggilan balik aktual dari SAP.

    • WEBSITE_PRIVATE_IP: Atur nilai variabel lingkungan ini ke 127.0.0.1 sebagai alamat localhost.
    • WEBSITE_PRIVATE_PORTS: Atur nilai variabel lingkungan ini ke dua port gratis dan dapat digunakan di komputer lokal Anda, memisahkan nilai dengan koma (,), misalnya, 8080.8088.

  • Konten pesan yang akan dikirim ke server SAP Anda, seperti contoh file IDoc. Konten ini harus dalam format XML dan menyertakan namespace tindakan SAP yang ingin Anda gunakan. Anda dapat mengirim IDocs dengan skema file datar dengan membungkusnya dalam amplop XML.

Prasyarat konektivitas jaringan

Sistem SAP memerlukan konektivitas jaringan dari host pustaka SAP .NET Connector (NCo):

  • Untuk alur kerja aplikasi logika Konsumsi di Azure Logic Apps multipenyewa, gateway data lokal menghosting pustaka Konektor SAP .NET (NCo). Jika Anda menggunakan kluster gateway data lokal, semua kluster node memerlukan konektivitas jaringan ke sistem SAP.

  • Untuk alur kerja aplikasi logika Standar di Azure Logic Apps penyewa tunggal, sumber daya aplikasi logika menghosting pustaka Konektor SAP .NET (NCo). Jadi, sumber daya aplikasi logika itu sendiri harus mengaktifkan integrasi jaringan virtual, dan jaringan virtual tersebut harus memiliki konektivitas jaringan ke sistem SAP.

  • Untuk alur kerja aplikasi logika Konsumsi di ISE, jaringan virtual ISE menghosting pustaka Konektor SAP .NET (NCo).

Konektivitas jaringan yang diperlukan sistem SAP mencakup server dan layanan berikut:

  • Server Aplikasi SAP, layanan Dispatcher (untuk semua jenis Logon)

    Sistem SAP Anda dapat menyertakan beberapa Server Aplikasi SAP. Host pustaka SAP .NET Connector (NCo) memerlukan akses ke setiap server dan layanannya.

  • Server Pesan SAP, Layanan pesan (untuk Grup jenis Logon)

    Server Pesan dan layanan akan dialihkan ke satu atau lebih layanan Dispatcher Server Aplikasi. Host pustaka SAP .NET Connector (NCo) memerlukan akses ke setiap server dan layanannya.

  • SAP Gateway Server, layanan Gateway

  • SAP Gateway Server, layanan aman Gateway

    Konektivitas jaringan yang diperlukan sistem SAP juga mencakup server dan layanan ini untuk digunakan dengan Secure Network Communications (SNC).

Pengalihan permintaan dari Server Aplikasi, layanan Dispatcher ke Server Gateway, layanan Gateway secara otomatis terjadi dalam pustaka Konektor SAP .NET (NCo). Pengalihan ini terjadi bahkan jika hanya Server Aplikasi, informasi layanan Dispatcher yang disediakan dalam parameter koneksi.

Jika Anda menggunakan load balancer di depan sistem SAP, Anda harus mengalihkan semua layanan ke server masing-masing. Untuk informasi lebih lanjut tentang layanan dan port SAP, tinjau Port TCP/IP dari Semua Produk SAP.

Catatan

Pastikan Anda mengaktifkan konektivitas jaringan dari host pustaka Konektor SAP .NET (NCo) dan port yang diperlukan terbuka pada firewall dan grup keamanan jaringan. Jika tidak, Anda mendapatkan kesalahan seperti mitra yang tidak tercapai dari komponen NI (antarmuka jaringan) dan teks kesalahan seperti WSAECONNREFUSED: Koneksi ditolak.

Prasyarat pustaka klien SAP NCo

Untuk menggunakan konektor SAP, Anda harus menginstal pustaka klien SAP Connector NCo untuk Microsoft .NET 3.1. Daftar berikut menjelaskan prasyarat untuk pustaka klien SAP NCo, berdasarkan alur kerja tempat Anda menggunakan konektor SAP:

  • Versi:

  • Dari folder penginstalan default pustaka klien, salin file assembly (.dll) ke lokasi lain, berdasarkan skenario Anda sebagai berikut. Atau, secara opsional, jika Anda hanya menggunakan konektor terkelola SAP, saat Anda menginstal pustaka klien SAP NCo, pilih Pendaftaran Cache Rakitan Global. Arsip zip ISE dan konektor bawaan SAP saat ini tidak mendukung pendaftaran GAC.

    • Untuk alur kerja Konsumsi yang berjalan di Azure Logic Apps multipenyewa dan menggunakan gateway data lokal Anda, salin file assembly (.dll) berikut ke folder penginstalan gateway data lokal, misalnya, C:\Program Files\On-Premises Data Gateway. Pustaka klien SAP NCo 3.0 berisi rakitan berikut:

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

      Pastikan Anda menyalin file rakitan ke folder penginstalan gateway data. Jika tidak, koneksi SAP Anda mungkin gagal dengan pesan kesalahan, Silakan periksa info dan/atau izin akun Anda dan coba lagi. Anda dapat memecahkan masalah lebih lanjut menggunakan penampil log pengikatan assembly .NET. Alat ini memungkinkan Anda memeriksa bahwa file assembly Anda berada di lokasi yang benar.

    • Untuk alur kerja Standar, salin file assembly (.dll) berikut ke lokasi tempat Anda dapat mengunggahnya ke sumber daya aplikasi logika atau proyek tempat Anda membangun alur kerja, baik di portal Azure atau secara lokal di Visual Studio Code. Pustaka klien SAP NCo 3.1 mencakup rakitan berikut:

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

    • Untuk alur kerja Konsumsi dalam ISE, ikuti prasyarat ISE sebagai gantinya.

Hubungan berikut ada antara pustaka klien SAP NCo, .NET Framework, runtime .NET, dan gateway data:

  • Adapter Microsoft SAP dan layanan host gateway keduanya menggunakan .NET Framework 4.7.2.

  • SAP NCo untuk .NET Framework 4.0 bekerja dengan proses yang menggunakan runtime bahasa umum .NET 4.0 hingga 4.8.

  • SAP NCo untuk .NET Framework 2.0 bekerja dengan proses yang menggunakan runtime bahasa umum .NET 2.0 hingga 3.5, tetapi tidak lagi bekerja dengan gateway terbaru.

Prasyarat SNC

Untuk alur kerja Konsumsi di Azure Logic Apps multipenyewa yang menggunakan gateway data lokal, dan secara opsional SNC, Anda juga harus mengonfigurasi pengaturan berikut.

  • Pastikan versi pustaka SNC Anda dan dependensinya kompatibel dengan lingkungan SAP Anda. Untuk memecahkan masalah kompatibilitas pustaka, Anda bisa menggunakan gateway data lokal dan log gateway data Anda.

  • Pastikan Anda menyalin file assembly (.dll) berikut di pustaka klien SAP NCo 3.0 ke folder penginstalan gateway data lokal, misalnya, C:\Program Files\On-Premises Data Gateway.

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

  • Untuk utilitas SAPGENPSE, Anda harus secara khusus menggunakan sapgenpse.exe.

  • Jika Anda menyediakan Lingkungan Keamanan Pribadi (PSE) dengan koneksi Anda, Anda tidak perlu menyalin dan menyiapkan PSE dan SECUDIR untuk gateway data lokal Anda.

  • Jika Anda mengaktifkan SNC melalui produk keamanan eksternal, seperti sapseculib, Kerberos, atau NTLM, pastikan bahwa pustaka SNC ada di komputer yang sama dengan penginstalan gateway data Anda. Untuk tugas ini, salin file biner pustaka SNC ke folder yang sama dengan penginstalan gateway data di komputer lokal Anda, misalnya, C:\Program Files\On-Premises Data Gateway.

    Catatan

    Di komputer dengan penginstalan gateway data dan pustaka SNC, jangan atur variabel lingkungan untuk SNC_LIB dan SNC_LIB_64. Jika tidak, variabel ini lebih diutamakan daripada nilai pustaka SNC yang diteruskan melalui konektor.

  • Untuk menggunakan SNC dengan akses menyeluruh (SSO), pastikan layanan gateway data berjalan sebagai pengguna yang dipetakan ke pengguna SAP. Untuk mengubah akun default untuk akun layanan gateway, pilih Ubah akun, dan masukkan kredensial pengguna.

    Cuplikan layar yang memperlihatkan penginstal gateway data lokal dan halaman Pengaturan Layanan dengan tombol untuk mengubah akun layanan gateway dipilih.

Untuk informasi selengkapnya tentang mengaktifkan SNC, tinjau Aktifkan Komunikasi Jaringan Aman (SNC).

Prasyarat lingkungan Azure Logic Apps

Untuk alur kerja Konsumsi di Azure Logic Apps multipenyewa, konektor terkelola SAP terintegrasi dengan sistem SAP melalui gateway data lokal. Misalnya, dalam skenario di mana alur kerja Anda mengirim pesan ke sistem SAP, gateway data bertindak sebagai klien RFC dan meneruskan permintaan yang diterima dari alur kerja Anda ke SAP. Demikian juga, dalam skenario di mana alur kerja Anda menerima pesan dari SAP, gateway data bertindak sebagai server RFC yang menerima permintaan dari SAP dan meneruskannya ke alur kerja Anda.

  1. Pada komputer host atau komputer virtual yang ada di jaringan virtual yang sama dengan sistem SAP tempat Anda menyambungkan, mengunduh, dan menginstal gateway data lokal.

    Gateway data membantu Anda mengakses data dan sumber daya lokal dengan aman. Pastikan untuk menggunakan versi gateway yang didukung. Jika Anda mengalami masalah dengan gateway Anda, coba tingkatkan ke versi terbaru, yang mungkin menyertakan pembaruan untuk mengatasi masalah Anda.

  2. Di portal Azure, buat sumber daya gateway Azure untuk penginstalan gateway data lokal Anda.

  3. Pada komputer lokal yang sama dengan penginstalan gateway data lokal Anda, unduh dan instal pustaka klien SAP NCo terbaru.

  4. Untuk komputer host dengan penginstalan gateway data lokal Anda, konfigurasikan nama host jaringan dan resolusi nama layanan.

    • Untuk menggunakan nama host atau nama layanan untuk koneksi dari Azure Logic Apps, Anda harus menyiapkan resolusi nama untuk setiap server Aplikasi, Pesan, dan Gateway SAP bersama dengan layanan mereka:

      • Di file %windir%\System32\drivers\etc\hosts atau di server DNS yang tersedia untuk komputer host untuk penginstalan gateway data lokal Anda, siapkan resolusi nama host jaringan.

      • Dalam file %windir%\System32\drivers\etc\services, siapkan resolusi nama layanan.

    • Jika Anda tidak bermaksud menggunakan nama host jaringan atau nama layanan untuk koneksi, Anda dapat menggunakan alamat IP host dan nomor port layanan sebagai gantinya.

    • Jika Anda tidak memiliki entri DNS untuk sistem SAP Anda, contoh berikut menunjukkan entri sampel untuk file host:

      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

      Daftar berikut ini memperlihatkan sekumpulan entri sampel untuk file layanan:

      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

Mengaktifkan Komunikasi Jaringan Aman (SNC)

Untuk alur kerja Konsumsi yang berjalan di Azure Logic Apps multipenyewa, Anda dapat mengaktifkan SNC untuk autentikasi, yang hanya berlaku saat Anda menggunakan gateway data. Sebelum memulai, pastikan Anda memenuhi semua prasyarat dan prasyarat SNC yang diperlukan.

  1. Di portal Azure, buka aplikasi logika Konsumsi dan alur kerja Anda di perancang.

  2. Menambahkan atau mengedit operasi konektor terkelola SAP.

  3. Dalam kotak informasi koneksi SAP, berikan informasi yang diperlukan berikut ini. Jenis Autentikasi yang Anda pilih mengubah opsi yang tersedia.

    Cuplikan layar memperlihatkan pengaturan koneksi SAP untuk Konsumsi.

    Catatan

    Bidang Nama Pengguna SAP dan Kata Sandi SAP bersifat opsional. Jika Anda tidak memberikan nama pengguna dan kata sandi, konektor menggunakan sertifikat klien yang disediakan dalam langkah selanjutnya untuk autentikasi.

  4. Untuk mengaktifkan SNC, dalam kotak informasi koneksi SAP, berikan informasi yang diperlukan berikut:

    Cuplikan layar memperlihatkan pengaturan koneksi SAP untuk SNC diaktifkan untuk Konsumsi.

    Parameter Deskripsi
    Menggunakan SNC Pilih kotak centang.
    Pustaka SNC Masukkan salah satu nilai berikut:

    - Nama untuk pustaka SNC Anda, misalnya, sapsnc.dll
    - Jalur relatif ke lokasi penginstalan NCo, misalnya, .\security\sapsnc.dll
    - Jalur absolut ke lokasi penginstalan NCo, misalnya, c:\security\sapsnc.dll
    Akses menyeluruh SNC Pilih Masuk menggunakan identitas SNC atau Masuk dengan nama pengguna/kata sandi yang disediakan pada tingkat RFC.

    Biasanya, identitas SNC digunakan untuk mengautentikasi pemanggil. Anda dapat memilih untuk mengautentikasi dengan nama pengguna dan kata sandi sebagai gantinya, tetapi nilai parameter ini masih dienkripsi.
    SNC Nama Saya Dalam kebanyakan kasus, Anda dapat menghilangkan nilai ini. Solusi SNC yang terpasang biasanya tahu nama SNC-nya sendiri. Dalam kasus di mana solusi Anda mendukung beberapa identitas, Anda mungkin harus menentukan identitas yang akan digunakan untuk tujuan atau server tertentu ini.
    Nama mitra SNC Masukkan nama untuk backend SNC, misalnya, p:CN=DV3, OU=LA, O=MS, C=US.
    Kualitas Perlindungan SNC Pilih kualitas layanan yang akan digunakan untuk komunikasi SNC dengan tujuan atau server tertentu ini. Nilai default ditentukan oleh sistem backend. Nilai maksimum ditentukan oleh produk keamanan yang digunakan untuk SNC.
    Sertifikat SNC Masukkan kunci publik yang dikodekan base64 agar sertifikat dapat digunakan untuk mengidentifikasi klien Anda ke SAP.

    Catatan: - Jangan sertakan header atau footer PEM.

    - Jangan masukkan kunci privat untuk sertifikat klien di sini. Lingkungan Keamanan Pribadi (PSE) Anda harus berisi kunci privat yang cocok untuk sertifikat ini dan mungkin berisi sertifikat privat lainnya. Untuk informasi selengkapnya, tinjau parameter berikutnya.
    PSE Masukkan SNC Personal Security Environment (PSE) Anda sebagai biner yang dikodekan base64.

    - PSE Anda harus berisi kunci privat untuk sertifikat klien di mana thumbprint cocok dengan kunci publik untuk sertifikat klien dalam parameter Sertifikat SNC.

    - Meskipun PSE Anda mungkin berisi beberapa sertifikat klien, untuk menggunakan sertifikat klien yang berbeda, buat alur kerja terpisah sebagai gantinya.

    - Jika Anda menggunakan lebih dari satu sertifikat klien SNC untuk sumber daya aplikasi logika Standar, Anda harus menyediakan PSE yang sama untuk semua koneksi. PSE Anda harus berisi kunci privat yang cocok untuk sertifikat klien untuk masing-masing dan semua koneksi. Anda harus mengatur parameter Sertifikat SNC agar sesuai dengan sertifikat privat tertentu untuk setiap koneksi.

  5. Untuk menyelesaikan pembuatan koneksi Anda, pilih Buat.

    Jika parameternya benar, koneksi akan dibuat. Jika ada masalah dengan parameter, dialog pembuatan koneksi menampilkan pesan kesalahan. Untuk memecahkan masalah parameter koneksi, Anda dapat menggunakan penginstalan gateway data lokal dan log lokal gateway.

Mengonversi file PSE biner menjadi format yang dikodekan base64

  1. Gunakan skrip PowerShell, misalnya:

    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. Simpan skrip sebagai file pseConvert.ps1 , lalu panggil skrip, misalnya:

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

    Jika Anda tidak menyediakan parameter jalur output, output skrip ke konsol berisi jeda baris. Hapus hentian baris di string dasar yang dikodekan 64 untuk parameter input koneksi.

Menyiapkan dan menguji pengiriman IDocs ke alur kerja Anda dari SAP

Ikuti langkah-langkah ini hanya untuk menguji konfigurasi SAP Anda dengan alur kerja aplikasi logika Anda. Lingkungan produksi memerlukan konfigurasi tambahan.

Untuk mengirim IDocs dari SAP ke alur kerja, Anda memerlukan konfigurasi minimum berikut:

  1. Buat tujuan RFC.
  2. Membuat koneksi ABAP.
  3. Membuat port penerima.
  4. Membuat port pengirim.
  5. Membuat mitra sistem logis.
  6. Membuat profil mitra.
  7. Menguji pengiriman pesan.

Membuat tujuan RFC

Tujuan ini mengidentifikasi alur kerja aplikasi logika Anda sebagai port penerima.

  1. Di SAP, buka Konfigurasi pengaturan Koneksi RFC. Anda dapat menggunakan kode transaksi sm59 (T-Code) dengan awalan /n .

  2. Pilih Sambungan TCP/IP>Buat.

  3. Buat tujuan RFC baru dengan pengaturan berikut:

    1. Untuk Tujuan RFC, masukkan nama.

    2. Pada tab Pengaturan Teknis, untuk Jenis Aktivasi, pilih Program Server Terdaftar.

    3. Untuk ID Program, masukkan nilai. Di server SAP Anda, pemicu alur kerja Anda terdaftar menggunakan pengidentifikasi ini.

      Penting

      ID Program SAP peka huruf besar/kecil. Pastikan Anda secara konsisten menggunakan format kasus yang sama untuk ID Program saat mengonfigurasi alur kerja dan server SAP. Jika tidak, Anda mungkin menerima kesalahan berikut di Monitor tRFC (T-Code SM58) ketika Anda mencoba mengirim IDoc ke SAP:

      • Fungsi IDOC_INBOUND_ASYNCHRONOUS tidak ditemukan
      • Klien RFC non-ABAP (jenis mitra ) tidak didukung

      Untuk informasi selengkapnya dari SAP, tinjau catatan berikut (login diperlukan):

    4. Pada tab Unicode, untuk Jenis Komunikasi dengan Sistem Target, pilih Unicode.

      Catatan

      Pustaka KLIEN SAP .NET hanya mendukung pengkodean karakter Unicode. Jika Anda mendapatkan kesalahan Klien RFC Non-ABAP (jenis mitra) tidak didukung saat Anda mengirim IDoc dari SAP ke Azure Logic Apps, periksa apakah nilai Jenis Komunikasi dengan Sistem Target diatur ke Unicode.

  4. Simpan perubahan Anda.

  5. Daftarkan ID Program baru Anda dengan Azure Logic Apps dengan membuat alur kerja aplikasi logika yang dimulai dengan pemicu terkelola SAP bernama Saat pesan diterima.

    Dengan demikian, saat Anda menyimpan alur kerja, Azure Logic Apps mendaftarkan ID Program di Gateway SAP.

  6. Dalam riwayat pemicu alur kerja Anda, log Adaptor SAP gateway data lokal, jika berlaku, dan log pelacakan SAP Gateway, periksa status pendaftaran.

    Dalam kotak monitor Gateway SAP (T-Code SMGW), di bawah Klien Masuk, pendaftaran baru muncul sebagai Server Terdaftar.

  7. Untuk menguji koneksi Anda, di bawah Tujuan RFC baru Anda, pilih Uji Koneksi.

Membuat sambungan ABAP

Tujuan ini mengidentifikasi sistem SAP Anda sebagai port pengirim.

  1. Di SAP, buka Konfigurasi pengaturan Koneksi RFC. Anda dapat menggunakan kode transaksi sm59 (T-Code) dengan awalan /n .

  2. Pilih Sambungan ABAP>Buat.

  3. Untuk Tujuan RFC, masukkan pengidentifikasi untuk sistem SAP pengujian Anda.

  4. Di Pengaturan Teknis, biarkan host target kosong untuk membuat koneksi lokal ke sistem SAP.

  5. Simpan perubahan Anda.

  6. Untuk menguji koneksi Anda, pilih Uji Sambungan.

Membuat port penerima

  1. Di SAP, buka pengaturan pemrosesan Port di IDOC. Anda dapat menggunakan kode transaksi we21 (T-Code) dengan awalan /n .

  2. Pilih Port>RFC Transaksional>Buat.

  3. Dalam kotak pengaturan yang terbuka, pilih nama port sendiri. Untuk port pengujian Anda, masukkan Nama. Simpan perubahan Anda.

  4. Di pengaturan untuk port penerima baru Anda, untuk Tujuan RFC, masukkan pengidentifikasi untuk tujuan RFC pengujian Anda.

  5. Simpan perubahan Anda.

Membuat port pengirim

  1. Di SAP, buka pengaturan pemrosesan Port di IDOC. Anda dapat menggunakan kode transaksi we21 (T-Code) dengan awalan /n .

  2. Pilih Port>RFC Transaksional>Buat.

  3. Dalam kotak pengaturan yang terbuka, pilih nama port sendiri.

  4. Untuk port pengujian Anda, masukkan Nama yang dimulai dengan SAP. Simpan perubahan Anda.

    Semua nama port pengirim harus dimulai dengan huruf SAP, misalnya, SAPTEST.

  5. Di pengaturan untuk port pengirim baru Anda, untuk tujuan RFC, masukkan pengidentifikasi untuk Sambungan ABAP Anda.

  6. Simpan perubahan Anda.

Membuat mitra sistem logis

  1. Di SAP, buka Tampilan Perubahan "Sistem Logis": Pengaturan gambaran umum . Anda dapat menggunakan kode transaksi bd54 (T-Code).

  2. Terima pesan peringatan berikut yang muncul: Perhatian: Tabel adalah lintas klien

  3. Di atas daftar yang menampilkan sistem logika Anda yang sudah ada, pilih Entri Baru.

  4. Untuk sistem logika baru Anda, masukkan pengidentifikasi Log.System dan deskripsi Nama singkat. Simpan perubahan Anda.

  5. Saat pemberitahuan Meminta Workbench muncul, buat permintaan baru dengan memberikan deskripsi, atau jika Anda sudah membuat permintaan, lewati langkah ini.

  6. Setelah Anda membuat permintaan workbench, tautkan permintaan tersebut ke permintaan pembaruan tabel. Untuk mengonfirmasi bahwa tabel Anda telah diperbarui, simpan perubahan Anda.

Membuat profil mitra

Untuk lingkungan produksi, Anda harus membuat dua profil mitra. Profil pertama adalah untuk pengirim, yaitu organisasi dan sistem SAP Anda. Profil kedua adalah untuk penerima, yang merupakan sumber daya dan alur kerja aplikasi logika Anda.

  1. Di SAP, buka pengaturan Profil mitra. Anda dapat menggunakan kode transaksi we20 (T-Code) dengan awalan /n .

  2. Di bawah Profil Mitra, pilih Jenis Mitra LS>Buat.

  3. Buat profil mitra baru dengan pengaturan berikut:

    Pengaturan Deskripsi
    Mitra No. Masukkan pengidentifikasi mitra sistem logis Anda.
    Bagian. Jenis Masukkan LS.
    Agen Masukkan pengidentifikasi untuk akun pengguna SAP yang akan digunakan saat Anda mendaftarkan pengidentifikasi program untuk Azure Logic Apps atau sistem non-SAP lainnya.

  4. Simpan perubahan Anda.

    Jika Anda belum membuat mitra sistem logis, Anda mendapatkan kesalahan, Masukkan nomor mitra yang valid.

  5. Di pengaturan profil mitra Anda, di bawah Parameter keluar, pilih Buat parameter keluar.

  6. Buat parameter keluar baru dengan pengaturan berikut:

  7. Simpan perubahan Anda.

Menguji pengiriman pesan

  1. Di SAP, buka Alat Pengujian untuk pengaturan Pemrosesan IDoc. Anda dapat menggunakan kode transaksi we19 (T-Code) dengan awalan /n .

  2. Di bawah Templat untuk pengujian, pilih Melalui jenis pesan. Masukkan jenis pesan Anda, misalnya, CREMAS. Pilih Buat.

  3. Konfirmasi pesan Jenis IDoc apa? dengan memilih Lanjutkan.

  4. Pilih simpul EDIDC. Masukkan nilai yang sesuai untuk port penerima dan pengirim Anda. Pilih Lanjutkan.

  5. Pilih Pemrosesan Keluar Standar.

  6. Untuk memulai pemrosesan IDoc keluar, pilih Lanjutkan.

    Ketika alat selesai diproses, IDoc yang dikirim ke sistem SAP atau pesan program eksternal muncul.

  7. Untuk memeriksa kesalahan pemrosesan, gunakan kode transaksi (T-Code) sm58 dengan awalan /n.

Membuat alur kerja untuk skenario SAP umum

Untuk panduan cara membuat alur kerja untuk beban kerja integrasi SAP umum, lihat langkah-langkah berikut:

Membuat alur kerja untuk skenario SAP tingkat lanjut

Menemukan log kesalahan yang diperluas (Konektor terkelola saja)

Jika Anda menggunakan konektor terkelola SAP, Anda dapat menemukan pesan kesalahan penuh dengan memeriksa log diperluas Adapter SAP Anda. Anda juga dapat mengaktifkan file log diperluas untuk konektor SAP.

  • Untuk rilis gateway data lokal mulai April 2020 dan yang lebih lama, log dinonaktifkan secara default.

  • Untuk rilis gateway data lokal mulai Juni 2020 dan yang lebih baru, Anda dapat mengaktifkan log gateway di pengaturan aplikasi.

    • Tingkat pengelogan default adalah Peringatan.

    • Jika Anda mengaktifkan Pencatatan log tambahan di pengaturan Diagnostik aplikasi gateway data lokal, tingkat pencatatan akan ditingkatkan menjadi Informasi.

    • Untuk meningkatkan tingkat pengelogan ke Verbose, perbarui pengaturan berikut dalam file konfigurasi Anda. Biasanya, file konfigurasi terletak di C:\Program Files\On-premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.

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

Menyiapkan pengelogan SAP yang diperluas di gateway data lokal (Hanya konektor terkelola)

Jika Anda menggunakan gateway data lokal untuk Azure Logic Apps, Anda dapat mengonfigurasi file log diperluas untuk konektor SAP. Anda bisa menggunakan gateway data lokal Anda untuk mengalihkan peristiwa Pelacak Peristiwa untuk Windows (ETW) ke file log berputar yang disertakan dalam file log .zip gateway Anda.

Anda dapat mengekspor semua log konfigurasi dan layanan gateway ke file .zip dari pengaturan aplikasi gateway.

Catatan

Pengelogan yang diperluas mungkin memengaruhi performa alur kerja Anda saat selalu diaktifkan. Merupakan praktik terbaik, untuk menonaktifkan file log yang diperluas setelah Anda selesai menganalisis dan memecahkan masalah.

Menangkap peristiwa ETW

Sebagai tugas pengelogan lanjutan opsional, Anda dapat langsung mengambil peristiwa ETW, lalu menggunakan data di Azure Diagnostics di Azure Event Hubs atau mengumpulkan data Anda ke Log Azure Monitor. Untuk informasi selengkapnya, tinjau praktik terbaik untuk mengumpulkan dan menyimpan data.

Untuk bekerja dengan file ETL yang dihasilkan, Anda dapat menggunakan PerfView, atau Anda dapat menulis program Anda sendiri. Panduan berikut menggunakan PerfView:

  1. Di menu PerfView, pilih Kumpulkan>Kumpulkan untuk mengambil peristiwa.

  2. Dalam parameter Penyedia Tambahan, masukkan *Microsoft-LobAdapter untuk menentukan penyedia SAP untuk mengambil peristiwa Adapter SAP. Jika Anda tidak menentukan informasi ini, pelacakan Anda hanya menyertakan peristiwa umum ETW.

  3. Pertahankan pengaturan default lainnya. Jika mau, Anda dapat mengubah nama file atau lokasi di parameter File Data.

  4. Pilih Mulai Koleksi untuk memulai pelacakan Anda.

  5. Setelah Anda mereproduksi masalah Anda atau mengumpulkan data analisis yang cukup, pilih Hentikan Koleksi.

  6. Untuk berbagi data Anda dengan pihak lain, seperti teknisi dukungan Azure, kompres file ETL.

  7. Untuk melihat konten jejak Anda:

    1. Di PerfView, pilih File>Open dan pilih file ETL yang baru saja Anda buat.

    2. Di bar samping PerfView, bagian Peristiwa di bawah file ETL Anda.

    3. Di bawah Filter, filter menurut Microsoft-LobAdapter untuk hanya menampilkan peristiwa dan proses gateway yang relevan.

Menguji alur kerja

Berdasarkan apakah Anda memiliki alur kerja Konsumsi di Azure Logic Apps multipenyewa atau alur kerja Standar di Azure Logic Apps penyewa tunggal, ikuti langkah-langkah yang sesuai:

  1. Jika sumber daya aplikasi logika Konsumsi Anda belum diaktifkan, pada menu aplikasi logika Anda, pilih Gambaran Umum. Pada bar alat, pilih Aktifkan.

  2. Pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>untuk memulai alur kerja Anda secara manual.

  3. Untuk memicu alur kerja Anda, kirim pesan dari sistem SAP Anda.

  4. Kembali ke panel Gambaran Umum aplikasi logika Anda. Di bawah Riwayat eksekusi, temukan eksekusi baru untuk alur kerja Anda.

  5. Buka eksekusi terbaru, yang menunjukkan eksekusi manual. Temukan dan tinjau bagian output pemicu.

Mengaktifkan pengelogan dan pelacakan pustaka klien SAP (NCo) (hanya konektor bawaan)

Ketika Anda harus menyelidiki masalah apa pun dengan komponen ini, Anda dapat menyiapkan pelacakan NCo berbasis file teks kustom, yang mungkin diminta dukungan SAP atau Microsoft dari Anda. Secara default, kemampuan ini dinonaktifkan karena mengaktifkan jejak ini mungkin berdampak negatif pada performa dan dengan cepat menggunakan ruang penyimpanan host aplikasi.

Anda dapat mengontrol kemampuan pelacakan ini di tingkat aplikasi dengan menambahkan pengaturan berikut:

  1. Di portal Azure, buka sumber daya aplikasi logika Standard Anda.

  2. Pada menu aplikasi logika, di bawah Pengaturan, pilih Variabel lingkungan untuk meninjau pengaturan aplikasi.

  3. Pada halaman Variabel lingkungan , pada tab Pengaturan aplikasi, tambahkan pengaturan aplikasi berikut:

    • SAP_RFC_TRACE_DIRECTORY: Direktori tempat menyimpan file pelacakan NCo, misalnya, C:\home\LogFiles\NCo.

    • SAP_RFC_TRACE_LEVEL: Tingkat pelacakan NCo dengan Level4 sebagai nilai yang disarankan untuk pengelogan verbose biasa. Dukungan SAP atau Microsoft mungkin meminta Anda mengatur tingkat pelacakan yang berbeda.

      Catatan

      Untuk alur kerja aplikasi logika Standar yang menggunakan runtime versi 1.69.0 atau yang lebih baru, Anda dapat mengaktifkan pengelogan untuk beberapa tingkat pelacakan dengan memisahkan setiap tingkat pelacakan dengan koma (,).

      Untuk menemukan versi runtime alur kerja Anda, ikuti langkah-langkah berikut:

      1. Di portal Azure, pada menu alur kerja Anda, pilih Gambaran Umum.
      2. Di bagian Esensial , temukan properti Versi Runtime.

    • SAP_CPIC_TRACE_LEVEL: Tingkat pelacakan Common Programming Interface for Communication (CPI-C) dengan Verbose sebagai nilai yang disarankan untuk pengelogan verbose biasa. Dukungan SAP atau Microsoft mungkin meminta Anda mengatur tingkat pelacakan yang berbeda.

    Untuk informasi selengkapnya tentang menambahkan pengaturan aplikasi, lihat Mengedit pengaturan host dan aplikasi untuk alur kerja aplikasi logika Standar.

  4. Simpan perubahan Anda. Langkah ini memulai ulang aplikasi.

Tingkat pelacakan tersedia

Tingkat Pelacakan NCo

Nilai Deskripsi
Level1 Tingkat untuk melacak panggilan fungsi jarak jauh.
Level2 Tingkat untuk melacak panggilan fungsi jarak jauh dan panggilan metode API publik.
Level3 Tingkat untuk melacak panggilan fungsi jarak jauh, panggilan metode API publik, dan panggilan metode API internal.
Level4 Tingkat untuk melacak panggilan fungsi jarak jauh, panggilan metode API publik, panggilan metode API internal, cadangan hex untuk protokol RFC, dan informasi terkait jaringan.
Penguncian Menulis data ke file pelacakan yang menunjukkan kapan utas meminta, memperoleh, dan melepaskan kunci pada objek.
Metadata Melacak metadata yang terlibat dalam panggilan fungsi jarak jauh untuk setiap panggilan.
Tidak Tingkat untuk menekan semua output jejak.
ParameterData Melacak data kontainer yang dikirim dan diterima selama setiap panggilan fungsi jarak jauh.
Performa Menulis data ke file pelacakan yang dapat membantu menganalisis masalah performa.
PublicAPI Melacak sebagian besar metode API publik, kecuali untuk getter, setter, atau metode terkait.
InternalAPI Melacak sebagian besar metode API internal, kecuali untuk getter, setter, atau metode terkait.
RemoteFunctionCall Melacak panggilan fungsi jarak jauh.
RfcData Melacak byte yang dikirim dan diterima selama setiap panggilan fungsi jarak jauh.
SessionProvider Melacak semua metode implementasi ISessionProvider yang saat ini digunakan.
SetValue Menulis informasi ke file pelacakan mengenai nilai yang ditetapkan untuk parameter fungsi, atau bidang struktur atau tabel.

Tingkat Pelacakan CPIC

Nilai Deskripsi
Nonaktif Tidak ada pengelogan
Dasar Pengelogan dasar
Verbose Pengelogan verbose
VerboseWithData Pengelogan verbose dengan semua cadangan respons server

Menampilkan jejak

  1. Pada menu sumber daya aplikasi logika standar, di bawah Alat Pengembangan, pilih Advanced Tools>Go.

  2. Pada toolbar Kudu, pilih Debug Console>CMD.

  3. Telusuri ke folder untuk pengaturan aplikasi bernama $SAP_RFC_TRACE_DIRECTORY.

    Folder baru bernama NCo, atau nama folder apa pun yang Anda gunakan, muncul untuk nilai pengaturan aplikasi, C:\home\LogFiles\NCo, yang Anda tetapkan sebelumnya.

  4. Buka folder $SAP_RFC_TRACE_DIRECTORY, yang berisi berikut ini :

    • Log pelacakan NCo: File bernama dev_nco_rfc.log, satu atau beberapa file bernama nco_rfc_NNNN.log, dan satu atau beberapa file bernama file nco_rfc_NNNN.trc di mana NNNN adalah pengidentifikasi utas.

    • Log pelacakan CPIC: Satu atau beberapa file bernama nco_cpic_NNNN.trc di mana NNNN adalah pengidentifikasi utas.

  5. Untuk melihat konten dalam file log atau pelacakan, pilih tombol Edit di samping file.

    Catatan

    Jika Anda mengunduh file log atau pelacakan yang dibuka alur kerja aplikasi logika anda dan saat ini sedang digunakan, unduhan Anda mungkin mengakibatkan file kosong.

Mengaktifkan pelacakan SAP Common Crypto Library (CCL) (hanya konektor bawaan)

Jika Anda harus menyelidiki masalah dengan pustaka kripto saat menggunakan autentikasi SNC, Anda dapat menyiapkan pelacakan CCL berbasis file teks kustom. Anda dapat menggunakan log CCL ini untuk memecahkan masalah autentikasi SNC, atau membagikannya dengan dukungan Microsoft atau SAP, jika diminta. Secara default, kemampuan ini dinonaktifkan karena mengaktifkan jejak ini mungkin berdampak negatif pada performa dan dengan cepat menggunakan ruang penyimpanan host aplikasi.

Anda dapat mengontrol kemampuan pelacakan ini di tingkat aplikasi dengan menambahkan pengaturan berikut:

  1. Di portal Azure, buka sumber daya aplikasi logika Standard Anda.

  2. Pada menu sumber daya aplikasi logika standar, di bawah Alat Pengembangan, pilih Advanced Tools>Go.

  3. Pada toolbar Kudu, pilih Debug Console>CMD.

  4. Telusuri ke lokasi di bawah C:\home\site\wwwroot, dan buat file teks, misalnya: CCLPROFILE.txt.

    Untuk informasi selengkapnya tentang parameter pengelogan, lihat Melacak> SAP NOTE 2338952. Sampel berikut menyediakan contoh konfigurasi pelacakan:

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

  5. Pada menu aplikasi logika, di bawah Pengaturan, pilih Variabel lingkungan untuk meninjau pengaturan aplikasi.

  6. Pada halaman Variabel lingkungan , pada tab Pengaturan aplikasi, tambahkan pengaturan aplikasi berikut:

    CCL_PROFILE: Direktori tempat CCLPROFILE.txt dibuat, misalnya, C:\home\site\wwwroot\CCLPROFILE.txt.

  7. Simpan perubahan Anda. Langkah ini memulai ulang aplikasi.

Menampilkan jejak

  1. Pada menu sumber daya aplikasi logika standar, di bawah Alat Pengembangan, pilih Advanced Tools>Go.

  2. Pada toolbar Kudu, pilih Debug Console>CMD.

  3. Telusuri ke folder untuk parameter $ccl/trace/directory , yang berasal dari file CCLPROFILE.txt .

    Biasanya, file jejak diberi nama sec-Microsoft.Azure.Work-$processId.trc dan sec-sapgenpse.exe-$processId.trc.

    Alur kerja aplikasi logika Anda melakukan autentikasi SNC sebagai proses dua langkah:

    1. Alur kerja aplikasi logika Anda memanggil sapgenpse.exe untuk menghasilkan file cred_v2 dari file PSE.

      Anda dapat menemukan jejak yang terkait dengan langkah ini dalam file bernama sec-sapgenpse.exe-$processId.trc.

    2. Alur kerja aplikasi logika Anda mengautentikasi akses ke server SAP Anda dengan menggunakan file cred_v2 yang dihasilkan, dengan pustaka klien SAP memanggil pustaka kripto umum.

      Anda dapat menemukan jejak yang terkait dengan langkah ini dalam file bernama sec-Microsoft.Azure.Work-$processId.trc.

Kirim telemetri SAP untuk gateway data lokal ke Azure Application Insights

Dengan pembaruan Agustus 2021 untuk gateway data lokal, operasi konektor SAP dapat mengirim data telemetri dari pustaka klien SAP NCo dan jejak dari Microsoft SAP Adapter ke Application Insights, yang merupakan kemampuan di Azure Monitor. Telemetri ini terutama mencakup data berikut:

  • Metrik dan jejak berdasarkan metrik dan monitor SAP NCo.

  • Jejak dari Adapter SAP Microsoft.

Metrik dan jejak dari pustaka klien SAP NCo

Metrik berbasis SAP NCo adalah nilai numerik yang mungkin atau mungkin tidak bervariasi selama periode waktu tertentu, berdasarkan penggunaan dan ketersediaan sumber daya di gateway data lokal. Anda dapat menggunakan metrik ini untuk lebih memahami kesehatan sistem dan untuk membuat peringatan tentang kegiatan berikut:

  • Kesehatan sistem menurun.
  • Peristiwa yang tidak biasa.
  • Beban sistem berat.

Informasi ini dikirim ke tabel Application Insights bernama customMetrics. Secara default, metrik dikirim pada interval 30 detik.

Jejak berbasis SAP NCo menyertakan informasi teks yang digunakan dengan metrik. Informasi ini dikirim ke tabel Application Insights bernama traces. Secara default, jejak dikirim pada interval 10 menit.

Metrik dan jejak SAP NCo didasarkan pada metrik SAP NCo, khususnya kelas NCo berikut:

  • RfcDestinationMonitor.
  • RfcConnectionMonitor.
  • RfcServerMonitor.
  • RfcRepositoryMonitor.

Untuk informasi selengkapnya tentang metrik yang disediakan setiap kelas, lihat dokumentasi SAP NCo (diperlukan masuk).

Menyiapkan telemetri SAP untuk Application Insights

Sebelum Anda dapat mengirim telemetri SAP untuk penginstalan gateway Anda ke Application Insights, Anda harus membuat dan menyiapkan sumber daya Application Insights Anda. Untuk informasi selengkapnya, tinjau dokumentasi berikut ini:

Untuk mengaktifkan pengiriman telemetri SAP ke insight Aplikasi, ikuti langkah-langkah berikut:

  1. Unduh paket NuGet untuk Microsoft.ApplicationInsights.EventSourceListener.dll dari lokasi ini: https://www.nuget.org/packages/Microsoft.ApplicationInsights.EventSourceListener/2.14.0.

  2. Tambahkan file yang diunduh ke direktori penginstalan gateway data lokal Anda, misalnya, C:\Program Files\On-Premises Data Gateway.

  3. Di direktori penginstalan gateway data lokal Anda, periksa apakah file Microsoft.ApplicationInsights.dll memiliki nomor versi yang sama dengan file Microsoft.ApplicationInsights.EventSourceListener.dll yang Anda tambahkan. Gateway saat ini menggunakan versi 2.14.0.

  4. Dalam file ApplicationInsights.config, tambahkan kunci instrumentasi Application Insights Anda dengan membatalkan penguraian baris dengan elemen <InstrumentationKey></InstrumentationKey>. Ganti tempat penampung, your-Application-Insights-instrumentation-key, dengan kunci Anda, misalnya:

    <?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. Dalam file ApplicationInsights.config, Anda dapat mengubah nilai jejak yang diperlukan Level untuk operasi konektor SAP Anda, sesuai kebutuhan Anda, misalnya:

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

    Untuk informasi selengkapnya, tinjau dokumentasi berikut ini:

  6. Setelah Anda menerapkan perubahan, hidupkan ulang layanan gateway data lokal.

Meninjau metrik di Application Insights

Setelah operasi SAP berjalan di alur kerja aplikasi logika Anda, Anda dapat meninjau telemetri yang dikirim ke Application Insights.

  1. Di portal Microsoft Azure, buka sumber daya Application Insights Anda.

  2. Pada menu sumber daya, di bawah Pemantauan, pilih Log.

    Cuplikan layar berikut memperlihatkan portal Microsoft Azure dengan Application Insights yang terbuka ke panel Log:

    Cuplikan layar memperlihatkan portal Azure dengan Application Insights terbuka ke panel

  3. Pada panel Log, Anda dapat membuat kueri menggunakan Bahasa Kueri Kusto (KQL) yang didasarkan pada persyaratan khusus Anda.

    Anda dapat menggunakan pola kueri yang mirip dengan kueri contoh berikut:

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

  4. Setelah Anda menjalankan kueri, tinjau hasilnya.

    Cuplikan layar berikut memperlihatkan tabel hasil metrik kueri contoh:

    Cuplikan layar memperlihatkan Application Insights dengan tabel hasil metrik.

    • MaxUsedCount adalah "Jumlah maksimal koneksi klien yang digunakan secara bersamaan oleh tujuan yang dipantau". seperti yang dijelaskan dalam dokumentasi SAP NCo (perlu masuk). Anda dapat menggunakan nilai ini untuk memahami jumlah koneksi yang terbuka secara bersamaan.

    • Kolom valueCount menunjukkan 2 untuk setiap pembacaan karena metrik dihasilkan pada interval 30 detik. Application Insights menggabungkan metrik ini per menit.

    • Kolom DestinationName berisi string karakter yang merupakan nama internal Adapter SAP Microsoft.

      Untuk lebih memahami tujuan Panggilan Fungsi Jarak Jauh (RFC) ini, gunakan nilai ini dengan traces, misalnya:

      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

Anda juga dapat membuat bagan metrik atau peringatan menggunakan kemampuan tersebut di Application Insights, misalnya:

Cuplikan layar memperlihatkan Application Insights dengan hasil dalam format bagan.

Jejak dari Adapter SAP Microsoft

Anda dapat menggunakan jejak yang dikirim dari Adapter SAP Microsoft untuk mengeluarkan pasca-analisis dan untuk menemukan kesalahan sistem internal yang ada yang mungkin atau mungkin tidak muncul dari operasi konektor SAP. Jejak ini memiliki message yang diatur ke "n\a" karena jejak tersebut berasal dari kerangka sumber peristiwa sebelumnya yang mendahului Application Insights, misalnya:

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"

Cuplikan layar berikut memperlihatkan tabel hasil jejak kueri contoh:

Cuplikan layar memperlihatkan Application Insights dengan tabel hasil jejak.

Langkah berikutnya