آموزش نوشتن فایل آنالیز برای ابزار با کنترل SMS

لطفاً قبل از این آموزش، حتماً آموزش‌های آنالیزر چیست و آموزش نوشتن فایل آنالیز را مطالعه کنید.

سر شماره پیامکی 90003497 است. تمام پیامک ها از طریق همین سرشماره دریافت و یا ارسال می شود. (فقط ایران)

فایل تبدیل داده های دریافتی شما از ابزار ها برای سرور (ارسال داده از ابزار به سرور)

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

برای ارسال دستورات خود به سرور نیاز است به صورت زیر اقدام نمایید.

CC:Data

CC : حروف بزرگ و ثابت است.

Data : دستورات شما که پس از ارسال به فایل های JS آنالیزر منتقل می شود که پس از پردازش شما به سمت اپلیکیشن موبایل ها ارسال می شود.

نمونه کد

function main(inputJsonString, outputJsonString) {

var inputJson = JSON.parse(inputJsonString);

var myArray = inputJson.split(":")

var outputJson = JSON.parse(outputJsonString);

outputJson.result = 'OK';

outputJson.status.push({key:"CHANNEL_NAME",value:"COMMAND"});

if( outputJson.status.length == 0 && myArray[1]!== undefined ) outputJson.status = myArray[1];

return JSON.stringify(outputJson);

}

نام تابع (main) : نام تابع شما باید حتما main باشد که شامل دو پارامتر ورودی است.

inputJsonString : این مقدار داده ای است که ابزار شما به سرور فرستاده است و مستقیما به عنوان این پارامتر وارد تابع میشود. داده شما حتما باید با CC: شروع شود.

outputJsonString : این json خروجی نتیجه کار شما می باشد که باید آن را پر نمایید.

{"result":"OK","status":[]}

این json را سرور همیشه ارسال می کند که شما باید مطابق با الگوی زیر status را پر نمایید.

{"result":"OK","status":[{"key":"OperationName","value" :"COMMAND"}]}

operationName: این دقیقا نام کانال شما یا operation شما است که می تواند هر چیزی باشد.

COMMAND : دقیقا همان مقدار سیستمی آن ابزار در هنگام تعریف دستورات می باشد که شما برای عملیات روشن و یا خاموش ( یا هر عملیات دیگر ثبت کرده اید)

ویدیو مربوط به آنالیزر ارسال پیامک از ابزار به سرور

کنترل ابزار توسط دستورات سرور (ارسال دستور از سرور به ابزار) :

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

برای مثال: سرور قصد دارد ابزار شما را روشن کند، پس یک پیام حاوی دستور مربوطه به ابزار ارسال می‌شود تا عملیات مورد نظر انجام گیرد.

    function main(inputJsonString) {       
        var inputJson = JSON.parse(inputJsonString);
    
        var outPut = "";
        switch (inputJson.operationName) {
            case "ch1": // operationName تعریفی شما در پنل کاربری 
                if (inputJson.value == "on") { // مقدار سیستمی هر operationName
                    outPut = 'pole1on'; // دستوری که ابزار شما متوجه عملیات مورد انتظار می شود
                } else if (inputJson.value == "off") {
                    outPut = 'pole1off';
                }
                break;
            case "ch2":
                if (inputJson.value == "on") {
                    outPut = 'pole2on';
                } else if (inputJson.value == "off") {
                    outPut = 'pole2off';
                }
                break;
            default:
                outPut = "";
                break;
        }
  
        return JSON.stringify(outPut);
    }

نام تابع (main) : نام تابع شما باید حتما main باشد که شامل دو پارامتر ورودی است.

inputJsonString : این مقدار داده ای است که سرور به فایل شما ارسال میکند و فرمت این مقدار به شکل زیر است :

{"deviceSerial":"DEVICE_SERIAL","operationName":"CHANNEL_NAME","value":"COMMAND"}

DEVICE_SERIAL : سریال ابزار شما می باشد که قرار است دستور را دیافت کند.

CHANNEL_NAME : نام کانال شما برای دریافت دستور می باشد.

COMMAND : مقدار دستور شما می باشد.

ویدیو مربوط به آنالیزر ارسال پیامک از سرور به ابزار