Integrasi beban kerja SAP - Amazon Quick Suite
Apa yang dapat Anda lakukanSebelum Anda mulaiSiapkan konfigurasi dan otentikasi sistem SAPSiapkan integrasi SAPOperasi yang tersedia berdasarkan jenis konektorParameter kueriKelola integrasi beban kerja SAPMemecahkan masalah integrasi beban kerja SAP

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Integrasi beban kerja SAP

Dengan integrasi beban kerja SAP, Anda dapat melakukan tindakan dalam berbagai sistem SAP. Mengelola data bisnis, inventaris, bahan, dan proses bisnis. Integrasi ini hanya mendukung eksekusi tindakan dan memerlukan Amazon Quick Suite Pro tier atau yang lebih tinggi.

Apa yang dapat Anda lakukan

Integrasi beban kerja SAP menyediakan konektivitas tingkat perusahaan untuk membantu Anda bekerja dengan sistem SAP Anda.

Konektor aksi

Lakukan tindakan dalam sistem SAP. Membuat, memperbarui, dan mengelola data bisnis, catatan inventaris, informasi material, dan operasi perusahaan lainnya melalui SAP APIs.

Beberapa modul SAP

Support untuk lima jenis integrasi yang berbeda: Bill of Material, Business Partner, Material Stock, Physical Inventory Documents, dan Product Master.

Sebelum Anda mulai

Sebelum Anda mengatur integrasi beban kerja SAP, pastikan Anda memiliki yang berikut ini:

  • Sistem SAP dengan modul yang sesuai diinstal dan dikonfigurasi.

  • Akun pengguna SAP dengan izin dan otorisasi yang diperlukan.

  • Amazon Quick Suite Author atau lebih tinggi.

  • Konektivitas jaringan antara Amazon Quick Suite dan sistem SAP Anda.

Siapkan konfigurasi dan otentikasi sistem SAP

Sebelum menyiapkan integrasi di Amazon Quick Suite, siapkan konfigurasi sistem SAP dan otentikasi pengguna Anda. Integrasi beban kerja SAP mendukung beberapa metode otentikasi dan memerlukan pengaturan sistem yang tepat.

Metode otentikasi

Integrasi beban kerja SAP mendukung dua metode otentikasi:

OAuth 2.0 (Direkomendasikan)

Metode otentikasi aman untuk alur kerja otomatis. Membutuhkan OAuth konfigurasi dalam sistem SAP Anda.

Parameter yang diperlukan:

  • ID Klien - ID OAuth Klien SAP

  • Rahasia Klien - Rahasia OAuth Klien SAP

  • URL Token - titik akhir OAuth token (mis.,https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100)

  • URL Domain - Titik akhir API sistem SAP (mis.,) https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER

Otentikasi Dasar

Otentikasi nama pengguna dan kata sandi untuk akses sistem SAP langsung.

Parameter yang diperlukan:

  • Nama pengguna - nama pengguna sistem SAP

  • Kata sandi - kata sandi sistem SAP

  • URL Domain - Titik akhir API sistem SAP

Persyaratan konfigurasi sistem SAP

Sebelum menggunakan integrasi beban kerja SAP, pastikan sistem SAP Anda dikonfigurasi dengan benar:

OAuth 2.0 pengaturan

Untuk otentikasi OAuth 2.0:

  • Konfigurasikan server OAuth otorisasi dengan cakupan yang sesuai

  • Verifikasi OAuth diaktifkan untuk layanan menggunakan kode transaksi /IWFND/MAINT_SERVICE

  • Lihat dokumentasi SAP untuk konfigurasi OAuth 2.0 terperinci: OAuth 2.0 Configuration Guide

Aktivasi SAP API

Pastikan layanan SAP API yang diperlukan aktif:

  • Aktifkan layanan API khusus untuk konektor SAP pilihan Anda

  • Verifikasi status layanan API di sistem SAP Anda

  • Lihat dokumentasi SAP untuk aktivasi API: Panduan Aktivasi Layanan SAP API

Jenis integrasi beban kerja SAP yang tersedia

Pilih jenis integrasi SAP yang sesuai dengan kebutuhan bisnis Anda dan pastikan modul SAP yang sesuai tersedia di sistem Anda.

Tagihan Bahan SAP

Mengelola data tagihan bahan, termasuk daftar komponen, jumlah, dan spesifikasi manufaktur.

Ruang lingkup yang dibutuhkan: ZAPI_BILL_OF_MATERIAL_SRV_0002

SAP Business Partner

Menangani informasi mitra bisnis, termasuk data pelanggan dan vendor, detail kontak, dan manajemen hubungan.

Ruang lingkup yang dibutuhkan: ZAPI_BUSINESS_PARTNER_0001

Stok Bahan SAP

