RDL - فایل زبان تعریف گزارش
فایل RDL چیست؟
RDL (زبان تعریف گزارش) معیاری است که توسط مایکروسافت برای تعریف گزارش ها تنظیم شده است. یک فایل RDL از یک یا چند عنصر RDL تشکیل شده است. در حالی که یک عنصر RDL از نوع داده و اصلی بودن آن تشکیل شده است. یک عنصر می تواند ساده یا پیچیده باشد. عنصر ساده هیچ عنصر یا ویژگی فرزند ندارد، در حالی که یک عنصر پیچیده دارای ویژگی های فرزند و اختیاری است.
تعریف طرحواره RDL XML
یک فایل XML Schema Definition (XSD) فایل RDL را تایید می کند. این طرح قوانینی را برای جایی که عناصر RDL می توانند در یک فایل rdl. یک عنصر RDL می تواند ساده یا پیچیده باشد. یک عنصر ساده دارای عناصر یا ویژگی های فرزند نیست و یک عنصر پیچیده دارای فرزند و به صورت اختیاری، ویژگی ها است.
ایجاد RDL
از آنجایی که RDL ماهیت باز و قابل توسعه دارد، بسیاری از برنامه ها و ابزارها را می توان ساخت که فایل های RDL را بر اساس طرح XML آن تولید می کنند. یکی از ساده‌ترین راه‌ها برای ایجاد RDL از یک برنامه، استفاده از کلاس‌های Microsoft .NET Framework فضای نام System.Xml و فضای نام System.Linq است. به ویژه، کلاس XmlTextWriter را می توان برای نوشتن RDL استفاده کرد. شما می توانید با استفاده از XmlTextWriter یک تعریف گزارش کامل را از ابتدا تا انتها در هر برنامه .NET Framework ایجاد کنید. توسعه دهندگان همچنین می توانند موارد گزارش سفارشی با ویژگی های سفارشی را برای گسترش RDL اضافه کنند.
انواع RDL
جدول زیر انواع و ویژگی های مورد استفاده در عناصر RDL را فهرست می کند.
| نوع | توضیحات |
|---|---|
| دودویی | یک ویژگی با مقدار باینری کدگذاری شده پایه 64. |
| بولی | یک ویژگی با true یا false به عنوان مقدار شی. مگر اینکه طور دیگری مشخص شده باشد، مقدار یک شی بولی اختیاری حذف شده False است. |
| Date | A property with a fully specified date or datetime value specified in ISO8601 date format: YYYY-MM-DD[THH:MM[:SS[.S]]]. |
| Enum | یک ویژگی با مقدار متن رشته ای که باید یکی از لیست مقادیر تعیین شده باشد. |
| Float | یک ویژگی با مقدار شناور. نقطه (.) به عنوان جداکننده اعشاری اختیاری استفاده می شود. |
| عدد صحیح | یک ویژگی با مقدار صحیح (int32). |
| زبان | یک ویژگی با مقدار متنی که حاوی کد زبان و فرهنگ است، مانند en-us برای انگلیسی ایالات متحده. مقدار باید یک زبان خاص یا یک زبان خنثی باشد که یک زبان پیش‌فرض برای آن در Microsoft .NET Framework تعریف شده است. |
| Name | یک ویژگی با مقدار متن رشته ای. نام ها باید در فضای نام مورد منحصر به فرد باشند. اگر مشخص نشده باشد، فضای نام برای یک آیتم، درونی ترین شی حاوی نام است. |
| NormalizedString | یک ویژگی با مقدار متن رشته ای که نرمال شده است. |
| Size | یک عنصر اندازه باید دارای یک عدد باشد (با یک کاراکتر نقطه که به عنوان جداکننده اعشاری اختیاری استفاده می شود). این عدد باید با یک نشانگر برای یک واحد طول CSS مانند cm، mm، in، pt یا pc دنبال شود. فاصله بین عدد و نشانگر اختیاری است. برای اطلاعات بیشتر در مورد تعیین‌کننده‌های اندازه، به مرجع مقادیر و واحدهای CSS مراجعه کنید. در RDL، حداکثر مقدار برای اندازه 160 اینچ است. حداقل اندازه 0 اینچ است. |
| رشته | یک ویژگی با مقدار متن رشته. |
| UnsignedInt | یک ویژگی با مقدار صحیح بدون علامت (uint32). |
| Variant | یک ویژگی با هر نوع XML ساده. |
انواع داده های RDL
در RDL، DataType Enumeration نوع داده یک ویژگی، عبارت یا پارامتر را تعریف می کند. جدول زیر نشان می دهد که چگونه انواع داده های CLR با انواع داده های RDL مطابقت دارند.
| نوع(های) CLR | نوع داده مربوطه |
|---|---|
| بولی | بولی |
| DateTime, DateTimeOffset | DateTime |
| Int16, Int32, UInt16, Byte, SByte | عدد صحیح |
| تک، دو | شناور |
| String، Char، GUID، Timespan | String |