Power Automate dan Power Apps

Konektor AutomaDoc membawa template Anda ke alat alur kerja Microsoft. Sebuah flow mengirim nilai placeholder template (dari item daftar SharePoint, baris Dataverse, baris Excel, atau jawaban formulir) dan menerima dokumen jadinya kembali, siap disimpan ke pustaka dokumen, dilampirkan ke email, atau diposting di Teams.

Konektor ini bekerja di Power Automate, Power Apps (melalui flow), Azure Logic Apps, dan Copilot Studio. Konektor ini dibangun di atas API dokumen, jadi semua yang dilakukan API dengan data Anda (nama, loop, gambar, kondisi) sama di sini.

Siapa yang dapat memakainya

Seperti API dokumen, konektor ini dapat dipakai di semua paket, termasuk Gratis. Dokumennya adalah dokumen otomatis: dihitung dari kuota Business lebih dulu, lalu kuota bulanan gratis, lalu paket dokumen Anda.

Sebelum mulai

1. Template. Buat di Portal Perusahaan pada menu Template, di add-in Excel, atau di ekstensi Lark Base, dengan placeholder seperti {Customer}, {Invoice_No}, atau loop {#Items}…{/Items}. Konektor menampilkan satu input per placeholder, yang dibaca dari unggahan terakhir template tersebut.
2. Kunci API perusahaan. Admin perusahaan Anda membuatnya di Portal Perusahaan di bawah Perusahaan → Kunci API. Kunci ini diawali amk_ dan hanya ditampilkan sekali: salin ke tempat yang aman. (Kunci milik sebuah template tidak dapat menampilkan daftar template Anda, jadi konektor memerlukan kunci perusahaan.)

Menambahkan konektor

Selama konektor AutomaDoc belum tercantum di antara konektor bersertifikat, tambahkan ke lingkungan Anda sebagai konektor kustom. Ini dilakukan sekali per lingkungan Power Platform.

1. Dapatkan definisi konektor. Unduh, Unduh definisi konektor, atau gunakan alamatnya: https://api.automadoc.cc/api/v1/power-platform.swagger.json
2. Di Power Automate, buka Data → Custom connectors (atau More → Discover all → Custom connectors), lalu New custom connector dan pilih Import an OpenAPI file (file yang Anda unduh) atau Import an OpenAPI from URL (tempel alamatnya). Beri nama AutomaDoc dan pilih Continue.
3. Tab General terisi dari definisi (host, URL dasar, dan deskripsi): tidak ada yang perlu diubah.
4. Di tab Security, pastikan jenis autentikasinya API Key, dengan nama parameter X-Webhook-API-Key dan lokasi Header (semuanya datang bersama definisi). Jika label parameter kosong, ketik API Key. Pilih Create connector.
5. Di tab Test, pilih New connection, tempel kunci API perusahaan Anda, dan buat koneksinya. Uji operasi ListTemplates: jawabannya 200 dengan template Anda.

Di alur, tambahkan tindakan dan cari AutomaDoc: ia tercantum bersama konektor kustom Anda. Setelah konektor bersertifikat tercantum, cari AutomaDoc saat menambahkan tindakan dan tempel kunci saat diminta koneksi.

Jika kebijakan pencegahan kehilangan data (DLP) organisasi Anda memblokir konektor kustom, admin Power Platform Anda dapat mengizinkan konektor ini melalui host-nya, api.automadoc.cc. Halaman Power Automate di Portal Perusahaan berisi langkah yang sama dan unduhannya.

Panduan: satu dokumen untuk setiap item SharePoint baru

Flow ini membuat invoice setiap kali item ditambahkan ke daftar SharePoint, lalu menyimpan PDF-nya ke pustaka dokumen.

1. Trigger. Buat automated cloud flow dengan SharePoint → When an item is created, lalu pilih situs dan daftar Anda (misalnya Invoices).
2. Buat dokumen. Tambahkan AutomaDoc → Generate a document.
   • Template: pilih template invoice Anda dari daftar.
   • Input template muncul di bawahnya. Petakan masing-masing dari dynamic content trigger: Invoice_No ← Title, Customer ← Customer, Total ← Amount, dan seterusnya.
   • Output Format: pdf. Langkah ini menunggu sampai dokumen siap, lalu memberikan Document ID, File Name, Status, dan Download URL kepada langkah berikutnya.
3. Unduh. Tambahkan AutomaDoc → Download document dengan Document ID ← Document ID dari langkah sebelumnya.
4. Simpan. Tambahkan SharePoint → Create file:
   • Folder Path: pustaka Anda, misalnya /Shared Documents/Invoices.
   • File Name: File Name dari Generate a document.
   • File Content: File Content dari Download document.
5. Simpan flow dan tambahkan item ke daftar. PDF-nya muncul di pustaka beberapa detik kemudian.

Untuk mengirimnya lewat email, gunakan Office 365 Outlook → Send an email (V2) dengan lampiran: nama File Name, isi File Content.

Flow siap pakai lainnya, untuk persetujuan, jawaban Microsoft Forms, atau melampirkan file ke item, ada di Resep Power Automate.

Item detail: loop di template

Baris tabel {#Items}…{/Items} di template muncul sebagai input daftar, Items, dengan satu field per kolom. Untuk mengisinya dari daftar lain (misalnya baris-baris invoice), alihkan input ke mode entire array dan berikan array yang objeknya memakai nama kolom sebagai key, misalnya yang dibuat dengan Data Operation → Select dari Get items:

Select: map key	Nilai
Product	Title
Qty	Quantity
Price	UnitPrice

Dari Dataverse atau Excel

Langkah-langkah setelah trigger sama; hanya trigger dan dynamic content yang berubah:

• Dataverse: When a row is added, modified or deleted (change type Added), lalu petakan kolom baris ke input template.
• Excel Online (Business): For a selected row (dijalankan dari Excel), atau List rows present in a table diikuti Apply to each: satu Generate a document per baris menghasilkan satu dokumen per baris.

Satu dokumen dari banyak baris

Template yang diatur untuk membuat satu dokumen dari banyak record (daftar, satu halaman per record, label) menerima daftar sebagai gantinya: inputnya adalah Records, satu entri per baris, dan langkah ini membuat satu dokumen dari semuanya. Teruskan baris dari List rows atau Get items melalui Select, seperti untuk item detail. Hingga 500 baris per dokumen.

Power Apps

Buat dokumen di flow dan panggil flow itu dari aplikasi:

1. Buat instant cloud flow dengan trigger Power Apps (V2) dan tambahkan input teks untuk nilai yang dikirim aplikasi.
2. Tambahkan Generate a document dan petakan input tersebut; akhiri dengan Respond to a Power App or flow yang mengembalikan Download URL (atau simpan file seperti di atas dan kembalikan tautannya).
3. Di aplikasi, panggil dari tombol: Set(doc, GenerateInvoice.Run(txtCustomer.Text, txtTotal.Text)); Launch(doc.downloadurl).

Flow menunggu dokumennya. Aplikasi yang memanggil konektor secara langsung tidak dibuat menunggu: aplikasi menerima dokumen saat masih processing, dan harus memanggil Get document status sampai dokumen selesai.

Logic Apps dan Copilot Studio

Konektor yang sama bekerja di Logic Apps (Standard dan Consumption), dengan aksi yang sama. Di Copilot Studio, tambahkan Generate a document sebagai alat agen Anda: agen mengisi input template dari percakapan dan dapat memberikan Download URL kepada pengguna.

Cara langkah pembuatan menunggu

Generate a document memakai pola polling yang diikuti alat alur kerja Microsoft dengan sendirinya: permintaan dijawab 202 Accepted dengan tautan untuk di-polling, dan platform membacanya setiap 5 detik sampai dokumen selesai, lalu melanjutkan dengan dokumen jadi. Dokumen yang gagal membuat langkah ini gagal, dengan alasannya (loop yang tidak pernah ditutup, gambar yang tidak dapat diambil) di output langkah tersebut. Dokumen yang gagal tidak pernah sampai ke langkah berikutnya seolah-olah sebuah file: Get document status dan Download document juga gagal karenanya (DOCUMENT_FAILED).

Jika Anda menonaktifkan pengaturan Asynchronous pattern pada langkah ini, langkah tersebut langsung kembali dengan dokumen yang masih processing. Tambahkan Get document status dengan Document ID: langkah itu menunggu dokumen dengan cara yang sama. Jika pola asinkron langkah itu juga dinonaktifkan, ia langsung menjawab; tunggu sendiri dengan Do until Status bukan processing, yang berisi Delay (5 detik) dan Get document status. Dokumen yang gagal membuat Get document status gagal (422), sehingga loop berhenti pada galat itu dan tidak pernah membaca failed: tangani dengan Configure run after (has failed) pada langkah berikutnya, atau letakkan loop di dalam Scope.

Batas

• 60 permintaan per menit per template dan 600 dokumen per menit per perusahaan, dibagi bersama API dokumen dan HTTP Trigger; 60 daftar template per menit per perusahaan; 60 pembacaan status dan 60 unduhan per menit per dokumen. Jika melewati batas, langkah ini menjawab 429 dan kebijakan retry platform mencoba lagi.
• Input gambar harus berupa alamat web publik (https://, atau http://). Tautan SharePoint atau OneDrive yang memerlukan login tidak dapat diambil; bagikan gambar dengan tautan publik atau simpan di tempat lain.
• Dokumen disimpan selama perusahaan Anda menyimpan dokumen yang dibuat (ditentukan oleh paket Anda). Unduh file di flow yang sama daripada menyimpan tautannya.
• Mengirim dokumen untuk ditandatangani dan lampiran yang digabungkan ke PDF tersedia melalui API dokumen, bukan sebagai input konektor.

Pemecahan masalah

Yang Anda lihat	Penyebabnya
Daftar template kosong atau koneksi gagal dengan COMPANY_KEY_REQUIRED	Koneksi memakai kunci milik sebuah template; buat koneksi dengan kunci API perusahaan
Sebuah placeholder tidak memiliki input	Input berasal dari unggahan terakhir template; unggah ulang template tersebut
QUOTA_EXCEEDED	Tidak ada dokumen tersisa bulan ini; beli paket dokumen atau seat
Langkah gagal dengan DOCUMENT_FAILED	Dokumen tidak dapat dibuat; output langkah tersebut menjelaskan alasannya
Download document gagal dengan DOCUMENT_NOT_READY	Pola asinkron langkah pembuatan dinonaktifkan, sehingga dokumen masih dibuat; tambahkan Get document status sebelum unduhan

Setiap penolakan lainnya tercantum beserta alasannya di referensi API dokumen.