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.
- Utwórz instancję XBRL od podstaw
- Analizuj pliki XBRL lub iXBRL
- Sprawdź poprawność plików XBRL lub iXBRL
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:
- Utwórz instancję klasy XbrlDocument.
- Uzyskaj dostęp do kolekcji instancji z obiektu XbrlDocument do obiektu XbrlInstanceCollection.
- Dodaj nową instancję XBRL za pomocą metody XbrlInstanceCollection.Add().
- Zapisz plik XBRL metodą XbrlDocument.Save(string).
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:
- Określ odwołanie do schematu w XBRL
- Dodaj konteksty w XBRL
- Wstaw jednostki w XBRL
- Dodaj elementy w XBRL
- i więcej.
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.
- Utwórz instancję klasy XbrlDocument i zainicjuj ją ścieżką pliku XBRL.
- Pobierz instancje w XBRL do obiektu XbrlInstanceCollection za pomocą właściwości XbrlDocument.XbrlInstances.
- Uzyskaj dostęp do żądanej instancji XBRL z kolekcji przy użyciu klasy XbrlInstance.
- Przeanalizuj zawartość instancji XBRL.
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.
- Utwórz obiekt klasy InlineXbrlDocument i zainicjuj go ścieżką pliku iXBRL.
- Uzyskaj dostęp do zawartości pliku za pomocą obiektu InlineXbrlDocument, tj. InlineXbrlDocument.Facts itp.
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:
- Utwórz instancję klasy XbrlDocument.
- Uzyskaj dostęp do instancji, która ma zostać zweryfikowana, z XbrlInstanceCollection.
- Sprawdź poprawność instancji XBRL za pomocą metody XbrlInstance.Validate().
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.
- Utwórz instancję klasy InlineXbrlDocument i zainicjuj ją ścieżką pliku iXBRL.
- Wywołaj metodę InlineXbrlDocument.Validate().
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ę.