Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# SharePoint Integrasi Microsoft
Gunakan SharePoint integrasi Microsoft untuk melakukan tindakan pada SharePoint daftar, item, dan file, atau untuk membuat basis pengetahuan dari SharePoint konten untuk pencarian dan Tanya Jawab yang didukung AI.
## Apa yang dapat Anda lakukan
**Konektor aksi**
Kelola SharePoint daftar, item, file, dan buku kerja Excel melalui panggilan Microsoft Graph API.
**Basis pengetahuan**
Indeks pustaka SharePoint dokumen, situs, dan halaman. Agen Amazon Quick kemudian dapat mencari dan menjawab pertanyaan tentang konten.
# Integrasi SharePoint tindakan Microsoft
Gunakan konektor SharePoint tindakan Microsoft untuk mengelola daftar, item, file, dan buku kerja Excel secara langsung di Amazon Quick melalui bahasa alami.
Menyiapkan integrasi ini melibatkan dua langkah. Pertama, Anda mendaftarkan aplikasi di Microsoft Entra dan mengonfigurasi izinnya. Kemudian, Anda membuat integrasi di Amazon Quick dan menghubungkannya ke aplikasi Entra Anda. Untuk informasi tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode otentikasi](quick-action-auth.md).
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Microsoft 365 dengan SharePoint akses.
+ Akses ke [pusat admin Microsoft Entra](https://entra.microsoft.com/) dengan setidaknya izin Pengembang Aplikasi.
+ Untuk persyaratan berlangganan, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## Konfigurasikan Microsoft Entra
Sebelum Anda mengonfigurasi Amazon Quick, buat pendaftaran aplikasi di Microsoft Entra. Selesaikan semua langkah berikut di Entra sebelum pindah ke konsol Amazon Quick.
Untuk informasi selengkapnya tentang pendaftaran aplikasi, lihat [Mendaftarkan aplikasi dengan platform identitas Microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app) di dokumentasi Microsoft.
### Daftarkan aplikasi
1. Buka [pusat admin Microsoft Entra](https://entra.microsoft.com/).
1. Di navigasi kiri, pilih **Entra ID**, lalu pilih **Pendaftaran aplikasi**.
1. Pilih **Pendaftaran baru**.
1. Untuk **Nama**, masukkan nama deskriptif untuk integrasi Anda.
1. Untuk **jenis akun yang didukung**, pilih **Akun di direktori organisasi ini saja**.
1. Untuk **Redirect URI**, pilih **Web** dan masukkan`https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`. Ganti *\$1region\$1* dengan AWS Wilayah tempat instans Amazon Quick Anda digunakan.
1. Pilih**Pendaftaran**.
1. Pada halaman ikhtisar, salin ID **Aplikasi (klien) dan ID** **Direktori (penyewa)**. Anda memerlukan nilai-nilai ini untuk konfigurasi Amazon Quick.
### Buat rahasia klien
Amazon Quick membutuhkan rahasia klien untuk mengautentikasi dengan Microsoft Entra. Rahasia ini bertindak sebagai kata sandi untuk pendaftaran aplikasi.
1. Dari pendaftaran aplikasi Anda, pilih **Sertifikat & rahasia**.
1. Pilih **Rahasia klien baru**.
1. Masukkan deskripsi dan pilih periode kedaluwarsa.
1. Pilih **Tambahkan**.
1. Salin **Nilai** segera. Nilai ini hanya ditampilkan sekali.
**penting**
Salin **Nilai** rahasia, bukan ID Rahasia. Nilai adalah string yang lebih panjang yang digunakan untuk otentikasi.
### Konfigurasikan izin API
Microsoft Graph mendukung dua jenis izin untuk integrasi ini. Izin yang didelegasikan memungkinkan aplikasi bertindak atas nama pengguna yang masuk. Izin aplikasi memungkinkan aplikasi untuk bertindak tanpa pengguna yang masuk. Untuk informasi selengkapnya, lihat [Ringkasan izin Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-overview) di dokumentasi Microsoft.
1. Dari pendaftaran aplikasi Anda, pilih **izin API**.
1. Pilih **Tambahkan izin**, lalu pilih **Microsoft Graph**.
1. Pilih **Izin yang didelegasikan** atau **Izin aplikasi** berdasarkan metode otentikasi Anda, dan tambahkan izin dari tabel yang sesuai di bawah ini.
1. Pilih **Berikan izin admin untuk [nama penyewa Anda]** untuk menyetujui izin.
**Untuk otentikasi pengguna (izin yang didelegasikan):**
Tambahkan yang berikut ini sebagai Izin yang didelegasikan dalam pendaftaran aplikasi Entra Anda. Untuk referensi izin lengkap, lihat referensi izin [Microsoft Graph](https://learn.microsoft.com/en-us/graph/permissions-reference) di dokumentasi Microsoft.
**SharePoint integrasi tindakan - izin yang didelegasikan**
| Izin | Deskripsi |
| --- | --- |
| Files.ReadWrite | Memungkinkan aplikasi membaca, membuat, memperbarui, dan menghapus file pengguna yang masuk. |
| Sites.ReadWrite.All | Memungkinkan aplikasi untuk mengedit atau menghapus dokumen dan mencantumkan item di semua koleksi situs atas nama pengguna yang masuk. |
| offline\$1access | Memungkinkan aplikasi untuk menyegarkan token akses tanpa mengharuskan pengguna untuk masuk lagi. Ini mengurangi seberapa sering pengguna perlu melakukan autentikasi ulang. |
**Untuk otentikasi layanan (izin aplikasi):**
Tambahkan yang berikut ini sebagai izin Aplikasi dalam pendaftaran aplikasi Entra Anda.
**SharePoint integrasi tindakan - izin aplikasi**
| Izin | Deskripsi |
| --- | --- |
| Sites.ReadWrite.All | Memungkinkan aplikasi membuat, membaca, memperbarui, dan menghapus dokumen dan mencantumkan item di semua koleksi situs tanpa pengguna yang masuk. |
**penting**
Dengan otentikasi layanan, semua tindakan dijalankan sebagai akun layanan. Setiap pengguna dengan akses ke integrasi ini dapat melakukan tindakan di semua koleksi situs yang dapat diakses oleh akun layanan. Cakupan izin aplikasi dengan tepat untuk persyaratan keamanan organisasi Anda.
### Rekam kredensional Anda
Sebelum meninggalkan pusat admin Microsoft Entra, konfirmasikan bahwa Anda memiliki nilai berikut. Anda membutuhkannya untuk konfigurasi Amazon Quick.
**Kredensi yang diperlukan dari Microsoft Entra**
| Nilai | Di mana menemukannya |
| --- | --- |
| ID Aplikasi (klien) | Halaman ikhtisar pendaftaran aplikasi |
| ID Direktori (penyewa) | Halaman ikhtisar pendaftaran aplikasi |
| Nilai rahasia klien | Sertifikat & halaman rahasia |
## Siapkan integrasi di Amazon Quick
Setelah Anda menyelesaikan konfigurasi Entra, buat integrasi di Amazon Quick.
1. Di konsol Amazon Quick, pilih **Integrasi.**
1. Pilih **Microsoft SharePoint** dan pilih tombol Tambah (plus “\$1”).
1. Pilih tab **Tindakan**.
1. Pilih **Lakukan tindakan di Microsoft SharePoint**.
1. Isi detail integrasi:
+ **Nama — Nama** deskriptif untuk SharePoint integrasi Anda.
+ **Deskripsi** (Opsional) — Tujuan integrasi.
1. Pilih jenis koneksi Anda dan isi pengaturan koneksi:
1. Untuk **autentikasi Pengguna (OAuth)**, konfigurasikan bidang berikut:
+ **URL dasar** — `https://graph.microsoft.com/v1.0`
+ **ID Klien — ID** Aplikasi (klien) dari pendaftaran aplikasi Entra Anda.
+ **Rahasia Klien** — Nilai rahasia klien dari pendaftaran aplikasi Entra Anda.
+ **URL Token** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **URL Auth** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize`
+ **URL pengalihan** - `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Untuk **otentikasi Layanan**, konfigurasikan bidang berikut:
+ **ID Klien — ID** Aplikasi (klien) dari pendaftaran aplikasi Entra Anda.
+ **Rahasia Klien** — Nilai rahasia klien dari pendaftaran aplikasi Entra Anda.
+ **URL Token** — `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **Lingkup** - `.default`
1. Pilih **Buat dan lanjutkan**.
1. Pilih pengguna untuk berbagi integrasi dengan.
1. Pilih **Berikutnya**.
## Tindakan yang tersedia
Setelah Anda mengatur integrasi, tindakan berikut tersedia.
**Tindakan Microsoft SharePoint yang tersedia**
| Kategori | Tindakan | Deskripsi |
| --- | --- | --- |
| Daftar dan item | Lihat item | Dapatkan koleksi item dalam daftar. |
| Daftar dan item | Get Item | Mengembalikan metadata untuk item dalam daftar. |
| Daftar dan item | Dapatkan Daftar | Mengembalikan metadata untuk daftar. |
| Daftar dan item | Perbarui Item | Perbarui properti pada item daftar. |
| Daftar dan item | Hapus Item | Menghapus item dari daftar. |
| Berkas | Unggah File | Unggah file baru atau perbarui file yang sudah ada. Mendukung file hingga 250 MB. |
| Berkas | Cari Item Drive Situs | Cari hierarki item yang cocok dengan kueri. |
| Buku kerja Excel | Lembar Daftar | Mengambil daftar objek lembar kerja. |
| Buku kerja Excel | Tambahkan Lembar | Tambahkan lembar kerja baru ke buku kerja. |
| Buku kerja Excel | Baca Lembar | Mengambil properti dari objek lembar kerja. |
| Buku kerja Excel | Lembar Pembaruan | Perbarui properti objek lembar kerja. |
| Buku kerja Excel | Hapus Lembar | Hapus lembar kerja dari buku kerja. |
| Buku kerja Excel | Baca Sel | Dapatkan nilai sel tunggal dengan nomor baris dan kolom. |
| Buku kerja Excel | Tulis Sel | Tetapkan nilai sel tunggal dengan nomor baris dan kolom. |
| Buku kerja Excel | Baca Rentang | Dapatkan nilai rentang. |
| Buku kerja Excel | Rentang Tulis | Perbarui nilai rentang. |
| Buku kerja Excel | Jangkauan yang jelas | Hapus nilai rentang, format, isi, dan batas. |
| Buku kerja Excel | Hapus Rentang | Hapus sel yang terkait dengan rentang. |
| Buku kerja Excel | Dapatkan Rentang Bekas | Dapatkan rentang terkecil yang mencakup sel dengan nilai atau pemformatan. |
## Kelola dan pecahkan masalah
Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### Masalah otentikasi
+ **Pendaftaran aplikasi salah** — Verifikasi pendaftaran aplikasi di Microsoft Entra menyertakan izin API yang diperlukan dan persetujuan admin telah diberikan.
+ **Rahasia klien kedaluwarsa** — Periksa apakah rahasia klien telah kedaluwarsa dalam **Sertifikat & rahasia** dan buat yang baru jika diperlukan.
+ **URI pengalihan salah** — Verifikasi kecocokan URI pengalihan di Microsoft Entra. `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
### Pesan kesalahan umum
+ **`Access denied. You do not have permission to perform this action`**— Pengguna yang diautentikasi tidak memiliki izin yang diperlukan. Hubungi administrator Anda untuk memverifikasi dan memberikan izin yang sesuai.
+ **`AADSTS50020: User account from identity provider does not exist in tenant`**— Akun pengguna tidak dikonfigurasi di penyewa Microsoft Entra yang benar. Pastikan akun pengguna ada di penyewa yang cocok dengan ID Direktori (penyewa) dalam pendaftaran aplikasi Anda.
# Integrasi basis SharePoint pengetahuan Microsoft
Gunakan integrasi basis SharePoint pengetahuan Microsoft untuk mengindeks SharePoint konten sehingga agen Amazon Quick dapat mencari dan menjawab pertanyaan tentangnya.
Amazon Quick menggunakan aplikasi multi-tenant pra-terdaftar untuk terhubung ke basis pengetahuan SharePoint. Anda tidak perlu membuat pendaftaran aplikasi. Saat pengguna pertama kali terhubung, Microsoft menyajikan dialog persetujuan. Administrator dapat memberikan persetujuan atas nama seluruh organisasi, atau pengguna individu dapat menyetujui sendiri.
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Microsoft 365 dengan SharePoint akses.
+ Untuk persyaratan berlangganan, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
+ Administrator Microsoft Anda mungkin perlu memberikan persetujuan organisasi sebelum pengguna dapat membuat basis SharePoint pengetahuan. Administrator dapat memberikan persetujuan seluruh organisasi dengan masuk dan memilih **Persetujuan atas nama organisasi Anda selama alur** pembuatan integrasi.
**catatan**
Ketika administrator memberikan persetujuan organisasi, Microsoft Entra secara otomatis membuat Aplikasi Perusahaan (prinsipal layanan) di penyewa Anda. Anda dapat menonaktifkan atau menghapus prinsip layanan ini kapan saja dari **aplikasi Enterprise** di pusat admin Microsoft Entra, yang segera mencabut semua akses.
## Izin diberikan selama persetujuan
**SharePoint basis pengetahuan - izin**
| Izin | API | Deskripsi |
| --- | --- | --- |
| Files.Read.All | Grafik Microsoft | Memungkinkan aplikasi membaca semua file yang dapat diakses pengguna. |
| Notes.Read.All | Grafik Microsoft | Memungkinkan aplikasi membaca semua OneNote notebook yang dapat diakses pengguna. |
| User.Read | Grafik Microsoft | Memungkinkan pengguna untuk masuk dan memungkinkan aplikasi membaca profil pengguna yang masuk. |
| Sites.Read.All | Grafik Microsoft | Memungkinkan aplikasi membaca dokumen dan daftar item di semua koleksi situs. |
| offline\$1access | Grafik Microsoft | Memungkinkan aplikasi mempertahankan akses saat pengguna tidak masuk secara aktif. |
| AllSites.Read | Office 365 SharePoint Online | Memungkinkan aplikasi membaca item di semua koleksi situs. |
## Menyiapkan integrasi basis pengetahuan
1. Di konsol Amazon Quick, pilih **Integrasi.**
1. Pilih **Microsoft SharePoint** dan pilih tombol Tambah (plus “\$1”).
1. Dalam dialog **Buat basis SharePoint pengetahuan**, di bawah **Akun yang terhubung**, pilih **Masuk ke SharePoint** dan selesaikan alur masuk dan persetujuan Microsoft.
1. Di bawah **Buat basis pengetahuan**, masukkan nama dan deskripsi opsional untuk basis pengetahuan Anda.
1. Di bagian **Konten**, pilih **Tambahkan konten** dan pilih SharePoint halaman, file, atau folder yang ingin diindeks.
1. Pilih **Buat**.
## Jenis konten yang didukung
+ **Pustaka dokumen:** Word, Excel,, PDF PowerPoint, OneNote (.one)
+ **File media:** MP3,, MOV MP4, WMV
+ **Halaman situs dan halaman wiki**
## Kontrol akses
**penting**
Saat Amazon Quick mengindeks SharePoint konten, Amazon tidak menyinkronkan daftar kontrol akses (ACLs) dari SharePoint. Semua konten yang diindeks dapat diakses oleh pengguna mana pun yang memiliki akses ke basis pengetahuan di Amazon Quick, terlepas dari izin mereka. SharePoint Tinjau konten mana yang Anda sertakan saat membuat basis pengetahuan.
## Kelola dan pecahkan masalah
Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
Untuk pemecahan masalah basis pengetahuan umum, termasuk masalah sinkronisasi dan dokumen yang hilang, lihat. [Memecahkan masalah basis pengetahuan](troubleshooting-knowledge-bases.md)
### SharePoint-masalah khusus
+ **Diperlukan persetujuan admin** — Beberapa organisasi mewajibkan administrator untuk memberikan persetujuan sebelum pengguna individu dapat terhubung. Administrator harus masuk dan memilih **Persetujuan atas nama organisasi Anda** selama alur persetujuan.
+ **Aplikasi Perusahaan dinonaktifkan** — Jika kepala layanan sebelumnya dinonaktifkan di **aplikasi Enterprise** di pusat admin Microsoft Entra, aktifkan kembali untuk memulihkan akses.
+ **SharePoint throttling** — SharePoint dapat membatasi permintaan selama periode penggunaan tinggi. Coba lagi sinkronisasi selama jam-jam di luar sibuk.