Membuat entri pintasan (plugin grup)

Artikel ini menjelaskan cara membuat entri pintasan.

​

Apa itu entri pintasan (plugin grup)

Saat pengguna mengklik entri plugin di dalam sebuah grup, parameter grup terkait akan ikut dibawa, sehingga developer dapat mengetahui siapa yang mengklik plugin tertentu di grup mana dan pada waktu berapa. Berdasarkan hal ini, penyedia solusi dapat menghadirkan layanan bisnis yang sangat cerdas dan tepat sasaran.

1. Masuk ke DingTalk Developer Console.
2. Di halaman Developer Console, pilih Scenario group dan klik Create group plugin.
3. Buat plugin grup, klik Create, lalu tunggu persetujuan. Catatan
   • Persetujuan diselesaikan dalam waktu 12 jam pada hari kerja.
   Tautan plugin grup yang berbeda dapat dikonfigurasi. Tautan tersebut dapat dibuka di workbench DingTalk, sidebar, browser eksternal, dan lainnya:

   Metode pembukaan	Konfigurasi tautan
   Membuka plugin grup di workbench DingTalk	dingtalk://dingtalkclient/action/openapp?corpid=dingxxxxxxxxxxx&container_type=work_platform&app_id=0_140444xxxxx&redirect_type=jump&redirect_url=https%3A%2F%2Fding-doc.dingtalk.io%2F
   Membuka plugin grup di sidebar	dingtalk://dingtalkclient/action/openapp?corpid=dingxxxxxxxxxxx&container_type=slide_panel&app_id=0_140444xxxxx&redirect_type=jump&redirect_url=https%3A%2F%2Fding-doc.dingtalk.io%2F
   Membuka plugin grup di browser eksternal	dingtalk://dingtalkclient/action/openapp?corpid=dingxxxxxxxxxxx&container_type=browser&app_id=0_140444xxxxx&redirect_type=jump&redirect_url=https%3A%2F%2Fding-doc.dingtalk.io%2F

​

Menyusun tautan entri pintasan

Entri pintasan (plugin grup) adalah tautan DingTalk dengan kemampuan bisnis. Developer harus menyusun tautan entri pintasan berdasarkan skenario nyata dari aplikasi mikro mereka dan kebutuhan spesifik pengguna dalam grup. Nama entri pintasan mendukung hingga empat karakter. Tautan entri pintasan menawarkan kemampuan yang luas, tetapi developer harus menyusunnya melalui parameter tautan. Misalnya, metode pembukaan di sisi seluler (push page, pop page, dll.) dan logika navigasi halaman di sisi PC (membuka kontainer baru atau menggeser halaman ke kiri) semuanya diimplementasikan melalui konfigurasi parameter tautan.

• Alihkan ke halaman H5 tautan (sidebar / kontainer slide-out) Contoh:
  dingtalk://dingtalkclient/page/link?dd_mode=push&pc_slide=true&url=http%3a%2f%2fomsdevdingtalkf.zjk.taeapp.com%2findex.html%3fcorpid%3d$CORPID$%26dd_nav_bgcolor%3dffff943e%2f%23%2fgroup-plugin%3fcorpid%3d$CORPID$%26openConversationId%3d$DOUBLE_ENCCID$%26dd_nav_bgcolor%3dffff943e%26pluginType%3d3%26appid%3d6397
  
  Deskripsi parameter:

  Parameter	Deskripsi
  url	URL halaman. Encoding URL diperlukan.
  dd_mode	Digunakan pada iOS. - push: mendorong kontainer dari kiri ke kanan pada iOS. - present: memunculkan kontainer dari bawah ke atas pada iOS.
  pc_slide	Ketika pc_slide=true, URL dibuka di dalam aplikasi pada sisi PC.

