aspose.finance

מאמר זה מספק מידע על דיווח עסקי באמצעות תקן XBRL, מטרת XBRL וכיצד לבצע אוטומציה של תהליך יצירת דוחות עסקיים מבוססי XBRL ביישומי NET. יתר על כן, הוא מכיל שיטות צעד אחר צעד לנתח קבצי XBRL ו-iXBRL ולאחזור נתונים באופן פרוגרמטי באמצעות C#. אחרון חביב, הוא מספק כמה דרכים פשוטות לאימות קבצי XBRL ו-iXBRL באמצעות C#.

eXtensible Business Reporting Language (XBRL)

XBRL הוא תקן ופורמט קובץ מבוסס XML בשימוש גלובלי לדיווח עסקי. זה מקל על חברות וארגונים חשבונאיים שונים לארגן, להרכיב ולתקשר ביעילות ובדייקנות דוחות כספיים או מידע/נתונים אחרים הקשורים לכספים. מכיוון ש-XBRL מבוסס על XML (שפת סימון מתרחבת), הוא משתמש בתגים כדי לשמור ולנתח כל פיסת נתונים פיננסיים. iXBRL(Inline XBRL) היא גרסה נוספת המאפשרת לשמור נתונים פיננסיים בצורה קריא אנושית ומכונה בו זמנית. בניגוד ל-XBRL, iXBRL משתמש בתקן HTML יחד עם כמה תגים נוספים עבור דמויות והצהרות.

התגים בשניהם, XBRL ו-iXBRL, מנותחים באמצעות תוכנה תואמת XBRL כדי לאחזר את הנתונים. על מנת להפוך את ניתוח XBRL לאוטומטי, Aspose מציעה Aspose.Finance for .NET API. זוהי ספריית כיתה NET המקלה עוד יותר על יצירת מופעי XBRL באופן תכנותי באמצעות C# או VB.NET. בנוסף, זה מאפשר לך לנתח ולאמת את קבצי XBRL או iXBRL בתוך יישומי NET. Aspose.Finance for .NET מספק את תכונות המניפולציה הבאות של XBRL/iXBRL שתלמד במאמר זה.

אתה יכול להתקין את Aspose.Finance עבור .NET מ-NuGet או הורד של ה-DLL שלו כדי להתייחס אליו באופן ידני בפרויקט שלך.

צור מופע XBRL מאפס ב-C#

Aspose.Finance עבור .NET מקל על יצירת מופעי XBRL מאפס. אתה יכול גם להוסיף את ההפניה לסכימה, ההקשר, היחידות, הפריטים, קישורי הערות השוליים, הפניות לתפקידים והפניות לתפקידי קשת במופע XBRL החדש שנוצר. להלן השלבים ליצירת מופע XBRL:

דוגמת הקוד הבאה מראה כיצד ליצור מופע XBRL ב-C#.

XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");

לאחר שיצרת את המופע של XBRL, תוכל להכניס אליו אובייקטים הנידונים במאמרים הבאים:

ניתוח קבצי XBRL או iXBRL ב-C#

Aspose.Finance עבור .NET מספק דרך קלה לנתח קבצי XBRL ולאחזר את התוכן שלהם בתוך כמה שורות קוד. הסעיפים הבאים מכילים את השלבים ודוגמאות הקוד של אופן הניתוח של קובצי XBRL ו-iXBRL.

ניתוח קבצי XBRL ב-C#

להלן השלבים לניתוח קובץ XBRL באמצעות Aspose.Finance עבור .NET.

  • צור מופע של המחלקה XbrlDocument ואתחול אותו עם הנתיב של קובץ XBRL.
  • קבל את המופעים ב-XBRL לאובייקט XbrlInstanceCollection באמצעות המאפיין XbrlDocument.XbrlInstances.
  • גש למופע ה-XBRL הרצוי מהאוסף באמצעות המחלקה XbrlInstance.
  • נתח את התוכן של מופע XBRL.

דגימת הקוד הבאה מדגימה כיצד לנתח קובץ XBRL ב-C#.

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 ב-C#

ניתוח קובץ iXBRL קל יחסית וניתן לעשות זאת באמצעות השלבים הבאים.

  • צור אובייקט מהמחלקה InlineXbrlDocument ואתחול אותו עם הנתיב של קובץ iXBRL.
  • גש לתוכן הקובץ באמצעות האובייקט InlineXbrlDocument, כלומר InlineXbrlDocument.Facts וכו'.

דוגמת הקוד הבאה מראה כיצד לנתח ולקרוא קובץ iXBRL ב-C#.

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 ב-C#

קבצי ה-XBRL וה-iXBRL חייבים לעמוד בכללי האימות במפרט XBRL ו-iXBRL מפרט בהתאמה. אי ציות לכללי המפרט עלול לבטל את תוקף הקבצים. Aspose.Finance עבור .NET גם מאפשר לך לאמת קבצי XBRL או iXBRL כדי לגלות את השגיאות. הסעיפים הבאים מדגימים כיצד לאמת קבצי XBRL ו-iXBRL.

אימות קבצי XBRL ב-C#

להלן השלבים לאימות קובץ XBRL:

דוגמת הקוד הבאה מראה כיצד לאמת קובץ XBRL ב-C#.

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 ב-C#

השלבים הבאים משמשים לאימות קובץ XBRL מוטבע.

דוגמת הקוד הבאה מראה כיצד לאמת קובץ iXBRL ב-C#.

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 עבור .NET בחינם

Aspose מציעה רישיון זמני להערכת ממשקי ה-API שלה ללא עלות. אתה יכול גם לפרסם את בקשתך ולקבל רישיון זמני.

ראה גם