این مقاله اطلاعاتی درباره گزارشدهی کسبوکار با استفاده از استاندارد XBRL، هدف XBRL و نحوه خودکارسازی فرآیند ایجاد گزارشهای تجاری مبتنی بر XBRL در برنامههای NET ارائه میدهد. علاوه بر این، شامل روش های گام به گام برای تجزیه فایل های XBRL و iXBRL و بازیابی داده ها به صورت برنامه نویسی با استفاده از C# است. آخرین اما نه کماهمیت، چند راه ساده برای اعتبارسنجی فایلهای XBRL و iXBRL با استفاده از سی شارپ ارائه میکند.
زبان گزارش دهی تجاری توسعه پذیر (XBRL)
XBRL یک استاندارد و فرمت فایل مبتنی بر XML است که در سطح جهانی برای گزارشدهی تجاری استفاده میشود. سازماندهی، گردآوری، و ارتباط صورت های مالی یا سایر اطلاعات/داده های مرتبط با امور مالی را برای شرکت ها و سازمان های حسابداری مختلف آسان تر می کند. از آنجایی که XBRL بر پایه XML (زبان نشانه گذاری توسعه پذیر) است، از برچسب ها برای نگهداری و تجزیه هر قطعه از داده های مالی استفاده می کند. iXBRL (داخلی XBRL) نوع دیگری است که امکان نگهداری همزمان دادههای مالی را به شکل قابل خواندن توسط انسان و ماشین قابل خواندن فراهم میکند. بر خلاف XBRL، iXBRL از استاندارد HTML به همراه برخی تگ های اضافی برای شکل ها و عبارات استفاده می کند.
برچسبها در هر دو، XBRL و iXBRL، با استفاده از نرمافزار سازگار با XBRL برای بازیابی دادهها تجزیه میشوند. به منظور خودکارسازی تجزیه XBRL، Aspose Aspose.Finance for .NET API را ارائه می دهد. این یک کتابخانه کلاس دات نت است که ساختن نمونه های XBRL را به صورت برنامه نویسی با استفاده از C# یا VB.NET آسان تر می کند. علاوه بر این، به شما امکان میدهد فایلهای XBRL یا iXBRL را در برنامههای NET تجزیه و اعتبارسنجی کنید. Aspose.Finance for .NET ویژگی های دستکاری XBRL/iXBRL زیر را ارائه می دهد که در این مقاله خواهید آموخت.
- نمونه XBRL را از ابتدا ایجاد کنید
- فایل های XBRL یا iXBRL را تجزیه کنید
- فایل های XBRL یا iXBRL را اعتبارسنجی کنید
می توانید Aspose.Finance را برای دات نت از NuGet نصب کنید یا DLL آن را دانلود به صورت دستی در پروژه خود ارجاع دهید.
ایجاد نمونه XBRL از ابتدا در سی شارپ
Aspose.Finance برای دات نت ایجاد نمونه های XBRL را از ابتدا ساده می کند. همچنین میتوانید مرجع طرح، زمینه، واحدها، آیتمها، پیوندهای پانوشت، ارجاعات نقش و ارجاعات نقش قوس را در نمونه جدید XBRL اضافه کنید. مراحل زیر برای ایجاد یک نمونه XBRL هستند:
- یک نمونه از کلاس XbrlDocument ایجاد کنید.
- به مجموعه نمونه ها از شی XbrlDocument به شی XbrlInstanceCollection دسترسی پیدا کنید.
- با استفاده از روش XbrlInstanceCollection.Add() یک نمونه XBRL جدید اضافه کنید.
- فایل XBRL را با استفاده از روش XbrlDocument.Save(string) ذخیره کنید.
نمونه کد زیر نحوه ایجاد یک نمونه XBRL در سی شارپ را نشان می دهد.
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");
هنگامی که نمونه XBRL را ایجاد کردید، می توانید اشیایی را در آن وارد کنید که در مقاله های زیر مورد بحث قرار گرفته اند:
- مرجع طرحواره را در XBRL مشخص کنید
- زمینه ها را در XBRL اضافه کنید
- درج واحدها در XBRL
- موارد را در XBRL اضافه کنید
- و بیشتر.
تجزیه فایل های XBRL یا iXBRL در سی شارپ
Aspose.Finance for .NET راهی آسان برای تجزیه فایل های XBRL و بازیابی محتوای آنها در چند خط کد ارائه می دهد. بخشهای زیر شامل مراحل و نمونههای کد نحوه تجزیه فایلهای XBRL و iXBRL است.
تجزیه فایل های XBRL در سی شارپ
مراحل زیر برای تجزیه یک فایل XBRL با استفاده از Aspose.Finance برای دات نت آمده است.
- یک نمونه از کلاس XbrlDocument ایجاد کنید و آن را با مسیر یک فایل XBRL مقداردهی اولیه کنید.
- نمونههای موجود در XBRL را با استفاده از ویژگی XbrlDocument.XbrlInstances در یک شی XbrlInstanceCollection دریافت کنید.
- با استفاده از کلاس XbrlInstance به نمونه XBRL مورد نظر از مجموعه دسترسی پیدا کنید.
- محتوای نمونه XBRL را تجزیه کنید.
نمونه کد زیر نحوه تجزیه یک فایل XBRL در سی شارپ را نشان می دهد.
XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
List<Fact> facts = xbrlInstance.Facts;
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
List<Context> contexts = xbrlInstance.Contexts;
List<Unit> units = xbrlInstance.Units;
تجزیه فایل های iXBRL در سی شارپ
تجزیه یک فایل iXBRL نسبتا ساده تر است و می توان با استفاده از مراحل زیر انجام داد.
- یک شی از کلاس InlineXbrlDocument ایجاد کنید و آن را با مسیر فایل iXBRL مقداردهی اولیه کنید.
- با استفاده از شی InlineXbrlDocument، یعنی InlineXbrlDocument.Facts و غیره به محتوای فایل دسترسی پیدا کنید.
نمونه کد زیر نحوه تجزیه و خواندن یک فایل iXBRL در سی شارپ را نشان می دهد.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;
اعتبار سنجی فایل های XBRL یا iXBRL در سی شارپ
فایلهای XBRL و iXBRL باید به ترتیب با قوانین اعتبارسنجی در مشخصات XBRL و مشخصات iXBRL مطابقت داشته باشند. رعایت نکردن قوانین مشخصات ممکن است فایل ها را باطل کند. Aspose.Finance for .NET همچنین به شما امکان می دهد فایل های XBRL یا iXBRL را اعتبارسنجی کنید تا به خطاها پی ببرید. بخشهای زیر نحوه اعتبارسنجی فایلهای XBRL و iXBRL را نشان میدهند.
اعتبار سنجی فایل های XBRL در سی شارپ
مراحل زیر برای تایید یک فایل XBRL هستند:
- یک نمونه از کلاس XbrlDocument ایجاد کنید.
- به نمونه ای که باید از XbrlInstanceCollection تأیید شود، دسترسی پیدا کنید.
- با استفاده از روش XbrlInstance.Validate() نمونه XBRL را اعتبارسنجی کنید.
نمونه کد زیر نحوه تأیید اعتبار یک فایل XBRL در سی شارپ را نشان می دهد.
XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
xbrlInstance.Validate();
if(xbrlInstance.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = xbrlInstance.ValidationErrors;
}
اعتبار سنجی فایل های iXBRL در سی شارپ
مراحل زیر برای اعتبارسنجی یک فایل XBRL Inline استفاده می شود.
- یک نمونه از کلاس InlineXbrlDocument ایجاد کنید و آن را با مسیر فایل iXBRL مقداردهی اولیه کنید.
- روش InlineXbrlDocument.Validate() را فراخوانی کنید.
نمونه کد زیر نحوه تأیید اعتبار یک فایل iXBRL در سی شارپ را نشان می دهد.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = document.ValidationErrors;
}
درباره کدهای خطای اعتبارسنجی و پیامهای خطا از اینجا بیشتر بیاموزید.
API را کاوش کنید
میتوانید درباره نحوه ایجاد، تجزیه، و اعتبارسنجی فایلهای XBRL و iXBRL از منبع زیر بیشتر بیاموزید:
Aspose.Finance را برای دات نت به صورت رایگان امتحان کنید
Aspose یک مجوز موقت برای ارزیابی API های خود بدون هزینه ارائه می دهد. همچنین میتوانید درخواست خود را ارسال کنید و مجوز موقت دریافت کنید.