Dieser Artikel enthält Informationen zur Geschäftsberichterstellung unter Verwendung des XBRL-Standards, zum Zweck von XBRL und zur Automatisierung des Prozesses zum Erstellen von XBRL-basierten Geschäftsberichten in .NET Anwendungen. Darüber hinaus enthält es Schritt-für-Schritt methoden zum Analysieren von XBRL und iXBRL Dateien und zum programmgesteuerten Abrufen von Daten mit C#. Last but not least bietet es einige einfache Möglichkeiten, XBRL und iXBRL Dateien mit C# zu validieren.
eXtensible Business Reporting Language (XBRL)
XBRL ist ein weltweit verwendeter XML-basierter Standard und ein Dateiformat für Geschäftsberichte. Es erleichtert verschiedenen Unternehmen und Buchhaltungsorganisationen die effiziente und genaue Organisation, Zusammenstellung und Übermittlung von Jahresabschlüssen oder anderen finanzbezogenen Informationen/Daten. Da XBRL auf XML (Extensible Markup Language) basiert, verwendet es Tags, um alle Finanzdaten zu speichern und zu analysieren. iXBRL (Inline XBRL) ist eine weitere Variante, die es ermöglicht, Finanzdaten gleichzeitig in menschenlesbarer und maschinenlesbarer Form zu halten. Im Gegensatz zu XBRL verwendet iXBRL den HTML-Standard zusammen mit einigen zusätzlichen Tags für Abbildungen und Aussagen.
Die Tags in XBRL und iXBRL werden mit XBRL-kompatibler Software geparst, um die Daten abzurufen. Um das XBRL-Parsing zu automatisieren, bietet Aspose die API Aspose.Finance for .NET. Es handelt sich um eine .NET Klassenbibliothek, die es noch einfacher macht, XBRL-Instanzen programmgesteuert mit C# oder VB.NET zu erstellen. Darüber hinaus können Sie die XBRL oder iXBRL Dateien innerhalb der .NET Anwendungen analysieren und validieren. Aspose.Finance for .NET bietet die folgenden XBRL/iXBRL-Manipulationsfunktionen, die Sie in diesem Artikel kennenlernen werden.
- Erstellen Sie eine XBRL-Instanz von Grund auf neu
- Analysieren Sie XBRL oder iXBRL Dateien
- Validieren Sie XBRL oder iXBRL Dateien
Sie können Aspose.Finance for .NET von NuGet installieren oder dessen DLL herunterladen, um sie in Ihrem Projekt manuell zu referenzieren.
XBRL-Instanz von Grund auf neu in C# erstellen
Aspose.Finance for .NET macht es einfach, XBRL-Instanzen von Grund auf neu zu erstellen. Sie können der neu erstellten XBRL-Instanz auch die Schemareferenz, den Kontext, Einheiten, Elemente, Fußnotenlinks, Rollenreferenzen und Arc-Rollenreferenzen hinzufügen. Im Folgenden sind die Schritte zum Erstellen einer XBRL-Instanz aufgeführt:
- Erstellen Sie eine Instanz der Klasse XbrlDocument.
- Greifen Sie auf die Sammlung der Instanzen vom XbrlDocument objekt in das XbrlInstanceCollection objekt zu.
- Fügen Sie eine neue XBRL-Instanz mit der methode XbrlInstanceCollection.Add() hinzu.
- Speichern Sie die XBRL Datei mit der methode XbrlDocument.Save(string).
Das folgende Codebeispiel zeigt, wie Sie eine XBRL-Instanz in C# erstellen.
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");
Nachdem Sie die Instanz von XBRL erstellt haben, können Sie Objekte einfügen, die in den folgenden Artikeln beschrieben werden:
- Schemareferenz in XBRL angeben
- Fügen Sie Kontexte in XBRL hinzu
- Einheiten in XBRL einfügen
- Elemente in XBRL hinzufügen
- und mehr.
Analysieren Sie XBRL oder iXBRL Dateien in C#
Aspose.Finance for .NET bietet eine einfache Möglichkeit, XBRL Dateien zu parsen und ihren Inhalt innerhalb weniger Codezeilen abzurufen. Die folgenden Abschnitte enthalten die Schritte und Codebeispiele zum Analysieren von XBRL und iXBRL Dateien.
Analysieren Sie XBRL Dateien in C#
Im Folgenden sind die Schritte zum Analysieren einer XBRL Datei mit Aspose.Finance for .NET aufgeführt.
- Erstellen Sie eine Instanz der Klasse XbrlDocument und initialisieren Sie sie mit dem Pfad einer XBRL Datei.
- Rufen Sie die Instanzen im XBRL mithilfe der Eigenschaft XbrlDocument.XbrlInstances in ein XbrlInstanceCollection objekt ab.
- Greifen Sie mithilfe der Klasse XbrlInstance aus der Sammlung auf die gewünschte XBRL-Instanz zu.
- Analysieren Sie den Inhalt der XBRL-Instanz.
Das folgende Codebeispiel zeigt, wie eine XBRL Datei in C# analysiert wird.
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;
Analysieren Sie iXBRL Dateien in C#
Das Parsen einer iXBRL Datei ist vergleichsweise einfacher und kann mit den folgenden Schritten durchgeführt werden.
- Erstellen Sie ein Objekt der Klasse InlineXbrlDocument und initialisieren Sie es mit dem Pfad der iXBRL Datei.
- Greifen Sie mit dem InlineXbrlDocument objekt auf den Inhalt der Datei zu, also InlineXbrlDocument.Facts usw.
Das folgende Codebeispiel zeigt, wie eine iXBRL Datei in C# analysiert und gelesen wird.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;
Validieren Sie XBRL oder iXBRL Dateien in C#
Die XBRL und iXBRL Dateien müssen den Validierungsregeln in der XBRL-Spezifikation bzw. der iXBRL-Spezifikation entsprechen. Die Missachtung der Spezifikationsregeln kann die Dateien ungültig machen. Mit Aspose.Finance for .NET können Sie auch XBRL oder iXBRL Dateien validieren, um die Fehler herauszufinden. Die folgenden Abschnitte zeigen, wie XBRL und iXBRL Dateien validiert werden.
XBRL Dateien in C# validieren
Im Folgenden sind die Schritte zum Validieren einer XBRL Datei aufgeführt:
- Erstellen Sie eine Instanz der Klasse XbrlDocument.
- Greifen Sie über die XbrlInstanceCollection auf die zu validierende Instanz zu.
- Validieren Sie die XBRL-Instanz mit der methode XbrlInstance.Validate().
Das folgende Codebeispiel zeigt, wie eine XBRL Datei in C# validiert wird.
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 Dateien in C# validieren
Die folgenden Schritte werden verwendet, um eine Inline-XBRL Datei zu validieren.
- Erstellen Sie eine Instanz der Klasse InlineXbrlDocument und initialisieren Sie sie mit dem Pfad der iXBRL Datei.
- Rufen Sie die Methode InlineXbrlDocument.Validate() auf.
Das folgende Codebeispiel zeigt, wie eine iXBRL Datei in C# validiert wird.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = document.ValidationErrors;
}
Weitere Informationen zu Validierungsfehlercodes und Fehlermeldungen finden Sie hier.
Erkunden Sie die API
Weitere Informationen zum Erstellen, Analysieren und Validieren von XBRL und iXBRL Dateien finden Sie in der folgenden Ressource:
Probieren Sie Aspose.Finance for .NET kostenlos aus
Aspose bietet eine temporäre Lizenz zur kostenlosen Evaluierung seiner APIs an. Sie können Ihre Anfrage auch posten und eine temporäre Lizenz erhalten.