Akses dan kelola tingkat stok material, pergerakan inventaris, dan informasi gudang.

Ruang lingkup yang dibutuhkan: ZAPI_MATERIAL_STOCK_SRV_0001

Dokumen Persediaan Fisik SAP

Membuat dan mengelola dokumen inventaris fisik, jumlah stok, dan proses rekonsiliasi inventaris.

Ruang lingkup yang dibutuhkan: ZAPI_MATERIAL_STOCK_SRV_0001

Master Produk SAP

Menjaga data master produk, termasuk spesifikasi material, klasifikasi, dan hierarki produk.

Ruang lingkup yang dibutuhkan: ZAPI_PRODUCT_SRV_0001

Pengaturan otentikasi beban kerja SAP

Siapkan kredensi otentikasi pengguna SAP dan pastikan izin akses sistem yang tepat.

  • URL sistem SAP - Dapatkan URL dasar atau alamat server untuk sistem SAP Anda.

  • Kredensi pengguna - Buat atau identifikasi akun pengguna SAP dengan izin yang sesuai.

  • Izin sistem - Pastikan akun pengguna memiliki otorisasi SAP dan kode transaksi yang diperlukan untuk modul SAP tertentu yang Anda rencanakan untuk diintegrasikan.

  • Akses jaringan - Verifikasi bahwa sistem SAP Anda dapat diakses dari koneksi eksternal dan aturan firewall memungkinkan integrasi.

Siapkan integrasi SAP

Setelah menyiapkan konfigurasi sistem SAP dan kredensi otentikasi Anda, proses penyiapannya serupa untuk semua jenis integrasi SAP. Pilih antara OAuth 2.0 atau Otentikasi Dasar berdasarkan persyaratan keamanan Anda.

  1. Di konsol Amazon Quick Suite, pilih Integrasi.

  2. Pilih salah satu konektor SAP yang tersedia:

    • Tagihan Bahan SAP

    • SAP Business Partner

    • Stok Bahan SAP

    • Dokumen Persediaan Fisik SAP

    • Master Produk SAP

  3. Klik Tambah (ditambah tombol “+”).

  4. Isi nama dan deskripsi untuk integrasi SAP Anda.

  5. Pilih jenis koneksi untuk integrasi Anda.

  6. Konfigurasikan otentikasi menggunakan salah satu metode yang didukung:

    1. OAuth 2.0 konfigurasi

      Untuk otentikasi OAuth 2.0, berikan:

      • ID Klien - ID OAuth Klien SAP Anda

      • Rahasia Klien - Rahasia OAuth Klien SAP Anda

      • URL Token - URL titik akhir OAuth token

      • URL Domain - URL titik akhir API sistem SAP

    2. Konfigurasi otentikasi dasar

      Untuk Otentikasi Dasar, berikan:

      • Nama Pengguna - Nama pengguna sistem SAP Anda

      • Kata Sandi - Kata sandi sistem SAP Anda

      • URL Domain - URL titik akhir API sistem SAP

  7. Pilih Buat dan lanjutkan.

  8. Pilih pengguna untuk berbagi integrasi dengan.

  9. Klik Berikutnya.

Hasil yang diharapkan

Setelah penyiapan berhasil, integrasi beban kerja SAP Anda muncul di daftar integrasi dan tersedia untuk digunakan dalam alur kerja, otomasi, dan agen AI Amazon Quick Suite. Anda dapat melakukan tindakan khusus SAP langsung dari Amazon Quick Suite menggunakan kredenal autentikasi yang dikonfigurasi.

Operasi yang tersedia berdasarkan jenis konektor

Setiap konektor beban kerja SAP menyediakan operasi spesifik yang disesuaikan dengan domain bisnisnya. Tinjau operasi yang tersedia untuk jenis konektor yang Anda pilih.

Operasi SAP Bill of Material

Operasi yang tersedia untuk mengelola data tagihan bahan:

  • Dapatkan Material BOM Item - Mengambil detail tagihan materi untuk bahan tertentu

    ID Operasi: getMaterialBOMItem

    Titik akhir: GET /MaterialBOMItem

Operasi SAP Business Partner

Operasi yang tersedia untuk mengelola data mitra bisnis:

  • Dapatkan Mitra Bisnis - Mengambil data umum mitra bisnis

    ID Operasi: getBusinessPartner

  • Dapatkan Alamat Mitra Bisnis - Mengambil data alamat mitra bisnis

    ID Operasi: getBusinessPartnerAddress

  • Dapatkan Peran Mitra Bisnis - Mengambil data peran mitra bisnis

    ID Operasi: getBusinessPartnerRole

  • Dapatkan Mitra Bisnis berdasarkan ID - Mengambil data mitra bisnis dengan nomor mitra bisnis

    ID Operasi: getBusinessPartnerByID

    Parameter yang diperlukan: BusinessPartner (string, maks 10 karakter)

  • Dapatkan Peran Mitra Bisnis berdasarkan ID - Mengambil data peran mitra bisnis menggunakan bidang kunci

    ID Operasi: getBusinessPartnerRoleByID

    Parameter yang diperlukan: BusinessPartner (string, maks 10 karakter), BusinessPartnerRole (string, maks 6 karakter)

