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 Pro tier atau 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:
+ Sistem SAP dengan modul yang sesuai diinstal dan dikonfigurasi.
+ Akun pengguna SAP dengan izin dan otorisasi yang diperlukan.
+ Amazon Quick Author atau lebih tinggi.
+ Konektivitas jaringan antara Amazon Quick dan sistem SAP Anda.
## Siapkan konfigurasi dan otentikasi sistem SAP
Sebelum menyiapkan integrasi di Amazon Quick, 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](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html)
#### 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](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm)
### 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 Material 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.
## Menyiapkan 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, pilih **Integrasi.**
1. Pilih salah satu konektor SAP yang tersedia:
+ **Tagihan Material SAP**
+ **SAP Business Partner**
+ **Stok Bahan SAP**
+ **Dokumen Persediaan Fisik SAP**
+ **Master Produk SAP**
1. Klik **Tambah** (ditambah tombol “\$1”).
1. Isi nama dan deskripsi untuk integrasi SAP Anda.
1. Pilih jenis koneksi untuk integrasi Anda.
1. 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
1. **Konfigurasi otentikasi dasar**
Untuk Otentikasi Dasar, berikan:
+ **Username - Nama pengguna** sistem SAP Anda
+ **Kata Sandi - Kata sandi** sistem SAP Anda
+ **URL Domain - URL** titik akhir API sistem SAP
1. Pilih **Buat dan lanjutkan**.
1. Pilih pengguna untuk berbagi integrasi dengan.
1. Klik **Berikutnya**.
### Hasil yang diharapkan
Setelah penyiapan berhasil, integrasi beban kerja SAP Anda muncul di daftar integrasi dan tersedia untuk digunakan di alur kerja Amazon Quick, otomatisasi, dan agen AI. Anda dapat melakukan tindakan khusus SAP langsung dari Amazon Quick 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**
| \$1 | Parameter | Deskripsi | Jenis |
| --- | --- | --- | --- |
| 1 | \$1top | Membatasi jumlah barang yang dikembalikan | integer |
| 2 | \$1skip | Melewatkan jumlah item yang ditentukan | bilangan bulat |
| 3 | \$1filter | Filter hasil berdasarkan kriteria yang ditentukan | string |
| 4 | \$1orderby | Hasil pesanan berdasarkan bidang yang ditentukan | array |
| 5 | \$1select | Memilih properti tertentu untuk kembali | array |
| 6 | \$1expand | Memperluas entitas terkait | array |
| 7 | \$1inlinecount | 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, pilih **Integrasi.**
1. Pilih jenis integrasi beban kerja SAP Anda dari grid integrasi.
1. Pilih integrasi Anda dari daftar dan pilih **Edit**.
1. Ubah pengaturan integrasi:
+ Perbarui kredensi otentikasi (nama pengguna dan kata sandi).
+ Ubah URL sistem SAP atau pengaturan koneksi.
+ Ubah nama atau deskripsi integrasi.
1. 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**.
1. Konfigurasikan opsi berbagi:
+ **Bagikan dengan pengguna tertentu** - Masukkan nama pengguna atau alamat email.
+ **Bagikan dengan organisasi - Sediakan** untuk semua pengguna di organisasi Anda.
1. Tetapkan tingkat izin untuk akses bersama.
1. 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.**
1. Tinjau dampak penghapusan, termasuk alur kerja atau otomatisasi apa pun yang menggunakan integrasi ini.
1. Ketik nama integrasi untuk mengonfirmasi penghapusan.
1. 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 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 (misalnya, 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