Menggunakan Variabel

Di Apidog, variabel memungkinkan Anda menyimpan dan menggunakan kembali nilai dengan mudah. Menyimpan suatu nilai sebagai variabel memungkinkan Anda mengaksesnya di berbagai lingkungan, permintaan, skrip, dan skenario pengujian. Penggunaan variabel meningkatkan produktivitas dan mendorong kerja sama tim di antara rekan kerja.

Apa itu Variabel?

Variabel adalah representasi simbolis dari data yang memungkinkan Anda mengambil suatu nilai tanpa perlu memasukkannya secara manual setiap kali diperlukan. Ini bermanfaat untuk menggunakan kembali nilai yang sama di berbagai lokasi.

Contoh:
Jika Anda memiliki token yang sama di beberapa permintaan dan memperkirakan adanya perubahan, simpan token tersebut sebagai variabel bernama {{my_token}}. Gunakan {{my_token}} pada nilai parameter permintaan. Ketika token berubah, memperbarui nilai variabel akan memperbaruinya di semua tempat.

Variabel dapat berlaku pada nilai parameter, body, URL, atau header.

Dalam modul Pengujian Apidog, variabel dapat digunakan untuk meneruskan data antarpermintaan.

Cakupan Variabel

Apidog mendukung variabel dalam berbagai cakupan untuk menyesuaikan dengan kebutuhan pengembangan, pengujian, dan kolaborasi yang berbeda.

Prioritas (dari terendah ke tertinggi): Global < Modul < Lingkungan < Data < Lokal

Ketika variabel dengan nama yang sama didefinisikan dalam cakupan yang berbeda, nilai dari cakupan tersempit akan diprioritaskan.

Variabel Global

Dibagikan dalam Proyek: Dapat diakses di seluruh proyek. Berguna untuk berbagi data antar-endpoint (misalnya, token login).

Dibagikan dalam Tim: Dibagikan ke seluruh tim di berbagai proyek (misalnya, token yang dibagikan antara proyek login dan proyek keuangan).

NOTE

Izin: Untuk mengelola variabel tim, Anda memerlukan izin admin tim. Buka Sumber Daya Tim > Variabel.

Skrip: Anda dapat menggunakan pm.globals.set untuk memperbarui nilai lokal dalam skrip, tetapi tidak dapat mengubah nama atau nilai bersama.

Variabel Modul

Didefinisikan dalam sebuah modul. Impor dari "Collection variables" Postman akan dipetakan ke Variabel Modul.

Variabel Lingkungan

Terikat pada lingkungan tertentu (Pengembangan, Pengujian, Produksi). Hanya variabel dari lingkungan yang aktif yang berlaku.

Variabel Data

Bersumber dari file CSV atau JSON eksternal dalam Skenario Pengujian atau CLI. Nilai tidak dipertahankan setelah proses berjalan selesai.

Variabel Lokal

Variabel sementara yang terbatas pada satu permintaan atau satu eksekusi skenario pengujian. Menghilang setelah selesai.

TIP

Variabel di Apidog disimpan sebagai string. Saat menyimpan objek atau array, gunakan JSON.stringify() untuk menyimpan dan JSON.parse() untuk mengambilnya.

Nilai Bersama dan Nilai Lokal

Setiap variabel memiliki dua status:

Nilai Bersama: Disinkronkan dengan server Apidog dan dibagikan kepada tim.

Nilai Lokal: Disimpan SECARA LOKAL di cache browser atau klien Anda. Tidak dibagikan.

Praktik Terbaik:

Gunakan Nilai Lokal untuk data sensitif (token, kata sandi) agar tetap berada di mesin Anda.

Biarkan Nilai Lokal kosong untuk menggunakan Nilai Bersama sebagai fallback.

Klik ikon tautan 🔗 untuk menyinkronkan Nilai Lokal dengan Nilai Bersama.

WARNING

Membersihkan cache Apidog akan menghapus Nilai Lokal.

Nilai Lokal TIDAK bermigrasi secara otomatis saat berpindah perangkat (gunakan Ekspor/Impor Lingkungan).

Menggunakan Variabel di Apidog CLI

Saat berjalan di CLI, Nilai Bersama digunakan secara default, sedangkan Klien menggunakan Nilai Lokal. Ini adalah penyebab umum perbedaan antara eksekusi Klien dan CLI.

TIP

Pelajari lebih lanjut tentang Apidog CLI.

Mendefinisikan Variabel

