Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Productboard
Productboard adalah sistem manajemen produk yang membantu tim produk mendapatkan produk yang tepat ke pasar, lebih cepat. Lebih dari 3.000 perusahaan modern yang dipimpin oleh produk, seperti Zendesk, UiPath dan Microsoft, menggunakan Productboard untuk memahami apa yang benar-benar dibutuhkan pengguna, memprioritaskan apa yang akan dibangun selanjutnya, dan menggalang semua orang di sekitar peta jalan mereka.
**Topics**
+ [AWS Glue dukungan untuk Productboard](productboard-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](productboard-configuring-iam-permissions.md)
+ [Mengkonfigurasi Productboard](productboard-configuring.md)
+ [Mengkonfigurasi koneksi Productboard](productboard-configuring-connections.md)
+ [Membaca dari entitas Productboard](productboard-reading-from-entities.md)
+ [Opsi koneksi productboard](productboard-connection-options.md)
+ [Membuat akun Productboard](productboard-create-account.md)
+ [Batasan](productboard-connector-limitations.md)
# AWS Glue dukungan untuk Productboard
AWS Glue mendukung Productboard sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data dari Productboard.
**Didukung sebagai target?**
Tidak.
**Versi API Productboard yang didukung**
v1
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan AWS izin yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode sebelumnya, sebagai alternatif, gunakan kebijakan IAM terkelola berikut:
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon EC2. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya ketika identitas yang dilampirkan kebijakan menggunakan konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Productboard
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer dari Productboard, Anda harus memenuhi persyaratan berikut:
## Persyaratan minimum
+ Anda memiliki akun Productboard dengan email dan kata sandi. Untuk informasi selengkapnya tentang membuat akun, lihat [Membuat akun Productboard](productboard-create-account.md).
+ Anda harus memiliki AWS Akun yang dibuat dengan akses layanan ke AWS Glue.
+ Anda memiliki detail otentikasi akun Productboard - baik Token JWT jika seseorang ingin menggunakan Custom Auth atau Client ID dan rahasia jika ingin menggunakan .0. OAuth2
+ Jika pengguna ingin menggunakan`OAuth2.0`, [Daftarkan aplikasi Anda dengan Productboard](https://app.productboard.com/oauth2/applications/new) dan atur aplikasi dengan mengikuti petunjuk di, [Cara mengintegrasikan dengan Productboard via OAuth2 ](https://developer.productboard.com/docs/how-to-integrate-with-productboard-via-oauth2-developer-documentation) - dokumentasi pengembang.
Jika Anda memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Productboard Anda. Untuk koneksi tipikal, Anda tidak perlu melakukan hal lain di Productboard.
# Mengkonfigurasi koneksi Productboard
Productboard mendukung otentikasi khusus dan. `OAuth2.0` Untuk `OAuth2.0` Productboard mendukung jenis `AUTHORIZATION_CODE` hibah.
+ Jenis hibah ini dianggap “berkaki tiga” `OAuth` karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Ini digunakan saat membuat koneksi melalui AWS Glue Konsol. Pengguna yang membuat koneksi mungkin secara default mengandalkan aplikasi terhubung yang AWS Glue dimiliki di mana mereka tidak perlu memberikan informasi `OAuth` terkait apa pun kecuali ID Klien Productboard dan Rahasia Klien mereka. AWS Glue Konsol akan mengarahkan pengguna ke Productboard tempat pengguna harus masuk dan mengizinkan izin yang diminta untuk mengakses AWS Glue instance Productboard mereka.
+ Pengguna masih dapat memilih untuk membuat aplikasi mereka sendiri yang terhubung di Productboard dan memberikan ID Klien dan Rahasia Klien mereka sendiri saat membuat koneksi melalui AWS Glue Konsol. Dalam skenario ini, mereka masih akan diarahkan ke Productboard untuk login dan otorisasi AWS Glue untuk mengakses sumber daya mereka.
+ Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses berumur pendek, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran.
+ Untuk dokumentasi Productboard publik tentang cara membuat aplikasi yang terhubung untuk `AUTHORIZATION_CODE OAuth` alur, lihat [Cara mengintegrasikan dengan Productboard melalui OAuth2 ](https://developer.productboard.com/docs/how-to-integrate-with-productboard-via-oauth2-developer-documentation) - dokumentasi pengembang.
Untuk mengkonfigurasi koneksi Productboard:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
+ Untuk `OAuth` autentikasi — Untuk aplikasi terhubung yang dikelola pelanggan: Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai.
+ Untuk `Custom auth` — Untuk aplikasi terhubung yang dikelola pelanggan: Rahasia harus berisi aplikasi yang terhubung `JWT token` dengan `access_token` sebagai kunci.
**catatan**
Ini adalah suatu keharusan untuk membuat rahasia per koneksi di AWS Glue.
1. Di AWS Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **Sumber Data**, pilih Productboard.
1. Pilih peran IAM yang AWS Glue dapat diasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih Jenis Otentikasi untuk terhubung ke sumber data:
+ Untuk `OAuth` autentikasi — Menyediakan`Token URL`, dan `User Managed Client Application ClientId` dari aplikasi Productboard.
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
1. Dalam konfigurasi AWS Glue pekerjaan Anda, berikan `connectionName` sebagai koneksi jaringan tambahan.
# Membaca dari entitas Productboard
**Prasyarat**
Objek Productboard yang ingin Anda baca. Lihat tabel entitas yang didukung di bawah ini untuk memeriksa entitas yang tersedia.
**Entitas yang didukung**
+ [Laporan penyalahgunaan](https://productboard.com/developer/marketing/api/campaign-abuse/)
+ [Otomatisasi](https://productboard.com/developer/marketing/api/automation/list-automations/)
+ [Kampanye](https://productboard.com/developer/marketing/api/campaigns/list-campaigns/)
+ [Detail klik-](https://productboard.com/developer/marketing/api/link-clickers/)
+ [Daftar](https://productboard.com/developer/marketing/api/link-clickers/)
+ [Anggota](https://productboard.com/developer/marketing/api/list-segment-members/)
+ [Detail terbuka](https://productboard.com/developer/marketing/api/list-members/)
+ [Segmen](https://productboard.com/developer/marketing/api/list-segments/)
+ [Toko](https://productboard.com/developer/marketing/api/ecommerce-stores/list-stores/)
+ [Berhenti berlangganan](https://productboard.com/developer/marketing/api/unsub-reports/)
| Entitas | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih\$1 | Mendukung Partisi |
| --- | --- | --- | --- | --- | --- |
| Fitur | Ya | Ya | Tidak | Ya | Ya |
| Komponen-komponen | Tidak | Ya | Tidak | Ya | Tidak |
| Produk | Tidak | Ya | Tidak | Ya | Tidak |
| Status Fitur | Tidak | Ya | Tidak | Ya | Ya |
| Definisi Bidang Kustom | Tidak | Ya | Tidak | Ya | Tidak |
| Nilai Bidang Kustom | Ya | Ya | Tidak | Ya | Tidak |
**Contoh**
```
Productboard_read = glueContext.create_dynamic_frame.from_options(
connection_type="Productboard",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "feature",
"API_VERSION": "1"
}
```
**Entitas papan produk dan detail bidang**
+ [Fitur](https://developer.productboard.com/#tag/features)
+ [Komponen](https://developer.productboard.com/#tag/components)
+ [Status fitur](https://developer.productboard.com/#tag/statuses)
+ [Produk](https://developer.productboard.com/#tag/products)
+ [Definisi bidang khusus](https://developer.productboard.com/#tag/hierarchyEntitiesCustomFields)
+ [Nilai bidang kustom](https://developer.productboard.com/#tag/hierarchyEntitiesCustomFieldsValues)
# Opsi koneksi productboard
Berikut ini adalah opsi koneksi untuk Productboard:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Nama Objek Anda di Productboard.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca. Productboard Engage Rest API versi yang ingin Anda gunakan. Misalnya: 3.0.
+ `SELECTED_FIELDS`(Daftar) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
# Membuat akun Productboard
1. Arahkan ke [halaman pendaftaran Productboard](https://app.productboard.com/), masukkan ID email dan kata sandi Anda, lalu pilih **Masuk saya**.
1. Di bidang **Nama Akun**, masukkan nama akun Productboard Anda, lalu pilih kotak **centang Saya setuju dengan Kebijakan Privasi**.
1. Pada halaman **Sekarang buat ruang kerja Anda**, di bidang **URL Workspace, masukkan URL** untuk ruang kerja baru Anda. Kemudian pilih **Lanjutkan** untuk melanjutkan ke halaman berikutnya dan berikan detail yang tersisa.
Ini membuat akun uji coba Anda. Akun uji coba gratis selama 15 hari. Setelah masa uji coba berakhir, Anda dapat membeli paket berbayar. Catat alamat email, kata sandi, dan URL ruang kerja Anda. Anda akan memerlukan informasi ini untuk mengakses akun Anda di masa depan.”
**Mendaftarkan `OAuth2.0` aplikasi**
1. Arahkan ke [halaman login Productboard](https://login.productboard.com/?locale=en), masukkan ID email dan kata sandi Anda, dan pilih **Masuk**.
1. Pilih ikon **Pengguna** di sudut kanan atas, lalu pilih **Akun dan penagihan** dari menu tarik-turun.
1. Pilih **Ekstra** dan pilih **Aplikasi terdaftar** dari menu tarik-turun.
1. Cari dan pilih **Daftarkan Aplikasi**.
1. Masukkan detail berikut:
+ **Nama aplikasi** — Nama aplikasi.
+ **Perusahaan/Organisasi** — Nama Perusahaan atau Organisasi Anda.
+ **Situs web aplikasi** — Situs web aplikasi.
+ **URI Pengalihan** — Pola URI Pengalihan adalah jalur URI (atau daftar jalur yang dipisahkan koma) yang dapat dialihkan oleh Productboard (jika diminta) saat alur masuk selesai. Sebagai contoh, `https://ap-southeast-2\\.console\\.aws\\.amazon\\.com`.
1. Pilih **Buat**.
1. **Client ID** dan **Client Secret** sekarang akan terlihat. Salin dan simpan di lokasi yang aman. Kemudian, pilih **Selesai**.
**catatan**
ID Klien dan string Rahasia Klien Anda adalah kredensil yang digunakan untuk membuat koneksi dengan konektor ini saat menggunakan atau. AppFlow AWS Glue
**Mengambil CustomAuth Kredensial**
1. Arahkan ke [halaman login Productboard](https://app.productboard.com/), masukkan ID email dan kata sandi Anda, dan pilih **Masuk saya**.
Anda akan diarahkan ke halaman rumah.
1. Di halaman beranda, navigasikan ke **Pengaturan Ruang Kerja** > **Integrasi** > **Publik APIs** > Token **Akses**.
**catatan**
Jika APIs bagian **Publik** tidak terlihat, akun Anda mungkin ada di paket Essentials. Akses ke token API membutuhkan setidaknya paket Pro. Fitur dan nama paket dapat berubah sewaktu-waktu. Untuk informasi selengkapnya tentang paket, lihat Harga [Productboard](https://www.productboard.com/pricing/).
1. Pilih **\$1** untuk menghasilkan token baru, dan pastikan untuk menyimpannya dengan aman untuk referensi di masa mendatang.
**Membuat `OAuth2.0` kredensil**
Untuk menggunakan `OAuth2.0` otentikasi dengan konektor Productboard, Anda perlu mendaftarkan aplikasi Anda di platform Productboard dan menghasilkan dan. `Client ID` `Client Secret`
1. Arahkan ke [halaman login Productboard](https://app.productboard.com/), masukkan ID email dan kata sandi Anda, dan pilih **Masuk saya**.
1. Untuk mendaftarkan OAuth2 aplikasi baru dengan akun Productboard Anda, navigasikan ke halaman [Producboard](to register new OAuth2 application with your Productboard account).
1. Lengkapi bidang yang diperlukan dan pilih cakupan yang diperlukan untuk setiap entitas yang ingin Anda akses.
**catatan**
Anda telah memilih empat cakupan berikut, yang diperlukan untuk enam entitas yang didukung.
1. **URL pengalihan** harus memiliki format berikut: `https://ap-southeast-2\\.console\\.aws\\.amazon\\.com`
**catatan**
Pengalihan Appflow dapat berubah URLs sewaktu-waktu. Setelah tersedia, perbarui pengalihan URLs untuk AWS Glue platform.
1. **Client ID** dan **Client Secret** sekarang akan terlihat. Salin dan simpan di lokasi yang aman.
1. Anda dapat mengatur dan memverifikasi `OAuth2` dengan mengikuti langkah-langkah di [Cara Mengintegrasikan dengan Productboard melalui dokumentasi OAuth2 pengembang](https://developer.productboard.com/docs/how-to-integrate-with-productboard-via-oauth2-developer-documentation).
# Batasan
Berikut ini adalah batasan untuk konektor Productboard:
+ Productboard tidak mendukung partisi berbasis bidang atau berbasis rekaman.