Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan CRM sebelumnya dengan integrasi Amazon S3
**penting**
AWS Partner Central berhenti menerima permintaan baru untuk jenis integrasi ini pada tahun 2024. Bagian ini hanya berlaku untuk mitra yang menggunakan Amazon S3.
Untuk memulai integrasi CRM kustom baru, lihat [AWS Partner Central API Reference](https://docs.aws.amazon.com/partner-central/latest/APIReference/aws-partner-central-api-reference-guide.html).
**Topics**
+ [Memutakhirkan dari CRM dengan integrasi Amazon S3 ke API Pusat Mitra](upgrade-crm-api.md)
+ [Mengkonfigurasi konektor untuk CRM dengan integrasi Amazon S3](s3-config.md)
+ [Sumber daya integrasi](resources.md)
+ [Berbagi memimpin](custom-lead-sharing.md)
+ [Berbagi kesempatan](custom-opportunity-sharing.md)
+ [Pemetaan lapangan](custom-field-mapping.md)
+ [Membuat jadwal sinkronisasi](crm-connector-scheduling.md)
+ [Praktik terbaik](best-practices.md)
+ [Kuota](quotas.md)
+ [Riwayat versi](version-history.md)
+ [FAQs](faqs.md)
# Memutakhirkan dari CRM dengan integrasi Amazon S3 ke API Pusat Mitra
**catatan**
Topik di bagian ini mengasumsikan Anda telah menyelesaikan prasyarat untuk integrasi AWS Partner Central, integrasi AWS Marketplace, atau keduanya. Untuk informasi lebih lanjut, lihat [Prasyarat integrasi](crm-integration-setting-up.md) dan [Memulai](crm-integration-getting-started.md) sebelumnya dalam panduan ini.
Langkah-langkah di bagian berikut menjelaskan cara meningkatkan dari CRM sebelumnya dengan integrasi Amazon S3 ke AWS Partner Central API. Upgrade menghilangkan kebutuhan untuk beberapa persyaratan ACE, seperti kebutuhan untuk pengguna integrasi, dan kebutuhan untuk mengatur jadwal sinkronisasi.
**Topics**
+ [Tingkatkan fitur](api-upgrade-features.md)
+ [Siapkan kredensial bernama](set-up-api-credentials.md)
+ [Tambahkan tombol Status Persetujuan ke halaman Rekaman Petir Peluang](add-approval-status-button.md)
+ [Tambahkan tombol yang tersisa](add-remaining-buttons.md)
+ [Segarkan tab Penawaran Solusi](refresh-the-solutions-from-the-solution-offerings-tab.md)
# Tingkatkan fitur
Upgrade menyediakan fitur-fitur berikut:
+ Anda tidak lagi memerlukan izin pengguna integrasi ACE yang disetel di Salesforce.
+ Anda tidak perlu lagi membuat jadwal untuk peluang ACE di Salesforce.
+ Partner Central API juga menyediakan serangkaian tombol yang memungkinkan tindakan berikut pada halaman **Rekaman Petir Peluang** Anda:
+ **Status Persetujuan** — Terima atau tolak Peluang yang AWS Dirujuk.
**catatan**
Tombol ini menggantikan daftar **Status Penerimaan Mitra**. Anda harus menggunakan tombol untuk menerima peluang AWS-originated.
+ **Bagikan dengan AWS** - Buat dan perbarui peluang.
+ **Associate atau Disassociate** — Mengaitkan atau memisahkan peluang dengan Solusi Mitra, AWS produk, dan AWS Marketplace penawaran sepanjang siklus hidup peluang.
+ **Tetapkan - Tetapkan** kembali peluang ke pengguna lain di akun Partner Central Anda.
Anda menambahkan tombol setelah Anda mengatur kredensi bernama. Topik berikut menjelaskan cara menyelesaikan tugas-tugas tersebut.
# Siapkan kredensial bernama
Untuk memutakhirkan ke API Pusat Mitra, Anda terlebih dahulu menyiapkan kredensi bernama. Konektor CRM menggunakan kredensi organisasi Salesforce Anda untuk mengautentikasi dengan Partner Central.
**Untuk mengatur kredensil**
1. Masuk ke Salesforce sebagai administrator sistem.
1. Di bawah **Kredensial bernama**, pilih **Baru** lebih awal.
1. Dalam bentuk **kredensi baru bernama**, masukkan nilai dari tabel berikut.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/set-up-api-credentials.html)
1. Pilih **Simpan**.
1. Kembali ke halaman **Pengaturan AWS terpandu**. Di bagian **Detail otentikasi**, pilih **Tinjau** dan konfirmasikan kredensialnya.
# Tambahkan tombol Status Persetujuan ke halaman Rekaman Petir Peluang
Langkah-langkah berikut menjelaskan cara menambahkan tombol **Status Persetujuan ke halaman Rekaman** Petir Opporuntiy Anda. Tombol ini memungkinkan Anda untuk melihat status peluang Anda saat mereka melalui proses persetujuan.
**Untuk menambahkan tombol**
1. Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
1. Arahkan ke halaman **Opportunity Lightning Record**.
1. Pilih panel yang disorot untuk membuka panel properti.
1. Pilih **Upgrade sekarang**.
1. Pilih **Migrasikan tindakan yang ada**, lalu pilih tata letak halaman tempat Anda ingin memutakhirkan tindakan.
—ATAU—
Mulai dari awal dan tambahkan tindakan secara manual.
1. Dari daftar **Tindakan**, pilih **Status Persetujuan**.
1. Pilih **Simpan**.
**catatan**
Anda hanya perlu menyelesaikan langkah 4 dan 5 sekali.
Tombol **status Persetujuan** hanya muncul di halaman **Catatan Petir Peluang** untuk peluang AWS yang dirujuk.
# Tambahkan tombol yang tersisa
Anda dapat menambahkan beberapa atau semua tombol yang tercantum dalam langkah-langkah berikut.
**Untuk menambahkan tombol**
1. Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
1. Arahkan ke **Halaman Catatan Petir Peluang**.
1. Pilih panel yang disorot untuk membuka panel properti.
1. Pilih **Tetapkan dari Tindakan**, lalu pilih beberapa atau semua item berikut:
+ **Berbagi dengan AWS**
+ **Associate atau Disassociate**
+ **Tetapkan**
Untuk informasi lebih lanjut tentang apa yang dilakukan setiap tombol, lihat[Tingkatkan fitur](api-upgrade-features.md), sebelumnya dalam panduan ini.
1. Pilih **Simpan**.
# Segarkan tab Penawaran Solusi
Langkah-langkah berikut menjelaskan cara me-refresh data pada tab **Penawaran Solusi**.
1. Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
1. Arahkan ke **tab Penawaran Solusi**.
1. Pilih **Refresh Solutions**.
# Mengkonfigurasi konektor untuk CRM dengan integrasi Amazon S3
**penting**
Mulai tahun 2024, AWS Partner Central membuat jenis integrasi ini tidak tersedia bagi pengguna baru.
**catatan**
Topik di bagian ini mengasumsikan Anda telah menyelesaikan prasyarat untuk integrasi AWS Partner Central, integrasi AWS Marketplace, atau keduanya. Untuk informasi lebih lanjut, lihat [Prasyarat integrasi](crm-integration-setting-up.md) dan [Memulai](crm-integration-getting-started.md) sebelumnya dalam panduan ini.
CRM yang tidak digunakan lagi dengan integrasi Amazon S3 menggunakan bucket Amazon S3 untuk mentransfer prospek dan peluang. Sebaiknya gunakan integrasi API Pusat Mitra seperti yang ditunjukkan pada bagian sebelumnya untuk membuat dan mengelola peluang. Namun, Anda dapat menggunakan konfigurasi ini jika Anda ingin menggunakan konektor untuk mengelola prospek di Salesforce.
**Topics**
+ [Memasukkan detail otentikasi koneksi](#apn-s3-authentication-details)
+ [Memasuki pengaturan konfigurasi sistem](#apn-s3-config-settings)
+ [Menguji koneksi](#apn-s3-testing)
+ [Mengirim dan menerima peluang dan prospek](#sending-receiving-opportunities-leads)
+ [Daftar periksa produksi](ace-production-checklist.md)
+ [Meningkatkan konektor AWS Partner CRM ke model data baru](connector-upgrade-plan.md)
+ [Pengujian kotak pasir dengan peluang ACE khusus dan objek utama ACE](custom-ace-opportunity.md)
+ [Menautkan penawaran AWS Marketplace pribadi ke peluang ACE](#linking-private-offers-to-ace)
## Memasukkan detail otentikasi koneksi
Mitra memulai proses integrasi dengan memasukkan detail yang diperlukan untuk terhubung ke titik akhir Amazon S3 mereka. Ikuti setiap rangkaian langkah dalam urutan yang tercantum, dan selesaikan setiap set sebelum melanjutkan ke yang berikutnya.
Tugas-tugas berikut dilakukan dari tab **pengaturan AWS terpandu**. Untuk informasi tentang menggunakan tab, lihat [Menggunakan pengaturan terpandu](use-guided-setup.md) sebelumnya dalam panduan ini.
**Untuk memasukkan detail otentikasi**
1. Di Salesforce, buka tab **pengaturan AWS terpandu**. Untuk informasi tentang membuka tab itu, lihat [Menggunakan pengaturan terpandu](use-guided-setup.md) sebelumnya dalam panduan ini.
1. Perluas **Langkah 1: detail otentikasi AWS koneksi** dan pilih **Mulai**.
1. Pada halaman **Kredensial bernama**, pilih **Baru** lebih awal.
1. Dalam bentuk **kredensi baru bernama**, masukkan nilai dari tabel berikut.
| **Bidang** | **Nilai** |
| --- | --- |
| Label | Koneksi APN API |
| URL | [https://s3.us-west-2.amazonaws.com](https://s3.us-west-2.amazonaws.com) |
| Jenis identitas | Dinamakan Principal |
| Protokol otentikasi | AWS versi tanda tangan 4 |
| AWS ID kunci akses | Cloud-Ops menyediakan ID selama langkah-langkah prasyarat |
| AWS kunci akses rahasia | Cloud-Ops menyediakan kunci akses selama langkah-langkah prasyarat |
| AWS Wilayah | us-west-2 |
| AWS layanan | s3 |
| Hasilkan header otorisasi | memeriksa |
| Izinkan bidang gabungan di header HTTP | tidak dicentang |
| Izinkan bidang gabungan di badan HTTP | tidak dicentang |
1. Pilih **Simpan**.
1. Kembali ke halaman **Pengaturan AWS terpandu**. Di bagian **Detail otentikasi**, pilih **Tinjau** dan konfirmasikan kredensialnya.
1. Biarkan halaman **pengaturan AWS terpandu** tetap terbuka dan lanjutkan ke langkah berikutnya.
## Memasuki pengaturan konfigurasi sistem
Langkah-langkah berikut menjelaskan cara memasukkan pengaturan konfigurasi sistem yang benar untuk integrasi.
1. Perluas **Langkah 2: Pengaturan konfigurasi sistem** dan pilih **Mulai.**
1. Temukan **Pengaturan Konektor CRM AWS Mitra**, dan pilih **Kelola**.
1. Pilih **Baru**, lalu masukkan nilai yang diperlukan dari tabel berikut.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/s3-config.html)
1. Pilih **Simpan**.
1. Kembali ke halaman **Pengaturan AWS terpandu**. Di bagian **Detail otentikasi**, pilih **Tinjau** dan konfirmasikan kredensialnya.
## Menguji koneksi
Sebelum menguji koneksi, pastikan Anda menyelesaikan langkah-langkah di bagian sebelumnya.
**Untuk menguji koneksi**
1. Perluas **Langkah 3: Uji konfigurasi untuk APN API**.
1. Pilih **Uji**.
Jika koneksi berhasil, Anda menerima pesan konfirmasi.
## Mengirim dan menerima peluang dan prospek
Anda mengirim dan menerima peluang dan prospek dengan menyinkronkannya dengan Partner Central. Untuk menyinkronkan peluang atau prospek, Anda harus mengatur bidang **Sync with Partner Central** ke **True**. Bidang kunci tambahan untuk integrasi termasuk **Tanggal Sinkronisasi APN Terakhir** dan bidang yang **Memenuhi Syarat untuk Sinkronisasi dengan APN**.
Bidang ini disertakan untuk peluang dan prospek standar. Namun, Anda harus membuat dan memetakannya untuk objek sumber kustom apa pun.
+ **Sinkronkan dengan Pusat Mitra** - Termasuk dalam aplikasi untuk peluang dan prospek standar. Jika AWS Partner memilih untuk memetakan ke objek kustom, bidang boolean kustom harus dibuat dan dipetakan dalam pemetaan peluang dan lead, masing-masing.
+ **Tanggal Sinkronisasi Terakhir dengan APN** — Menunjukkan terakhir kali rekaman berhasil dikirim atau diterima dari APN. Bidang ini disetel otomatis ketika catatan berhasil dikirim ke APN atau pembaruan diterima dari APN.
+ **Memenuhi Syarat untuk Disinkronkan dengan APN** — Kolom rumus yang menentukan apakah catatan ditargetkan untuk dikirim ke APN di pekerjaan terjadwal berikutnya. Dihitung berdasarkan apakah catatan diubah sejak terakhir kali jadwal keluar berjalan, dan diperbarui oleh pengguna selain pengguna integrasi yang ditunjuk untuk AWS Partner organisasi.
# Daftar periksa produksi
Ikuti langkah-langkah ini untuk menyelesaikan instalasi produksi konektor AWS Partner CRM Anda.
1. Konfirmasikan bahwa Anda telah menyelesaikan [proses orientasi](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-getting-started.html) untuk integrasi CRM. Pada [tahap 6](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) proses ini, Anda mengatur lingkungan produksi dan melakukan migrasi data sehingga Anda dapat mengelola peluang dan prospek melalui integrasi.
1. Instal dan konfigurasikan konektor CRM. Untuk informasi lebih lanjut, lihat[Memasang konektor](install-connector.md).
1. Memetakan peluang dan memimpin objek dengan memilih salah satu opsi pemetaan berikut. Untuk referensi, lihat daftar [bidang wajib](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv) ini di GitHub.
+ Gunakan objek khusus peluang AWS ACE yang disediakan dengan konektor AWS Partner CRM untuk mencatat peluang dan membaginya. AWS Dengan menggunakan opsi ini, Anda dapat secara otomatis memetakan AWS bidang ke bidang Salesforce.
+ Gunakan objek Salesforce standar dan petakan bidang yang diperlukan AWS .
+ Gunakan objek peluang khusus ACE. Pertama-tama Anda membuat alur kerja untuk mengisi tabel perantara objek peluang ACE dan kemudian memetakan bidang Salesforce ke. AWS
1. Untuk detail dan panduan tambahan tentang opsi pemetaan, lihat. [Memetakan objek ACE](crm-connector-mapping.md)
1. (Opsional) Siapkan jadwal sinkronisasi masuk dan keluar antara Jaringan dan Salesforce. AWS Partner Untuk detailnya, lihat[Membuat jadwal sinkronisasi](crm-connector-scheduling.md).
1. Untuk memvalidasi peluang yang berasal dari mitra dalam produksi, ajukan [kasus dukungan](https://docs.aws.amazon.com/partner-central/latest/crm/crm-integration-faq.html#troubleshooting) dengan Operasi Pusat Mitra (PCO) di akun Pusat Mitra Anda. Dalam proses ini, Anda membuat peluang dummy, menyinkronkannya dengan AWS, dan meminta agen AWS dukungan untuk mengonfirmasi bahwa AWS menerima kesempatan tersebut. Di akhir pengujian, minta agen AWS dukungan Anda untuk menolak permintaan peluang sehingga Anda dapat menghapusnya dari sisi Anda.
1. (Opsional) Lakukan pengisian ulang data. Proses ini memastikan bahwa referensi peluang AWS Originated dan Partner Originated dapat diidentifikasi selama pembaruan di masa mendatang. Untuk informasi lebih lanjut, lihat [Tahap 6: Persetujuan produksi](https://docs.aws.amazon.com/partner-central/latest/crm/stage-6-production-approval.html) dalam proses orientasi CRM.
1. Aktifkan integrasi produksi untuk memungkinkan pertukaran file melalui bucket Amazon S3. Untuk detailnya, lihat [Tahap 7: Peluncuran](https://docs.aws.amazon.com/partner-central/latest/crm/stage-7-launch.html).
# Meningkatkan konektor AWS Partner CRM ke model data baru
**penting**
Uji dan setujui peningkatan model data baru di organisasi Salesforce kotak pasir Anda sebelum meningkatkan lingkungan produksi Anda. Untuk model data baru dan perubahan antara model lama dan baru, lihat [partner-crm-integration-samplesaws-samples/](https://github.com/aws-samples/partner-crm-integration-samples/tree/main/opportunity-samples) on berikut: GitHub
**Peluang- FieldsAndStandardValues - DiffWithPrevVersion -v14.3.xLSX**
**Opportunity-Fields.xlsx**
**Peluang \$1 -\$1 StandardValues .xlsx**
## Prasyarat
+ Gunakan definisi bidang untuk pedoman model data baru dari integrasi ACE CRM, dan memigrasikan peluang terbuka yang diperlukan dan mengarah ke model data baru.
+ Tambahkan atau hapus kolom di objek kustom atau standar Anda (objek yang digunakan dalam pemetaan).
+ Pastikan Anda menggunakan konektor AWS Partner CRM versi 2.0 atau yang lebih baru.
**Untuk meng-upgrade ke model data baru**
1. Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
1. Nonaktifkan jadwal aktif apa pun.
1. Pilih **Pengaturan**, **Pengaturan Kustom, Pengaturan** **konektor AWS Partner CRM**, dan kemudian perbarui versi ke **2.0** atau yang lebih baru.
**catatan**
Dimulai dengan versi 2.0, bidang **Versi** wajib. Bidang ini menentukan versi payload yang digunakan mitra untuk berinteraksi dengan Integrasi CRM. Ketika mitra pindah ke versi 2.0, mereka harus sepenuhnya mengadopsi spesifikasinya. Mengembalikan ke versi sebelumnya tidak diizinkan.
1. Pilih tab **Pemetaan ACE**.
1. Buat, tinjau, dan perbarui semua pemetaan dan detail bidang yang diperlukan. Untuk pengujian kotak pasir, gunakan peluang ACE khusus dan objek utama ACE untuk menguji fitur model data baru. Untuk informasi lebih lanjut, lihat[Pengujian kotak pasir dengan peluang ACE khusus dan objek utama ACE](custom-ace-opportunity.md).
1. Aktifkan jadwal untuk peluang dan prospek.
1. Tinjau log sinkronisasi ACE untuk kesalahan sinkronisasi dan lakukan koreksi apa pun.
1. Tinjau peluang dan petunjuk yang disinkronkan untuk memastikan bahwa transformasi data akurat. Atau, tinjau peluang dan prospek di ACE untuk memastikan bahwa perubahan model data baru ditangkap secara akurat.
1. Ikuti proses penyebaran produk Anda untuk memigrasikan perubahan ke lingkungan Salesforce produksi Anda.
**catatan**
Jika Anda membutuhkan bantuan, lihat[Mendapatkan bantuan](getting-help.md).
# Pengujian kotak pasir dengan peluang ACE khusus dan objek utama ACE
**catatan**
Jika Anda adalah pengguna konektor CRM yang ada, lihat. [Meningkatkan konektor AWS Partner CRM ke model data baru](connector-upgrade-plan.md)
1. Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
1. Pilih **Pengaturan**, **Pengaturan khusus, pengaturan** **konektor AWS Partner CRM**, dan perbarui versi ke **2**.
1. Pilih tab **Pemetaan ACE**.
1. Untuk **Peluang**, petakan ke objek kustom **peluang ACE**.
1. Pilih **objek ACE Peta Otomatis**.
**catatan**
Jika Anda ingin meningkatkan ke versi baru konektor CRM yang ingin menggunakan peluang ACE khusus dan objek utama ACE dari konektor untuk pengujian kotak pasir, kami sarankan untuk menghapus catatan yang tersedia secara manual dari `Field Mappings` dan `Field Mapping Details` objek dari database sebelum menggunakan fitur objek ACE Peta Otomatis. Anda hanya perlu melakukan ini sekali.
1. Tinjau pemetaan bidang dan nilai pemetaan bidang untuk daftar pilih dan multipicklist.
1. Aktifkan jadwal untuk peluang dan prospek.
1. Tinjau Log Sinkronisasi ACE untuk kesalahan sinkronisasi dan lakukan koreksi yang diperlukan.
1. Tinjau peluang dan prospek yang disinkronkan untuk memastikan transformasi data akurat. Atau, tinjau peluang dan prospek di ACE untuk memastikan bahwa perubahan model data baru telah ditangkap secara akurat.
## Melihat catatan detail log sinkronisasi untuk peluang ACE
Anda dapat melihat detail log sinkronisasi untuk peluang ACE yang AWS dikirim pada tab **Terkait** pada catatan peluang ACE.
**catatan**
Langkah-langkah ini hanya berlaku untuk objek peluang ACE yang AWS dikirim. Jika Anda memetakan ke objek standar atau kustom di organisasi Salesforce, Anda dapat melihat detail log sinkronisasi pada tab Log **Sinkronisasi ACE**.
1. Masuk ke organisasi Salesforce Anda.
1. Di **App Launcher**, pilih konektor **AWS Partner CRM**.
1. Pilih tab **Peluang ACE**.
1. Pilih catatan peluang ACE.
1. Pilih tab **Terkait** untuk melihat detail termasuk **Nama Log Sinkronisasi**, **Status**, **Pesan Kesalahan**, dan **Tanggal Dibuat**.
## Menautkan penawaran AWS Marketplace pribadi ke peluang ACE
Anda dapat menautkan penawaran pribadi langsung dari halaman catatan peluang ACE yang AWS dikirimkan.
1. Masuk ke organisasi Salesforce Anda.
1. Di **App Launcher**, pilih konektor **AWS Partner CRM**.
1. Pilih tab **Peluang ACE**.
1. Pilih catatan peluang ACE.
1. Pilih **Tautan Penawaran Pribadi**.
1. Di **Offer ID Look Up**, pilih penawaran pribadi.
1. Pilih **Simpan**.
# Sumber daya integrasi
AWS menyediakan sumber daya berikut untuk membantu Anda membuat integrasi khusus.
**Topics**
+ [Definisi bidang](#custom-field-definitions)
+ [Nilai standar](#standard-values)
+ [Contoh file masuk](#sample-inbound-files)
+ [Contoh file keluar](#sample-outbound-files)
+ [Sampel hasil yang diproses](#sample-processed-results)
+ [Contoh kasus uji](#sample-test-cases)
+ [Contoh cuplikan kode](#sample-code-snippets)
## Definisi bidang
Tautan di bagian berikut mencantumkan semua bidang, menjelaskan jenis data, penggunaan, dan batasan atau aturan pemformatan apa pun yang berlaku. Mereka berfungsi sebagai referensi untuk memastikan bahwa ketika mitra dan AWS bertukar data, itu diformat dan dipahami dengan benar.
Tautan berikut membawa Anda ke GitHub.
+ [Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Memimpin](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Nilai standar
Daftar ini menguraikan nilai standar dan pencacahan untuk berbagai bidang. Mereka membantu menjaga konsistensi dalam data yang dipertukarkan, dan memastikan bahwa kedua belah pihak memiliki pemahaman yang sama tentang nilai-nilai yang digunakan.
Tautan berikut membawa Anda ke GitHub.
+ [Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity_-_StandardValues.csv)
+ [Memimpin](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead_-_StandardValues.csv)
## Contoh file masuk
File contoh berikut menunjukkan struktur payload JSON untuk file yang dikirim dari mitra ke. AWS
Tautan berikut membawa Anda ke GitHub.
+ [Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Create-Inbound-Sample.json)
+ [Memimpin](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Update-Inbound-Sample.json)
## Contoh file keluar
File contoh berikut menunjukkan struktur payload JSON untuk file yang dikirim dari AWS ke mitra.
Tautan berikut membawa Anda ke GitHub.
+ [Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Outbound-Sample.json)
+ [Memimpin](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Outbound-Sample.json)
## Sampel hasil yang diproses
File berikut menunjukkan hasil yang khas setelah AWS memproses muatan yang dikirim oleh mitra.
Tautan berikut membawa Anda ke GitHub.
+ [Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Memimpin](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
## Contoh kasus uji
Tautan berikut membawa Anda ke GitHub.
+ [Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity%20-%20Testing%20Scenarios.xlsx)
+ [Memimpin](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead%20-%20Testing%20Scenarios.xlsx)
## Contoh cuplikan kode
Tautan berikut membawa Anda ke GitHub.
+ [ace\$1read\$1s3.py](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ [Apex\$1sample\$1rest\$1 API\$1C ode.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)
+ [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)
+ [Sampel\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ [SFDC puncak s3 sample.txt](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/SFDC_apex_s3_sample.txt)
+ [Apex\$1get\$1files\$1dari\$1s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_get_files_from_s3_ace_partner_test.cls)
+ [s3\$1ace\$1partner\$1test.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/s3_ace_partner_test.cls)
# Berbagi memimpin
## Bagaimana AWS saham memimpin
1. **Ekspor tambahan**: Amazon Web Services (AWS) mengekspor prospek baru (dan pembaruan) yang dirujuk oleh AWS, setiap jam.
1. **Pembuatan file**: AWS menghasilkan file lead yang mengikuti format tertentu. Untuk spesifikasi file rinci, lihat[Definisi bidang](resources.md#custom-field-definitions).
1. **Unggahan file**: File utama diunggah ke `lead-outbound` folder.
## Mengkonsumsi lead dari AWS
Untuk menggunakan lead secara efektif AWS, buat integrasi kustom dengan fungsionalitas berikut.
1. **Pengambilan file**:
+ Pindai `lead-outbound` folder secara teratur menggunakan pekerjaan terjadwal pada interval yang Anda pilih.
+ Ambil file lead untuk diproses.
1. **Transformasi dan pemetaan data**:
+ Setelah Anda membaca konten setiap file, ubah dan petakan data ke catatan utama dalam sistem manajemen hubungan pelanggan (CRM) Anda.
+ Untuk panduan tentang pemetaan lapangan, lihat. [Pemetaan lapangan](custom-field-mapping.md)
1. **Identifikasi timbal**:
+ Identifikasi secara unik setiap lead menggunakan salah satu atau`partnerCrmLeadId`. `apnCrmUniqueIdentifier`
+ Jika `partnerCrmLeadId` kosong dan ada, lead `apnCrmUniqueIdentifier` adalah referral baru dari AWS Partner Network (APN) Customer Engagement (ACE).
+ Jika kedua pengidentifikasi hadir, catatan diperlakukan sebagai pembaruan dari ACE.
1. **Konsumsi timbal**:
+ Menelan prospek baru atau memperbarui prospek yang ada dalam sistem CRM.
1. **Manajemen file**:
+ Setelah Anda berhasil memproses setiap prospek dan data file lengkap, hapus file dari folder keluar.
+ Setiap file secara otomatis diarsipkan dalam `lead-outbound-archive` folder.
**Integrasi dan referensi kode**:
+ Untuk membaca file yang diunggah ke bucket Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3), Anda dapat menggunakan AWS Lambda atau membaca langsung dari sistem CRM Anda.
+ Gunakan kode contoh di bawah ini untuk Lambda dan Salesforce REST API untuk memvalidasi dan memperbarui catatan CRM.
+ **Lambda untuk memvalidasi file**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ **API REST Salesforce: [API\$1CAPEX\$1SAMPLE\$1REST\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)** ode.cls.
+ Jika Anda menggunakan sistem CRM selain Salesforce, Anda harus memberikan kode khusus untuk sistem Anda untuk memperbarui data Anda.
## Berbagi pembaruan tentang prospek dengan AWS
1. **Identifikasi prospek**: Temukan prospek dengan pembaruan untuk dibagikan AWS.
1. **Transformasi data**: Ubah data ke dalam AWS format, seperti yang diuraikan dalam[Definisi bidang](resources.md#custom-field-definitions).
1. **Pembuatan file**:
+ Hasilkan file lead dalam format JSON.
+ Tambahkan stempel waktu ke setiap file, pastikan semua nama file unik dan ikuti formatnya:. `{name}_MMDDYYYY24HHMMSS.json`
1. **Otentikasi dan unggah**:
+ Otentikasi ke bucket ACE Amazon S3.
+ Unggah file ke `lead-inbound` folder. Semua file yang dibagikan AWS secara otomatis diarsipkan di `lead-inbound-archive` folder.
+ Saat Anda mengunggah file ke S3, pastikan Anda menyediakan akses penuh ke pemilik bucket.
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
Lihat hasil sampel menjalankan perintah ini di [“Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)”.
1. **Pengolahan file**:
+ Setelah diterima, AWS secara otomatis memproses file.
+ Hasil pemrosesan diunggah ke `lead-inbound-processed-results` folder di bucket Amazon S3. Ini termasuk status keberhasilan dan kesalahan, serta pesan kesalahan untuk setiap prospek.
+ Hasil yang diproses ini juga diarsipkan di `lead-inbound-processed-results-archive` folder.
+ Untuk informasi lebih lanjut, lihat[Tanya Jawab Teknis — Prospek dan Peluang](technical-faq-leads-and-opps.md).
1. **Penanganan respons**:
+ Anda harus mengembangkan logika untuk mengkonsumsi tanggapan ini, meninjau catatan yang salah, memperbaiki kesalahan, dan mengirim ulang data ke ACE.
+ Anda dapat menemukan kesalahan sampel di bagian FAQ dan Pemecahan Masalah.
+ Untuk mengunggah file ke Amazon S3 dari CRM:
+ Referensi versi AWS tanda tangan.
+ Gunakan permintaan HTTPS untuk mengunggah file.
+ Untuk referensi, gunakan file berikut untuk mengunggah file ke bucket Amazon S3:
+ **[Untuk mengautentikasi bucket S3: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
+ **Untuk mengunggah file ke ember S3**[: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **CATATAN:** File tidak boleh melebihi 1 MB, dan file duplikat tidak akan diproses.
# Berbagi kesempatan
## Bagaimana AWS berbagi peluang
1. **Ekspor tambahan**: Amazon Web Services (AWS) mengekspor peluang baru (dan pembaruan) yang dirujuk oleh AWS, setiap jam.
1. **Pembuatan file**: AWS menghasilkan file peluang yang mematuhi format tertentu. Untuk spesifikasi file terperinci, lihat [definisi bidang Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv).
1. **Unggahan file**: File peluang diunggah ke `opportunity-outbound` folder.
## Mengkonsumsi peluang dari AWS
Untuk memanfaatkan peluang secara efektif AWS, Anda perlu membangun integrasi khusus dengan fungsionalitas ini.
1. **Pengambilan file**:
+ Gunakan pekerjaan terjadwal untuk memindai `opportunity-outbound` folder secara teratur, pada interval yang Anda pilih.
+ Ambil file peluang untuk diproses.
1. **Transformasi dan pemetaan data**:
+ Setelah Anda membaca konten setiap file, ubah dan petakan data ke catatan peluang dalam sistem manajemen hubungan pelanggan (CRM) Anda.
+ Untuk panduan tentang pemetaan lapangan, lihat. [Pemetaan lapangan](custom-field-mapping.md)
1. **Identifikasi peluang**:
+ Identifikasi secara unik setiap peluang menggunakan salah satu atau`partnerCrmOpportunityId`. `apnCrmUniqueIdentifier`
+ Jika `partnerCrmOpportunityId` kosong dan `apnCrmUniqueIdentifier` hadir, peluangnya adalah rujukan baru dari AWS Partner Network (APN) Customer Engagement (ACE).
+ Jika kedua pengidentifikasi hadir, catatan diperlakukan sebagai pembaruan dari ACE.
1. **Penyerapan peluang**: Menelan peluang baru atau memperbarui peluang yang ada dalam sistem CRM.
1. **Manajemen file**:
+ Setelah Anda berhasil memproses setiap peluang dan data file lengkap, hapus file dari folder keluar.
+ Setiap file secara otomatis diarsipkan dalam `opportunity-outbound-archive` folder.
**Integrasi dan referensi kode**:
+ Untuk membaca file yang diunggah ke bucket Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3), Anda dapat menggunakan AWS Lambda atau membaca langsung dari sistem CRM Anda.
+ Gunakan kode contoh di bawah ini untuk Lambda dan Salesforce REST API untuk memvalidasi dan memperbarui catatan CRM.
+ **Lambda untuk memvalidasi file**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
+ **API REST Salesforce: [API\$1CAPEX\$1SAMPLE\$1REST\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)** ode.cls.
+ Jika Anda menggunakan sistem CRM selain Salesforce, Anda harus memberikan kode khusus untuk sistem Anda untuk memperbarui data Anda.
## Berbagi pembaruan untuk peluang dengan AWS
1. **Identifikasi peluang**: Temukan peluang dengan pembaruan untuk dibagikan AWS.
1. **Transformasi data**: Ubah data ke dalam AWS format, seperti yang diuraikan dalam[Definisi bidang](resources.md#custom-field-definitions).
1. **Pembuatan file**:
+ Hasilkan file peluang dalam format JSON.
+ Tambahkan stempel waktu ke setiap file, pastikan semua nama file unik dan ikuti formatnya:. `{name}_MMDDYYYY24HHMMSS.json`
1. **Otentikasi dan unggah**:
+ Otentikasi ke bucket ACE Amazon S3.
+ Unggah file ke `opportunity-inbound` folder. Semua file yang dibagikan AWS secara otomatis diarsipkan di `opportunity-inbound-archive` folder.
+ Saat mengunggah file ke S3, pastikan Anda menyediakan akses penuh ke pemilik bucket:
```
aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
```
Lihat hasil sampel menjalankan perintah ini di [Opportunity Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json).
1. **Pengolahan file**:
+ Setelah diterima, AWS secara otomatis memproses file.
+ Hasil pemrosesan diunggah ke `lead-inbound-processed-results` folder di bucket Amazon S3. Ini termasuk status keberhasilan dan kesalahan, serta pesan kesalahan apa pun untuk setiap peluang.
+ Hasil yang diproses ini juga diarsipkan di `opportunity-inbound-processed-results-archive` folder.
+ Untuk informasi lebih lanjut, lihat[Tanya Jawab Teknis — Prospek dan Peluang](technical-faq-leads-and-opps.md).
1. **Penanganan respons**:
+ Anda harus mengembangkan logika untuk mengkonsumsi tanggapan ini, meninjau catatan yang salah, memperbaiki kesalahan, dan mengirim ulang data ke ACE.
+ Anda dapat menemukan kesalahan sampel di bagian FAQ dan Pemecahan Masalah.
+ Untuk mengunggah file ke Amazon S3 dari CRM:
+ Referensi versi AWS tanda tangan.
+ Gunakan permintaan HTTPS untuk mengunggah file.
+ Untuk referensi, gunakan file berikut untuk mengunggah file ke bucket Amazon S3:
+ **[Untuk mengautentikasi bucket S3: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
+ **Untuk mengunggah file ke ember S3**[: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
+ **CATATAN:** File tidak boleh melebihi 1 MB, dan file duplikat tidak akan diproses.
# Pemetaan lapangan
Pemetaan lapangan merupakan langkah penting dalam proses integrasi di mana mitra menyelaraskan bidang sistem manajemen hubungan pelanggan (CRM) mereka dengan yang ditentukan oleh Amazon Web Services ().AWS Ini memastikan bahwa kedua belah pihak secara akurat bertukar dan memahami data. Di bawah ini adalah pedoman untuk membantu dalam proses ini.
## Pemetaan lapangan wajib
+ Petakan setiap bidang wajib ke bidang yang sesuai di sistem CRM Anda. Ini penting untuk pertukaran data yang sukses ketika Anda memastikan semua bidang yang diperlukan dipetakan. Untuk informasi lebih lanjut, lihat [Definisi bidang](resources.md#custom-field-definitions)
+ [Kesempatan](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv)
+ [Memimpin](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Leads-Fields.csv)
## Menangani bidang opsional
+ Memahami peran bidang opsional dalam proses integrasi. Putuskan apakah Anda ingin memetakan bidang-bidang ini berdasarkan kebutuhan bisnis Anda, dan waspadai kemungkinan implikasi dari membiarkannya tidak dipetakan.
## Pemetaan nilai
+ Sejajarkan setiap nilai bidang dalam CRM Anda dengan nilai daftar Customer Engagement AWS Partner Network (ACE) yang diperlukan (APN), seperti yang ditentukan dalam. [Definisi bidang](resources.md#custom-field-definitions) Hal ini penting untuk menjaga konsistensi dan integritas data.
## Jenis data dan validasi format
+ Verifikasi bahwa tipe data dan format bidang dalam sistem CRM Anda sejajar dengan yang ditentukan dalam definisi AWS *Bidang*. Sangat penting untuk menjaga konsistensi dalam tipe dan format data untuk mencegah korupsi data dan memastikan integrasi yang mulus.
## Panjang dan batasan bidang
+ Perhatikan batasan panjang bidang dan batasan lainnya. Pastikan bahwa data dari sistem CRM Anda cocok dengan bidang yang sesuai AWS tanpa terpotong atau menyebabkan kesalahan.
## Jenis data dan validasi format
+ Verifikasi bahwa tipe dan format data bidang dalam sistem CRM Anda sejajar dengan yang ditentukan dalam. [Definisi bidang](resources.md#custom-field-definitions) Sangat penting untuk mencegah korupsi data dan memastikan integrasi yang mulus dengan konsistensi dalam tipe dan format data.
## Tinjauan dan pembaruan berkala
+ Tinjau dan perbarui pemetaan lapangan Anda secara teratur untuk mengakomodasi perubahan dalam sistem atau persyaratan CRM Anda. AWS Pendekatan proaktif ini memastikan akurasi dan efisiensi pertukaran data yang berkelanjutan.
## Dokumentasi pemetaan lapangan
+ Pertahankan dokumentasi pemetaan lapangan yang komprehensif. Praktik ini membantu dalam pemecahan masalah, pembaruan masa depan, dan memastikan kejelasan tentang bagaimana data ditransfer antar sistem.
## Pengujian dan validasi
+ Melakukan pengujian pemetaan lapangan menyeluruh untuk memvalidasi bahwa data sedang ditransfer dan diubah secara akurat. Atasi setiap perbedaan atau masalah segera untuk memastikan integritas data.
## Menangani penimpaan yang tidak diinginkan
+ Untuk mencegah AWS data menimpa bidang CRM tertentu, pertimbangkan hal berikut:
+ Membuat bidang CRM khusus untuk data yang ingin Anda lindungi.
+ Memiliki bidang kustom ini ditinjau oleh perwakilan penjualan.
+ Setelah bidang kustom disetujui, tambahkan ke catatan peluang dan pipeline.
+ Ini sangat penting untuk bidang-bidang seperti `MRR` atau`Stage`, terutama jika mereka menandakan bahwa suatu produk telah diluncurkan.
## Mengelola dependensi hilir
+ Jika ada dependensi hilir di sistem Anda yang mengandalkan pertukaran data, pertimbangkan hal berikut:
+ Membuat bidang baru di CRM Anda untuk mengakomodasi AWS data.
+ Menyelaraskan kembali proses bisnis Anda seperlunya untuk memastikan integrasi dan aliran data yang mulus.
# Membuat jadwal sinkronisasi
**catatan**
Topik di bagian ini mengasumsikan Anda telah menyelesaikan prasyarat untuk integrasi AWS Partner Central, integrasi AWS Marketplace, atau keduanya. Untuk informasi lebih lanjut, lihat [Prasyarat integrasi](crm-integration-setting-up.md) dan [Memulai](crm-integration-getting-started.md) sebelumnya dalam panduan ini.
Anda dapat membuat jadwal sinkronisasi masuk dan keluar antara Salesforce dan AWS Partner Central. Langkah-langkah di bagian berikut menjelaskan caranya.
**Topics**
+ [Prasyarat](#scheduling-prerequisites)
+ [Membuat jadwal](#creating-a-schedule)
+ [Menonaktifkan pekerjaan terjadwal](#deactivating-a-scheduled-job)
+ [Melihat semua jadwal](#viewing-all-schedules)
## Prasyarat
Pastikan Anda menyelesaikan hal-hal berikut sebelum membuat jadwal sinkronisasi:
+ [Petakan](crm-connector-mapping.md) semua bidang yang diperlukan pada setidaknya satu objek, peluang, atau prospek.
+ Buat [pengguna integrasi sistem](#system-integration-user) di Salesforce.
### Membuat pengguna integrasi sistem
Sebelum Anda dapat membuat jadwal sinkronisasi, Anda harus menggunakan Salesforce untuk membuat pengguna integrasi sistem dengan izin integrasi APN. Untuk membuat jadwal sinkronisasi, Anda harus masuk ke Salesforce sebagai pengguna integrasi sistem. Membuat jadwal tanpa izin pengguna integrasi APN dapat merusak integrasi APN.
**Untuk membuat pengguna integrasi sistem**
1. Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
1. Buat pengguna di organisasi Salesforce Anda. Tetapkan profil ke pengguna dengan akses ke objek yang diperlukan di organisasi Salesforce Anda. Untuk informasi selengkapnya, lihat [Tambahkan satu pengguna](https://help.salesforce.com/s/articleView?id=sf.adding_new_users.htm).
1. Tetapkan pengguna yang ditetapkan izin **Pengguna Integrasi APN**. Untuk informasi selengkapnya, lihat [Tetapkan izin yang disetel ke pengguna](https://help.salesforce.com/s/articleView?id=sf.assign_permission_set_to_user.htm).
## Membuat jadwal
Setelah menyelesaikan [prasyarat](#scheduling-prerequisites), Anda dapat membuat jadwal sinkronisasi antara Salesforce dan APN.
**Untuk membuat jadwal sinkronisasi dengan APN**
1. Masuk ke Salesforce sebagai pengguna dengan izin pengguna integrasi sistem.
1. Pada tab **Jadwal**, pilih **Baru**.
1. Pilih objek yang akan dijadwalkan. Anda dapat mengatur jadwal untuk prospek dan peluang, atau untuk satu objek.
1. Pilih frekuensi jadwal, dari minimal setiap lima menit hingga maksimal sekali sehari.
1. Pilih **Jadwal**.
**catatan**
Hanya satu jadwal per objek yang dapat aktif pada satu waktu. Membuat jadwal baru untuk objek yang sama menonaktifkan jadwal yang ada.
Untuk menonaktifkan integrasi masuk saat membuat jadwal, pilih **Nonaktifkan Integrasi Masuk,** Jadwal.
Membuat jadwal tanpa izin pengguna integrasi APN dapat merusak integrasi APN.
## Menonaktifkan pekerjaan terjadwal
1. Pada halaman **Penjadwalan**, pilih **Nonaktifkan Semua Pekerjaan** untuk menonaktifkan jadwal aktif apa pun.
1. Lanjutkan melalui layar konfirmasi untuk menonaktifkan jadwal sinkronisasi.
## Melihat semua jadwal
**Dari tab **Jadwal**, gunakan filter tampilan daftar untuk beralih antara jadwal Aktif, Tidak **Aktif**, dan Semua **sinkronisasi**.**
# Praktik terbaik
Gunakan praktik terbaik ini untuk mengoptimalkan pengembangan dan pemeliharaan integrasi kustom Anda.
## Praktik terbaik umum
1. Petakan semua bidang *wajib* karena merupakan bidang wajib dalam formulir pengajuan Customer Engagement (ACE) (APN). AWS Partner Network
1. Connect dengan pengguna ACE Pipeline Manager Anda saat ini untuk memahami seperti apa prosesnya. Tangkap processes/field penggunaan unik apa pun, sehingga Anda dapat membangunnya ke dalam pengalaman Anda.
1. Pertimbangkan untuk membuat tahapan pipeline penjualan terpisah untuk tahapan penjualan yang dilaporkan Amazon Web Services (AWS) (contoh: Tahap, Tanggal Penutupan Target, AWS Pendapatan Bulanan yang Diharapkan, Langkah Selanjutnya). Jika kami memiliki definisi tahap yang berbeda, kami mungkin mengesampingkan tahapan penjualan Anda. Ketika Anda membuat tahapan penjualan terpisah, ini memungkinkan Anda untuk mengelola pipa Anda dengan tepat, tetapi masih memiliki visibilitas ke dalam apa yang AWS diproyeksikan.
1. Untuk peluang yang dirujuk mitra, tim ACE approve/reject mengharuskannya sebelum kami menerima pembaruan apa pun.
1. Untuk peluang yang AWS dirujuk, pasangan harus menerima atau menolak peluang tersebut.
## Protokol pertukaran data
1. **Konvensi input**: Pisahkan entri daftar pilih multi-pilihan dengan titik koma dan hilangkan spasi.
1. **Perhatian terhadap detail**: Nama dan nilai bidang peka huruf besar/kecil, jadi pertahankan akurasi.
1. **Prosedur penghapusan**: Jalankan penghapusan bidang dengan mentransmisikan nilai `null` untuk bidang yang dipilih.
1. **Sinkronisasi**: Proses sinkronisasi beroperasi setiap jam, menyebabkan potensi penundaan dalam refleksi data. Pembaruan AWS dapat memakan waktu hingga satu jam untuk tercermin dalam manajemen hubungan AWS pelanggan (CRM). Hindari mengirim beberapa dokumen per jam.
## Praktik terbaik khusus lapangan
1. **Modifikasi masuk**: Untuk melindungi integritas data Anda, nonaktifkan modifikasi untuk bidang seperti`stage`,`closedDate`, dan`closedLostReason`. Untuk melacak AWS nilai tanpa memengaruhi nilai Salesforce lokal Anda, gunakan bidang hanya-baca ini:`awsStage`,, dan. `awsCloseDate` `awsClosedLostReason`
1. **Pemetaan dan validasi pelanggan**: Pastikan akurasi situs web pelanggan karena sangat penting untuk pemetaan CRM. AWS Pasangkan dengan nama pelanggan untuk pemetaan akun CRM superior.
1. **Kejelasan deskripsi proyek**: Berikan deskripsi yang jelas yang merinci tantangan pelanggan dan penyelarasan solusi. AWS menggunakan ini untuk memvalidasi peluang.
1. **Penyediaan: (Opsional) Saat Anda memberikan** spesifik kontak pelanggan akhir, ini memungkinkan AWS untuk menelusuri kembali prospek dan kampanye. Ini mengarah pada peningkatan putusan pendanaan.
## Praktik terbaik tambahan
1. Patuhi pedoman definisi bidang payload terbaru.
1. Pertahankan konsistensi penamaan bucket kotak pasir dengan format yang ditentukan.
1. Gunakan pola penamaan yang disarankan untuk ember produksi.
1. Prioritaskan pengujian lingkungan kotak pasir sebelum penerapan langsung.
1. Pertahankan pengidentifikasi yang berbeda untuk catatan antara AWS dan mitra CRMs.
1. Pasca-pemrosesan, hapus file di folder Amazon Simple Storage Service (Amazon S3) keluar. Asli tetap ada di arsip.
1. Untuk mencegah kesalahan, siapkan validasi tingkat bidang di sumbernya.
# Kuota
## File masuk ke Amazon Web Services ()AWS
| Operasi | Kuota |
| --- | --- |
| Peluang maksimal | 500 per file |
| Ukuran maksimum file | 1 MB |
| Frekuensi sinkronisasi | Dekat waktu nyata |
| Jumlah maksimum file yang dikirimkan | 10.000 per periode 24 jam |
## File keluar ke mitra
| Operasi | Kuota |
| --- | --- |
| Ukuran maksimum file | 5 MB |
| Frekuensi sinkronisasi | Per Jam |
# Riwayat versi
Versi bidang saat ini: 14 (15 November 2023)
Tabel berikut menjelaskan perubahan penting pada bidang integrasi khusus untuk prospek dan peluang setelah tahun 2020. Untuk diberitahu tentang pembaruan masa depan, berlangganan umpan RSS.
| Perubahan | Versi | Tanggal |
| --- | --- | --- |
| Perbarui kuota Amazon S3 | 14 | 1/17/2024 |
| **Perubahan pada bidang peluang integrasi:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) | 14 | 11/15/2023 |
| **Perubahan pada bidang peluang integrasi:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) | 13 | 03/29/2023 |
| **Perubahan pada bidang peluang integrasi:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) **Perubahan nilai standar pada peluang:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) | 12 | 09/01/2022 |
| **Perubahan pada bidang peluang integrasi:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) **Perubahan nilai standar pada bidang peluang:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) | 11 | 03/21/2022 |
| **Perubahan pada bidang peluang integrasi:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) **Perubahan nilai standar pada peluang:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) | 10 | 01/26/2022 |
| **Perubahan nilai standar pada bidang lead:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) **Perubahan pada bidang lead integrasi:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) **Perubahan pada bidang peluang integrasi:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/partner-central/latest/crm/version-history.html) | 9 | 9/16/2021 |
| Perbarui kode alasan Closed Lost | 8 | 6/24/2021 |
# FAQs
Gunakan pertanyaan dan jawaban umum ini untuk membantu integrasi kustom.
**Topics**
+ [FAQ Umum](general-faq.md)
+ [FAQ Teknis—Bidang](technical-faq-fields.md)
+ [Tanya Jawab Teknis—Amazon S3](technical-faq-s3.md)
+ [Tanya Jawab Teknis — Prospek dan Peluang](technical-faq-leads-and-opps.md)
+ [Tanya Jawab Teknis—Versioning dan kompatibilitas mundur](technical-faq-versioning.md)
# FAQ Umum
## Bagaimana cara kerja integrasi?
**T: Dapatkah saya mengakses bucket Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3) yang digunakan untuk mengirim dan menerima file?**
Ya. Mitra dapat mengakses bucket Amazon S3 secara terprogram menggunakan secret/access kunci (IAM) AWS Identity and Access Management yang memiliki akses ke bucket. Mitra tidak akan memiliki akses konsol ke bucket Amazon S3 karena bucket ini ada di akun Amazon Web Services (AWS) sendiri.
**T: Keahlian apa yang dibutuhkan pengembang mitra?**
Pengembang mitra harus terbiasa dengan sistem manajemen hubungan pelanggan (CRM) mereka dan Amazon S3.
**T: Apakah file kode sampel menyertakan kode lengkap atau apakah mitra harus menulis kode?**
Mitra perlu menulis kode berdasarkan file kode sampel yang disediakan.
**T: Jika mitra mengembangkan solusi mereka dalam Python, Golang, atau bahasa lain, apakah AWS Partner Network (APN) Customer Engagement (ACE) menyediakan perangkat pengembangan perangkat lunak (SDK) dalam bahasa tersebut untuk integrasi ini?**
Tidak.
**T: Apa proses sinkronisasi dari bucket Amazon S3 ke ACE internal?**
Setiap jam, proses batch berjalan untuk mengambil file dan menyinkronkan informasi. Setiap pembaruan yang dibuat tim AWS penjualan dalam catatan dapat memakan waktu hingga satu jam untuk dikirim ke ember mitra. Mitra dapat menerima pemberitahuan email tentang pembaruan segera, tetapi pembaruan dari AWS mungkin masih tertunda satu jam.
**T: Berapa frekuensi unggahan file prospek dan peluang oleh ACE?**
ACE mengirimkan data prospek dan peluang setiap satu jam.
**T: Apakah ada lingkungan kotak pasir untuk ACE?**
Ya. Kami memang memiliki lingkungan kotak pasir untuk ACE, tetapi kami tidak dapat menyediakan akses ke mitra karena alasan keamanan. Angkat kasus dukungan di Partner Central jika Anda ingin memiliki peluang atau prospek baru yang didorong ke dalam ember Anda.
**T: Bagaimana kami mempertahankan pengenal di seluruh CRM dan APN mitra?**
Untuk memberikan lebih banyak fleksibilitas bagi mitra kami, kami menggunakan dua set pengenal dalam sistem kami.
1. `apnCrmUniqueIdentifier`: AWS mengelola pengenal ini. Dimulai dengan `OXXXXXX` peluang dan `LXXXXXX` untuk prospek.
1. `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: Mitra mengelola pengenal ini pada peluang dan prospek, masing-masing, dalam CRM mereka. Mitra harus menambahkan pengenal ini sambil mengambil peluang baru untuk melacak pembaruan kembali ke CRM mereka.
Ketika sebuah kesempatan dikirim tanpa `apnCrmUniqueIdentifier` atau`partnerCrmUniqueIdentifier`, AWS perlakukan itu sebagai peluang baru dan berikan yang baru `apnCrmUniqueIdentifier` untuk kesempatan itu.
Ketika kesempatan dikirim dengan `apnCrmUniqueIdentifier` atau`partnerCrmUniqueIdentifier`, AWS memperlakukannya sebagai tindakan pembaruan dan memperbarui peluang yang ada dengan data payload.
**T: Bagaimana cara mencegah rekaman duplikat dibuat di kedua sistem?**
Dari sisi CRM mitra, harus ada pengenal unik untuk setiap catatan yang dikirim ke ACE, yang disebut. `partnerCrmUniqueIdentifier` Demikian pula, ACE juga mempertahankan pengenal unik untuk setiap catatan, yang disebut`apnCrmUniqueIdentifier`. Ketika data dikirim, baik ACE dan mitra harus menyertakan dua bidang ini, yang membantu mengidentifikasi apakah catatan adalah peluang baru (jika kosong) atau peluang yang ada (jika diisi).
# FAQ Teknis—Bidang
**T: Apakah integrasi mendukung format CSV?**
Tidak. Integrasi hanya menerima format file JSON.
**T: Kapan file harus dihapus dari folder keluar?**
Hapus file hanya setelah Anda berhasil memprosesnya.
**T: Jika saya tidak sengaja menghapus file dari folder keluar, di mana saya dapat menemukan file asli?**
File tersedia di `lead-outbound-archive` folder `opportunity-outbound-archive` dan.
**T: Apa yang harus saya lakukan untuk dukungan selama pengembangan?**
Untuk bantuan selama pengembangan, hubungi dukungan AWS Partner Network (APN) di Partner Central.
**Q: Apa perbedaan antara `opportunityOwnerName` dan`opportunityOwnerEmail`?**
+ `opportunityOwnerName`: Nama pemilik peluang di organisasi mitra. Ini harus menjadi pengguna Partner Central.
+ `opportunityOwnerEmail`: Email pemilik peluang di organisasi mitra. Ini harus menjadi pengguna Partner Central. Jika tidak diberikan, peluang dibuat dengan Mitra Central Alliance Lead sebagai pemilik.
**T: Apa zona waktu untuk semua bidang tanggal (`targetCloseDate`,, `lastModifiedDate``createdDate`, dan`acceptBy`)?**
Zona waktu untuk bidang tanggal adalah Greenwich Mean Time (GMT).
**T: Apakah file JSON masuk berversi?**
Tidak. Amazon Web Services (AWS) tidak mendukung pembuatan versi file. APN Customer Engagement (ACE) memproses file segera setelah menerima dan kemudian menghapus file setelah pemrosesan berhasil. Jika kami menerima nama file yang sama lagi, itu ditolak.
**T: Bidang apa dalam file JSON Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3) yang menunjukkan tanggal pembuatan dan pembaruan terbaru dari prospek dan peluang tertentu?**
`createdDate` dan `lastModifiedDate`.
**T: Bagaimana Anda menentukan apakah suatu peluang baru atau sudah ada?**
Bidang `PartnerCrmUniqueIdentifier` ini adalah pengenal unik pada setiap peluang yang kami butuhkan dari mitra. Pengenal ini harus didefinisikan dalam CRM sumber sistem mitra. Kami menggunakan ini untuk menentukan apakah ada peluang AWS. Jika ada, kami memperbarui peluang dengan informasi yang dibagikan. Jika tidak, kami menciptakan peluang baru.
Ketika kami mengirim data ke mitra, kami menyertakan keduanya `PartnerCrmUniqueIdentifier` dan`apnCrmUniqueIdentifier`. Jika kesempatan yang dibagikan oleh AWS dikirim untuk pertama kalinya, Anda tidak akan melihat nilai apa pun`PartnerCrmUniqueIdentifier`. Ini membantu Anda memperlakukan peluang sebagai hal baru dari ACE. Setelah Anda menelannya ke CRM Anda, Anda mengirim pembaruan kembali kepada kami dengan keduanya dan`PartnerCrmUniqueIdentifier`. `apnCrmUniqueIdentifier`
**T: Apakah mungkin memiliki lebih dari satu file JSON keluar dan hasil di Amazon S3?**
Ya. Terkadang kami dapat menghasilkan lebih banyak file di folder keluar. Demikian pula, jika Anda mengirim file ke folder masuk, kami memprosesnya dan menyimpan file hasil di folder hasil. Anda harus menandai atau menghapus file hasil setelah diproses.
**T: Apakah file outbound berisi lebih dari satu record?**
Ya. File keluar dapat berisi beberapa catatan.
**T: Jika 20 peluang masuk dikirim dalam satu file JSON input di bawah bagian peluang, dan salah satu peluang tidak sesuai dengan standar APN, apa yang terjadi?**
Jika formatnya salah, terlepas dari kasusnya, seluruh file ditolak. Jika formatnya benar tetapi hanya satu peluang yang tidak dapat diproses di pihak kami, file hasil mencakup semua 20 peluang dan statusnya, bersama dengan pesan kesalahan untuk peluang yang gagal.
**T: Apa atribut kunci untuk memvalidasi jika file JSON berhasil diproses?**
Ini adalah atribut kunci untuk membantu Anda memahami apakah file JSON berhasil diproses.
```
{
"inboundApiResults": [
{
"warnings": null, // no warnings
"partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side
"isSuccess": true, // file successfully processed
"errors": null, //no errors reported
"apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
}
]
}
```
**T: Apa yang terjadi jika saya mengirim JSON yang tidak valid?**
Anda menerima respons kesalahan ini: "`[{input JSON}]`bukan tipe`object`”.
**T: Berapa banyak lead/opportunity catatan yang dapat dimasukkan dalam satu file JSON masuk?**
Maksimal 50 catatan dapat dalam satu file.
# Tanya Jawab Teknis—Amazon S3
**T: Di mana saya bisa mendapatkan dokumentasi Amazon Simple Storage Service (Amazon S3) REST API?**
Untuk informasi selengkapnya, lihat [Pendahuluan API Amazon S3 REST](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).
**T: Bagaimana cara mendapatkan detail kunci Amazon Web Services AWS Key Management Service (AWS KMS) untuk diautentikasi untuk mengakses bucket Amazon S3?**
AWS Partner Network (APN) membagikan kebijakan yang mencakup nama kunci.
**T: Bagaimana cara mengautentikasi Amazon S3 dari Salesforce.com (SFDC)?**
Gunakan file kode sampel [S3\$1Authentication.cls untuk mengautentikasi Amazon](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) S3 dari SFDC.
**T: Bagaimana cara mengunggah file dari kit pengembangan AWS perangkat lunak (SDK) ke S3?**
Gunakan perintah AWS CLI berikut untuk mengunggah file ke S3.
```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```
File kode sampel [Sample\$1 AceOutboundBatch .cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) berisi kode untuk mengunggah file data dari SFDC.
**T: Siapa yang memiliki ember Amazon S3?**
AWS memiliki dan mengelola ember Amazon S3. Anda memiliki akses terprogram ke bucket Amazon S3 Anda sendiri dengan AWS Identity and Access Management pengguna (IAM).
**T: Apakah ada folder atau ember terpisah untuk menerima dan mengirim file?**
Ada satu ember dengan folder berbeda untuk menerima dan mengirim file. Lihat panduan pengguna untuk detail lebih lanjut tentang folder.
**T: Apakah saya perlu mengakses bucket Amazon S3 menggunakan AWS Lambda, atau dapatkah saya mengaksesnya secara langsung menggunakan sistem manajemen hubungan pelanggan (CRM)?**
Anda dapat mengaksesnya dengan dua cara.
**T: Apakah bucket Amazon S3 diamankan atau dienkripsi?**
Ya. Kami mengaktifkan mekanisme enkripsi default yang ditawarkan Amazon S3.
**T: Apakah mungkin mengaktifkan Amazon Simple Notification Service (Amazon SNS) mendengarkan bucket Amazon S3, jadi saya hanya dapat menindaklanjuti acara tersebut, alih-alih melakukan polling secara berkala?**
Tidak. Saat ini, APN Customer Engagement (ACE) tidak mendukung fitur ini.
**T: Folder apa yang dapat saya akses dan apa tujuan dari setiap folder?**
Anda dapat menemukan daftar folder Amazon S3 di. [Prasyarat integrasi](crm-integration-setting-up.md)
# Tanya Jawab Teknis — Prospek dan Peluang
## Mengirim dan menerima prospek dan peluang
**T: Apakah ada konvensi penamaan file?**
Setiap nama file harus unik. Kami merekomendasikan nama file`PartnerProvided FileName+{timestamp}.json`.
**T: Apa struktur hasilnya?**
Contoh file untuk hasil (sukses dan kesalahan) dapat diunduh dari lokasi berikut:
+ [Hasil Utama Sampel Sukses.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json)
+ [Hasil Peluang Sampel Sukses.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json)
+ [Hasil Pimpin Dengan Kesalahan Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json)
+ [Hasil Peluang Dengan Kesalahan Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json)
**T: Apa konvensi penamaan hasil?**
`PartnerProvidedFileName_result.json`
**T: Bagaimana jika saya mengirimkan file JSON kedua dengan nama yang sama?**
Kami tidak akan memproses file, dan file dipindahkan ke folder arsip.
**T: Berapa batas ukuran file masuk?**
Batas ukuran file masuk adalah 1MB.
**T: Apakah ada jumlah peluang dan prospek maksimum yang dapat dikelompokkan ke dalam satu file JSON?**
Mengingat batas 1MB, kami sarankan Anda memiliki satu peluang atau prospek per file.
**T: Saya mendapatkan pesan kesalahan akses ditolak, jadi saya tidak dapat mengunggah file. Apa yang harus saya lakukan?**
Mitra menerima pesan *Akses ditolak* karena dua alasan.
1. Anda mengunggah file ke `outbound` folder alih-alih `inbound` folder. Unggah file ke `inbound` folder.
1. Anda perlu menyediakan daftar kontrol akses (ACL). Gunakan perintah Amazon Web Services (AWS) CLI berikut untuk mengunggah file data:
```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```
**T: Apa yang terjadi jika file dengan ekstensi seperti`.pdf`,`.docx`, atau apa pun selain `.json` diunggah?**
Kami menolak file dan menghasilkan `*.error.json` file dengan detail alasannya.
**T: Apa yang harus saya lakukan setelah saya menerima pesan kesalahan masalah data dalam produksi?**
1. Jika data perlu diperbaiki dalam sistem manajemen hubungan pelanggan (CRM) mitra, setelah Anda memperbaiki data, kirim file yang direvisi ke Amazon Simple Storage Service (Amazon S3).
1. Jika ada klarifikasi yang diperlukan untuk data, hubungi Manajer Pengembangan Mitra (PDM) Anda.
1. Untuk dukungan teknis lainnya, angkat kasus dukungan AWS Partner Network (APN) di Portal APN.
**T: Di mana saya dapat menemukan file hasil dan berapa lama mereka tersedia?**
File hasil ada di `opportunity-inbound-results` folder `lead-inbound-results` dan. Mereka tersedia sampai Anda menghapusnya. Anda dapat menghapus file setelah penarikan berhasil.
**T: Jika saya perlu menemukan file hasil setelah saya menghapusnya, di mana kita dapat menemukannya?**
Anda dapat menemukan file hasil di `opportunity-inbound-results-archive/YYYY/MM/DD` folder `lead-inbound-results-archive/YYYY/MM/DD` dan.
**T: Jika ada kegagalan dalam APN memproses file, bagaimana saya diberitahu?**
APN memiliki alarm yang secara otomatis membuat tiket Sev2 untuk melacak kesalahan pemrosesan. Kami meninjau, menyelesaikan, dan mengomunikasikannya kepada mitra.
**T: Bidang apa yang dapat diperbarui setelah peluang diluncurkan?**
Bidang berikut hanya dapat diperbarui oleh Mitra Akselerasi Penjual Perangkat Lunak Independen (ISV):
+ `isThisForMarketplace`
+ `isNetNewBusinessForCompany`
+ `deliveryModel`
+ `awsFieldEngagement`
+ `additionalComments`
**T: Saya menerima kesalahan *Catatan tidak dapat diedit*. Apa artinya?**
Ketika Anda mengirim peluang yang dirujuk mitra baru, itu akan melalui proses validasi dan tim APN Customer Engagement (ACE) harus menyetujui atau menolaknya. Saat peluang sedang ditinjau dan belum divalidasi, Anda tidak dapat memperbarui catatan, dan Anda menerima kesalahan ini.
**T: Apa yang terjadi jika tidak ada aktivitas di pihak saya (contoh: Saya tidak memproses file atau tidak mengirim peluang masuk)?**
Jika Anda tidak mengirim informasi apa pun atau tidak memproses file yang kami sediakan, saat ini kami tidak memiliki mekanisme untuk mengingatkan Anda. Kami mendorong Anda untuk memantau sistem Anda untuk memastikan informasi mengalir ke APN.
**T: Seberapa cepat hasil JSON tersedia di folder hasil setelah pengajuan peluang/prospek new/updated masuk?**
Pemrosesannya hampir real time. Anda harus menerima file dalam waktu kurang dari lima menit.
**T: Jika saya mengirim CRM peluang masuk yang tidak mematuhi format/length batasan standar APN, bagaimana sistem menanganinya? Apakah itu menghasilkan laporan kesalahan?**
Jika file tidak dalam format definisi bidang, file hasil dari APN akan memanggil file tersebut.
**T: Saya tidak memiliki ID AWS akun pada saat peluncuran. Apa yang harus saya lakukan?**
Per proses ACE, `Launched` berarti beban kerja selesai dan penagihan dimulai. Ini membutuhkan ID AWS akun. Untuk informasi lebih lanjut, lihat [Program ACE FAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ).
**T: Setelah Pengujian Penerimaan Pengguna (UAT), bagaimana seharusnya data historis ditangani selama pindah ke produksi?**
Secara default, ketika ada pembaruan yang terjadi di ACE, kami mengirimkan peluang tersebut ke bucket Amazon S3. Untuk data historis yang tidak ingin Anda proses, Anda perlu memberikan nilai dummy seperti `X0001, X0002….X000N` dalam ekstrak untuk apa yang tidak ingin Anda proses di sistem Anda. `partnerCrmUniqueIdentifier` Anda perlu menulis kode untuk mengenali pengidentifikasi ini dan memprosesnya sesuai dengan itu. Peluang lainnya memberikan `partnerCrmUniqueIdentifier` nilai yang benar. Ini memastikan bahwa Anda memiliki kontrol penuh pada apa yang harus diproses dan apa yang tidak diproses dalam sistem Anda.
**T: Apakah file outbound berisi lebih dari satu record?**
Ya. File keluar dapat berisi lebih dari satu catatan.
**T: Mengapa data mengirim *Terima untuk melihat* beberapa bidang?**
Untuk peluang atau prospek yang AWS dirujuk, semua bidang PII ditutupi dengan label *Terima untuk melihat* sampai peluang atau prospek diterima oleh Anda. Setelah diterima, Anda menerima semua bidang data dalam siklus sinkronisasi berikutnya.
**T: Apa yang harus saya lakukan ketika peluang atau prospek yang AWS dirujuk baru disinkronkan untuk pertama kalinya?**
Ketika peluang atau prospek baru disinkronkan untuk pertama kalinya, Anda harus menerima atau menolaknya untuk mendapatkan data tambahan (contoh: kontak pelanggan).
## Membuat dan memperbarui peluang/prospek
**T: Bagaimana cara memanfaatkan peluang *Partner Referred (Originated)* baru ke dalam ACE melalui integrasi?**
Untuk menciptakan peluang baru di ACE melalui integrasi, Anda perlu mencerna informasi peluang yang diperlukan dalam format JSON yang ditentukan ke dalam folder`opportunity-inbound`. AWS memproses informasi ini, menciptakan peluang baru di ACE, dan membagikan hasil operasi successful/failed buat di `opportunity-inbound-processed-results` folder.
**T: Bagaimana integrasi membedakan antara pengiriman peluang baru dan pembaruan?**
Bidang `PartnerCrmUniqueIdentifier` pada setiap kesempatan adalah pengidentifikasi unik yang diperlukan. Pengenal ini harus didefinisikan dalam CRM sumber sistem Anda. AWS menggunakan ini untuk menentukan apakah peluang sudah ada di ACE. Jika tersedia di ACE, kami menggunakan informasi yang dibagikan untuk memperbarui peluang, tetapi jika tidak tersedia di ACE, kami menggunakan informasi yang dibagikan untuk menciptakan peluang baru.
**T: Jika saya sudah menerapkan fungsionalitas pembaruan melalui integrasi, apa yang harus saya lakukan untuk menggunakan integrasi untuk mengirimkan (membuat) peluang baru?**
Anda perlu membuat perubahan berikut pada integrasi yang ada:
1. Mulai menelan peluang baru untuk pembuatan di `opportunity-inbound` folder. Berikan pembaruan di folder yang sama.
1. Pastikan bahwa bidang wajib yang diperlukan untuk membuat tersedia di Opportunity JSON yang dibagikan.
1. Verifikasi setiap peluang baru memiliki keunikan `PartnerCrmUniqueIdentifier` yang tidak ada di ACE/Partner Central. Praktik terbaik go-live yang penting adalah memetakan dan memperbarui data yang ada di ACE ke masing-masing `PartnerCrmUniqueIdentifier` CRM Anda sehingga kami tidak membuat duplikat saat kami menerima pembaruan. Untuk bantuan, hubungi ACE.
**T: Sebagai bagian dari proses go-live, bagaimana cara memperbarui peluang yang ada di ACE dengan saya? `PartnerCrmUniqueIdentifier`**
Tim ACE memberi Anda daftar semua peluang terbuka untuk membantu persiapan peluncuran produksi. Anda harus memetakan peluang yang ada di ACE ke masing-masing`PartnerCrmUniqueIdentifier`, dan mengembalikan file yang diperbarui ke ACE untuk diintegrasikan ke dalam AWS CRM.
Jika Anda memilih untuk menyinkronkan hanya sebagian dari peluang yang AWS disediakan, Anda harus mengembangkan logika untuk melewati AWS pembaruan untuk setiap peluang yang tidak ingin Anda proses. Pendekatan ini juga harus diterapkan pada peluang masa depan, pasca-orientasi. Anda harus menyediakan yang terkait `partnerCrmUniqueIdentifier` untuk peluang yang membutuhkan penyelarasan di keduanya CRMs. Selain itu, Anda harus menunjukkan peluang mana yang tidak akan Anda perbarui (contoh: Menandai peluang tertutup yang hilang atau tertutup) untuk mengecualikannya dari pembaruan. Sangat penting bahwa semua peluang terbuka/aktif yang AWS berbagi, dan Anda menerima, diberikan a. `partnerCrmUniqueIdentifier`
**T: Dapatkah saya memperbarui hanya bidang tertentu dalam peluang atau prospek?**
Ya. Anda hanya dapat menyediakan bidang yang memerlukan pembaruan, bersama dengan pengidentifikasi yang diperlukan.
**T: Apakah mungkin untuk mengubah *ApnCrmUniqueIdentifier***?
Tidak. Pengidentifikasi ini tetap konstan AWS dan secara unik mengidentifikasi setiap peluang.
**T: Bagaimana jika saya memberikan *partnerCrmUniqueIdentifier* yang salah**?
Jika Anda memberikan pengenal yang salah, peluang baru dibuat. Pastikan akurasi untuk menghindari duplikasi data.
**T: Dapatkah saya memperbarui peluang yang AWS dikirimkan?**
Ya. Anda dapat memperbarui peluang yang AWS dikirimkan menggunakan yang benar`partnerCrmUniqueIdentifier`.
**T: Seberapa cepat saya dapat mengharapkan hasil untuk peluang yang diajukan?**
Pemrosesan hampir real time, dan hasilnya biasanya tersedia dalam beberapa menit di `opportunity-inbound-processed-results` folder.
**T: Apa yang harus saya lakukan jika ada kesalahan pemrosesan untuk peluang yang diajukan?**
Tinjau detail kesalahan dalam file hasil, atasi masalah, dan cari bantuan lebih lanjut dari tim dukungan ACE.
**T: Dapatkah saya menghapus peluang melalui integrasi?**
Tidak. Penghapusan langsung tidak didukung. Anda dapat memperbarui kesempatan untuk mencerminkan status *Tertutup*.
**T: Apa arti kesalahan *Record not editable*?**
Kesalahan ini terjadi jika Anda mencoba memperbarui peluang dalam ulasan ACE. Peluang ini tidak dapat diedit sampai divalidasi.
**T: Bagaimana jika tidak mengirim pembaruan atau peluang baru?**
Tidak ada data baru yang diterima dan diproses jika Anda tidak mengirim pembaruan atau peluang baru melalui integrasi.
**T: Berapa lama file hasil tersedia?**
File hasil tersedia untuk durasi yang wajar. Anda harus mengambil dan mengelolanya segera.
# Tanya Jawab Teknis—Versioning dan kompatibilitas mundur
**T: Apa yang dimaksud dengan payload dalam pertukaran data Amazon Web Services (AWS)?**
Payload adalah bagian terstruktur dari data yang diformat dalam JSON, dikirim baik masuk atau keluar dari. AWS AWS Setiap kunci dalam struktur JSON ini disebut sebagai *bidang*, dan setiap bidang memiliki *nilai* terkait.
**T: Bagaimana versi payload ditentukan?**
Versi payload ditentukan dalam `version` bidang payload itu sendiri. Muatan yang mengikuti definisi bidang v13 dianggap Payload Versi 1.0, sedangkan yang mengikuti format yang ditentukan dalam definisi bidang v14 atau lebih tinggi disebut sebagai Payload Versi 2.0.
**T: Apa arti kompatibilitas mundur dalam konteks ini, dan bagaimana penanganannya?**
Kompatibilitas mundur memastikan bahwa peluang yang ada tidak gagal saat bidang baru dan wajib diperkenalkan dalam versi payload yang lebih baru. AWS mempertahankan ini dengan menetapkan nilai default secara otomatis ke bidang yang diperlukan dalam versi baru. Anda mungkin melihat nilai dalam UI AWS Partner Network (APN) Customer Engagement (ACE) yang tidak Anda berikan secara eksplisit melalui Integrasi Customer Relationship Management (CRM). Rincian dan ketentuan untuk setiap bidang dijelaskan dalam deskripsi bidang atau detail tambahan tentang bidang tersebut.
**T: Apakah kompatibilitas mundur merupakan fitur permanen?**
Tidak. Kompatibilitas mundur terikat waktu, dirancang untuk memberikan fleksibilitas bagi Anda untuk merencanakan dan mengimplementasikan perubahan yang akan datang. Ini berhenti bekerja di luar tanggal cut-off yang ditentukan, yang akan diumumkan akhir tahun ini sebagai bagian dari peluncuran yang lebih luas.
**T: Apa yang terjadi ketika saya mulai mengirim muatan dengan versi 2.0?**
Setelah Anda mengirim payload dengan versi 2.0, sistem mengasumsikan bahwa semua perubahan yang diperlukan telah diterapkan, dan validasi untuk versi payload baru berlaku untuk semua perubahan berikutnya. Sangat penting bahwa Anda tidak menerapkan fitur sebagian antara versi 1.0 dan versi 2.0 payload.
**T: Dapatkah saya kembali ke payload versi 1.0 setelah memperbarui ke versi 2.0?**
Tidak. Transisi ke payload versi 2.0 adalah proses satu arah. Setelah Anda memperbarui ke versi 2.0, Anda tidak dapat kembali ke versi 1.0 dari payload.