aspose.finance

У цій статті наведено інформацію про бізнес-звіти за допомогою стандарту XBRL, призначення XBRL і те, як автоматизувати процес створення бізнес-звітів на основі XBRL у програмах .NET. Крім того, він містить покрокові методи аналізу файлів XBRL та iXBRL і програмного отримання даних за допомогою C#. І останнє, але не менш важливе: він надає кілька простих способів перевірки файлів XBRL та iXBRL за допомогою C#.

eXtensible Business Reporting Language (XBRL)

XBRL — це всесвітньо використовуваний стандарт і формат файлів для бізнес-звітів на основі XML. Це полегшує різним компаніям і бухгалтерським організаціям ефективну та точну організацію, компіляцію та передачу фінансових звітів або іншої інформації/даних, пов’язаних з фінансами. Оскільки XBRL базується на XML (розширювана мова розмітки), він використовує теги для зберігання та аналізу кожної частини фінансових даних. iXBRL(вбудований XBRL) — ще один варіант, який дає змогу зберігати фінансові дані у формі, зрозумілій людині та машині одночасно. На відміну від XBRL, iXBRL використовує стандарт HTML разом із деякими додатковими тегами для цифр і тверджень.

Теги в обох, XBRL та iXBRL, аналізуються за допомогою XBRL-сумісного програмного забезпечення для отримання даних. Для автоматизації синтаксичного аналізу XBRL Aspose пропонує API Aspose.Finance for .NET. Це бібліотека класів .NET, яка спрощує програмне створення екземплярів XBRL за допомогою C# або VB.NET. Крім того, він дозволяє аналізувати та перевіряти файли XBRL або iXBRL у програмах .NET. Aspose.Finance for .NET надає наступні функції маніпулювання XBRL/iXBRL, про які ви дізнаєтеся в цій статті.

Ви можете встановити Aspose.Finance for .NET із NuGet або завантажити його DLL, щоб вручну посилатися на нього у своєму проекті.

Створення екземпляра XBRL з нуля в C#

Aspose.Finance for .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 for .NET забезпечує простий спосіб аналізу файлів XBRL і отримання їхнього вмісту за допомогою кількох рядків коду. У наступних розділах містяться кроки та зразки коду для аналізу файлів XBRL та iXBRL.

Розбір файлів XBRL у C#

Нижче наведено кроки для аналізу файлу XBRL за допомогою Aspose.Finance for .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 for .NET також дозволяє перевірити файли XBRL або iXBRL, щоб виявити помилки. У наступних розділах показано, як перевірити файли XBRL та iXBRL.

Перевірте файли XBRL у C#

Нижче наведено кроки для перевірки файлу XBRL:

  • Створіть екземпляр класу XbrlDocument.
  • Отримайте доступ до примірника, який потрібно перевірити, із XbrlInstanceCollection.
  • Перевірте екземпляр XBRL за допомогою методу XbrlInstance.Validate().

У наведеному нижче прикладі коду показано, як перевірити файл 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 for .NET безкоштовно

Aspose пропонує тимчасову ліцензію на безкоштовну оцінку своїх API. Ви також можете опублікувати свій запит і отримати тимчасову ліцензію.

Дивись також