بعد از ساخت dataset، باید data sourceها و viewهای آن را با تغییر workflowهای خود به‌روز نگه دارید. با مدیریت درست dataset می‌توانید داده‌های تست، script و mock server را از یک نقطه کنترل کنید.
Datasetها در پلن‌های Solo، Team و Enterprise در دسترس هستند. در Local View، هر dataset با یک فایل YAML در Git repository محلی workspace تعریف می‌شود.
مدیریت خود dataset
برای مدیریت یک dataset:
- در sidebar روی Items کلیک کنید.
- Datasets را انتخاب کنید.
- کنار dataset موردنظر، منوی View more actions را باز کنید.
از این منو می‌توانید کارهای زیر را انجام دهید:
- Rename: تغییر نام dataset
- Edit YAML: فقط در Local View، باز کردن و ویرایش مستقیم فایل YAML dataset
- Delete: حذف dataset از workspace
مدیریت data sourceها
Data source مشخص می‌کند داده dataset از کجا می‌آید؛ مثل فایل داده یا اتصال دیتابیس. یک dataset می‌تواند چند data source داشته باشد.
افزودن data source جدید
- از sidebar وارد Items شوید.
- Datasets را انتخاب کنید.
- کنار dataset، در بخش Sources گزینه Add source را بزنید.
- Add New Source را انتخاب کنید.
- نوع data source را انتخاب کنید.
- تنظیمات آن را کامل کنید.
- در صورت نیاز، data sourceهای بیشتری اضافه کنید.
- Save را بزنید.
اگر یک data source را حذف کنید، viewهایی که از آن استفاده می‌کنند خراب می‌شوند. پس بعد از حذف، queryهای viewها را هم بررسی و اصلاح کنید.
به‌روزرسانی data source موجود
- از Items وارد Datasets شوید.
- data source موردنظر را انتخاب کنید.
- تنظیمات آن را متناسب با نوع data source تغییر دهید.
- برای دیدن آخرین داده فایل یا دیتابیس، Refresh را بزنید.
- پیش‌نمایش داده را از تب Data بررسی کنید.
برای هر data source می‌توانید نام را تغییر دهید یا آن را حذف کنید. حذف data source داده اصلی را از دیتابیس یا فایل خارجی الزاماً حذف نمی‌کند، اما ارتباط آن را از dataset برمی‌دارد.
به‌روزرسانی data source با Agent Mode
Agent Mode می‌تواند برای تولید یا تغییر داده نمونه در فایل‌های CSV و JSON کمک کند. مثال:
Add 5 new users with realistic data to my dataset, including userId, name, and email fields.اگر data source شما به دیتابیس وصل است، می‌توانید از Agent Mode بخواهید داده نمونه تولید و در جدول وارد کند:
Generate 10 sample orders with realistic data and insert them into the orders table in my connected MySQL database.بعد از تغییر data source، آن را refresh کنید و در صورت نیاز viewها را هم به‌روزرسانی کنید.
مدیریت viewها
View مشخص می‌کند داده چطور از dataset خوانده شود. با view می‌توانید داده را فیلتر، ترکیب یا تبدیل کنید. برای نمونه، یک view می‌تواند فقط سناریوهای تست خاص را برگرداند یا با query ستون‌های جدید بسازد.
برای افزودن یا تغییر view:
- از Items وارد Datasets شوید.
- برای ساخت view جدید، کنار Views گزینه Add view را بزنید؛ یا یک view موجود را انتخاب کنید.
- یک query سازگار با SQLite وارد کنید.
- Run را بزنید تا query اجرا شود.
- در table pane، نتیجه query را preview و search کنید.
Viewها می‌توانند از چند data source داده بگیرند، اما نمی‌توانند data source محلی و cloud-based را با هم ترکیب کنند.
اشتراک‌گذاری dataset
در Cloud View می‌توانید لینک مستقیم dataset، data source یا view را با تیم خود به اشتراک بگذارید. از مسیر Items > Datasets آیتم موردنظر را باز کنید و از بالای صفحه Copy link را بزنید.
Push و pull کردن datasetها
با push، آخرین نسخه dataset از workspace محلی به cloud Postman sync می‌شود. فایل‌های محلی که push می‌شوند به cloud file تبدیل می‌شوند.
با pull، آخرین نسخه dataset از cloud Postman به workspace محلی شما sync می‌شود. Cloud fileهایی که pull می‌شوند در Git repository محلی شما به فایل محلی تبدیل می‌شوند.
عیب‌یابی datasetها
اگر کنار dataset در sidebar علامت خطا مثل (!) دیدید، معمولاً یکی از این موارد رخ داده است:
- Dataset out of sync: ممکن است فایل‌های dataset را بیرون از Postman ویرایش کرده باشید یا merge conflict وجود داشته باشد. Postman را restart کنید تا فایل‌ها دوباره sync شوند.
- Invalid or corrupted dataset files: فایل dataset ممکن است format یا محتوای نامعتبر داشته باشد. فایل‌های local Git repository را بررسی کنید یا نسخه سالم قبلی را برگردانید.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.