Skip to content

Commit c9a3e2c

Browse files
nikola-yankovnikola-yankov
committed
finance convert options and project management convert options documents
1 parent f38d482 commit c9a3e2c

2 files changed

Lines changed: 260 additions & 0 deletions

File tree

‎net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-finance-with-advanced-options.md‎

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
---
2+
id: convert-to-finance-with-advanced-options
3+
url: conversion/net/convert-to-finance-with-advanced-options
4+
title: Convert to Finance formats with advanced options
5+
weight: 18
6+
description: "Learn about FinanceConvertOptions class for financial data formats (XBRL, iXBRL, OFX) in GroupDocs.Conversion for .NET."
7+
keywords: Convert to XBRL, Convert to iXBRL, Convert to OFX, Financial reporting conversion, XBRL conversion
8+
productName: GroupDocs.Conversion for .NET
9+
hideChildren: False
10+
toc: True
11+
---
12+
13+
GroupDocs.Conversion provides the [FinanceConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/financeconvertoptions) class to specify financial data format conversion settings. This class implements [IPagedConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions) for page selection support.
14+
15+
## Supported Finance Formats
16+
17+
The following financial data formats are recognized:
18+
19+
| Format | Extension | Description | Use Case |
20+
|--------|-----------|-------------|----------|
21+
| **XBRL** | .xbrl | eXtensible Business Reporting Language | Financial reporting, regulatory compliance |
22+
| **iXBRL** | .ixbrl | Inline XBRL (HTML + XBRL) | Human-readable and machine-readable financial reports |
23+
| **OFX** | .ofx | Open Financial Exchange | Banking data, financial transactions |
24+
25+
## Properties
26+
27+
**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired financial file format. Available options are: *Xbrl, IXbrl, Ofx*.
28+
29+
**[PageNumber](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagenumber)** - Specifies the starting page number for conversion.
30+
31+
**[PagesCount](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/ipagedconvertoptions/pagescount)** - Specifies the number of pages to convert.
32+
33+
## API Structure
34+
35+
The following example shows the API structure for FinanceConvertOptions:
36+
37+
```csharp
38+
using GroupDocs.Conversion.Options.Convert;
39+
using GroupDocs.Conversion.FileTypes;
40+
41+
// Create options object
42+
FinanceConvertOptions options = new FinanceConvertOptions
43+
{
44+
Format = FinanceFileType.Xbrl,
45+
PageNumber = 1, // Starting page (for multi-page sources)
46+
PagesCount = 10 // Number of pages to process
47+
};
48+
```
49+
50+
## Converting Between Finance Formats
51+
52+
You can convert between XBRL and iXBRL formats. This allows you to transform between human-readable inline XBRL and standard XBRL format.
53+
54+
### Convert XBRL to iXBRL
55+
56+
```csharp
57+
using GroupDocs.Conversion;
58+
using GroupDocs.Conversion.Options.Convert;
59+
using GroupDocs.Conversion.FileTypes;
60+
61+
// Load the source XBRL file
62+
using (Converter converter = new Converter("financial-report.xbrl"))
63+
{
64+
// Configure iXBRL convert options
65+
FinanceConvertOptions options = new FinanceConvertOptions
66+
{
67+
Format = FinanceFileType.IXbrl
68+
};
69+
70+
// Convert and save
71+
converter.Convert("financial-report.ixbrl", options);
72+
}
73+
```
74+
75+
### Convert iXBRL to XBRL
76+
77+
```csharp
78+
using GroupDocs.Conversion;
79+
using GroupDocs.Conversion.Options.Convert;
80+
using GroupDocs.Conversion.FileTypes;
81+
82+
// Load the source iXBRL file
83+
using (Converter converter = new Converter("inline-report.ixbrl"))
84+
{
85+
// Configure XBRL convert options
86+
FinanceConvertOptions options = new FinanceConvertOptions
87+
{
88+
Format = FinanceFileType.Xbrl
89+
};
90+
91+
// Convert and save
92+
converter.Convert("inline-report.xbrl", options);
93+
}
94+
```
95+
96+
## Format Selection
97+
98+
You can specify different financial formats using the Format property:
99+
100+
### XBRL Format
101+
102+
XBRL (eXtensible Business Reporting Language) is the international standard for digital business reporting:
103+
104+
```csharp
105+
using GroupDocs.Conversion.Options.Convert;
106+
using GroupDocs.Conversion.FileTypes;
107+
108+
FinanceConvertOptions xbrlOptions = new FinanceConvertOptions
109+
{
110+
Format = FinanceFileType.Xbrl
111+
};
112+
```
113+
114+
### iXBRL Format
115+
116+
iXBRL (Inline XBRL) combines human-readable HTML with machine-readable XBRL data:
117+
118+
```csharp
119+
FinanceConvertOptions ixbrlOptions = new FinanceConvertOptions
120+
{
121+
Format = FinanceFileType.IXbrl
122+
};
123+
```
124+
125+
### OFX Format
126+
127+
OFX (Open Financial Exchange) is used for financial data exchange between institutions and applications:
128+
129+
```csharp
130+
FinanceConvertOptions ofxOptions = new FinanceConvertOptions
131+
{
132+
Format = FinanceFileType.Ofx
133+
};
134+
```
135+
136+
## Format Support Notes
137+
138+
**Supported conversions:**
139+
- XBRL ↔ iXBRL (bidirectional conversion between standard and inline XBRL)
140+
141+
**Not supported:**
142+
- Conversion from standard document formats (PDF, Word, Excel) to financial formats
143+
- Conversion from financial formats to other formats (PDF, images, etc.)
144+
- OFX conversions to/from XBRL or iXBRL
145+
146+
Financial formats like XBRL require highly specific data structures, taxonomies, and metadata that are not present in general documents.
147+
148+
## More Resources
149+
150+
- [API Reference: FinanceConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/financeconvertoptions)
151+
- [API Reference: FinanceFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/financefiletype)
152+
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
153+
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})