Operasi Stok Bahan SAP

Operasi yang tersedia untuk mengelola data stok material:

  • Dapatkan Stok Material Di Akun - Mengambil informasi stok material yang diposting di model akun

    ID Operasi: getMaterialStockInAccount

Operasi Dokumen Inventaris Fisik SAP

Operasi yang tersedia untuk mengelola dokumen inventaris fisik:

  • Dapatkan Item PhysInventory Dokumen - Membaca informasi tentang item inventaris fisik

    ID Operasi: getPhysInventoryDocItem

Operasi Master Produk SAP

Operasi yang tersedia untuk mengelola data master produk:

  • Dapatkan Item Master Produk - Mengembalikan catatan master produk

    ID Operasi: getProductMaster

  • Dapatkan Data Tanaman Berdasarkan Material - Mengembalikan data tanaman dari catatan induk produk

    ID Operasi: getPlantDataByMaterial

    Parameter yang diperlukan: Product (string, maks 40 karakter)

  • Dapatkan Data Perencanaan Pasokan Berdasarkan Material - Mengembalikan data perencanaan pasokan berdasarkan nomor produk dan pabrik

    ID Operasi: getSupplyPlanningDataByMaterial

    Parameter yang diperlukan: Product (string, maks 40 karakter), Plant (string, maks 4 karakter)

Parameter kueri

Konektor SAP mendukung parameter kueri standar untuk memfilter, mengurutkan, dan memformat respons API. Gunakan parameter ini untuk mengoptimalkan pengambilan dan pemrosesan data.

Parameter Kueri yang Didukung
# Parameter Deskripsi Jenis
1 $top Membatasi jumlah barang yang dikembalikan integer
2 $skip Melewatkan jumlah item yang ditentukan bilangan bulat
3 $filter Filter hasil berdasarkan kriteria yang ditentukan string
4 $orderby Hasil pesanan berdasarkan bidang tertentu array
5 $select Memilih properti tertentu untuk kembali array
6 $expand Memperluas entitas terkait array
7 $inlinecount Termasuk jumlah item sebagai tanggapan string

Kelola integrasi beban kerja SAP

Setelah Anda membuat integrasi beban kerja SAP Anda, Anda dapat mengelolanya melalui beberapa opsi.

Edit pengaturan integrasi

Ikuti langkah-langkah ini untuk memodifikasi pengaturan integrasi beban kerja SAP Anda.

  1. Di konsol Amazon Quick Suite, pilih Integrasi.

  2. Pilih jenis integrasi beban kerja SAP Anda dari grid integrasi.

  3. Pilih integrasi Anda dari daftar dan pilih Edit.

  4. Ubah pengaturan integrasi:

    • Perbarui kredensi otentikasi (nama pengguna dan kata sandi).

    • Ubah URL sistem SAP atau pengaturan koneksi.

    • Ubah nama atau deskripsi integrasi.

  5. Pilih Simpan perubahan untuk menerapkan modifikasi Anda.

Integrasi berbagi

Anda dapat berbagi konektor tindakan beban kerja SAP dengan pengguna lain di organisasi Anda.

  1. Dari halaman detail integrasi SAP, pilih Bagikan.

  2. Konfigurasikan opsi berbagi:

    • Bagikan dengan pengguna tertentu - Masukkan nama pengguna atau alamat email.

    • Bagikan dengan organisasi - Sediakan untuk semua pengguna di organisasi Anda.

  3. Tetapkan tingkat izin untuk akses bersama.

  4. Pilih Bagikan integrasi untuk menerapkan pengaturan berbagi.

Hapus integrasi

Ikuti langkah-langkah ini untuk menghapus integrasi SAP Anda secara permanen.

  1. Dari halaman detail integrasi beban kerja SAP, pilih Hapus.

  2. Tinjau dampak penghapusan, termasuk alur kerja atau otomatisasi apa pun yang menggunakan integrasi ini.

  3. Ketik nama integrasi untuk mengonfirmasi penghapusan.

  4. Pilih Hapus integrasi untuk menghapusnya secara permanen.

Memecahkan masalah integrasi beban kerja SAP

Gunakan tips pemecahan masalah ini untuk mengatasi masalah integrasi beban kerja SAP yang umum.

Masalah otentikasi

OAuth 2.0 kegagalan otentikasi

