نام (NAME)

gammu-smsbackup - قالب فایل پشتیبان پیامک gammu(1).

قالب پشتیبان پیامک (SMS)، یک فایل متنی با کدگذاری جاری بستری (پلتفرمی) است که Gammu روی آن اجرا می‌شود.

این فایل از نحو فایل‌های ini استفاده می‌کند، قالب فایل INI <#ini> را ببینید.

بخش‌ها (SECTIONS)

این فایل از بخش‌هایی تشکیل شده است که نام آن‌ها با SMSBackup آغاز می‌شود. هنگام ایجاد فایل پشتیبان، سه رقم برای تعیین ترتیب به این متن الحاق می‌شود. در زمان خواندن فایل پشتیبان، هر بخشی پس از متن SMSBackup نادیده گرفته می‌شود و هر آنچه با این متن آغاز شود پردازش خواهد شد. بنابراین می‌توانید نام بخش را حتی SMSBackupFoo بگذارید و پردازش خواهد شد.

تعداد پیام‌ها در فایل پشتیبان در حال حاضر با GSM_BACKUP_MAX_SMS <#c.GSM_BACKUP_MAX_SMS> محدود شده است (۱۰۰۰۰۰ پیام در زمان نگارش این سند).

بخش SMSBackup (SMSBackup section)

هر بخش یک پیامک فیزیکی را تفسیر می‌کند (برای نمونه، یک بخش از پیام در صورت وجود پیام‌های چندبخشی).

متن رمزگشایی‌شده (Decoded text)

برای پشتیبان‌های پیامک ایجادشده توسط Gammu، متن رمزگشایی‌شده‌ای به‌صورت کامنت درست پس از نام بخش وجود دارد:

[SMSBackup001]
; This is message text

اگر متن بیش از حد طولانی باشد یا پیام اصلی شامل خطوط جدید (سطر جدید) بوده باشد، متن می‌تواند به چندین خط تقسیم شود.

نکته (Note):

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

متغیرها (Variables)

متغیرهای زیر را می‌توان برای هر پیامک تعریف کرد:

SMSC: نمایش متنی شمارهٔ SMSC؛ در صورتی که SMSCUnicode وجود داشته باشد توسط Gammu استفاده نمی‌شود.
SMSCUnicode: رشتهٔ کدگذاری‌شده با هگزادسیمال در فرمت UCS-2 حاوی شمارهٔ SMSC.
Class: کلاس پیام.
Sent: برچسب زمانی (Timestamp) ارسال پیام.
PDU: نوع پیام، یکی از موارد زیر:

Deliver - پیام دریافتی
Submit - پیام جهت ارسال
Status_Report - پیام ارسالی به همراه گزارش تحویل

DateTime: برچسب زمانی پیام (ارسالی یا دریافتی).
RejectDuplicates: مشخص می‌کند که آیا گیرنده باید پیام‌های تکراری را رد کند یا خیر.
ReplaceMessage: شناسهٔ (ID) پیامی که باید جایگزین شود.
MessageReference: شماره مرجع پیام که توسط شبکه تولید شده است.
State: وضعیت پیام:

Read (خوانده‌شده)
UnRead (خوانده‌نشده)
Sent (ارسال‌شده)
UnSent (ارسال‌نشده)

Number: شمارهٔ گیرنده.
Name: نام پیام.
Length: طول متن پیام.
Coding: کدگذاری پیام:

8bit - پیام باینری
Default - کدگذاری GSM، تا ۱۶۰ نویسه در پیام
Unicode - کدگذاری یونیکد، تا ۷۰ نویسه در پیام

Text00 ... TextNN: بخش‌های شماره‌گذاری‌شدهٔ بار دادهٔ (payload) پیام.
Folder: شناسهٔ پوشه‌ای که پیام در آن ذخیره شده است.
UDH: هدر تعریف‌شده توسط کاربر (User defined header) برای پیام.

مثال (EXAMPLE)

پشتیبان یک پیام می‌تواند به شکل زیر باشد:

[SMSBackup000]
#ABCDEFGHIJKLMNOPQRSTUVWXYZ
#
SMSC = "+4540590000"
SMSCUnicode = 002B0034003500340030003500390030003000300030
Sent = 20021201T025023
State = UnRead
Number = "+4522706947"
NumberUnicode = 002B0034003500320032003700300036003900340037
Name = ""
NameUnicode =
Text00 = 004100420043004400450046004700480049004A004B004C004D004E004F0050005100520053005400550056005700580059005A000A
Coding = Default
Folder = 1
Length = 27
Class = -1
ReplySMSC = False
RejectDuplicates = True
ReplaceMessage = 0
MessageReference = 0

نویسنده (AUTHOR)

Michal Čihař <michal@cihar.com>

حق نشر (COPYRIGHT)

2009-2015, Michal Čihař <michal@cihar.com>