شروع کنید

آموزش ساخت فایل تنظیمات ابزارها

چرا فایل تنظیمات ؟

از موارد مهمی که پیش بینی شده است، امکان داشتن تنظیمات خاص برای هر ابزار می باشد که توسط یک فایل html امکان ارایه آن می باشد.

شما می توانید با تکمیل یک فایل html مانند نمونه های آخر این مقاله، تنظیمات خاص را بر روی ابزار خود انجام دهید.

آیا فایل تنظیمات اجباری است ؟

خیر. این امکان صرفا برای ارائه راهکاری جامع و کامل برای توانمند سازی ابزار شما در بازارهای فروش است.

شروع کنید

در ابتدا باید بدانید ما فایل شما را در نرم افزار موبایل همراه با چند query string لود می نماییم. این query string ها حاوی اطلاعات کلیدی آن پروژه و ابزار می باشد تا شما بتوانید به واسطه jquery اقدام به فراخوانی از Api هایی که برای بالابردن بهره وری شما ارایه داده ایم استفاده نمایید.

پارامتر های query string (اگر نمی دانید query sting چیست در گوگل جستوجو نمایید) :

صفحات تنظیمات شما به صورت زیر در اپلیکیشن های موبایل لود می شود.

نحوه فراخوانی فایل html شما

https://example.com/htmlPage.html?projectId=xxxxxx&deviceSerial=xxxxxx&token=$xxxxxx&operationName=xxxxxx&operationId=xxxxx

projectId : این مشخصه پروژه جاری می باشد که ابزار در آن نصب می باشد.

token : این مشخصه در واقع یک توکن موقت می باشد که برای دسترسی شما به Api های مختلف طراحی شده است.

deviceSerial : این مشخصه سریال دستگاه شما می باشد تا هنگام publish کردن اطلاعات بتوانید تشخیص دهید این تنظیمات برای کدام ابزار است.

operationName : این مشخصه همان نام دستور شما برای یک ابزار می باشد که در پنل خود تعریف کرده اید.

operationId : این مشخصه آیدی همان نام دستور شما برای یک ابزار می باشد که در پنل خود تعریف کرده اید.

نمونه کد دریافت query string توسط JQUERY :

نمونه کد دریافت query string توسط JQUERY

$(document).ready(function() {
    // get url
    const urlParams = new URLSearchParams(window.location.search);

    // get all query string
    const projectId = urlParams.get('projectId');
    const token = urlParams.get('token');
    const deviceSerial = urlParams.get('deviceSerial');
    const operationName = urlParams.get('operationName');
    const operationId = urlParams.get('operationId');
})