• Alihkan ke aplikasi mikro openapp (seperti workbench, browser, atau panel geser kiri) Contoh:
  dingtalk://dingtalkclient/action/openapp?corpid=$CORPID$&container_type=work_platform&app_id=3204&redirect_type=emit_params&params=&redirect_url=https%3A%2F%2Ftestt2.wmnetwork.cc%2Fmanage%2Findex%3Fmid%3Dwfp40mx9
  
  Deskripsi parameter:

  Parameter	Deskripsi
  container_type	Kontainer tempat halaman ditampilkan: - browser: browser. - slide_panel: panel geser kiri. - work_platform: workbench.
  corpid	ID organisasi.
  app_id	- Untuk Aplikasi perusahaan pihak ketiga, isi appId. Lihat cara menampilkan appId. - Untuk Aplikasi internal, isi 0_agentId, yang terdiri dari angka 0, sebuah Garis Bawah, dan agentId. agentId dapat dilihat di detail aplikasi.
  redirect_type	Tipe pengalihan: - jump: membuka redirect_url secara langsung. - emit_params: menggunakan metode event-emitting.
  params	Parameter. Saat membuka untuk pertama kali, tambahkan parameter ini ke daftar parameter URL pengalihan.
  redirect_url	URL pengalihan. Encoding URL diperlukan.
  slide_panel_option	Parameter untuk panel geser kiri, eksklusif untuk versi PC. Misalnya: {"width":500,"showAppPage":true} (width adalah lebar sidebar, dan showAppPage menunjukkan apakah halaman web ditampilkan).

• Alihkan ke mini program
  1. Parameter umum (didukung oleh open_micro_app dan open_mini_app)

     Parameter	Wajib	Deskripsi
     appId	Pilih salah satu antara appId dan agent_id. Jika keduanya ada, app_id diprioritaskan.	ID aplikasi mikro. Perhatikan bahwa ini bukan ID mini program. Aplikasi ISV menggunakan ID ini.
     page	Tidak	Jalur halaman mini program. Parameter GET dapat ditambahkan. Default-nya adalah halaman beranda mini program.
     query	Tidak	Parameter startup mini program, yang dapat diperoleh di callback App.onLaunch / onShow. Saat mini program dijalankan, Sisi klien menambahkan parameter corpId secara default. Oleh karena itu, sisi bisnis tidak dapat mengatur corpId, karena akan ditimpa.
     containerType	Tidak	Parameter khusus PC. Opsi berikut tersedia: - browser: browser. - slide_panel (Default): panel geser kiri. - work_platform: workbench. - mobile: mengalihkan ke sisi seluler.
     title	Tidak	Parameter khusus PC yang digunakan untuk menampilkan judul.
     source	Tidak	Sumber (digunakan hanya saat paket perlu ditarik dari Sisi server): - debug: versi debug perangkat nyata. - trial: versi uji coba.
     version	Tidak	Nomor versi.
     ddMode	Tidak	Mode transisi untuk meluncurkan mini program. - push: mode push. - present: mode pop-up. - float: mode floating layer. - pop: mode pop view. Jika tidak ditentukan, Sisi klien meluncurkan menggunakan mode transisi default. Rilis grayscale dimulai pada Sisi klien v4.5.8. float dan pop memulai rilis grayscale di v4.6.35 (20190624).
     mainTask	Tidak	Diperlukan hanya untuk klien Android. Nilainya “true” atau “false”, default-nya false. Jika diatur ke “true”, mini program berjalan dalam Task yang sama dengan Task utama DingTalk dan tidak lagi dijaga tetap aktif. Didukung pada Sisi klien v4.6.3.
     ddJointNavi	Tidak	Mengonfigurasi gaya bilah navigasi. Jika dikonfigurasi, akan menimpa logika ddMode. android & iOS: “0”, “1”, atau “1001”. - 0: bilah navigasi lama. - 1: bilah navigasi baru. - 1001: bilah navigasi hanya dengan tombol kembali dan judul.
     keepAlive	Tidak	Dapat diatur ke true atau false, default-nya true. Jika mainTask diatur ke true, key ini diabaikan.
     ddFocus	Tidak	Dapat diatur ke true atau false, default-nya true. Jika diatur ke true, kontainer menonaktifkan elemen internal agar tidak mendapatkan fokus selama inisialisasi.
     ddEnableWX	Tidak	Apakah rendering Weex didukung. Ketika rendering Weex didukung, jika halaman dikonfigurasi dengan mode rendering Weex, Weex dapat diluncurkan untuk memuat halaman.
     ddForceAsync	Tidak	Apakah memaksa startup asinkron. Dengan startup asinkron paksa, jika paket offline lokal ada, pembaruan sinkron tidak dipicu dan aplikasi dijalankan dengan pembaruan asinkron paksa (untuk mengatasi masalah startup di lingkungan offline).
     animated	Tidak	Nilainya 0 atau 1. Menunjukkan apakah animasi transisi digunakan untuk startup asinkron (diabaikan untuk skenario startup sinkron). Default-nya 1. Tersedia sejak v4.6.36.

