Postavit stůl z DataTable

Často vaše aplikace vytáhne data z databáze a uloží je ve formě DataTable. Možná budete chtít tato data snadno vložit do dokumentu jako novou tabulku a rychle použít formátování do celé tabulky.

Všimněte si, že preferovaný způsob vložení dat z DataTable do tabulky dokumentů pomocí Mail Merge s regiony. Technika uvedená v tomto článku je navržena pouze tehdy, pokud nejste schopni vytvořit vhodnou šablonu předem pro sloučení dat s, jinými slovy, pokud požadujete, aby se vše stalo programově.

Použití Aspose.Words, můžete snadno získat data z databáze a uložit je jako tabulku:

1. Vytvořit nový DocumentBuilder objekt na vašem Document.
2. Spustit novou tabulku pomocí DocumentBuilder.
3. Pokud chceme vložit jména každého z našich sloupců DataTable jako řádek záhlaví pak projede každý datový sloupec a zapíše jména sloupce do řádku v tabulce.
4. Iterovat každý DataRow v DataTable:
   1. Iterace prostřednictvím každého objektu v DataRow.
   2. Vložit objekt do dokumentu pomocí DocumentBuilder. Použitá metoda závisí na typu vloženého objektu např. DocumentBuilder.writeln() pro text a DocumentBuilder.insertImage() pro pole byte, které představuje obrázek.
   3. Na konci zpracování datového řádku také končí řádek vytvořený DocumentBuilder použitím DocumentBuilder.endRow().
5. Jednou všechny řádky z DataTable byly zpracovány dokončit tabulku voláním DocumentBuilder.endTable().
6. Konečně můžeme nastavit požadovaný styl tabulky pomocí jedné z odpovídajících vlastností tabulky, jako je Table.getStyleIdentifier() automaticky aplikovat formátování do celé tabulky. Následující údaje v našem DataTable se používá v tomto příkladu:

Následující příklad kódu ukazuje, jak provést výše uvedený algoritmus v Aspose.Words:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
/// <summary>
/// Imports the content from the specified DataTable into a new Aspose.Words Table object.
/// The table is inserted at the document builder's current position and using the current builder's formatting if any is defined.
/// </summary>
public Table importTableFromDataTable(DocumentBuilder builder, DataTable dataTable,
    boolean importColumnHeadings)
{
    Table table = builder.startTable();

    // Check if the columns' names from the data source are to be included in a header row.
    if (importColumnHeadings)
    {
        // Store the original values of these properties before changing them.
        boolean boldValue = builder.getFont().getBold();
        int paragraphAlignmentValue = builder.getParagraphFormat().getAlignment();

        // Format the heading row with the appropriate properties.
        builder.getFont().setBold(true);
        builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);

        // Create a new row and insert the name of each column into the first row of the table.
        for (DataColumn column : dataTable.getColumns())
        {
            builder.insertCell();
            builder.writeln(column.getColumnName());
        }

        builder.endRow();

        // Restore the original formatting.
        builder.getFont().setBold(boldValue);
        builder.getParagraphFormat().setAlignment(paragraphAlignmentValue);
    }

    for (DataRow dataRow : (Iterable<DataRow>) dataTable.getRows())
    {
        for (Object item : dataRow.getItemArray())
        {
            // Insert a new cell for each object.
            builder.insertCell();

            switch (item.getClass().getName())
            {
                case "DateTime":
                    // Define a custom format for dates and times.
                    Date dateTime = (Date) item;
                    SimpleDateFormat simpleDateFormat = new SimpleDateFormat("MMMM d, yyyy");
                    builder.write(simpleDateFormat.format(dateTime));
                    break;
                default:
                    // By default any other item will be inserted as text.
                    builder.write(item.toString());
                    break;
            }
        }

        // After we insert all the data from the current record, we can end the table row.
        builder.endRow();
    }

    // We have finished inserting all the data from the DataTable, we can end the table.
    builder.endTable();

    return table;
}

Metoda pak lze snadno volat pomocí vašeho DocumentBuilder a data.

Následující příklad kódu ukazuje, jak importovat data z DataTable a vložit ji do nové tabulky do dokumentu:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
// We can position where we want the table to be inserted and specify any extra formatting to the table.
DocumentBuilder builder = new DocumentBuilder(doc);

// We want to rotate the page landscape as we expect a wide table.
doc.getFirstSection().getPageSetup().setOrientation(Orientation.LANDSCAPE);

DataSet ds = new DataSet();
ds.readXml(getMyDir() + "List of people.xml");
// Retrieve the data from our data source, which is stored as a DataTable.
DataTable dataTable = ds.getTables().get(0);

// Build a table in the document from the data contained in the DataTable.
Table table = importTableFromDataTable(builder, dataTable, true);

// We can apply a table style as a very quick way to apply formatting to the entire table.
table.setStyleIdentifier(StyleIdentifier.MEDIUM_LIST_2_ACCENT_1);
table.setStyleOptions(TableStyleOptions.FIRST_ROW | TableStyleOptions.ROW_BANDS | TableStyleOptions.LAST_COLUMN);

// For our table, we want to remove the heading for the image column.
table.getFirstRow().getLastCell().removeAllChildren();

doc.save(getArtifactsDir() + "WorkingWithTables.BuildTableFromDataTable.docx");

Tabulka uvedená na obrázku níže se vyrábí s použitím výše uvedeného kódu.