Konfigurasikan URL entri pintasan (group plugin)

​

Alihkan ke halaman

dingtalk://dingtalkclient/page/link?dd_mode=present&pc_slide=true&url=https%3A%2F%2Fwww.dingtalk.io

​

Alihkan ke aplikasi web (aplikasi mikro H5)

dingtalk://dingtalkclient/action/openapp?corpid=$CORPID$&container_type=work_platform&app_id=0_1234&redirect_type=jump&redirect_url=https%3A%2F%2Fwww.dingtalk.io

​

Alihkan ke mini program

1. Parameter yang didukung saat ddMode=float (jendela mengambang)

   Parameter	Wajib	Deskripsi
   panelHeight	Tidak	Tinggi jendela mengambang. Dapat berupa nilai Persentase layar atau tinggi tetap. - percent50 berarti 50% dari layar. Angka harus berada di antara (0, 100]. Nilai di luar batas akan dijepit ke batas. - 1000 berarti tinggi tetap 1000 pt (bukan px). - Jika tidak diatur atau diatur ke 0, jendela mengambang ditampilkan secara layar penuh.
   containerType	Tidak	Dua nilai tambahan tersedia dalam skenario ini: - miniApp (default): Mini program. - online: H5 online.
   miniAppId	Ditentukan oleh containerType	appId mini program.
   page	Ditentukan oleh containerType	Alamat halaman yang di-encode URL. Untuk mini program, ini adalah page mini program. Untuk H5 online, ini adalah alamat URL.
   coverVisible	Tidak. Ditampilkan secara default. Atur ke false untuk menyembunyikan.	- true (default): Menampilkan lapisan overlay. - false: Menyembunyikan lapisan overlay. Ditampilkan secara default.

​

Parameter yang didukung saat ddMode=pop (lapisan pop-up)

2. Skema open app (skema khusus untuk mini program perusahaan) Skema: dingtalk://dingtalkclient/action/open_micro_app The basic parameters are the same as the general parameter list. Logika kontrol peluncuran bertahap harus ditempatkan di handler skema ini.

   Parameter	Wajib	Deskripsi
   corpId	Ya	ID organisasi. Penting Ini memiliki prioritas lebih tinggi dan menimpa corpId di query.
   appId	Salah satu dari appId atau agent_id wajib diisi. Jika keduanya diisi, appid diutamakan.	ID Aplikasi mikro. Perhatikan bahwa ini bukan ID mini program. Gunakan ID ini untuk aplikasi ISV.
   agentId	Salah satu dari app_id atau agent_id wajib diisi.	agent_id dari aplikasi internal.
   fallbackUrl	Tidak. Tidak diperlukan untuk aplikasi mikro yang tidak mendukung H5. Wajib selama fase peluncuran bertahap dari H5 ke mini program.	Alamat H5. Untuk aplikasi mikro yang tidak mendukung mini program, alamat ini digunakan secara langsung.
   ddFocus	Tidak	Saat diatur ke true, container mencegah elemen internal mendapatkan fokus selama inisialisasi. Default adalah false.
   ddForceAsync	Tidak	Apakah memaksa peluncuran asinkron. Saat dipaksa meluncur secara asinkron, jika paket offline lokal ada, pembaruan sinkron tidak dipicu. Pembaruan asinkron dipaksa (untuk mengatasi masalah peluncuran di lingkungan offline).

   Kasus uji untuk PC:
   • Buka URL di panel samping 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
     
   • Buka URL di panel samping tanpa judul.
     dingtalk://dingtalkclient/action/open_micro_app?corpId=11233&app_id=123&fallback_url=https%3A%2F%2Fwww.dingtalk.io
     
   • Buka 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
     
   • Buka URL di panel samping 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
     
   • Buka 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 open mini program (skema khusus untuk mini program pribadi) Skema: dingtalk://dingtalkclient/action/open_mini_app Parameter dasarnya sama dengan 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 untuk pengembangan framework appx. Mini program yang dibuka dengan cara ini meluncurkan dokumen utama secara langsung melalui URL. Mereka tidak masuk ke proses manajemen paket dan tidak memicu logika keep-alive. miniAppId digunakan hanya untuk verifikasi API dan tujuan serupa.

​

Penting

​

Mengambil informasi grup sumber melalui tautan

• Tentukan metode pembukaan khusus. Entri pintasan (group plugin) adalah Tautan dingtalk dengan kemampuan bisnis. Developer perlu menyusun Tautan group plugin berdasarkan skenario nyata Aplikasi mikro mereka dan kebutuhan spesifik pengguna dalam grup. Nama plugin mendukung hingga 4 karakter. Tautan menawarkan kemampuan yang luas, tetapi developer harus menyusunnya melalui parameter Tautan. Misalnya, metode pembukaan pada perangkat mobile (halaman push, halaman pop-up, dan sebagainya) dan logika pengalihan halaman pada PC (membuka container baru atau menggunakan panel geser) semuanya diimplementasikan melalui konfigurasi parameter Tautan. Berikut ini menggunakan entri pintasan sebuah grup proyek sebagai contoh untuk menjelaskan secara rinci bagaimana 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 diteruskan sebagai parameter input ke alamat “protokol pengalihan terpadu DingTalk” dan oleh karena itu harus di-encode URL.
    • 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 ditentukan dibuka. Opsi yang saat ini didukung mencakup “Buka di browser” dan “Buka di panel samping”. Path dari protokol pengalihan terpadu berbeda untuk setiap opsi.
    • Beberapa path protokol pengalihan terpadu hanya tersedia pada platform tertentu. Misalnya, “Buka di panel samping” hanya tersedia pada PC dan Mac.
  • Parameter dinamis alamat entri pintasan (opsional): $CORPID$ $DOUBLE_ENCCID$
    • Saat parameter dinamis diatur, bagian URL ini digantikan 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 dinamis berikut hanya dikenali saat dibuka melalui entri pintasan (group plugin).

      Parameter	Deskripsi
      $CORPID$	Digantikan secara dinamis dengan ID Organisasi (corpId).
      $ENCCID$	Digantikan secara dinamis dengan ID percakapan terbuka (openConversationId). Gunakan parameter dinamis ini hanya ketika protokol pengalihan terpadu DingTalk tidak digunakan.
      $DOUBLE_ENCCID$	Digantikan secara dinamis dengan ID percakapan terbuka (openConversationId). Perbedaannya adalah bahwa ini di-encode URL dua kali, digunakan untuk decoding URL di beberapa pengalihan pass-through protokol. Gunakan parameter dinamis ini hanya ketika protokol pengalihan terpadu DingTalk digunakan.

      $DOUBLE_ENCCID$ di-encode dan di-decode URL dua kali karena DingTalk memiliki lapisan protokol internal yang dimulai dengan dingtalk://, yang membutuhkan satu putaran encoding saat parsing. Protokol HTTPS bisnis yang diteruskan melalui parameter URL ke container hilir juga membutuhkan satu putaran encoding dan decoding. Karena konsumen membutuhkan dua putaran parsing, dua putaran encoding diperlukan saat menghasilkan URL. Contoh pembuatan URL: urlencode(DingTalk URL?xxx=xxx & url = urlencode(business URL)) Contoh parsing URL: a. urldecode(DingTalk URL) -> Dapatkan business URL; b. urldecode(business URL) -> Dapatkan parameter yang dapat digunakan.