Google Integrasi

Google GSuite

Frappe memungkinkan Anda menggunakan dokumen GSuite Google sebagai template, menghasilkan dokumen GSuite baru dari mereka yang akan ditempatkan di folder yang dipilih. Variabel dapat diisi baik dalam tubuh maupun nama dokumen GSuite menggunakan format Jinja2 standar. Setelah dihasilkan, dokumen GSuite akan tetap terkait dengan DocType sebagai lampiran.

Dokumen GSuite dihasilkan dengan memanggil fungsi "attach file" dari DocType apa pun.

Salah satu kasus penggunaan umum dari fitur ini adalah mengisi kontrak dari data pelanggan/karyawan/pemasok.

1. Mengaktifkan integrasi dengan Google GSuite

1.1 Publikasikan skrip Google apps

Jika Anda akan menggunakan skrip default, Anda dapat melewati dan langsung ke langkah 1.2

Buka https://script.google.com
Buat Proyek baru. Klik File > New > Project
Salin kode dari Desk > Explore > Integrations > GSuite Settings > Google Apps Script ke clipboard dan tempelkan ke Code.gs kosong di script.google.com
Simpan Proyek. Klik File > Save > Masukkan nama proyek baru
Deploy aplikasi. Klik Publish > Deploy as web app
Salin "Current web app URL" ke dalam Desk > Explore > Integrations > GSuite Settings > Script URL
Klik OK tetapi jangan tutup skrip

1.2 Dapatkan akses Google

Buka konsol proyek Google Anda dan pilih proyek Anda atau buat yang baru. https://console.developers.google.com
Di Library, klik Google Drive API dan Enable
Klik Credentials > Create Credentials > OAuth Client ID
Isi formulir dengan:
- Aplikasi Web
- Authorized redirect URI sebagai http://{{ your_site }}/?cmd=frappe.integrations.doctype.gsuite_settings.gsuite_settings.gsuite_callback
Salin Client ID dan Client Secret ke dalam Desk > Explore > Integrations > GSuite Settings > Client ID and Client Secret
Simpan GSuite Settings

1.3 Uji Skrip

Klik Allow GSuite Access dan Anda akan diarahkan untuk memilih pengguna dan memberikan akses. Jika Anda mengalami kesalahan, pastikan Anda menggunakan Authorized Redirect URI yang benar. Anda dapat menemukan URI lengkap yang dialihkan oleh GSuite di bagian akhir URL halaman kesalahan. Periksa bahwa protokol http:// atau https:// sesuai dengan yang Anda gunakan.
Klik Run Script test. Anda akan diminta untuk memberikan izin.

2. Template GSuite

2.1 Google Document sebagai Template

Buat Dokumen baru atau gunakan yang sudah Anda miliki. Atur variabel sesuai kebutuhan Anda. Variabel didefinisikan dengan {{VARIABLE}} di mana VARIABLE adalah field dari Doctype Anda.
Misalnya, jika dokumen ini akan digunakan untuk karyawan dan Doctype memiliki field name, maka Anda dapat menggunakannya di Google Docs sebagai {{name}}
Dapatkan ID dari Dokumen tersebut dari URL dokumen Anda. Misalnya: dalam URL dokumen ini https://docs.google.com/document/d/1Y2_btbwSqPIILLcJstHnSm1u5dgYE0QJspcZBImZQso/edit, ID dokumen adalah 1Y2_btbwSqPIILLcJstHnSm1u5dgYE0QJspcZBImZQso
Dapatkan ID folder tempat Anda ingin menempatkan dokumen yang dihasilkan. (Anda dapat melewati poin ini jika Anda ingin menempatkan dokumen yang dihasilkan di root Google Drive.)
Misalnya: dalam URL folder ini https://drive.google.com/drive/u/0/folders/0BxmFzZZUHbgyQzVJNzY5eG5jbmc, ID folder adalah 0BxmFzZZUHbgyQzVJNzY5eG5jbmc

2.2 Mengasosiasikan Template dengan Doctype

Buka Desk > Explore > Integrations > GSuite Templates > New
Isi formulir dengan:
- Nama Template (Misalnya: Employee Contract)
- Related DocType (Misalnya: Employee)
- Template ID adalah ID Dokumen yang Anda dapatkan dari Google Docs Anda (Misalnya: 1Y2_btbwSqPIILLcJstHnSm1u5dgYE0QJspcZBImZQso)
- Nama Dokumen adalah nama file baru. Anda dapat menggunakan field dari DocType (Misalnya: Employee Contract of {name})
- Destination ID adalah ID folder dari file Anda yang dibuat dari Template ini. (Misalnya: 0BxmFzZZUHbgyQzVJNzY5eG5jbmc)

3. Membuat Dokumen

Buka Dokumen yang sudah Anda miliki Template-nya (Misalnya: Employee > John Doe)
Klik Attach File
Pada bagian GSuite Document pilih Template dan klik Attach
Anda akan melihat dokumen yang dihasilkan sudah dibuat dan dilampirkan
Mengklik dokumen yang dilampirkan akan membukanya di dalam GSuite

Integrasi Google Calendar

TechMaju menyediakan integrasi dengan Google Calendar agar semua pengguna dapat menyinkronkan acara mereka.

Pengaturan

Untuk memungkinkan sinkronisasi dengan Google Calendar, Anda perlu terhubung ke aplikasi Anda di Google Cloud Platform dan kemudian membuat akun untuk masing-masing pengguna Anda:

Buat proyek baru di Google Cloud Platform dan buat kredensial OAuth 2.0 baru
Tambahkan https://{your_site} ke Authorized JavaScript origins
Tambahkan https://{your_site}?cmd=frappe.integrations.doctype.gcalendar_settings.gcalendar_settings.google_callback sebagai authorized redirect URI
Tambahkan Client ID dan Client Secret Anda di aplikasi GCalendar: di "Modules>Integrations>Google Calendar>GCalendar Settings"

Setelah langkah ini berhasil diselesaikan, setiap pengguna dapat membuat akun mereka sendiri di Google Calendar > GCalendar Account. Mereka akan diminta untuk mengotorisasi aplikasi Google Anda untuk mengakses informasi kalender mereka dan kemudian akan diarahkan ke halaman sukses.

Fitur

Pembuatan kalender baru di Google Calendar
- Setiap Pengguna dapat memilih nama khusus untuk Google Calendar mereka.
Sinkronisasi acara dari TechMaju ke GCalendar
- Semua Acara yang dibuat di TechMaju dibuat di Google Calendar.
- Acara Berulang dibuat sebagai acara berulang juga.
- Anda dapat menambahkan tautan konferensi Google Meet ke Acara secara opsional.
- Semua peserta (Email Pengguna) akan ditambahkan ke Acara.
- Acara yang diubah di TechMaju diperbarui di Google Calendar.
- Acara yang dihapus di TechMaju dihapus di Google Calendar.
Sinkronisasi acara dari GCalendar ke TechMaju
- Acara yang dibuat di Google Calendar dibuat di TechMaju.
- Acara yang diperbarui di Google Calendar diperbarui di TechMaju.

Modul sinkronisasi mengikuti aturan otorisasi TechMaju: Sebuah acara hanya akan disinkronkan jika bersifat publik atau jika pengguna adalah pemiliknya.

Keterbatasan

Saat ini, jika sebuah instance dari acara berulang dibatalkan di Google Calendar, perubahan ini tidak akan tercermin di TechMaju.