1. Manajemen Lingkungan (Preset)

Nilai untuk variabel Global dan Lingkungan dapat dipreset secara manual.

Klik ikon Manajemen Lingkungan ≡.

Pilih Variabel Global atau lingkungan tertentu.

Tambahkan nama variabel, nilai bersama, dan nilai lokal.

Klik Simpan.

2. Mengekstrak Variabel

Ekstrak nilai secara visual dari respons API ke dalam variabel tanpa menulis kode.

Di tab Jalankan (Mode Desain), buka Post Processors.

Pilih Extract Variable.

Konfigurasikan sumber ekstraksi (JSON, XML, Header, dll.) dan JSONPath.

Kirim permintaan untuk menjalankan dan memverifikasi di Console.

TIP

Pelajari lebih lanjut tentang Extract Variable.

3. Skrip

Gunakan objek pm dalam Pre/Post-processors.

Sintaks untuk set:

Menyimpan Objek/Array:

TIP

Pelajari lebih lanjut tentang Sintaks Skrip.

4. Operasi Basis Data

Hubungkan ke basis data untuk mengambil data dan menetapkannya sebagai variabel.

Tambahkan Database Operation di Post Processors.

Konfigurasikan koneksi basis data.

Masukkan perintah SQL (mendukung {{variable}}).

Atur Extract Result To Variable.

TIP

Pelajari lebih lanjut tentang Operasi Basis Data.

Parameter Permintaan

Gunakan kurung kurawal ganda {{variable}} dalam URL, parameter, header, atau body.

Contoh URL:
http://127.0.0.1/pet/findByStatus?status={{CurrentStatus}}

Contoh Body JSON:

{
    "status": "{{CurrentStatus}}",
    "quantity": {{TotalPet}}
}

WARNING

String: Tambahkan tanda kutip ganda "" di sekitar variabel untuk string (misalnya, "{{name}}").

Angka/Boolean: JANGAN tambahkan tanda kutip (misalnya, {{count}}).

Mengakses Sub-elemen

Jika sebuah variabel berisi objek/array JSON, akses properti melalui notasi titik menggunakan JSONPath.

Objek dalam {{user}}:

{ "id": 1, "name": "Jack" }

Permintaan: {{user.name}}

Skrip: pm.variables.get("user.name")

Array dalam {{users}}:

[ { "name": "Jack" } ]

Permintaan: {{users[0].name}}

Skrip: pm.variables.get("users[0].name")

Menggunakan Variabel dalam Skrip

Dalam skrip, gunakan pm.*.get() alih-alih {{}}.

Logging:

Periksa tab Console untuk melihat output.

Menggunakan Variabel Data

Dalam Skenario Pengujian, mengimpor file CSV/JSON akan membuat "Variabel Data". Gunakan {{column_name}} untuk merujuknya. Setiap baris dalam file memicu iterasi terpisah.

TIP

Pelajari lebih lanjut tentang Data Driven Testing.

FAQ

T: Dapatkah saya menggunakan variabel dalam Mock?

Tidak. Variabel diselesaikan ketika sebuah permintaan dikirim. Mock adalah definisi statis atau berjalan di server mock tanpa konteks "pengiriman" sisi klien dengan cara yang sama.

T: Bagaimana cara mendapatkan base URL dalam skrip?

Gunakan pm.request.getBaseUrl().

Hindari pm.environment.get('BASE_URL') karena mungkin tidak akurat untuk endpoint server non-default.

Menggunakan Variabel

Apa itu Variabel?#

Cakupan Variabel#

Nilai Bersama dan Nilai Lokal#

Menggunakan Variabel di Apidog CLI#

Mendefinisikan Variabel#

1. Manajemen Lingkungan (Preset)#

2. Mengekstrak Variabel#

3. Skrip#

4. Operasi Basis Data#

Menggunakan Variabel#

Parameter Permintaan#

Mengakses Sub-elemen#

Menggunakan Variabel dalam Skrip#

Menggunakan Variabel Data#

FAQ#

Apa itu Variabel?

Cakupan Variabel

Nilai Bersama dan Nilai Lokal

Menggunakan Variabel di Apidog CLI

Mendefinisikan Variabel

1. Manajemen Lingkungan (Preset)

2. Mengekstrak Variabel

3. Skrip

4. Operasi Basis Data

Menggunakan Variabel

Parameter Permintaan

Mengakses Sub-elemen

Menggunakan Variabel dalam Skrip

Menggunakan Variabel Data

FAQ