Bu makale, XBRL standardını kullanan iş raporlaması, XBRL’nin amacı ve .NET uygulamalarında XBRL tabanlı iş raporları oluşturma sürecinin nasıl otomatikleştirileceği hakkında bilgi sağlar. Ayrıca, XBRL ve iXBRL dosyalarını ayrıştırmak ve C# kullanarak programlı olarak veri almak için adım adım yöntemler içerir. Son olarak, C# kullanarak XBRL ve iXBRL dosyalarını doğrulamak için bazı basit yollar sağlar.
Genişletilebilir İş Raporlama Dili (XBRL)
XBRL, iş raporlaması için dünya çapında kullanılan XML tabanlı bir standart ve dosya biçimidir. Çeşitli şirketlerin ve muhasebe kuruluşlarının mali tabloları veya finansla ilgili diğer bilgileri/verileri verimli ve doğru bir şekilde düzenlemesini, derlemesini ve iletmesini kolaylaştırır. XBRL, XML’e (Genişletilebilir İşaretleme Dili) dayalı olduğundan, her finansal veri parçasını tutmak ve ayrıştırmak için etiketler kullanır. iXBRL (satır içi XBRL), finansal verileri aynı anda insan tarafından okunabilir ve makine tarafından okunabilir bir biçimde tutmayı mümkün kılan başka bir varyanttır. XBRL’nin aksine iXBRL, şekiller ve ifadeler için bazı ekstra etiketlerle birlikte HTML standardını kullanır.
Hem XBRL hem de iXBRL’deki etiketler, verileri almak için XBRL uyumlu yazılım kullanılarak ayrıştırılır. XBRL ayrıştırmasını otomatikleştirmek için Aspose, Aspose.Finance for .NET API’sini sunar. C# veya VB.NET kullanarak programlı olarak XBRL örnekleri oluşturmayı daha da kolaylaştıran bir .NET sınıf kitaplığıdır. Ayrıca, .NET uygulamaları içinde XBRL veya iXBRL dosyalarını ayrıştırmanıza ve doğrulamanıza olanak tanır. Aspose.Finance for .NET, bu makalede öğreneceğiniz aşağıdaki XBRL/iXBRL manipülasyon özelliklerini sağlar.
- Sıfırdan XBRL örneği oluşturun
- XBRL veya iXBRL dosyalarını ayrıştırın
- XBRL veya iXBRL dosyalarını doğrulayın
Aspose.Finance for .NET’i projenizde manuel olarak referans almak için NuGet veya indirme DLL’sinden yükleyebilirsiniz.
C# ile Sıfırdan XBRL Örneği Oluşturma
Aspose.Finance for .NET, sıfırdan XBRL örnekleri oluşturmayı kolaylaştırır. Yeni oluşturulan XBRL örneğine şema referansını, bağlamı, birimleri, öğeleri, dipnot bağlantılarını, rol referanslarını ve ark rolü referanslarını da ekleyebilirsiniz. Aşağıdakiler bir XBRL örneği oluşturma adımlarıdır:
- XbrlDocument sınıfının bir örneğini oluşturun.
- Örnek koleksiyonuna XbrlDocument nesnesinden XbrlInstanceCollection nesnesine erişin.
- XbrlInstanceCollection.Add() yöntemini kullanarak yeni bir XBRL örneği ekleyin.
- XBRL dosyasını XbrlDocument.Save(string) yöntemini kullanarak kaydedin.
Aşağıdaki kod örneği, C# dilinde bir XBRL örneğinin nasıl oluşturulacağını gösterir.
XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");
XBRL örneğini oluşturduktan sonra, ona aşağıdaki makalelerde açıklanan nesneleri ekleyebilirsiniz:
- XBRL’de şema referansını belirtin
- XBRL’de bağlamlar ekleyin
- XBRL’de birimleri ekle
- XBRL’de öğe ekleme
- ve daha fazla.
XBRL veya iXBRL Dosyalarını C# ile Ayrıştırın
Aspose.Finance for .NET, XBRL dosyalarını ayrıştırmanın ve içeriklerini birkaç satır kodla almanın kolay bir yolunu sunar. Aşağıdaki bölümler, XBRL ve iXBRL dosyalarının nasıl ayrıştırılacağına ilişkin adımları ve kod örneklerini içerir.
XBRL Dosyalarını C# ile Ayrıştırma
Aspose.Finance for .NET kullanarak bir XBRL dosyasını ayrıştırmak için izlenecek adımlar aşağıdadır.
- XbrlDocument sınıfının bir örneğini oluşturun ve onu bir XBRL dosyasının yolu ile başlatın.
- XbrlDocument.XbrlInstances özelliğini kullanarak XBRL’deki örnekleri bir XbrlInstanceCollection nesnesine alın.
- XbrlInstance sınıfını kullanarak koleksiyondan istenen XBRL örneğine erişin.
- XBRL örneğinin içeriğini ayrıştırın.
Aşağıdaki kod örneği, C# dilinde bir XBRL dosyasının nasıl ayrıştırılacağını gösterir.
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 Dosyalarını C# ile Ayrıştırın
Bir iXBRL dosyasını ayrıştırmak nispeten daha kolaydır ve aşağıdaki adımlar kullanılarak yapılabilir.
- InlineXbrlDocument sınıfından bir nesne oluşturun ve onu iXBRL dosyasının yolu ile başlatın.
- InlineXbrlDocument nesnesini, yani InlineXbrlDocument.Facts vb. kullanarak dosyanın içeriğine erişin.
Aşağıdaki kod örneği, C# dilinde bir iXBRL dosyasının nasıl ayrıştırılacağını ve okunacağını gösterir.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;
XBRL veya iXBRL Dosyalarını C# ile Doğrulayın
XBRL ve iXBRL dosyaları, sırasıyla XBRL spesifikasyonu ve iXBRL spesifikasyonu’ndaki doğrulama kurallarına uygun olmalıdır. Spesifikasyon kurallarına uymamak dosyaları geçersiz kılabilir. Aspose.Finance for .NET ayrıca hataları bulmanız için XBRL veya iXBRL dosyalarını doğrulamanıza olanak tanır. Aşağıdaki bölümlerde, XBRL ve iXBRL dosyalarının nasıl doğrulanacağı gösterilmektedir.
XBRL Dosyalarını C# ile Doğrulayın
Aşağıdakiler, bir XBRL dosyasını doğrulama adımlarıdır:
- XbrlDocument sınıfının bir örneğini oluşturun.
- Doğrulanacak örneğe XbrlInstanceCollection‘den erişin.
- XbrlInstance.Validate() yöntemini kullanarak XBRL örneğini doğrulayın.
Aşağıdaki kod örneği, C# dilinde bir XBRL dosyasının nasıl doğrulanacağını gösterir.
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 Dosyalarını C# ile Doğrulayın
Aşağıdaki adımlar, bir Satır İçi XBRL dosyasını doğrulamak için kullanılır.
- InlineXbrlDocument sınıfının bir örneğini oluşturun ve onu iXBRL dosyasının yolu ile başlatın.
- InlineXbrlDocument.Validate() yöntemini çağırın.
Aşağıdaki kod örneği, C# dilinde bir iXBRL dosyasının nasıl doğrulanacağını gösterir.
InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
List<ValidationError> validationErrors = document.ValidationErrors;
}
Doğrulama hata kodları ve hata mesajları hakkında buradan daha fazla bilgi edinin.
API’yi keşfedin
Aşağıdaki kaynaktan XBRL ve iXBRL dosyalarının nasıl oluşturulacağı, ayrıştırılacağı ve doğrulanacağı hakkında daha fazla bilgi edinebilirsiniz:
Aspose.Finance for .NET’i Ücretsiz Deneyin
Aspose, API’lerini ücretsiz olarak değerlendirmek için geçici bir lisans sunar. Ayrıca isteğinizi gönderebilir ve geçici bir lisans alabilirsiniz.