Den här artikeln ger information om affärsrapportering med XBRL-standarden, syftet med XBRL och hur man automatiserar processen för att skapa XBRL-baserade affärsrapporter i .NET-applikationer. Dessutom innehåller den steg-för-steg-metoder för att analysera XBRL- och iXBRL-filer och hämta data programmatiskt med C#. Sist men inte minst ger det några enkla sätt att validera XBRL- och iXBRL-filer med C#.
eXtensible Business Reporting Language (XBRL)
XBRL är en globalt använd XML-baserad standard och filformat för affärsrapportering. Det gör det lättare för olika företag och redovisningsorganisationer att effektivt och korrekt organisera, sammanställa och kommunicera bokslut eller annan finansrelaterad information/data. Eftersom XBRL är baserat på XML (Extensible Markup Language), använder den taggar för att behålla och analysera varje del av finansiell data. iXBRL(inline XBRL) är en annan variant som gör det möjligt att hålla finansiell data i en människoläsbar och maskinläsbar form på samma gång. Till skillnad från XBRL använder iXBRL HTML-standarden tillsammans med några extra taggar för figurer och påståenden.
Taggarna i båda, XBRL och iXBRL, analyseras med XBRL-kompatibel programvara för att hämta data. För att automatisera XBRL-analys erbjuder Aspose Aspose.Finance for .NET API. Det är ett .NET-klassbibliotek som gör det ännu enklare att skapa XBRL-instanser programmatiskt med C# eller VB.NET. Dessutom låter den dig analysera och validera XBRL- eller iXBRL-filerna i .NET-applikationerna. Aspose.Finance för .NET tillhandahåller följande XBRL/iXBRL-manipulationsfunktioner som du kommer att lära dig i den här artikeln.
Du kan installera Aspose.Finance för .NET från NuGet eller ladda ner dess DLL för att manuellt referera till det i ditt projekt.
Skapa XBRL-instans från början i C#
Aspose.Finance för .NET gör det enkelt att skapa XBRL-instanser från grunden. Du kan också lägga till schemareferens, sammanhang, enheter, objekt, fotnotslänkar, rollreferenser och bågrollreferenser i den nyskapade XBRL-instansen. Följande är stegen för att skapa en XBRL-instans:
- Skapa en instans av klassen XbrlDocument.
- Få åtkomst till instansernas samling från XbrlDocument-objekt till XbrlInstanceCollection-objekt.
- Lägg till en ny XBRL-instans med metoden XbrlInstanceCollection.Add().
- Spara XBRL-filen med metoden XbrlDocument.Save(string).
Följande kodexempel visar hur man skapar en XBRL-instans i C#.
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");
När du har skapat instansen av XBRL kan du infoga objekt till den som diskuteras i följande artiklar:
- Ange schemareferens i XBRL
- Lägg till sammanhang i XBRL
- Infoga enheter i XBRL
- Lägg till objekt i XBRL
- och mer.
Analysera XBRL- eller iXBRL-filer i C#
Aspose.Finance för .NET ger ett enkelt sätt att analysera XBRL-filer och hämta deras innehåll inom några rader kod. Följande avsnitt innehåller stegen och kodexemplen för hur man tolkar XBRL- och iXBRL-filer.
Analysera XBRL-filer i C#
Följande är stegen för att analysera en XBRL-fil med Aspose.Finance för .NET.
- Skapa en instans av klassen XbrlDocument och initiera den med sökvägen till en XBRL-fil.
- Hämta instanserna i XBRL till ett XbrlInstanceCollection-objekt med hjälp av egenskapen XbrlDocument.XbrlInstances.
- Få åtkomst till önskad XBRL-instans från samlingen med klassen XbrlInstance.
- Analysera innehållet i XBRL-instansen.
Följande kodexempel visar hur man analyserar en XBRL-fil i 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;
Analysera iXBRL-filer i C#
Att analysera en iXBRL-fil är jämförelsevis enklare och kan göras med följande steg.
- Skapa ett objekt av klassen InlineXbrlDocument och initiera det med iXBRL-filens sökväg.
- Gå till filens innehåll med hjälp av InlineXbrlDocument-objektet, dvs InlineXbrlDocument.Facts osv.
Följande kodexempel visar hur man analyserar och läser en iXBRL-fil i C#.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;
Validera XBRL- eller iXBRL-filer i C#
XBRL- och iXBRL-filerna måste följa valideringsreglerna i XBRL-specifikationen respektive iXBRL-specifikationen. Att inte följa specifikationsreglerna kan göra filerna ogiltiga. Aspose.Finance för .NET låter dig också validera XBRL- eller iXBRL-filer för att ta reda på felen. Följande avsnitt visar hur man validerar XBRL- och iXBRL-filer.
Validera XBRL-filer i C#
Följande är stegen för att validera en XBRL-fil:
- Skapa en instans av klassen XbrlDocument.
- Gå till instansen som ska valideras från XbrlInstanceCollection.
- Validera XBRL-instans med metoden XbrlInstance.Validate().
Följande kodexempel visar hur man validerar en XBRL-fil i 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;
}
Validera iXBRL-filer i C#
Stegen nedan används för att validera en Inline XBRL-fil.
- Skapa en instans av klassen InlineXbrlDocument och initiera den med iXBRL-filens sökväg.
- Anropa metoden InlineXbrlDocument.Validate().
Följande kodexempel visar hur man validerar en iXBRL-fil i C#.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = document.ValidationErrors;
}
Läs mer om valideringsfelkoderna och felmeddelandena från här.
Utforska API:et
Du kan lära dig mer om hur du skapar, analyserar och validerar XBRL- och iXBRL-filer från följande resurs:
Prova Aspose.Finance för .NET gratis
Aspose erbjuder en tillfällig licens för att utvärdera sina API:er utan kostnad. Du kan också lägga upp din begäran och skaffa en tillfällig licens.