У цій статті наведено інформацію про бізнес-звіти за допомогою стандарту 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:
- Створіть екземпляр класу XbrlDocument.
- Доступ до колекції екземплярів з об’єкта XbrlDocument в об’єкт XbrlInstanceCollection.
- Додайте новий екземпляр XBRL за допомогою методу XbrlInstanceCollection.Add().
- Збережіть файл XBRL за допомогою методу XbrlDocument.Save(string).
У наведеному нижче прикладі коду показано, як створити екземпляр XBRL у C#.
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 у 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.
- Створіть екземпляр класу InlineXbrlDocument та ініціалізуйте його шляхом до файлу iXBRL.
- Викличте метод InlineXbrlDocument.Validate().
У наведеному нижче прикладі коду показано, як перевірити файл 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. Ви також можете опублікувати свій запит і отримати тимчасову ліцензію.