aspose.finance

Cet article fournit des informations sur les rapports commerciaux utilisant la norme XBRL, l’objectif de XBRL et comment automatiser le processus de création de rapports commerciaux basés sur XBRL dans les applications .NET. En outre, il contient des méthodes étape par étape pour analyser les fichiers XBRL et iXBRL et récupérer les données par programmation à l’aide de C#. Dernier point mais non le moindre, il fournit des moyens simples de valider les fichiers XBRL et iXBRL à l’aide de C#.

Langage de rapport commercial extensible (XBRL)

XBRL est une norme et un format de fichier XML utilisés dans le monde entier pour les rapports d’activité. Il permet à diverses entreprises et organisations comptables d’organiser, de compiler et de communiquer efficacement et avec précision des états financiers ou d’autres informations/données liées aux finances. Étant donné que XBRL est basé sur XML (Extensible Markup Language), il utilise des balises pour conserver et analyser chaque élément de données financières. iXBRL (XBRL en ligne) est une autre variante qui permet de conserver les données financières sous une forme lisible par l’homme et lisible par la machine en même temps. Contrairement à XBRL, iXBRL utilise la norme HTML avec quelques balises supplémentaires pour les chiffres et les déclarations.

Les balises dans les deux, XBRL et iXBRL, sont analysées à l’aide d’un logiciel compatible XBRL pour récupérer les données. Afin d’automatiser l’analyse XBRL, Aspose propose l’API Aspose.Finance for .NET. Il s’agit d’une bibliothèque de classes .NET qui facilite encore la création d’instances XBRL par programmation à l’aide de C# ou VB.NET. De plus, il vous permet d’analyser et de valider les fichiers XBRL ou iXBRL dans les applications .NET. Aspose.Finance for .NET fournit les fonctionnalités de manipulation XBRL/iXBRL suivantes que vous apprendrez dans cet article.

Vous pouvez installer Aspose.Finance for .NET à partir de NuGet ou télécharger sa DLL pour la référencer manuellement dans votre projet.

Créer une instance XBRL à partir de rien en C#

Aspose.Finance for .NET simplifie la création d’instances XBRL à partir de zéro. Vous pouvez également ajouter la référence de schéma, le contexte, les unités, les éléments, les liens de note de bas de page, les références de rôle et les références de rôle d’arc dans l’instance XBRL nouvellement créée. Voici les étapes pour créer une instance XBRL :

L’exemple de code suivant montre comment créer une instance XBRL en C#.

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

Une fois que vous avez créé l’instance de XBRL, vous pouvez y insérer des objets qui sont abordés dans les articles suivants :

Analyser des fichiers XBRL ou iXBRL en C#

Aspose.Finance for .NET fournit un moyen simple d’analyser les fichiers XBRL et de récupérer leur contenu en quelques lignes de code. Les sections suivantes contiennent les étapes et les exemples de code d’analyse des fichiers XBRL et iXBRL.

Analyser les fichiers XBRL en C#

Voici les étapes pour analyser un fichier XBRL à l’aide d’Aspose.Finance for .NET.

  • Créez une instance de la classe XbrlDocument et initialisez-la avec le chemin d’un fichier XBRL.
  • Obtenez les instances du XBRL dans un objet XbrlInstanceCollection à l’aide de la propriété XbrlDocument.XbrlInstances.
  • Accédez à l’instance XBRL souhaitée à partir de la collection à l’aide de la classe XbrlInstance.
  • Analysez le contenu de l’instance XBRL.

L’exemple de code suivant montre comment analyser un fichier XBRL en 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;

Analyser les fichiers iXBRL en C#

L’analyse d’un fichier iXBRL est relativement plus facile et peut être effectuée en suivant les étapes suivantes.

  • Créez un objet de la classe InlineXbrlDocument et initialisez-le avec le chemin du fichier iXBRL.
  • Accédez au contenu du fichier à l’aide de l’objet InlineXbrlDocument, c’est-à-dire InlineXbrlDocument.Facts etc.

L’exemple de code suivant montre comment analyser et lire un fichier iXBRL en C#.

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

Valider les fichiers XBRL ou iXBRL en C#

Les fichiers XBRL et iXBRL doivent respecter les règles de validation de la spécification XBRL et de la spécification iXBRL respectivement. Le non-respect des règles de spécification peut invalider les fichiers. Aspose.Finance for .NET vous permet également de valider les fichiers XBRL ou iXBRL afin de découvrir les erreurs. Les sections suivantes montrent comment valider les fichiers XBRL et iXBRL.

Valider les fichiers XBRL en C#

Voici les étapes pour valider un fichier XBRL :

L’exemple de code suivant montre comment valider un fichier XBRL en 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;
}

Valider les fichiers iXBRL en C#

Les étapes ci-dessous sont utilisées pour valider un fichier Inline XBRL.

L’exemple de code suivant montre comment valider un fichier iXBRL en C#.

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

En savoir plus sur les codes d’erreur de validation et les messages d’erreur à partir de ici.

Explorer l’API

Vous pouvez en savoir plus sur la création, l’analyse et la validation des fichiers XBRL et iXBRL à partir de la ressource suivante :

Essayez Aspose.Finance for .NET gratuitement

Aspose propose une licence temporaire pour évaluer gratuitement ses API. Vous pouvez également poster votre demande et obtenir une licence temporaire.

Voir également