امضای الکترونیک

افزونه امضای شامل چندین عملکرد است که امکان مدیریت و استفاده از قابلیت‌های امضا را فراهم می‌کند. این عملکردها به شرح زیر هستند:

1. signmanager/initialize

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

فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/initialize(\"1234567890\",\"09123456789\",\"1370/01/01\",\"12345\",\"نام\",\"نام‌خانوادگی\",\"FirstName\",\"LastName\",\"email@example.com\")");

فراخوانی در XML:

<Button onclick="signmanager/initialize('1234567890','09123456789','1370/01/01','12345','نام','نام‌خانوادگی','FirstName','LastName','email@example.com')" />

2. signmanager/isIdentityProvided

این عملکرد بررسی می‌کند که آیا اطلاعات هویتی توسط کاربر فراهم شده است یا خیر. نتیجه این بررسی به صورت یک مقدار بولین برگردانده می‌شود. فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/isIdentityProvided()");

فراخوانی در XML:

<Button onclick="signmanager/isIdentityProvided()" />

3. signmanager/getRegistrationObject

این عملکرد شیء ثبت نامی را که توسط SignManager مدیریت می‌شود، برمی‌گرداند. فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/getRegistrationObject()");

فراخوانی در XML:

<Button onclick="signmanager/getRegistrationObject()" />

4. signmanager/jsonStamp

این عملکرد یک رشته ی base64 شده را دریافت کرده و نسخه مهر شده‌ی آن را به صورت json برمی‌گرداند. فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/jsonStamp('{\"key\":\"value\"}')");

فراخوانی در XML:

<Button onclick="signmanager/jsonStamp('{\"key\":\"value\"}')" />

5. signmanager/setRegistrationObjectResponse

این عملکرد برای تنظیم پاسخ شیء ثبت نامی در SignManager استفاده می‌شود. فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/setRegistrationObjectResponse('{\"registrationObject\":\"value\"}')");

فراخوانی در XML:

<Button onclick="signmanager/setRegistrationObjectResponse('{\"registrationObject\":\"value\"}')" />

6. signmanager/getIdentityKeySpec

این عملکرد کلید مشخصات هویتی را که توسط SignManager مدیریت می‌شود، برمی‌گرداند. فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/getIdentityKeySpec()");

فراخوانی در XML:

<Button onclick="signmanager/getIdentityKeySpec()" />

7. signmanager/docDeCipher

این عملکرد یک سند را دریافت کرده و آن را رمزگشایی می‌کند و نتیجه به صورت رشته‌ای که شامل دو مقدار است، برگردانده می‌شود. فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/docDeCipher('encryptedDocument')");

فراخوانی در XML:

<Button onclick="signmanager/docDeCipher('encryptedDocument')" />

8. signmanager/docToCipher

این عملکرد یک سند را دریافت کرده و آن را رمزنگاری می‌کند و نسخه رمزنگاری شده را به صورت یک رشته برمی‌گرداند. فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("signmanager/docToCipher('documentToEncrypt')");

فراخوانی در XML:

<Button onclick="signmanager/docToCipher('documentToEncrypt')" />

---

این نمونه‌ها نشان می‌دهند که چگونه می‌توانید هر یک از عملکردهای افزونه "امضا" را با استفاده از دو روش Appsan.runAction() و فراخوانی مستقیم در XML فراخوانی کنید.

نمونه کد تست

<page title="نمایش نتایج روی نتشه" scrollable="false">
    <button text=\"init\" onclick=\"signmanager/initialize('1111111111', '09123456789', '1370/01/01',
	    '0x123456789', ' اسم', 'فامیل ', 'First','last', 'example@gmail.com')"/>
    <button text="isIdent" onclick="signmanager/isIdentityProvided->script/s:res($data)"/>
	<script id=\"s\">function res(data) {console.log(data)}"</script>
</page>