نتیجهٔ عملیات حساب کاربری
هر عملکرد حساب کاربری، نتیجهٔ مخصوص خودش را دارد. با اتصال متن خطا و شرط موفقیت به نتیجهٔ همان عملکرد، خطای ورود در فرم عضویت یا خطای تغییر موبایل در فرم ویرایش نام دیده نمیشود.
متغیر مناسب هر عملکرد
| عملکرد | موفقیت | پیام خطا |
|---|---|---|
| ورود | sys.user.loginSuccess | sys.user.loginError |
| عضویت | sys.user.registerSuccess | sys.user.registerError |
| بازیابی رمز | sys.user.forgetSuccess | sys.user.forgetError |
| ذخیره نام | sys.user.saveNameSuccess | sys.user.saveNameError |
| ذخیره موبایل | sys.user.saveMobileSuccess | sys.user.saveMobileError |
| ذخیره ایمیل | sys.user.saveEmailSuccess | sys.user.saveEmailError |
| تغییر رمز | sys.user.savePasswordSuccess | sys.user.savePasswordError |
| ذخیره فیلد سفارشی | sys.user.saveFieldSuccess | sys.user.saveFieldError |
| تعویض عکس | sys.user.setPicSuccess | sys.user.setPicError |
| تازهسازی اطلاعات | sys.user.refreshSuccess | sys.user.refreshError |
شروع، پایان و انصراف
| وضعیت | متغیر موفقیت همان عملکرد | پیام خطا |
|---|---|---|
| شروع تلاش تازه | خالی (null) | خالی |
| پایان موفق | true | خالی |
| پایان ناموفق | false | توضیح خطا |
| انصراف از ورود، ثبتنام، بازیابی رمز یا انتخاب عکس | خالی میماند | خالی میماند |
شروع یک عملکرد، نتیجهٔ عملکردهای دیگر را پاک نمیکند. برای مثال، تازهسازی پروفایل نتیجهٔ ذخیره نام را تغییر نمیدهد. بستن پنجرهٔ تأیید هم موفقیت نیست؛ مرحلهٔ بعد را فقط با شرط موفقیت همان عملکرد اجرا کنید.
در ذخیرهٔ موبایل و ایمیل، بستن پنجرهٔ تأیید یا تأیید ناموفق، نتیجهٔ false و پیام خطای کد را ثبت میکند. تازهسازی اطلاعات نیز پس از پایان فراخوانی true میدهد؛ این نتیجه بهتنهایی تضمین دریافت موفق داده از شبکه نیست.
مثال: فرم ورود
- متن خطا را به
{{sys.user.loginError}}وصل کنید و شرط نمایش را خالی نبودن همین متغیر قرار دهید. - روی دکمهٔ ورود، یک عملکرد چندگانه بگذارید: ابتدا ورود، سپس بستن صفحه با شرط
sys.user.loginSuccess == true. - انتظار برای پایان را فعال کنید تا مرحلهٔ دوم پس از پایان ورود بررسی شود.
- در رویداد ورود به فرم یا هنگام برگشت به بخش ورود، پاککردن نتیجهٔ عملیات حساب کاربری را با انتخاب «ورود» اجرا کنید.
برای فرم عضویت از registerSuccess و registerError، و برای بازیابی رمز از forgetSuccess و forgetError استفاده کنید. بلوکهای آمادهٔ تازهٔ پنل این اتصالها را دارند؛ فرمهای قبلی را خودتان بهروز کنید.
پاککردن پیام قبلی
عملکرد پاککردن نتیجهٔ عملیات حساب کاربری نتیجهٔ یک عملیات یا همهٔ عملیاتها را خالی میکند. آن را هنگام ورود به فرم، تغییر تب یا رفتن از ورود به عضویت اجرا کنید. این کار درخواست شبکه نمیفرستد، کاربر را از حساب خارج نمیکند و مقدار فیلدهای فرم را عوض نمیکند.
اگر پس از پاککردن، پاسخ درخواست قبلی برسد، نتیجهٔ پاکشده را دوباره نمایش نمیدهد. درخواست شبکه و اثر احتمالی آن روی حساب همچنان میتوانند تکمیل شوند؛ این عملکرد برای پاککردن وضعیت نمایشی است.
اپها و نتیجههای قبلی
sys.user.saveSuccess و sys.user.saveError همچنان نتیجهٔ آخرین عملیات تکمیلشده را نگه میدارند. شروع تلاش تازه یا انصراف، این دو متغیر مشترک را تغییر نمیدهد. بنابراین در فرمهای جداگانه از نتیجههای اختصاصی جدول بالا استفاده کنید.
برای اصلاح فرم موجود، متن خطا و شرط موفقیت هر بخش را عوض کنید و پاککردن نتیجه را به رویداد مناسب اضافه کنید. تغییر اتصالها خودکار روی فرمهای ذخیرهشدهٔ قبلی اعمال نمیشود. نتیجههای اختصاصی و عملکرد تازه به ساخت و نصب خروجی جدید با پشتیبانی این قابلیت نیاز دارند؛ انتشار آنلاین بهتنهایی آنها را به خروجی قبلی اضافه نمیکند.
زبان پیامها
در خروجیهای تازه، خطاهای شناختهشدهٔ ورود و کد تأیید از ترجمههای اپ خوانده میشوند. در تنظیمات زبان، متنهای تازهٔ حساب کاربری را برای زبانهای اپ تکمیل کنید؛ بهروزرسانی نمونهٔ زبان در پنل، ترجمههای ذخیرهشدهٔ اپ شما را بازنویسی نمیکند. پیام اعتبارسنجی فیلدهای سفارشی ممکن است متن اختصاصی سرور باشد.