‎net/developer-guide/advanced-usage/converting/conversion-options-by-document-family/convert-to-project-management-with-advanced-options.md‎

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
---
2+
id: convert-to-project-management-with-advanced-options
3+
url: conversion/net/convert-to-project-management-with-advanced-options
4+
title: Convert to Project Management formats with advanced options
5+
weight: 17
6+
description: "Learn how to convert documents to Microsoft Project and Primavera formats (MPP, MPT, MPX, XER) using GroupDocs.Conversion for .NET."
7+
keywords: Convert to Project, Convert to MPP, Convert to MPX, Microsoft Project conversion, Primavera conversion
8+
productName: GroupDocs.Conversion for .NET
9+
hideChildren: False
10+
toc: True
11+
---
12+
13+
GroupDocs.Conversion provides the [ProjectManagementConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/projectmanagementconvertoptions) class to control conversion to project management file formats.
14+
15+
## Supported Project Management Formats
16+
17+
The following project management formats are supported:
18+
19+
| Format | Extension | Description | Application |
20+
|--------|-----------|-------------|-------------|
21+
| **MPP** | .mpp | Microsoft Project binary format | Microsoft Project |
22+
| **MPT** | .mpt | Microsoft Project template | Microsoft Project |
23+
| **MPX** | .mpx | Microsoft Project Exchange (ASCII format) | Microsoft Project & Primavera |
24+
| **XER** | .xer | Primavera P6 format | Primavera P6 |
25+
26+
## Properties
27+
28+
**[Format](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/convertoptions-1/format/)** - Specifies the desired project management file format. Available options are: *Mpp, Mpt, Mpx, Xer*.
29+
30+
## Converting FROM Project Management Formats
31+
32+
You can convert project management files to other formats like PDF. This is useful for sharing project schedules with stakeholders.
33+
34+
### Convert MPX to PDF
35+
36+
```csharp
37+
using GroupDocs.Conversion;
38+
using GroupDocs.Conversion.Options.Convert;
39+
40+
// Load the source MPX file
41+
using (Converter converter = new Converter("project-schedule.mpx"))
42+
{
43+
// Set PDF convert options
44+
PdfConvertOptions options = new PdfConvertOptions();
45+
46+
// Convert and save
47+
converter.Convert("project-schedule.pdf", options);
48+
}
49+
```
50+
51+
### Convert MPP to PDF
52+
53+
```csharp
54+
using GroupDocs.Conversion;
55+
using GroupDocs.Conversion.Options.Convert;
56+
57+
// Load the source MPP file
58+
using (Converter converter = new Converter("construction-plan.mpp"))
59+
{
60+
// Set PDF convert options
61+
PdfConvertOptions options = new PdfConvertOptions();
62+
63+
// Convert and save
64+
converter.Convert("construction-plan.pdf", options);
65+
}
66+
```
67+
68+
### Convert XER (Primavera) to PDF
69+
70+
```csharp
71+
using GroupDocs.Conversion;
72+
using GroupDocs.Conversion.Options.Convert;
73+
74+
// Load the source Primavera XER file
75+
using (Converter converter = new Converter("engineering-project.xer"))
76+
{
77+
// Set PDF convert options
78+
PdfConvertOptions options = new PdfConvertOptions();
79+
80+
// Convert and save
81+
converter.Convert("engineering-project.pdf", options);
82+
}
83+
```
84+
85+
## ProjectManagementConvertOptions Usage
86+
87+
The ProjectManagementConvertOptions class is used to specify the target project management format when converting TO project formats.
88+
89+
```csharp
90+
using GroupDocs.Conversion.Options.Convert;
91+
using GroupDocs.Conversion.FileTypes;
92+
93+
// Specify target format for project management conversion
94+
ProjectManagementConvertOptions options = new ProjectManagementConvertOptions
95+
{
96+
Format = ProjectManagementFileType.Mpx
97+
};
98+
```
99+
100+
**Note:** Conversion from standard document formats (PDF, Word, Excel) to project management formats is not supported. Project management formats require specific data structures for tasks, resources, dependencies, and timelines that are not present in general documents.
101+
102+
## More Resources
103+
104+
- [API Reference: ProjectManagementConvertOptions](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.options.convert/projectmanagementconvertoptions)
105+
- [API Reference: ProjectManagementFileType](https://reference.groupdocs.com/conversion/net/groupdocs.conversion.filetypes/projectmanagementfiletype)
106+
- [Supported File Formats]({{< ref "conversion/net/getting-started/supported-document-formats.md" >}})
107+
- [Common Conversion Options]({{< ref "conversion/net/developer-guide/advanced-usage/converting/common-conversion-options/_index.md" >}})

0 commit comments

Comments
 (0)