Menambahkan dan menjalankan kode JavaScript sebaris dengan alur kerja untuk Azure Logic Apps

Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)

Untuk melakukan tugas integrasi kustom sebaris dengan alur kerja Anda di Azure Logic Apps, Anda dapat langsung menambahkan dan menjalankan cuplikan kode JavaScript sederhana dari alur kerja Anda di portal Azure. Untuk tugas ini, gunakan tindakan Kode Sebaris bernama Jalankan Kode JavaScript. Tindakan ini mengembalikan hasil dari cuplikan kode sehingga Anda dapat menggunakan output tersebut dalam tindakan alur kerja berikutnya. Tindakan ini juga memiliki batas yang berbeda, berdasarkan apakah Anda memiliki alur kerja Konsumsi atau Standar dan berfungsi paling baik untuk cuplikan kode dengan atribut berikut:

Untuk menjalankan kode yang tidak sesuai dengan atribut ini, Anda dapat membuat dan memanggil fungsi menggunakan Azure Functions.

Panduan ini memperlihatkan cara kerja tindakan dalam contoh alur kerja yang dimulai dengan pemicu Outlook Office 365. Alur kerja berjalan saat email baru tiba di akun email Outlook terkait. Cuplikan kode sampel mengekstrak alamat email apa pun yang ada di isi email dan mengembalikan alamat tersebut sebagai output yang dapat Anda gunakan dalam tindakan berikutnya.

Diagram berikut menunjukkan sorotan dari contoh alur kerja:

Prasyarat

• Akun dan langganan Azure. Jika Anda tidak memiliki langganan, daftar untuk mendapatkan akun Azure secara gratis.

• Alur kerja aplikasi logika tempat Anda ingin menambahkan cuplikan kode Anda. Alur kerja harus sudah dimulai dengan pemicu.

  Contoh artikel ini menggunakan pemicu Office 365 Outlook yang diberi nama Saat email baru tiba.

  Jika Anda tidak memiliki alur kerja, lihat dokumentasi berikut ini:

  • Konsumsi: Membuat contoh alur kerja aplikasi logika Konsumsi

  • Standar: Membuat contoh alur kerja aplikasi logika Standar

• Berdasarkan apakah Anda memiliki alur kerja aplikasi logika Konsumsi atau Standar, tinjau persyaratan berikut:

  • Alur kerja konsumsi

    • Node.js versi 8.11.10

    • Tautkan ke akun integrasi, kosong atau sebaliknya, dari sumber daya aplikasi logika Anda.

      Penting

      Pastikan Anda menggunakan akun integrasi yang sesuai untuk kasus atau skenario penggunaan Anda.

      Misalnya, akun integrasi Tingkat gratis hanya dimaksudkan untuk skenario dan beban kerja eksploratif, bukan skenario produksi, yang terbatas dalam penggunaan dan throughput, dan tidak didukung oleh perjanjian tingkat layanan (SLA).

      Tingkat akun integrasi lainnya dikenakan biaya, tetapi termasuk dukungan SLA, menawarkan lebih banyak throughput, dan memiliki batasan yang lebih tinggi. Pelajari lebih lanjut tentang tingkatan akun integrasi, batasan, and harga.

  • Alur kerja standar

    • Node.js versi 16.x.x

    • Tidak diperlukan akun integrasi.

Menambahkan tindakan Jalankan Kode JavaScript

Mereferensikan pemicu dan output tindakan dengan menggunakan objek workflowContext

Dari dalam cuplikan kode Anda pada perancang, Anda dapat menggunakan daftar konten dinamis untuk memilih token yang mereferensikan output dari pemicu atau tindakan sebelumnya. Saat Anda memilih token, tindakan Jalankan Kode JavaScript menyelesaikan token tersebut ke objek JSON baca-sajaworkflowContext. Objek ini memberi kode Anda akses ke output dari pemicu, tindakan sebelumnya, dan alur kerja. Objek menggunakan struktur berikut dan mencakup properti actions, trigger, dan workflow, yang juga merupakan objek:

{
   "workflowContext": {
      "actions": {
         "<action-name-1>": @actions('<action-name-1>'),
         "<action-name-2>": @actions('<action-name-2>')
      },
      "trigger": {
         @trigger()
      },
      "workflow": {
         @workflow()
      }
   }
}

Tabel berikut ini memiliki informasi selengkapnya tentang properti ini:

Dalam contoh artikel ini, objek JSON workflowContext mungkin memiliki properti sampel dan nilai berikut dari pemicu Outlook:

