Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Senin
Monday.com adalah sistem operasi kerja serbaguna yang merampingkan manajemen proyek dan kolaborasi tim. Ini fitur alur kerja yang dapat disesuaikan, dasbor visual, dan alat otomatisasi untuk meningkatkan produktivitas. Pengguna dapat melacak tugas, mengelola sumber daya, dan berkomunikasi secara efektif dalam satu platform terintegrasi.
**Topics**
+ [AWS Glue dukungan untuk hari Senin](monday-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](monday-configuring-iam-permissions.md)
+ [Mengkonfigurasi Senin](monday-configuring.md)
+ [Mengkonfigurasi koneksi Senin](monday-configuring-connections.md)
+ [Membaca dari entitas Senin](monday-reading-from-entities.md)
+ [Referensi opsi koneksi Senin](monday-connection-options.md)
+ [Batasan](monday-connector-limitations.md)
+ [Buat akun Senin baru:](#monday-account-creation)
# AWS Glue dukungan untuk hari Senin
AWS Glue mendukung hari Senin sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data mulai hari Senin.
**Didukung sebagai target?**
Tidak.
**Versi API Senin yang didukung**
v2.
# 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": "*"
}
]
}
```
------
Anda juga dapat menggunakan kebijakan IAM terkelola berikut untuk mengizinkan akses:
+ [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 saat 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 Senin
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer data dari hari Senin, Anda harus memenuhi persyaratan ini:
## Persyaratan minimum
+ Anda memiliki akun pengembang Senin dengan Email dan Kata Sandi. Untuk informasi selengkapnya, lihat [Buat akun Senin baru:](connecting-to-monday.md#monday-account-creation).
+ Akun pengembang Senin Anda diaktifkan untuk akses API. Semua penggunaan hari Senin APIs tersedia tanpa biaya tambahan dalam masa percobaan. Setelah masa percobaan selesai, Anda perlu membeli langganan untuk membuat dan mengakses data. Untuk informasi lebih lanjut, lihat [halaman lisensi hari Senin](https://developer.monday.com/api-reference/reference/about-the-api-reference) untuk detail selengkapnya.
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Senin Anda. Untuk koneksi biasa, Anda tidak perlu melakukan hal lain di hari Senin.
# Mengkonfigurasi koneksi Senin
Senin mendukung dua jenis berikut untuk mekanisme otentikasi:
1. OAuth Auth: Senin mendukung jenis hibah AUTHORIZATION\$1CODE untuk. OAuth2
+ 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 untuk instanceurl Senin. AWS Glue Konsol akan mengarahkan pengguna ke hari Senin di mana pengguna harus masuk dan mengizinkan izin AWS Glue yang diminta untuk mengakses instance Senin mereka.
+ Pengguna harus memilih untuk membuat aplikasi terhubung mereka sendiri pada hari Senin dan memberikan id klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue Konsol. Dalam skenario ini, mereka masih akan diarahkan ke hari Senin untuk masuk dan memberi wewenang AWS Glue untuk mengakses sumber daya mereka.
+ Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses aktif selama satu jam, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran.
+ Untuk informasi selengkapnya, lihat [dokumentasi tentang membuat aplikasi yang terhubung untuk alur AUTHORIZATION\$1CODE OAuth ](https://developers.Monday.com/docs/api/v1/Oauth).
1. Auth Kustom:
+ Untuk dokumentasi hari Senin publik tentang pembuatan kunci API yang diperlukan untuk otorisasi kustom, lihat [https://developer.monday.com/api-reference/api-token-permissionsdocs/authentication\$1](https://developer.monday.com/api-reference/docs/authentication#api-token-permissions).
Untuk mengonfigurasi koneksi Senin:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut. Diperlukan untuk membuat rahasia untuk setiap koneksi di AWS Glue.
1. Untuk OAuth autentikasi:
+ Untuk aplikasi terhubung yang dikelola pelanggan - Rahasia harus berisi aplikasi Consumer Secret yang terhubung dengan USER\$1MANAGED\$1CLIENT\$1APPLICATION\$1CLIENT\$1SECRET sebagai kunci.
1. Untuk autentikasi khusus:
+ Untuk aplikasi terhubung yang dikelola pelanggan - Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `personalAccessToken` sebagai.
1. Di AWS Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Di bawah Koneksi Data, pilih **Buat koneksi**.
1. Saat memilih **Sumber Data**, pilih Senin.
1. Berikan **InstanceURL** Senin Anda.
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 Senin
+ Untuk OAuth autentikasi: Berikan **URL Token** dan **Aplikasi ClientId Klien Terkelola Pengguna** pada hari Senin yang ingin Anda sambungkan.
+ Untuk autentikasi khusus: Pilih Jenis Otentikasi **KUSTOM** untuk terhubung ke Senin.
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`. Pilih **Berikutnya**.
1. Dalam konfigurasi AWS Glue pekerjaan Anda, berikan `connectionName` sebagai **koneksi jaringan tambahan**.
# Membaca dari entitas Senin
**Prasyarat**
+ Objek Senin yang ingin Anda baca. Lihat tabel entitas yang didukung di bawah ini untuk memeriksa entitas yang tersedia.
**Entitas yang didukung untuk Sumber**
Daftar entitas:
+ Akun: [https://developer.monday.com/api-reference/dokumen/akun](https://developer.monday.com/api-reference/docs/account#queries) \$1queries
+ Papan: [https://developer.monday.com/api-reference/dokumen/papan](https://developer.monday.com/api-reference/docs/boards#queries) \$1queries
+ Kolom: [https://developer.monday.com/api-reference/dokumen/kolom](https://developer.monday.com/api-reference/docs/columns#queries) \$1queries
+ Dokumen: [https://developer.monday.com/api-reference/dokumen/dokumen \$1queries](https://developer.monday.com/api-reference/docs/docs#queries)
+ Blok Dokumen: [https://developer.monday.com/api-reference/docs/blocks \$1queries](https://developer.monday.com/api-reference/docs/blocks#queries)
+ File: [https://developer.monday.com/api-reference/docs/files](https://developer.monday.com/api-reference/docs/files#queries) \$1queries
+ Folder: [https://developer.monday.com/api-reference/dokumen/folder](https://developer.monday.com/api-reference/docs/folders#queries) \$1queries
+ Grup: [https://developer.monday.com/api-reference/docs/groups](https://developer.monday.com/api-reference/docs/groups#queries) \$1queries
+ Barang: [https://developer.monday.com/api-reference/dokumen/item](https://developer.monday.com/api-reference/docs/items#queries) \$1queries
+ Sub item: [https://developer.monday.com/api-reference/dokumen/subitem](https://developer.monday.com/api-reference/docs/subitems#queries) \$1queries
+ Tag: [https://developer.monday.com/api-reference/dokumen/tag-kueri](https://developer.monday.com/api-reference/docs/tags-queries#queries) \$1queries
+ Tim: [https://developer.monday.com/api-reference/dokumen/tim](https://developer.monday.com/api-reference/docs/teams#queries) \$1queries
+ Pembaruan: [https://developer.monday.com/api-reference/dokumen/pembaruan](https://developer.monday.com/api-reference/docs/updates#queries) \$1queries
+ Pengguna: [https://developer.monday.com/api-reference/dokumen/pengguna](https://developer.monday.com/api-reference/docs/users#queries) \$1queries
+ Ruang kerja: [https://developer.monday.com/api-reference/dokumen/ruang](https://developer.monday.com/api-reference/docs/workspaces#queries) kerja \$1queries
| Entitas | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih\$1 | Mendukung Partisi |
| --- | --- | --- | --- | --- | --- |
| Akun | Tidak | Tidak | Tidak | Ya | Tidak |
| Papan | Ya | Ya | Tidak | Ya | Tidak |
| Kolom | Tidak | Tidak | Tidak | Ya | Tidak |
| Dokumen | Ya | Ya | Tidak | Ya | Tidak |
| Blok Dokumen | Tidak | Ya | Tidak | Ya | Tidak |
| Berkas | Ya | Tidak | Tidak | Ya | Tidak |
| Grup | Tidak | Tidak | Tidak | Ya | Tidak |
| Item | Ya | Ya | Tidak | Ya | Tidak |
| Sub item | Tidak | Tidak | Tidak | Ya | Tidak |
| Tag | Ya | Tidak | Tidak | Ya | Ya |
| Tim | Ya | Tidak | Tidak | Ya | Tidak |
| Pembaruan | Tidak | Ya | Tidak | Ya | Tidak |
| Pengguna | Ya | Ya | Tidak | Ya | Tidak |
| Workspace | Ya | Ya | Tidak | Ya | Tidak |
| Folder | Ya | Ya | Tidak | Ya | Tidak |
**Contoh**
```
monday_read = glueContext.create_dynamic_frame.from_options(
connection_type="monday",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "account",
"API_VERSION": "v2"
}
```
# Referensi opsi koneksi Senin
Berikut ini adalah opsi koneksi untuk hari Senin:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Nama Objek Anda di hari Senin.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Versi Monday Rest API yang ingin Anda gunakan. Contoh: v2.
+ `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.
# Batasan
Berikut ini adalah batasan untuk konektor Senin:
+ Respons metadata dinamis memiliki konflik tertentu dengan dokumentasi seperti yang disebutkan di bawah ini:
+ Grup, entitas Kolom mendukung operasi filter, tetapi tidak ada di titik akhir metadata dinamis, oleh karena itu disimpan sebagai entitas yang tidak dapat difilter.
+ Titik akhir dinamis terdiri dari sekitar 15000\$1 baris dan mengembalikan metadata semua entitas dalam satu respons, karena ini bidang membutuhkan rata-rata 10 detik untuk dimuat karenanya, ini akan memerlukan waktu tambahan saat menjalankan pekerjaan.
+ Lihat tabel di bawah ini untuk batas tarif Senin. Ukuran signifikan dari data respons entitas dinamis menyebabkan penundaan yang nyata, dengan bidang yang membutuhkan rata-rata 10 detik untuk memuat.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/monday-connector-limitations.html)
## Buat akun Senin baru:
1. Arahkan ke beranda hari Senin, [https://monday.com/](https://monday.com/)dan pilih **Login**.
1. Anda akan diarahkan kembali ke halaman login. Di bagian bawah halaman, pilih **Daftar**.
1. Masukkan alamat email Anda dan pilih **Lanjutkan**. Sebagai alternatif, Anda dapat masuk dengan Google.
1. Masukkan detail yang diperlukan dan pilih **Lanjutkan**.
1. Lengkapi pertanyaan survei dan ikuti langkah-langkah untuk menyelesaikan proses pembuatan akun.
**Daftarkan OAuth aplikasi:**
1. Masuk ke akun monday.com Anda. Klik avatar Anda (ikon gambar) di sudut kiri bawah layar Anda.
1. Pilih **Pengembang**.
1. Pilih **Buat aplikasi**.
1. Lengkapi bidang yang diperlukan untuk nama dan deskripsi.
1. Arahkan ke bagian “OAuth” yang ada di sisi kanan tambahkan cakupan dan pilih “Simpan Fitur”.
1. Arahkan ke tab “Redirect URLS” di samping cakupan dan tambahkan URL pengalihan dan pilih “Simpan Fitur”.
1. Di bawah URLs tab **Redirect**, berikan URL aplikasi Anda. Ini harus https://\$1region-code\$1.console.aws.amazon.com/appflow/ oauth. Misalnya, jika Anda menggunakan, `us-east-1 ` Anda dapat menambahkan`https://us-east-1.console.aws.amazon.com/appflow/oauth`.
1. Aplikasi ini sekarang siap digunakan. Anda dapat menemukan kredensyal Anda, di bagian “Informasi Dasar”. Catat ID Klien dan string rahasia Klien Anda. String ini digunakan untuk membuat koneksi dengan aplikasi ini menggunakan AppFlow konektor.
**Hasilkan token akses pribadi:**
Saat ini, monday.com hanya menawarkan token API V2 kami, yang semuanya merupakan token pribadi. Untuk mengakses token API Anda, Anda dapat menggunakan salah satu dari dua metode tergantung pada tingkat pengguna Anda. Pengguna admin dapat menggunakan kedua metode untuk memperoleh token API mereka. Pengguna anggota dapat mengakses token API mereka dari tab Pengembang mereka.
Admin - Jika Anda adalah pengguna admin di akun monday.com Anda, Anda dapat mengakses token API Anda dari tab “Admin” dengan langkah-langkah berikut:
1. Masuk ke akun monday.com Anda. Klik avatar Anda (ikon gambar) di sudut kiri bawah layar Anda.
1. Pilih “Administrasi” dari menu yang dihasilkan (ini mengharuskan Anda memiliki izin admin).
1. Arahkan ke Bagian “API” dan buat “Token API V2”. Anda dapat menyalin token Anda dan menggunakannya.
Pengembang - Jika Anda adalah pengguna anggota di akun monday.com Anda, Anda dapat mengakses token API Anda dari tab Pengembang dengan langkah-langkah berikut:
1. Masuk ke akun monday.com Anda. Klik avatar Anda (ikon gambar) di sudut kiri bawah layar Anda.
1. Pilih “Pengembang” dari menu yang dihasilkan.
1. Di menu atas, pilih menu tarik-turun “Pengembang”. Pilih opsi pertama pada menu drop-down berjudul “My Access Tokens.”