aspose.finanse

Ten artykuł zawiera informacje na temat raportowania biznesowego przy użyciu standardu XBRL, celu XBRL oraz sposobu automatyzacji procesu tworzenia raportów biznesowych opartych na XBRL w aplikacjach .NET. Ponadto zawiera metody krok po kroku do analizowania plików XBRL i iXBRL oraz programowego pobierania danych przy użyciu języka C#. Wreszcie, zapewnia kilka prostych sposobów sprawdzania poprawności plików XBRL i iXBRL przy użyciu języka C#.

eXtensible Business Reporting Language (XBRL)

XBRL to używany na całym świecie standard i format plików oparty na XML do raportowania biznesowego. Ułatwia różnym firmom i organizacjom księgowym wydajne i dokładne organizowanie, kompilowanie i przekazywanie sprawozdań finansowych lub innych informacji/danych związanych z finansami. Ponieważ XBRL jest oparty na XML (Extensible Markup Language), używa tagów do przechowywania i analizowania każdego fragmentu danych finansowych. iXBRL (inline XBRL) to kolejny wariant, który umożliwia jednoczesne przechowywanie danych finansowych w formie czytelnej dla człowieka i maszyny. W przeciwieństwie do XBRL, iXBRL używa standardu HTML wraz z kilkoma dodatkowymi tagami dla liczb i zestawień.

Tagi zarówno w XBRL, jak i iXBRL są analizowane przy użyciu oprogramowania kompatybilnego z XBRL w celu pobrania danych. Aby zautomatyzować parsowanie XBRL, Aspose oferuje Aspose.Finance for .NET API. Jest to biblioteka klas .NET, która jeszcze bardziej ułatwia programowe tworzenie instancji XBRL przy użyciu C# lub VB.NET. Ponadto pozwala analizować i weryfikować pliki XBRL lub iXBRL w aplikacjach .NET. Aspose.Finance dla platformy .NET zapewnia następujące funkcje manipulacji XBRL/iXBRL, których nauczysz się w tym artykule.

Możesz zainstalować Aspose.Finance for .NET z NuGet lub pobierz jego bibliotekę DLL, aby ręcznie odwoływać się do niego w swoim projekcie.

Utwórz instancję XBRL od podstaw w C#

Aspose.Finance for .NET ułatwia tworzenie instancji XBRL od podstaw. Możesz także dodać odniesienie do schematu, kontekst, jednostki, elementy, łącza do przypisów, odniesienia do ról i odniesienia do ról łukowych w nowo utworzonej instancji XBRL. Poniżej przedstawiono kroki tworzenia instancji XBRL:

Poniższy przykładowy kod pokazuje, jak utworzyć wystąpienie XBRL w języku C#.

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

Po utworzeniu instancji XBRL możesz wstawiać do niej obiekty, które zostały omówione w następujących artykułach:

Analizuj pliki XBRL lub iXBRL w C#

Aspose.Finance for .NET zapewnia łatwy sposób analizowania plików XBRL i pobierania ich zawartości w ciągu kilku linii kodu. Poniższe sekcje zawierają kroki i przykłady kodu analizowania plików XBRL i iXBRL.

Analizuj pliki XBRL w C#

Poniżej przedstawiono kroki, aby przeanalizować plik XBRL przy użyciu Aspose.Finance dla platformy .NET.

Poniższy przykładowy kod demonstruje, jak analizować plik XBRL w języku 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;

Analizuj pliki iXBRL w C#

Analiza pliku iXBRL jest stosunkowo łatwiejsza i można ją wykonać, wykonując następujące czynności.

Poniższy przykładowy kod pokazuje, jak analizować i odczytywać plik iXBRL w języku C#.

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;

Sprawdź poprawność plików XBRL lub iXBRL w C#

Pliki XBRL i iXBRL muszą być zgodne z zasadami walidacji zawartymi odpowiednio w specyfikacji XBRL i specyfikacji iXBRL. Nieprzestrzeganie zasad specyfikacji może spowodować unieważnienie plików. Aspose.Finance for .NET umożliwia również sprawdzanie poprawności plików XBRL lub iXBRL w celu znalezienia błędów. W poniższych sekcjach pokazano, jak sprawdzać poprawność plików XBRL i iXBRL.

Sprawdź poprawność plików XBRL w C#

Poniżej przedstawiono kroki sprawdzania poprawności pliku XBRL:

Poniższy przykładowy kod pokazuje, jak sprawdzić poprawność pliku XBRL w języku 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;
}

Sprawdź poprawność plików iXBRL w C#

Poniższe kroki służą do sprawdzania poprawności pliku Inline XBRL.

Poniższy przykładowy kod pokazuje, jak sprawdzić poprawność pliku iXBRL w języku C#.

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
    List<ValidationError> validationErrors = document.ValidationErrors;
}

Dowiedz się więcej o kodach błędów sprawdzania poprawności i komunikatach o błędach z tutaj.

Zapoznaj się z interfejsem API

Więcej informacji na temat tworzenia, analizowania i sprawdzania poprawności plików XBRL i iXBRL można znaleźć w następującym zasobie:

Wypróbuj Aspose.Finance for .NET za darmo

Aspose oferuje tymczasową licencję na bezpłatną ocenę swoich interfejsów API. Możesz również opublikować swoją prośbę i uzyskać tymczasową licencję.

Zobacz też