​

Parameter yang didukung saat ddMode=float (jendela mengambang)

​

Parameter yang didukung saat ddMode=pop (lapisan pop)

2. Skema membuka aplikasi mikro (skema eksklusif untuk mini program perusahaan) Skema: dingtalk://dingtalkclient/action/open_micro_app Basic parameters are the same as in the common parameters list. Logika kontrol grayscale harus ditempatkan dalam handler skema ini. ​

   Parameter	Wajib	Deskripsi
   corpId	Ya	ID organisasi. Penting Parameter ini memiliki prioritas tinggi dan menimpa corpId di query.
   appId	Pilih salah satu antara appId dan agent_id. Jika keduanya ada, appid diprioritaskan.	ID aplikasi mikro. Perhatikan bahwa ini bukan ID mini program. Aplikasi ISV menggunakan ID ini.
   agentId	Pilih salah satu antara agentId dan app_id.	agent_id dari Aplikasi internal.
   fallbackUrl	Tidak. Tidak diperlukan untuk aplikasi mikro yang tidak mendukung H5. Diperlukan untuk aplikasi mikro dalam fase grayscale antara H5 dan mini program.	Alamat H5. Aplikasi mikro yang tidak mendukung mini program menggunakan alamat ini secara langsung.
   ddFocus	Tidak	Jika diatur ke true, kontainer menonaktifkan elemen internal agar tidak mendapatkan fokus selama inisialisasi. Default-nya false.
   ddForceAsync	Tidak	Apakah memaksa startup asinkron. Dengan startup asinkron paksa, jika paket offline lokal ada, pembaruan sinkron tidak dipicu dan aplikasi dijalankan dengan pembaruan asinkron paksa (untuk mengatasi masalah startup di lingkungan offline).

   Kasus uji sisi PC:
   • Membuka URL di panel geser tanpa judul.
     dingtalk://dingtalkclient/action/open_micro_app?corpId=11233&app_id=123&fallback_url=https%3A%2F%2Fwww.dingtalk.io&container_type=slide_panel
     
   • Membuka URL di panel geser tanpa judul.
     dingtalk://dingtalkclient/action/open_micro_app?corpId=11233&app_id=123&fallback_url=https%3A%2F%2Fwww.dingtalk.io
     
   • Membuka URL di browser.
     dingtalk://dingtalkclient/action/open_micro_app?corpId=11233&app_id=123&fallback_url=https%3A%2F%2Fwww.dingtalk.io&container_type=browser
     
   • Membuka URL di panel geser dengan judul.
     https://www.dingtalk.io?micro_app_scheme=dingtalk%3A%2F%2Fdingtalkclient%2Faction%2Fopen_micro_app%3F%0AcorpId%3D11233%26app_id%3D123%26container_type%3Dslide_panel%26title%3Dtest_title
     
   • Membuka URL di browser.
     https://www.dingtalk.io?micro_app_scheme=dingtalk%3A%2F%2Fdingtalkclient%2Faction%2Fopen_micro_app%3F%0AcorpId%3D11233%26app_id%3D123%26container_type%3Dbrowser%26title%3Dtest_title
     
3. Skema meluncurkan mini program (skema eksklusif untuk mini program pribadi) Skema: dingtalk://dingtalkclient/action/open_mini_app Parameter dasar sama dengan yang ada di daftar parameter umum.

   Parameter	Wajib	Deskripsi
   miniAppId	Ya	ID mini program.

4. Skema debug mini program Skema: dingtalk://dingtalkclient/action/dev_mini_app Utamanya digunakan untuk men-debug mini program dan mengembangkan dengan framework appx. Mini program yang dibuka dengan cara ini meluncurkan dokumen utama secara langsung melalui URL. Proses manajemen paket tidak dijalankan, dan logika keep-alive tidak dipicu. miniAppId hanya digunakan untuk verifikasi antarmuka dan tujuan sejenis.

​

Penting

Parameter-parameter tersebut semuanya telah di-encode. Decode terlebih dahulu sebelum digunakan.

​

