Menyambungkan ke server FTP dari alur kerja di Azure Logic Apps
Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)
Artikel ini memperlihatkan cara mengakses server File Transfer Protocol (FTP) Anda dari alur kerja di Azure Logic Apps dengan konektor FTP. Anda kemudian dapat membuat alur kerja otomatis yang berjalan saat dipicu oleh peristiwa di server FTP Anda atau di sistem lain dan menjalankan tindakan untuk mengelola file di server FTP Anda.
Misalnya, alur kerja Anda dapat dimulai dengan pemicu FTP yang memantau dan merespons peristiwa di server FTP Anda. Pemicu membuat output tersedia untuk tindakan berikutnya dalam alur kerja Anda. Alur kerja Anda dapat menjalankan tindakan FTP yang membuat, mengirim, menerima, dan mengelola file melalui akun server FTP Anda menggunakan tugas tertentu berikut:
- Memantau ketika file ditambahkan atau diubah.
- Membuat, menyalin, menghapus, mencantumkan, dan memperbarui file.
- Dapatkan metadata dan konten file.
- Kelola folder.
Jika Anda baru menggunakan Azure Logic Apps, tinjau dokumentasi memulai berikut ini:
Referensi teknis konektor
Konektor FTP memiliki versi yang berbeda, berdasarkan jenis aplikasi logika dan lingkungan host.
Jenis aplikasi logika (paket) | Lingkungan | Versi konektor |
---|---|---|
Consumption | Azure Logic Apps multipenyewa | Konektor terkelola, yang muncul di galeri konektor di bawah Bersama Runtime>. Untuk informasi selengkapnya, tinjau dokumentasi berikut: - Referensi konektor terkelola FTP - Konektor terkelola di Azure Logic Apps |
Standard | Azure Logic Apps penyewa tunggal dan Lingkungan App Service v3 (hanya paket Windows) | Konektor terkelola (dihosting Azure), yang muncul di galeri konektor di bawah Runtime>Shared, dan konektor bawaan, yang muncul di galeri konektor di bawah Runtime>In App dan berbasis penyedia layanan. Konektor bawaan dapat langsung mengakses jaringan virtual Azure dengan string koneksi. Untuk informasi selengkapnya, tinjau dokumentasi berikut: - Referensi konektor terkelola FTP - Bagian operasi konektor bawaan FTP nanti di artikel ini - Konektor terkelola di Azure Logic Apps - Konektor bawaan di Azure Logic Apps |
Batasan
Kapasitas dan throughput
Konektor bawaan untuk alur kerja Standar:
Secara default, tindakan FTP dapat membaca atau menulis file berukuran 200 MB atau lebih kecil. Saat ini, konektor bawaan FTP tidak mendukung penggugusan.
Konektor terkelola atau yang dihosting Azure untuk alur kerja Konsumsi dan Standar
Secara default, tindakan FTP dapat membaca atau menulis file berukuran 50 MB atau lebih kecil. Untuk menangani file yang lebih besar dari 50 MB, tindakan FTP mendukung potongan pesan. Tindakan Dapatkan konten file secara implisit menggunakan potongan.
Pemicu untuk konektor yang dikelola FTP atau yang dihosting Azure mungkin mengalami hasil yang hilang, tidak lengkap, atau tertunda saat tanda waktu "terakhir diubah" dipertahankan. Di sisi lain, pemicu konektor bawaan FTP dalam alur kerja aplikasi logika Standar tidak memiliki batasan ini. Untuk informasi selengkapnya, tinjau bagian Batasan konektor FTP.
Konektor yang dikelola FTP atau yang dihosting Azure dapat membuat sejumlah koneksi terbatas ke server FTP, berdasarkan kapasitas koneksi di wilayah Azure tempat sumber daya aplikasi logika Anda berada. Jika batas ini menimbulkan masalah dalam alur kerja aplikasi logika Konsumsi, pertimbangkan untuk membuat alur kerja aplikasi logika Standar dan gunakan konektor bawaan FTP sebagai gantinya.
Prasyarat
Akun dan langganan Azure. Jika Anda tidak memiliki langganan Azure, daftar akun Azure gratis.
Alur kerja aplikasi logika tempat Anda ingin mengakses akun FTP Anda. Untuk memulai alur kerja Anda dengan pemicu FTP, Anda harus memulai dengan alur kerja kosong. Untuk menggunakan tindakan FTP, mulai alur kerja Anda dengan pemicu lain, seperti pemicu Pengulangan .
Untuk persyaratan lebih lanjut yang berlaku untuk konektor terkelola FTP dan konektor bawaan, tinjau referensi konektor terkelola FTP - Persyaratan.
Masalah umum
Secara default, pemicu yang mengembalikan array memiliki pengaturan Split On yang sudah diaktifkan. Dengan mengaktifkan pengaturan ini, pemicu secara otomatis memperdebatkan array dengan membuat instans alur kerja terpisah secara internal untuk memproses setiap item array. Semua instans alur kerja berjalan secara paralel sehingga item array diproses secara bersamaan.
Namun, ketika pengaturan Split On diaktifkan, pemicu konektor terkelola mengembalikan output untuk semua item array sebagai daftar. Setiap tindakan berikutnya yang mereferensikan output ini harus terlebih dahulu menangani output ini sebagai daftar. Untuk menangani setiap item array satu per satu, Anda dapat menambahkan tindakan tambahan. Misalnya, untuk melakukan iterasi melalui item array ini, Anda dapat menggunakan untuk setiap perulangan. Untuk pemicu yang hanya mengembalikan metadata atau properti, gunakan tindakan yang mendapatkan metadata item array terlebih dahulu, lalu gunakan tindakan untuk mendapatkan konten item.
Anda harus menerapkan pendekatan ini hanya untuk pemicu konektor terkelola , bukan pemicu konektor bawaan yang mengembalikan output untuk satu item array pada saat pengaturan Pisahkan Saat diaktifkan.
Misalnya, Anda memiliki pemicu konektor terkelola bernama Saat file ditambahkan atau dimodifikasi (hanya properti) yang mengembalikan metadata atau properti untuk file baru atau yang diperbarui sebagai array. Untuk mendapatkan metadata secara terpisah untuk setiap file, Anda dapat menggunakan untuk setiap perulangan yang berulang melalui array. Dalam perulangan ini, gunakan tindakan konektor terkelola berikut dalam urutan yang ditentukan:
Dapatkan metadata file untuk mendapatkan metadata setiap file.
Dapatkan tindakan konten file untuk mendapatkan konten setiap file.
Menambahkan pemicu FTP
Alur kerja aplikasi logika Konsumsi hanya dapat menggunakan konektor terkelola FTP. Namun, alur kerja aplikasi logika Standar dapat menggunakan konektor terkelola FTP dan konektor bawaan FTP. Dalam alur kerja aplikasi logika Standar, konektor terkelola juga diberi label sebagai konektor Azure .
Konektor terkelola FTP dan konektor bawaan masing-masing hanya memiliki satu pemicu yang tersedia:
Pemicu konektor terkelola: Pemicu FTP bernama Saat file ditambahkan atau dimodifikasi (hanya properti) menjalankan alur kerja aplikasi logika Konsumsi atau Standar saat satu atau beberapa file ditambahkan atau diubah dalam folder di server FTP. Pemicu ini hanya mendapatkan properti file atau metadata, bukan konten file. Namun, untuk mendapatkan konten file, alur kerja Anda dapat mengikuti pemicu ini dengan tindakan FTP lainnya.
Untuk informasi selengkapnya tentang pemicu ini, tinjau Saat file ditambahkan atau dimodifikasi (hanya properti).
Pemicu konektor bawaan: Pemicu FTP bernama Saat file ditambahkan atau diperbarui menjalankan alur kerja aplikasi logika Standar saat satu atau beberapa file ditambahkan atau diubah dalam folder di server FTP. Pemicu ini hanya mendapatkan properti file atau metadata, bukan konten file. Namun, untuk mendapatkan konten, alur kerja Anda dapat mengikuti pemicu ini dengan tindakan FTP lainnya. Untuk informasi selengkapnya tentang pemicu ini, tinjau Saat file ditambahkan atau diperbarui.
Langkah-langkah berikut menggunakan portal Azure, tetapi dengan ekstensi Azure Logic Apps yang sesuai, Anda juga dapat menggunakan alat berikut untuk membuat dan mengedit alur kerja aplikasi logika:
Alur kerja aplikasi logika konsumsi: Visual Studio Code
Alur kerja aplikasi logika standar: Visual Studio Code
Di portal Azure, dan buka alur kerja aplikasi logika kosong Anda di perancang.
Pada perancang, di bawah kotak pencarian, pilih Standar. Di kotak pencarian, masukkan ftp.
Dari daftar pemicu, pilih pemicu bernama Saat file ditambahkan atau dimodifikasi (hanya properti).
Berikan informasi untuk koneksi Anda. Jika sudah selesai, pilih Buat.
Catatan
Secara default, konektor ini mentransfer file dalam format teks. Untuk mentransfer file dalam format biner, misalnya, di mana dan saat pengodean digunakan, pilih opsi transportasi biner.
Setelah kotak informasi pemicu muncul, temukan folder yang ingin Anda pantau untuk file baru atau yang diedit.
Dalam kotak Folder , pilih ikon folder untuk melihat direktori folder.
Pilih panah sudut kanan (>). Telusuri ke folder yang Anda inginkan, lalu pilih folder .
Folder pilihan Anda muncul pada kotak Folder.
Setelah selesai, simpan alur kerja.
Saat Anda menyimpan alur kerja, langkah ini secara otomatis menerbitkan pembaruan Anda ke aplikasi logika yang disebarkan, yang ditayangkan di Azure. Hanya dengan pemicu, alur kerja Anda hanya memeriksa server FTP berdasarkan jadwal yang Anda tentukan. Anda harus menambahkan tindakan yang merespons pemicu dan melakukan sesuatu dengan output pemicu.
Menambahkan tindakan FTP
Alur kerja aplikasi logika Konsumsi hanya dapat menggunakan konektor terkelola FTP. Namun, alur kerja aplikasi logika Standar dapat menggunakan konektor terkelola FTP dan konektor bawaan FTP. Setiap versi memiliki beberapa tindakan. Misalnya, versi konektor terkelola dan bawaan memiliki tindakan mereka sendiri untuk mendapatkan metadata file dan mendapatkan konten file.
Tindakan konektor terkelola: Tindakan ini berjalan dalam alur kerja aplikasi logika Konsumsi atau Standar.
Tindakan konektor bawaan: Tindakan ini hanya berjalan dalam alur kerja aplikasi logika Standar.
Langkah-langkah berikut menggunakan portal Azure, tetapi dengan ekstensi Azure Logic Apps yang sesuai, Anda juga dapat menggunakan alat berikut untuk membangun alur kerja aplikasi logika:
- Alur kerja konsumsi: Visual Studio Code
- Alur kerja standar: Visual Studio Code
Sebelum Anda dapat menggunakan tindakan FTP, alur kerja Anda harus sudah dimulai dengan pemicu, yang bisa dalam bentuk apa pun yang Anda pilih. Misalnya, Anda dapat menggunakan pemicu bawaan Pengulangan generik untuk memulai alur kerja Anda pada jadwal tertentu.
Di portal Azure, dan buka alur kerja aplikasi logika Anda di perancang.
Temukan dan pilih tindakan FTP yang ingin Anda gunakan.
Contoh ini berlanjut dengan tindakan bernama Dapatkan metadata file sehingga Anda bisa mendapatkan metadata untuk satu item array.
Pada perancang, di bawah pemicu atau tindakan lainnya, pilih Langkah baru.
Di bawah kotak pencarian Pilih operasi , pilih Standar.
Dalam kotak pencarian, masukkan ftp get file metadata.
Dari daftar tindakan, pilih tindakan bernama Dapatkan metadata file.
Jika perlu, berikan informasi untuk koneksi Anda. Jika sudah selesai, pilih Buat.
Catatan
Secara default, konektor ini mentransfer file dalam format teks. Untuk mentransfer file dalam format biner, misalnya, di mana dan saat pengodean digunakan, pilih opsi transportasi biner.
Setelah kotak Dapatkan informasi tindakan metadata file muncul, klik di dalam kotak File sehingga daftar konten dinamis terbuka.
Anda sekarang dapat memilih output dari pemicu sebelumnya.
Di daftar konten dinamis, di bawah Saat file ditambahkan atau dimodifikasi, pilih Daftar Id File.
Properti File sekarang mereferensikan output pemicu Daftar Id File.
Pada perancang, di bawah tindakan Dapatkan metadata file, pilih Langkah baru.
Di bawah kotak pencarian Pilih operasi , pilih Standar.
Dalam kotak pencarian, masukkan ftp dapatkan konten file.
Dari daftar tindakan, pilih tindakan bernama Dapatkan konten file.
Setelah kotak Dapatkan informasi tindakan konten file muncul, klik di dalam kotak File sehingga daftar konten dinamis terbuka.
Anda sekarang dapat memilih output dari pemicu sebelumnya dan tindakan lainnya.
Dalam daftar konten dinamis, di bawah Dapatkan metadata file, pilih Id, yang mereferensikan file yang ditambahkan atau diperbarui.
Properti File sekarang mereferensikan output tindakan Id .
Setelah selesai, simpan alur kerja. Di bar alat perancang, pilih Simpan.
Menguji alur kerja
Untuk memeriksa apakah alur kerja Anda mengembalikan konten yang Anda harapkan, tambahkan tindakan lain yang mengirimi Anda konten dari file yang ditambahkan atau diperbarui. Contoh ini menggunakan tindakan Office 365 Outlook bernama Kirim email.
Di bawah tindakan Dapatkan konten file, tambahkan tindakan Office 365 Outlook bernama Kirim email. Jika Anda memiliki akun Outlook.com, tambahkan tindakan Outlook.com Kirim email , dan sesuaikan langkah-langkah berikut.
Pada perancang, di bawah tindakan Dapatkan konten file, pilih Langkah baru.
Di bawah kotak pencarian Pilih operasi , pilih Standar.
Dalam kotak pencarian, masukkan office 365 outlook kirim email. Dari daftar tindakan, pilih tindakan Office 365 Outlook bernama Kirim email.
Jika perlu, masuk ke akun email Anda.
Dalam kotak informasi tindakan, berikan nilai yang diperlukan dan sertakan parameter atau properti lain yang ingin Anda uji.
Misalnya, Anda dapat menyertakan output konten File dari tindakan Dapatkan konten file. Untuk menemukan output ini, ikuti langkah-langkah berikut:
Dalam tindakan Dapatkan konten file, klik di dalam kotak Isi sehingga daftar konten dinamis terbuka.
Di daftar konten dinamis, di samping Dapatkan konten file, pilih Lihat selengkapnya.
Di daftar konten dinamis, di bawah Dapatkan konten file, pilih Konten File.
Properti Isi sekarang mereferensikan output tindakan Konten File.
Menyimpan alur kerja aplikasi logika Anda.
Untuk menjalankan dan memicu alur kerja, pada toolbar perancang, pilih Jalankan Eksekusi Pemicu>. Tambahkan file ke folder FTP yang dipantau alur kerja Anda.
Operasi konektor bawaan FTP
Konektor bawaan FTP hanya tersedia untuk alur kerja aplikasi logika Standar dan menyediakan operasi berikut:
Pemicu | Deskripsi |
---|---|
Saat file ditambahkan atau diperbarui | Mulai alur kerja aplikasi logika saat file ditambahkan atau diperbarui di folder yang ditentukan di server FTP. Catatan: Pemicu ini hanya mendapatkan metadata atau properti file, bukan konten file. Namun, untuk mendapatkan konten, alur kerja Anda dapat mengikuti pemicu ini dengan tindakan Dapatkan konten file. |
Tindakan | Deskripsi |
---|---|
Membuat file | Buat file menggunakan jalur file dan konten file yang ditentukan. |
Hapus file | Hapus file menggunakan jalur file yang ditentukan. |
Dapatkan isi file | Dapatkan konten file menggunakan jalur file yang ditentukan. |
Dapatkan metadata file | Dapatkan metadata atau properti file menggunakan jalur file yang ditentukan. |
Mencantumkan file dan subfolder dalam folder | Dapatkan daftar file dan subfolder di folder yang ditentukan. |
Perbarui file | Perbarui file menggunakan jalur file dan konten file yang ditentukan. |
Saat file ditambahkan atau diperbarui
ID Operasi: whenFtpFilesAreAddedOrModified
Pemicu ini memulai alur kerja aplikasi logika yang dijalankan saat file ditambahkan atau diperbarui di folder yang ditentukan di server FTP. Pemicu hanya mendapatkan metadata atau properti file, bukan konten file apa pun. Namun, untuk mendapatkan konten, alur kerja Anda dapat mengikuti pemicu ini dengan tindakan Dapatkan konten file.
Parameter
Nama | Tombol | Wajib | Tipe | Deskripsi |
---|---|---|---|---|
Jalur Folder | folderPath |
Benar | string |
Jalur folder, relatif terhadap direktori akar. |
Jumlah file yang akan dikembalikan | maxFileCount |
Salah | integer |
Jumlah maksimum file yang akan dikembalikan dari satu eksekusi pemicu. Nilai yang valid berkisar antara 1 - 100. Catatan: Secara default, pengaturan Split On diaktifkan dan memaksa pemicu ini untuk memproses setiap file satu per satu secara paralel. |
Tanda waktu cutoff untuk mengabaikan file yang lebih lama | oldFileCutOffTimestamp |
Salah | dateTime |
Waktu cutoff yang digunakan untuk mengabaikan file yang lebih lama. Gunakan format YYYY-MM-DDTHH:MM:SS tanda waktu . Untuk menonaktifkan fitur ini, biarkan properti ini kosong. |
Mengembalikan
Saat pengaturan Split On pemicu diaktifkan, pemicu mengembalikan metadata atau properti untuk satu file pada satu waktu. Jika tidak, pemicu mengembalikan array yang berisi metadata setiap file.
Nama | Tipe |
---|---|
Daftar file | BlobMetadata |
Membuat file
ID Operasi: createFile
Tindakan ini membuat file menggunakan jalur file dan konten file yang ditentukan. Jika file sudah ada, tindakan ini akan menimpa file tersebut.
Penting
Jika Anda menghapus atau mengganti nama file di server FTP segera setelah pembuatan dalam alur kerja yang sama, operasi mungkin mengembalikan kesalahan HTTP 404 , yaitu berdasarkan desain. Untuk menghindari masalah ini, sertakan penundaan 1 menit sebelum Anda menghapus atau mengganti nama file yang baru dibuat. Anda dapat menggunakan tindakan Tunda untuk menambahkan penundaan ini ke alur kerja Anda.
Parameter
Nama | Tombol | Wajib | Tipe | Deskripsi |
---|---|---|---|---|
Jalur file | filePath |
Benar | string |
Jalur file, termasuk ekstensi nama file jika ada, relatif terhadap direktori akar. |
Konten file | fileContent |
Benar | string |
Konten file. |
Mengembalikan
Tindakan ini mengembalikan objek BlobMetadata bernama Isi.
Nama | Tipe |
---|---|
Nama File metadata file | string |
Jalur File metadata file | string |
Ukuran File metadata file | string |
Metadata file | BlobMetadata |
Hapus file
ID Operasi: deleteFtpFile
Tindakan ini menghapus file menggunakan jalur file yang ditentukan.
Parameter
Nama | Tombol | Wajib | Tipe | Deskripsi |
---|---|---|---|---|
Jalur file | filePath |
Benar | string |
Jalur file, termasuk ekstensi nama file jika ada, relatif terhadap direktori akar. |
Mengembalikan
Tidak
Dapatkan isi file
ID Operasi: getFtpFileContent
Tindakan ini mendapatkan konten file menggunakan jalur file yang ditentukan.
Parameter
Nama | Tombol | Wajib | Tipe | Deskripsi |
---|---|---|---|---|
Jalur file | path |
Benar | string |
Jalur file, termasuk ekstensi nama file jika ada, relatif terhadap direktori akar. |
Mengembalikan
Tindakan ini mengembalikan konten file sebagai nilai biner bernama Konten file.
Nama | Tipe |
---|---|
Konten file | Biner |
Dapatkan metadata file
ID Operasi: getFileMetadata
Tindakan ini mendapatkan metadata atau properti file menggunakan jalur file yang ditentukan.
Parameter
Nama | Tombol | Wajib | Tipe | Deskripsi |
---|---|---|---|---|
Jalur file | path |
Benar | string |
Jalur file, termasuk ekstensi nama file jika ada, relatif terhadap direktori akar. |
Mengembalikan
Tindakan ini mengembalikan output berikut:
Nama | Tipe |
---|---|
Nama file | string |
Jalur file | string |
Ukuran file | string |
Waktu terakhir diperbarui | string |
Metadata file | BlobMetadata |
Mencantumkan file dan subfolder dalam folder
ID Operasi: listFilesInFolder
Tindakan ini mendapatkan daftar file dan subfolder dalam folder yang ditentukan.
Parameter
Nama | Tombol | Wajib | Tipe | Deskripsi |
---|---|---|---|---|
Jalur Folder | folderPath |
Benar | string |
Jalur folder, relatif terhadap direktori akar. |
Konten file | fileContent |
Benar | string |
Konten untuk file |
Mengembalikan
Tindakan ini mengembalikan array yang bernama Respons dan berisi objek BlobMetadata.
Nama | Tipe |
---|---|
Respons | Array dengan objek BlobMetadata |
Perbarui file
ID Operasi: updateFile
Tindakan ini memperbarui file menggunakan jalur file dan isi file yang ditentukan.
Penting
Jika Anda menghapus atau mengganti nama file di server FTP segera setelah pembuatan dalam alur kerja yang sama, operasi mungkin mengembalikan kesalahan HTTP 404 , yaitu berdasarkan desain. Untuk menghindari masalah ini, sertakan penundaan 1 menit sebelum Anda menghapus atau mengganti nama file yang baru dibuat. Anda dapat menggunakan tindakan Tunda untuk menambahkan penundaan ini ke alur kerja Anda.
Parameter
Nama | Tombol | Wajib | Tipe | Deskripsi |
---|---|---|---|---|
Jalur file | filePath |
Benar | string |
Jalur file, termasuk ekstensi nama file jika ada, relatif terhadap direktori akar. |
Konten file | fileContent |
Benar | string |
Konten untuk file |
Mengembalikan
Tindakan ini mengembalikan objek BlobMetadata bernama Isi.
Nama | Tipe |
---|---|
Isi | BlobMetadata |