پرش به مطلب اصلی

ذخیره نام و نام خانوادگی

این عملکرد نام و نام خانوادگی کاربر واردشده را روی حساب او ذخیره می‌کند. مقدارها از متغیر خوانده می‌شوند، نه از یک متن ثابت؛ بنابراین می‌توانید فیلدهای فرم دلخواه خودتان را به متغیر وصل کنید و دکمه «ذخیره» را به این عملکرد بدهید.

این عملکرد بخشی از مجموعه‌ای است که طراحی آزاد صفحه پروفایل را ممکن می‌کند.

کاربردها

  • ساخت فرم «ویرایش نام» با ظاهر دلخواه، به‌جای استفاده از ردیف آماده ویجت پروفایل کاربر.
  • تکمیل پروفایل در یک صفحه خوش‌آمدگویی، بلافاصله بعد از عضویت.
  • ذخیره نام از داخل یک شیت یا دیالوگ سفارشی.

تنظیمات

  • متغیر نام: نام متغیری که مقدار «نام» را نگه می‌دارد. این مقدار نمی‌تواند خالی باشد.
  • متغیر نام خانوادگی: نام متغیری که مقدار «نام خانوادگی» را نگه می‌دارد. خالی بودن آن مجاز است.
important

در این فیلدها نام متغیر را وارد کنید، نه مقدار. مقدار در زمان اجرا از همان متغیر خوانده می‌شود.

نتیجه اجرا

بعد از اجرا، دو متغیر سیستمی مقدار می‌گیرند:

متغیرمقدار
sys.user.saveSuccesstrue در صورت موفقیت، false در صورت خطا
sys.user.saveErrorپیام خطا؛ در صورت موفقیت خالی می‌شود

پس از ذخیره موفق، متغیرهای sys.user.name، sys.user.lastname و sys.user.fullName به‌صورت خودکار به‌روز می‌شوند.

توضیحات

  • اگر کاربر وارد حساب نشده باشد، عملکرد اجرا نمی‌شود و پیام «ابتدا وارد حساب کاربری شوید» در sys.user.saveError قرار می‌گیرد.
  • اگر متغیر نام خالی باشد، درخواستی به سرور فرستاده نمی‌شود و خطای «یک نام وارد نمایید» برگردانده می‌شود.
  • فضای خالی ابتدا و انتهای مقدار حذف می‌شود.

نکات تکمیلی

  • برای نمایش خطا به کاربر، یک ویجت متن با محتوای {{sys.user.saveError}} بگذارید و آن را با شرط sys.user.saveSuccess == false نمایش دهید.
  • برای بستن شیت ویرایش بعد از ذخیره موفق، از عملکرد چندگانه استفاده کنید: ابتدا این عملکرد، سپس «بستن صفحه» با شرط sys.user.saveSuccess == true.
  • فیلد فرم را با بایندینگ دوطرفه به متغیر وصل کنید تا مقدار فعلی کاربر هنگام باز شدن فرم داخل فیلد دیده شود.

خطاهای رایج

  • وارد کردن مقدار به‌جای نام متغیر در فیلدهای تنظیمات.
  • فراموش کردن نمایش sys.user.saveError؛ در این حالت خطای سرور دیده نمی‌شود و کاربر فکر می‌کند ذخیره انجام شده است.
  • اجرای عملکرد بدون بررسی ورود کاربر.