Bagikan melalui

Menyambungkan ke server FTP dari alur kerja di Azure Logic Apps

  • Artikel

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:

  1. Dapatkan metadata file untuk mendapatkan metadata setiap file.

  2. 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:

  1. Di portal Azure, dan buka alur kerja aplikasi logika kosong Anda di perancang.

  2. Pada perancang, di bawah kotak pencarian, pilih Standar. Di kotak pencarian, masukkan ftp.

  3. Dari daftar pemicu, pilih pemicu bernama Saat file ditambahkan atau dimodifikasi (hanya properti).

    Cuplikan layar memperlihatkan portal Azure, perancang alur kerja Konsumsi, dan pemicu FTP dipilih.

  4. 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.

    Cuplikan layar memperlihatkan perancang alur kerja Konsumsi dan profil koneksi FTP.

  5. Setelah kotak informasi pemicu muncul, temukan folder yang ingin Anda pantau untuk file baru atau yang diedit.

    1. Dalam kotak Folder , pilih ikon folder untuk melihat direktori folder.

    2. Pilih panah sudut kanan (>). Telusuri ke folder yang Anda inginkan, lalu pilih folder .

    Cuplikan layar memperlihatkan perancang alur kerja konsumsi, pemicu FTP, dan properti

    Folder pilihan Anda muncul pada kotak Folder.

    Cuplikan layar memperlihatkan perancang alur kerja Konsumsi, pemicu FTP, dan properti

  6. 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:

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.

  1. Di portal Azure, dan buka alur kerja aplikasi logika Anda di perancang.

  2. 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.

    1. Pada perancang, di bawah pemicu atau tindakan lainnya, pilih Langkah baru.

    2. Di bawah kotak pencarian Pilih operasi , pilih Standar.

    3. Dalam kotak pencarian, masukkan ftp get file metadata.

    4. Dari daftar tindakan, pilih tindakan bernama Dapatkan metadata file.

    Cuplikan layar memperlihatkan portal Azure, perancang alur kerja Konsumsi, kotak pencarian dengan

  3. 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.

    Cuplikan layar memperlihatkan perancang alur kerja Konsumsi dan profil koneksi FTP untuk tindakan.

  4. 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.

  5. Di daftar konten dinamis, di bawah Saat file ditambahkan atau dimodifikasi, pilih Daftar Id File.

    Cuplikan layar memperlihatkan perancang alur kerja Konsumsi, tindakan

    Properti File sekarang mereferensikan output pemicu Daftar Id File.

  6. Pada perancang, di bawah tindakan Dapatkan metadata file, pilih Langkah baru.

  7. Di bawah kotak pencarian Pilih operasi , pilih Standar.

  8. Dalam kotak pencarian, masukkan ftp dapatkan konten file.

  9. Dari daftar tindakan, pilih tindakan bernama Dapatkan konten file.

    Cuplikan layar memperlihatkan portal Azure, perancang alur kerja Konsumsi, kotak pencarian dengan

  10. 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.

  11. Dalam daftar konten dinamis, di bawah Dapatkan metadata file, pilih Id, yang mereferensikan file yang ditambahkan atau diperbarui.

    Cuplikan layar memperlihatkan perancang alur kerja Konsumsi, tindakan

    Properti File sekarang mereferensikan output tindakan Id .

    Cuplikan layar memperlihatkan perancang alur kerja Konsumsi, tindakan

  12. 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.

  1. 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.

    1. Pada perancang, di bawah tindakan Dapatkan konten file, pilih Langkah baru.

    2. Di bawah kotak pencarian Pilih operasi , pilih Standar.

    3. Dalam kotak pencarian, masukkan office 365 outlook kirim email. Dari daftar tindakan, pilih tindakan Office 365 Outlook bernama Kirim email.

    Cuplikan layar memperlihatkan perancang alur kerja Konsumsi dan tindakan

  2. Jika perlu, masuk ke akun email Anda.

  3. 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:

    1. Dalam tindakan Dapatkan konten file, klik di dalam kotak Isi sehingga daftar konten dinamis terbuka.

    2. Di daftar konten dinamis, di samping Dapatkan konten file, pilih Lihat selengkapnya.

      Cuplikan layar memperlihatkan perancang alur kerja Konsumsi, tindakan

    3. Di daftar konten dinamis, di bawah Dapatkan konten file, pilih Konten File.

      Properti Isi sekarang mereferensikan output tindakan Konten File.

      Cuplikan layar memperlihatkan perancang alur kerja Konsumsi, tindakan

  4. Menyimpan alur kerja aplikasi logika Anda.

  5. 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:SStanda 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

Langkah berikutnya