Cara memperoleh informasi grup sumber melalui tautan

• Tentukan metode pembukaan khusus. Entri pintasan (plugin grup) adalah tautan DingTalk dengan kemampuan bisnis. Developer harus menyusun tautan plugin grup berdasarkan skenario nyata dari aplikasi mikro mereka dan kebutuhan spesifik pengguna dalam grup. Nama plugin mendukung hingga empat karakter. Tautan plugin menawarkan kemampuan yang luas, tetapi developer harus menyusunnya melalui parameter tautan. Misalnya, metode pembukaan di sisi seluler (push page, pop page, dll.) dan logika navigasi halaman di sisi PC (membuka kontainer baru atau menggeser halaman ke kiri) semuanya diimplementasikan melalui konfigurasi parameter tautan. Berikut ini menggunakan entri pintasan untuk grup proyek sebagai contoh untuk menjelaskan secara rinci bagaimana sebuah tautan entri pintasan disusun. <dingtalk://dingtalkclient/page/link?url=https%3a%2f%2fding-doc.dingtalk.io%2fdoc%23%2fpqkq0u%2feluagw%2f$CORPID$%2f$DOUBLE_ENCCID$>
  • Alamat halaman target developer: https%3a%2f%2fding-doc.dingtalk.io%2fdoc%23%2fpqkq0u%2feluagw
    • Saat Anda menggunakan protokol pengalihan terpadu DingTalk, bagian ini digunakan sebagai parameter dari alamat “protokol pengalihan terpadu DingTalk”, sehingga encoding URL diperlukan.
    • Saat Anda tidak menggunakan protokol pengalihan terpadu DingTalk, Anda dapat menggunakan URL asli secara langsung sebagai alamat entri pintasan. Encoding URL tidak diperlukan.
  • Protokol pengalihan terpadu DingTalk (opsional) dingtalk://dingtalkclient/page/link?url=
    • Bagian ini menentukan bagaimana halaman yang Anda tentukan dibuka. Metode yang saat ini didukung meliputi “buka di browser”, “buka di sidebar”, dan lainnya. Jalur protokol pengalihan terpadu berbeda untuk setiap metode.
    • Beberapa jalur protokol pengalihan terpadu hanya tersedia pada klien platform tertentu. Misalnya, “buka di sidebar” hanya tersedia pada klien PC dan Mac.
  • Entri pintasan parameter dinamis alamat (opsional) $CORPID$ $DOUBLE_ENCCID$
    • Saat parameter dinamis ini diatur, bagian yang sesuai dalam URL diganti dengan informasi Konteks grup (seperti corpId dan openConversationId) ketika pengguna mengklik entri pintasan untuk mengakses alamat developer. Parameter dinamis yang saat ini didukung adalah sebagai berikut:

      Parameter	Deskripsi
      $CORPID$	Diganti secara dinamis dengan ID Organisasi (corpId).
      $ENCCID$	Diganti secara dinamis dengan ID grup terbuka (openConversationId). Gunakan parameter dinamis ini hanya saat protokol pengalihan terpadu DingTalk tidak digunakan.
      $DOUBLE_ENCCID$	Diganti secara dinamis dengan ID grup terbuka (openConversationId). Perbedaannya adalah bahwa ia di-encode URL dua kali, yang digunakan untuk decoding URL selama pengalihan pass-through multi-protokol. Gunakan parameter dinamis ini hanya saat protokol pengalihan terpadu DingTalk digunakan.

      Alasan encoding/decoding URL ganda dari $DOUBLE_ENCCID$ adalah sebagai berikut: DingTalk menggunakan protokol internal dengan prefiks “dingtalk://”, yang memerlukan satu putaran encoding agar dapat diurai. Protokol HTTPS bisnis yang di-pass-through setelah parameter URL juga memerlukan satu putaran encoding/decoding lagi saat dikonsumsi oleh kontainer hilir. Karena konsumen perlu melakukan dua putaran decoding, dua putaran encoding diperlukan saat menghasilkan URL. Contoh menghasilkan URL: urlencode (DingTalk URL?xxx=xxx & url = urlencode (business URL)) Contoh mengurai URL: a. urldecode (DingTalk URL) -> mendapatkan business URL; b. urldecode (business URL) -> mendapatkan parameter yang dapat digunakan.