Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Upgrade dari Amazon S3 ke API-based integrasi
catatan
Topik di bagian ini mengasumsikan Anda telah menyelesaikan prasyarat untuk integrasi Pusat AWS Mitra, integrasi AWS Marketplace, atau keduanya. Untuk informasi lebih lanjut, lihat Prasyarat integrasi dan Memulai sebelumnya dalam panduan ini.
Direkomendasikan: Sel esaikan aktivitas ini di lingkungan Sandbox terlebih dahulu, uji secara menyeluruh, lalu terapkan ke Produksi.
Bagian ini memandu Anda melalui peningkatan Konektor CRM AWS Partner Anda dari Amazon S3-based ke API-based integrasi. API-based Integrasi menggantikan model bucket Amazon S3 lama dengan sinkronisasi dua arah real-time melalui peran dan API IAM.
Untuk panduan interaktif sepenuhnya dengan tangkapan layar, lihat lokakarya peningkatan Konektor CRM AWS Partner
Upgrade melibatkan langkah-langkah berikut:
Prasyarat
Urutan operasi migrasi
Mitra sering bertanya apakah akan bermigrasi ke pengalaman Partner Central baru di Kon AWS sol atau memutakhirkan dari Amazon S3 ke API terlebih dahulu. Berikut adalah pendekatan yang disarankan:
| Skenario | Rekomendasi |
|---|---|
| Saat ini di Amazon S3, belum menggunakan pengalaman Partner Central baru | Bermigrasi ke API terlebih dahulu, lalu bermigrasi ke pengalaman Partner Central baru secara paralel atau setelahnya |
| Saat ini di Amazon S3, sudah menggunakan pengalaman Partner Central baru | Lanjutkan langsung dengan migrasi API |
| Sudah menggunakan API, belum menggunakan pengalaman Partner Central baru | Bermigrasi ke pengalaman Partner Central baru sesuka Anda |
Penautan akun adalah satu-satunya prasyarat sulit
Penautan akun adalah satu-satunya prasyarat sulit untuk S3-to-API migrasi Amazon. Migrasi ke pengalaman Partner Central yang baru TIDAK diperlukan untuk memulai peningkatan API.
Informasi kunci:
S3-based Integrasi Amazon tidak digunakan lagi dan tidak lagi tersedia untuk pengguna baru.
Mitra di Amazon S3 harus merencanakan untuk menyelesaikan migrasi ke API sesegera mungkin untuk menghindari degradasi layanan.
Periksa dokumentasi Integrasi CRM AWS Partner untuk mengetahui garis waktu terbaru di akhir masa pakai backend Amazon S3.
Pastikan Partner Central terhubung ke AWS akun
S3-based Konektor Amazon diautentikasi menggunakan izin ke bucket Amazon S3 terkelola di akun AWS manajemen. API-based Konektor malah mengautentikasi melalui peran IAM di AWS akun tertaut mitra sendiri untuk memanggil API Pusat Mitra secara langsung. Inilah sebabnya mengapa penautan akun adalah prasyarat teknis yang sulit: tanpanya, konektor tidak memiliki cara untuk menjangkau API Pusat Mitra dengan izin yang diperlukan.
Mengapa ini mungkin hilang
Ketika API Pusat Mitra untuk Penjualan AWS dirilis pada November 2024, penautan akun diperkenalkan untuk memungkinkan mitra mengakses API ini secara terprogram. Dari konektor versi 3.0 (juga November 2024), penautan akun menjadi persyaratan untuk API-based sinkronisasi. Mitra yang menyiapkan S3-based konektor Amazon mereka sebelum tanggal ini tidak akan menyelesaikan penautan akun.
Tautkan akun Pusat Mitra Anda ke AWS akun utama Anda. Pilih akun Anda dengan hati-hati sejak awal. Meskipun memutuskan tautan dan menautkan ulang akun yang berbeda dimungkinkan, hal itu menciptakan masalah persistensi data dan memerlukan upaya rekonsiliasi manual.
Aturan pemilihan akun — AWS akun harus:
Akun berbayar dengan reputasi baik (bukan Tingkat Gratis)
Dimiliki oleh perusahaan mitra (bukan akun distributor)
Memiliki alamat penagihan yang cocok dengan lokasi bisnis utama mitra
BUKAN kotak pasir, pengembang, pribadi, atau management/payer akun
Penautan akun bersifat permanen
Penautan akun bersifat permanen setelah migrasi Pusat Partner ke Kon AWS sol. Semua sumber daya APN (peluang ACE, riwayat, undangan multi-mitra) secara permanen terikat ke akun ini. Pilih dengan hati-hati.
Sumber Daya:
Bagian Penautan Akun dari lokakarya peningkatan
di situs web AWS Workshops Memutuskan tautan akun
di situs web Pusat Mitra
Opsional: Bermigrasi ke pengalaman Partner Central baru di AWS Konsol
Langkah ini tidak diperlukan untuk peningkatan S3-to-API konektor Amazon. Penautan akun saja menyediakan API-based fungsionalitas yang dibutuhkan. Namun, bermigrasi ke pengalaman Partner Central yang baru memberi tim Anda akses ke kemampuan tambahan:
Agen Pusat Mitra (Co-Sell Agen, Agen Pendanaan, Prospeksi Otonom)
Pengalaman AWS Konsol terpusat untuk mengelola aktivitas mitra bersama AWS sumber daya Anda
Peningkatan visibilitas ke peristiwa siklus hidup peluang langsung di konsol
Perubahan format ID Solusi
Jika Anda bermigrasi ke pengalaman Partner Central baru dan kemudian membuat solusi baru, solusi tersebut akan menggunakan soln-* format baru. Konektor CRM belum mendukung format ini; itu memerlukan S-* format lama untuk solutionOffered bidang tersebut. Solusi lama yang dibuat sebelum migrasi mempertahankan S-* format dan terus bekerja.
Lihat panduan migrasi Partner Central untuk detail selengkapnya.
Pre-migration pembersihan data
Sebelum memulai migrasi, pastikan pemotongan bersih dari S3-based integrasi Amazon. Langkah paling penting adalah menghapus pekerjaan terjadwal yang tersisa yang dapat mengganggu API-based konektor dan proses pengisian ulang.
Saat Anda menonaktifkan jadwal Amazon S3 melalui UI konektor, Pekerjaan Terjadwal Salesforce yang mendasarinya (dengan awalan APN) tetap ada di sistem. Jika ini masih ada saat Anda memulai pengisian ulang atau mengaktifkan API-based sinkronisasi, penjadwal lama dan konektor baru dapat menulis ke catatan yang sama secara bersamaan, menyebabkan pembuatan peluang duplikat atau konflik data.
Menonaktifkan di UI tidak cukup
Menonaktifkan jadwal di UI konektor tidak cukup. Anda juga harus menghapus entri Pekerjaan Terjadwal yang mendasarinya di Penyiapan Salesforce. Lihat Tinjau dan nonaktifkan jadwal untuk Amazon S3 langkah demi langkah lengkapnya.
Penyiapan AWS infrastruktur
Fase ini membutuhkan Administrator Salesforce untuk bekerja dengan Admin Cloud IT untuk menyiapkan dua komponen baru: Aplikasi Klien Eksternal Salesforce dan komponen AWS infrastruktur (EventBridge aturan dan peran IAM).
Menyiapkan Aplikasi Klien Eksternal Salesforce
Dengan versi Amazon S3, kedua arah sinkronisasi melewati bucket Amazon S3 bersama per mitra. Versi API membalik ini untuk pembaruan masuk — Partner Central sekarang mendorong acara langsung ke organisasi Anda secara real-time melalui. EventBridge Aplikasi Klien Eksternal mengaktifkan aliran KredenSIAL Klien OAuth 2.0 sehingga EventBridge dapat mengirimkan pemberitahuan saat terjadi.
Administrator Salesforce harus mengikuti instruksi di bagian Siapkan
Penyiapan AWS komponen
AWS Infrastruktur untuk versi API meliputi:
EventBridgeuntuk pemrosesan acara real-time
Peran IAM untuk otentikasi aman
Komponen ini menggantikan model akses bucket Amazon S3 yang digunakan dalam versi sebelumnya.
Admin IT Cloud harus menerapkan CloudFormation template dengan mengikuti instruksi di bagian A
Selesaikan penyiapan dan konfigurasi dalam Salesforce
Konfigurasi yang tersisa dilakukan oleh Administrator Salesforce. Selesaikan aktivitas di Sandbox terlebih dahulu, uji, lalu pindah ke Produksi.
Instal versi terbaru AWS Partner CRM Connector dari Salesforce AppExchange
Meninjau dan menyesuaikan pemetaan Anda
Dengan versi Amazon S3, sinkronisasi keluar bergantung pada Has Updates for AWS bidang Sync with AWS dan. Ini tidak lagi digunakan dalam API-based integrasi.
Dengan versi API, sinkronisasi keluar dikontrol melalui pengaturan Aktifkan Bagikan dengan AWS Integrasi di pengaturan kustom AWS
Partner CRM Connector (Companion_App_Settings__c). Ketika diaktifkan, Peluang ACE secara otomatis dibagikan AWS setiap kali pembaruan kualifikasi terjadi.
Poin kunci:
Ob jek ACE Opport unity direkomendasikan sebagai area pendaratan — objek ini cocok dengan titik data AWS peluang di Partner Central dan memungkinkan pemetaan otomatis.
Jika Anda sudah menggunakan ACE Opportunity untuk pemetaan integrasi Anda, konfigurasi yang mendasarinya tidak berubah. Namun, paket yang ditingkatkan memperkenalkan bidang baru yang tidak ada di versi sebelumnya.
Tinjau otomatisasi apa pun yang mereferensikan S3-era bidang Amazon lama (
Sync_with_AWS__c,Has_Updates_for_AWS__c) untuk menggunakan padanan baru.
Model data ACE Opportunity tersedia di situs GitHub web
Versi konektor terbaru menyertakan template aliran untuk membantu memetakan peluang standar Anda ke peluang ACE. Untuk detail selengkapnya, lihat template alur.
Tinjau dan tambahkan kolom dan tombol yang diperlukan
Konektor telah memperkenalkan bidang dan tombol baru sejak versi 3.0+. Anda harus memperbarui tata letak halaman catatan petir Anda secara manual.
Tambahkan tombol berikut ke halaman catatan petir ACE Opportunity:
| Tombol | Tujuan |
|---|---|
| Berbagi dengan AWS | Dorong peluang secara manual ke Pusat Mitra melalui API. |
| Refresh dari AWS | Menarik data terbaru dari Partner Central ke dalam catatan ACE Opportunity ini. |
| Accept/Reject | Terima atau tolak peluang AWS yang dirujuk. |
| Associate/Disassociate | Tautkan atau putuskan tautan dengan Solusi AWS Mitra, Produk, dan Penawaran Marketplace yang disetujui. |
| Menetapkan | Tetapkan kembali kesempatan kepada pengguna lain di akun Pusat Mitra Anda. |
Hapus tombol lama berikut dari halaman catatan petir ACE Opportunity:
| Tombol | Alasan |
|---|---|
| Kirim ke AWS | Digantikan oleh Share with AWS. |
| Tautan Penawaran Pribadi | Diganti oleh Associate/Disassociate. |
Tambahkan tombol tampilan daftar berikut ke tab ACE Opportunity:
Terima Peluang — Bulk-accept banyak peluang yang AWS dirujuk.
Tetapkan Pel uang - Bulk-reassign banyak peluang.
Untuk bidang baru, tinjau semua bidang yang ditambahkan setelah Konektor Versi 3.0
Tinjau dan nonaktifkan jadwal untuk Amazon S3
Dengan API-based pendekatan ini, tidak ada lagi kebutuhan untuk pekerjaan terjadwal - integrasi berjalan secara real time.
Untuk menonaktifkan pekerjaan terjadwal
Arahkan ke tab Jadwal dalam aplikasi AWS Partner CRM Connector.
Pilih N onaktifkan Semua Pekerjaan dan kemudian pilih N onaktifkan lagi.
Juga hapus catatan yang dijadwalkan. Untuk menghapus sisa pekerjaan terjadwal APN dari Pengaturan:
Untuk menghapus pekerjaan terjadwal APN dari Pengaturan
Arahkan ke Pengaturan. Cari “Terjadwal” dan pilih Pekerjaan Terjadwal.
Tinjau daftar untuk APN-related pekerjaan apa pun. Pilih Del untuk menghapusnya.
Terus CustomLogInteractionBatch berlari
Jaga agar CustomLogInteractionBatch pekerjaan tetap berjalan (AppExchange App Analytics).
Hapus pekerjaan yang dijadwalkan, jangan hanya menonaktifkan
Jangan tinggalkan pekerjaan dalam status “dinonaktifkan tetapi tidak dihapus”. Pekerjaan yang tersisa telah menyebabkan penciptaan peluang duplikat ketika dikombinasikan dengan sinkronisasi API-based waktu nyata.
Pembersihan
Nonaktifkan aturan validasi lama
Beberapa aturan validasi lama harus dinonaktifkan dan yang lainnya harus tetap aktif. Lihat bagian lokakarya ini
Juga pastikan aliran lama berikut telah dinon aktifkan:
Sinkronkan ACE Opportunity ke API Pusat Mitra
Pencarian Penawaran Pribadi
Pemberitahuan Kegagalan Sinkronisasi APN
Memperbarui bidang Penawaran Pribadi Pada Peluang ACE
Memperbarui bidang peluang Ace pada Catatan Detail Log Sinkronisasi
Alur Standard-ACE Sinkronisasi Peluang Terpadu (templat)
Uji proses Anda sebelum pindah ke produksi. Lihat pengujian dari pengaturan
Pengisian kembali peluang lengkap dari AWS ke Salesforce
Jalankan isi ulang untuk memastikan kecocokan data antar lingkungan. Bid awsapn__Last_Modified_Date__c ang pada Peluang ACE harus cocok dengan Tanggal Modifikasi Terakhir di Pusat Mitra agar pembaruan di masa mendatang dapat disinkronkan. Integrasi Amazon S3 tidak mengisi bidang ini, jadi peluang migrasi dari Amazon S3 akan membuatnya kosong — isi ulang mengisinya.
Isi ulang menawarkan tiga mode:
| Modus | Apa yang dilakukannya | Kapan harus digunakan |
|---|---|---|
| Hanya peluang refresh yang hilang Tanggal Modifikasi Terakhir | Memperbarui hanya catatan di awsapn__Last_Modified_Date__c mana kosong | Direkomendasikan untuk S3-to-API migrasi Amazon |
| Hanya menyegarkan AWS peluang yang sudah ada di Salesforce | Memperbarui semua catatan yang sudah memiliki ID CRM APN | Alternatif aman untuk migrasi |
| Segarkan semua AWS peluang | Menarik seluruh pipeline Partner Central ke Salesforce | Hanya digunakan pada instalasi baru |
Sebelum menjalankan isi ulang:
Konfirmasikan semua pekerjaan terjadwal APN dihapus (tidak hanya dinonaktifkan).
Nonaktifkan alur “Sinkronkan Peluang ACE ke API Pusat Mitra” jika aktif.
Nonaktifkan Aktifkan AWS Bag ikan dengan Integrasi di pengaturan khusus (
Companion_App_Settings__c).Selesaikan pembersihan data pra-migrasi yang dijelaskan di. Pre-migration pembersihan data
Setelah isi ulang selesai:
Re-enable Aktifkan Bagikan dengan AWS Integr asi — ini mendorong sinkronisasi yang berkelanjutan.
Alur “Sinkronkan Peluang ACE ke API Pusat Mitra” TIDAK perlu diaktifkan kembali.
Verifikasi sampel catatan untuk mengonfirmasi
awsapn__Last_Modified_Date__ctelah diisi.
Untuk detail selengkapnya, lihat bagian
Post-migration: Memantau EventBridge acara
Setelah bermigrasi, organisasi Salesforce Anda menerima pembaruan real-time dari Pusat Mitra melalui. EventBridge Untuk memverifikasi peristiwa mengalir:
CloudWatch Metrik: Arahkan ke CloudWatch > Metrik > EventBridge. Periksa Pemanggilan dan FailedInvocations untuk Tujuan API Anda.
Log Sinkronisasi Salesforce: Pada setiap Peluang ACE, periksa daftar terkait Log Sinkronisasi untuk entri masuk terbaru.
EventBridge Pemantauan A turan: Periksa aturan yang dibuat oleh CloudFormation template untuk peristiwa yang cocok baru-baru ini.
| Gejala | Kemungkinan penyebabnya | Resolusi |
|---|---|---|
| Tidak ada pembaruan masuk di Salesforce | Token Aplikasi Klien Eksternal kedaluwarsa | Re-authenticate aplikasi yang terhubung; verifikasi kredenSIAL OAuth di Tujuan API EventBridge |
| Acara berhenti setelah bekerja | Batas waktu sesi Salesforce | Periksa kesehatan Tujuan API di EventBridge; sambungkan kembali |
| Pembaruan sebagian (beberapa bidang hilang) | Ketidakcocokan pemetaan lapangan | Tingkatkan ke versi konektor terbaru; verifikasi pemetaan bidang |
Memecahkan masalah migrasi umum
| Kesalahan/Gejala | Penyebab galat | Resolusi |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTIONsaat mengklik “Refresh dari AWS” | Aturan validasi lama tidak dinonaktifkan | Nonaktifkan ACEOppNew_PreventUpdatesWhenPOSubmitted dan ACEOpp_PreventUpdatesWhenPOSubmitted |
| Peluang duplikat | Pekerjaan terjadwal yang tersisa atau beberapa pengguna integrasi | Hapus SEMUA pekerjaan terjadwal APN. Verifikasi hanya satu pengguna memegangAPN Business Admin. |
| Sinkronisasi catatan log berkembang pesat | Rekaman gagal validasi coba lagi setiap siklus | Identifikasi catatan yang gagal melalui log sinkronisasi. Perbaiki bidang wajib yang hilang. |
| Isi ulang melebihi batas penyimpanan | Terlalu banyak rekaman sekaligus | Jalankan dalam batch yang lebih kecil. Memantau penyimpanan. |
| “Refresh dari AWS" menunjukkan data basi | awsapn__Last_Modified_Date__cketidakcocokan | Re-run isi ulang yang ditargetkan menggunakan “Hanya peluang refresh yang hilang Tanggal Modifikasi Terakhir” |
| Peluang dari Partner Central tidak muncul | EventBridge masalah koneksi atau berbagi otomatis dinonaktifkan | Veri EventBridge fikasi kesehatan Tujuan API. Konfirmasikan “Aktifkan Bag AWS ikan dengan Integrasi” diaktifkan. |
Mendapatkan bantuan
Jika Anda mengalami masalah yang tidak dapat diselesaikan oleh langkah sebelumnya:
Buka kasus dukungan: Pusat Mitra → Dukungan → Buka Kasus Baru
→ Integrasi CRM Bantuan migrasi: Untuk migrasi kompleks (500+ peluang, integrasi khusus, atau insiden produksi sebelumnya), mintalah dukungan langsung melalui Pemimpin Aliansi Anda.