{
   "workflowContext": {
      "trigger": {
         "name": "When_a_new_email_arrives",
         "inputs": {
            "host": {
               "connection": {
                  "name": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Web/connections/office365"
               }
            },
            "method": "get",
            "path": "/Mail/OnNewEmail",
            "queries": {
               "includeAttachments": "False"
            }
         },
         "outputs": {
            "headers": {
               "Pragma": "no-cache",
               "Content-Type": "application/json; charset=utf-8",
               "Expires": "-1",
               "Content-Length": "962095"
            },
            "body": {
               "Id": "AAMkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgBGAAAAAABmZwxUQtCGTqSPpjjMQeD",
               "DateTimeReceived": "2019-03-28T19:42:16+00:00",
               "HasAttachment": false,
               "Subject": "Hello World",
               "BodyPreview": "Hello World",
               "Importance": 1,
               "ConversationId": "AAQkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgAQ",
               "IsRead": false,
               "IsHtml": true,
               "Body": "Hello World",
               "From": "<sender>@<domain>.com",
               "To": "<recipient-2>@<domain>.com;<recipient-2>@<domain>.com",
               "Cc": null,
               "Bcc": null,
               "Attachments": []
            }
         },
         "startTime": "2019-05-03T14:30:45.971564Z",
         "endTime": "2019-05-03T14:30:50.1746874Z",
         "scheduledTime": "2019-05-03T14:30:45.8778117Z",
         "trackingId": "1cd5ffbd-f989-4df5-a96a-6e9ce31d03c5",
         "clientTrackingId": "08586447130394969981639729333CU06",
         "originHistoryName": "08586447130394969981639729333CU06",
         "code": "OK",
         "status": "Succeeded"
      },
      "workflow": {
         "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>",
         "name": "<logic-app-workflow-name>",
         "type": "Microsoft.Logic/workflows",
         "location": "<Azure-region>",
         "run": {
            "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>/runs/08586453954668694173655267965CU00",
            "name": "08586453954668694173655267965CU00",
            "type": "Microsoft.Logic/workflows/runs"
         }
      }
   }
}

Menambahkan dependensi sebagai parameter ke tindakan Jalankan Kode JavaScript

Dalam beberapa skenario, Anda mungkin harus secara eksplisit mengharuskan tindakan Jalankan Kode JavaScript menyertakan output dari pemicu atau tindakan yang direferensikan kode Anda sebagai dependensi. Misalnya, Anda harus mengambil langkah tambahan ini saat kode Anda mereferensikan output yang tidak tersedia pada durasi alur kerja. Selama waktu pembuatan alur kerja, mesin Azure Logic Apps menganalisis cuplikan kode untuk menentukan apakah kode mereferensikan pemicu atau output tindakan apa pun. Jika referensi tersebut tersedia, mesin menyertakan output tersebut secara otomatis. Pada durasi alur kerja, jika pemicu atau output tindakan yang dirujuk tidak ditemukan di objek workflowContext, mesin akan menghasilkan kesalahan. Untuk mengatasi kesalahan ini, Anda harus menambahkan pemicu atau tindakan tersebut sebagai dependensi eksplisit untuk tindakan Jalankan Kode JavaScript. Skenario lain yang mengharuskan Anda untuk mengambil langkah ini adalah ketika objek workflowContext mereferensikan pemicu atau nama tindakan yang menggunakan operator titik (.).

Untuk menambahkan pemicu atau tindakan sebagai dependensi, Anda menambahkan parameter Pemicu atau Tindakan sebagaimana berlaku untuk tindakan Jalankan Kode JavaScript. Setelahnya, Anda menambahkan nama pemicu atau tindakan saat muncul dalam definisi JSON yang mendasar pada alur kerja Anda.

Misalnya, tindakan Mengirim surel persetujuan konektor Office 365 Outlook mendahului cuplikan kode dalam alur kerja sampel. Contoh cuplikan kode berikut menyertakan referensi ke output SelectedOption dari tindakan ini.

Untuk contoh ini, Anda hanya harus menambahkan parameter Tindakan, lalu menambahkan nama JSON tindakan, Send_approval_email, ke parameter tersebut. Dengan begitu, Anda menentukan bahwa tindakan Jalankan Kode JavaScript secara eksplisit menyertakan output dari tindakan Kirim email persetujuan.

Menemukan pemicu atau nama JSON tindakan

Sebelum memulai, Anda memerlukan nama JSON untuk pemicu atau tindakan dalam definisi alur kerja yang mendasar.

• Nama dalam definisi alur kerja Anda menggunakan garis bawah (_), bukan spasi.

• Jika nama tindakan menggunakan operator titik (.), sertakan operator tersebut, misalnya:

  My.Action.Name

Menambahkan pemicu atau nama tindakan ke tindakan Jalankan Kode JavaScript

1. Dalam tindakan Jalankan Kode JavaScript, buka daftar Tambahkan parameter baru.

2. Dari daftar parameter, pilih parameter berikut seperti yang diperlukan skenario Anda.

   Parameter	Deskripsi
   Tindakan	Sertakan output dari tindakan sebelumnya sebagai dependensi. Saat memilih parameter ini, Anda akan diminta untuk tindakan yang ingin Anda tambahkan.
   Pemicu	Sertakan output dari pemicu sebagai dependensi. Saat Anda memilih parameter ini, Anda akan ditanya apakah akan menyertakan hasil pemicu. Jadi, dari daftar Pemicu pilih Ya.

3. Untuk contoh ini, pilih parameter Tindakan.

   

4. Dalam kotak Item Tindakan - 1, masukkan nama JSON tindakan.

   

5. Untuk menambahkan nama tindakan lain, pilih Menambahkan item baru.

6. Setelah selesai, simpan alur kerja.

Referensi tindakan

Untuk informasi lebih lanjut tentang struktur dan sintaks tindakan Menjalankan Kode JavaScript dalam definisi alur kerja yang mendasari Anda menggunakan Bahasa Definisi Alur Kerja, lihat pada tindakan ini yaitu bagian referensi.

Langkah berikutnya

• Konektor terkelola untuk Azure Logic Apps
• Konektor bawaan untuk Azure Logic Apps