Gejala: Pembuatan token gagal, kredensi klien tidak valid, atau kesalahan cakupan. OAuth

Resolusi:

  • Verifikasi ID OAuth klien dan rahasia klien sudah benar

  • Periksa apakah OAuth dikonfigurasi dengan benar di SAP menggunakan transaksi /IWFND/MAINT_SERVICE

  • Pastikan cakupan yang diperlukan dikonfigurasi dengan benar untuk jenis konektor beban kerja SAP Anda

  • Verifikasi format URL token cocok dengan konfigurasi sistem SAP Anda

Kegagalan otentikasi dasar

Gejala: Kegagalan login, kredensi tidak valid, atau kesalahan akses ditolak.

Resolusi:

  • Verifikasi nama pengguna dan kata sandi SAP sudah benar

  • Periksa apakah akun pengguna memiliki otorisasi SAP yang diperlukan

  • Pastikan akun pengguna tidak terkunci atau kedaluwarsa

  • Verifikasi URL domain dapat diakses dan diformat dengan benar

Masalah konfigurasi sistem SAP

Layanan API tidak diaktifkan

Gejala: Kesalahan layanan tidak tersedia, titik akhir API tidak ditemukan, atau respons HTTP 404.

Resolusi:

  • Verifikasi layanan SAP API yang diperlukan diaktifkan di sistem Anda

  • Periksa status layanan API menggunakan kode transaksi SAP

  • Pastikan layanan API sesuai dengan jenis konektor SAP yang Anda pilih

  • Hubungi administrator SAP Anda untuk mengaktifkan layanan API yang hilang

Batas waktu koneksi

Gejala: Minta batas waktu, kesalahan konektivitas jaringan, atau waktu respons yang lambat.

Resolusi:

  • Periksa apakah URL sistem SAP Anda benar dan dapat diakses

  • Verifikasi konektivitas jaringan memungkinkan koneksi ke sistem SAP

  • Pastikan aturan firewall mengizinkan lalu lintas integrasi

  • Periksa kinerja dan ketersediaan sistem SAP

Kesalahan izin dan otorisasi

Otorisasi SAP tidak mencukupi

Gejala: Kesalahan akses ditolak, pesan otorisasi hilang, atau kegagalan operasi terbatas.

Resolusi:

  • Pastikan pengguna yang diautentikasi telah memerlukan otorisasi SAP untuk modul tertentu

  • Verifikasi bahwa pengguna memiliki akses ke kode transaksi yang diperlukan

  • Periksa apakah akun pengguna memiliki tugas peran yang sesuai

  • Hubungi administrator SAP Anda untuk memberikan izin yang hilang

Kesalahan izin lingkup

Gejala: kesalahan OAuth cakupan, izin yang tidak memadai untuk operasi API, atau pesan akses terbatas.

Resolusi:

  • Verifikasi OAuth konfigurasi mencakup cakupan yang diperlukan untuk jenis konektor Anda

  • Periksa apakah izin ruang lingkup diberikan dengan benar di sistem SAP

  • Pastikan OAuth klien telah diberikan hak akses API yang diperlukan

Format data dan kesalahan parameter

Format parameter tidak valid

Gejala: Kesalahan validasi data, pesan panjang bidang tidak valid, atau pengecualian format parameter.

Resolusi:

  • Tinjau parameter tindakan dan pastikan sesuai dengan format data SAP yang diharapkan

  • Periksa panjang bidang yang cocok dengan persyaratan sistem SAP (mis., BusinessPartner Maks. 10 karakter)

  • Verifikasi tipe data yang benar untuk modul SAP tertentu

  • Pastikan semua bidang yang diperlukan disediakan untuk operasi

Kesalahan parameter kueri

Gejala: Kesalahan sintaks kueri, pesan parameter yang tidak didukung, atau kesalahan permintaan yang salah.

Resolusi:

  • Verifikasi parameter menggunakan sintaks yang benar (misalnya,$filter,$top,$skip)

  • Periksa apakah nilai parameter diformat dengan benar

  • Pastikan SAP API mendukung parameter spesifik yang digunakan

  • Lihat dokumentasi SAP API untuk opsi kueri yang didukung

Masalah ketersediaan sistem SAP

Ketidaktersediaan sistem SAP

Gejala: Kesalahan yang ditolak koneksi, sistem tidak merespons, atau layanan pesan yang tidak tersedia.

Resolusi:

  • Periksa status dan ketersediaan sistem SAP dengan administrator SAP Anda

  • Verifikasi apakah ada jendela pemeliharaan terjadwal yang memengaruhi sistem

  • Periksa peringatan sistem SAP atau masalah yang diketahui

  • Coba lagi operasi setelah mengonfirmasi ketersediaan sistem