FVA-Workbench KnowledgeBase

Beispiel Wert aus einer Excel Zelle lesen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let value = workbook.getValue("B3");
4println(value);

Beispiel Zeile aus Excel-Datei lesen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let array = workbook.getValuesRow("B3", 5);
4println(array);

Beispiel Array als Spalte aus einer Excel-Datei lesen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let array = workbook.getValuesColumn("B3", 5);
4println(array);

Beispiel Matrix aus Excel-Datei lesen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let matrix = workbook.getValuesMatrix("B3", 4, 5);
4println(matrix);

Beispiel Matrix aus Excel-Datei lesen und transponieren

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let matrix = workbook.getValuesMatrixT("B3", 4, 5);
4println(matrix);

Beispiel Formel aus einer Excel Zelle lesen und auf dem Scripting-Monitor ausgeben

let excelfile = "c:/example/excelfile.xlsx";
let workbook = workbookFactory.createWorkbook(excelfile);
let formula = workbook.getFormula("C12");
println(formula);

Beispiel Wert in eine Excel Zelle schreiben

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.setValue("B3", 12.3);
4workbook.writeToFile(excelfile);

Beispiel Formatierten Text in Excel Zellen schreiben

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.setRichText("B3", "{b}This text is displayed in bold");
4workbook.setRichText("B4", "{b}This text is displayed in bold {}This text has no formatting");
5workbook.setRichText("B5", "{bi}This text is displayed in bold and italic");
6workbook.writeToFile(excelfile);

Beispiel Array als Zeile in Excel-Datei herausschreiben

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let array = [1.2, 1.4, 1,7, 1.9];
4workbook.setValuesRow("B3", array);
5workbook.writeToFile(excelfile);

Beispiel Array von Werten als Spalte in Excel herausschreiben

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let array = [1.2, 1.4, 1,7, 1.9];
4workbook.setValuesColumn("B3", array);
5workbook.writeToFile(excelfile);

Beispiel Matrix von Daten in Excel-Datei herausschreiben

1let stageID = getCompByType('cylindrical_mesh')[0];
2let excelfile = "c:/example/excelfile.xlsx";
3let workbook = workbookFactory.createWorkbook(excelfile);
4let matrix = getAttr("local_methods_grid_pressure_z", stageID, RDAT);
5workbook.setValuesMatrix("B3", matrix);
6workbook.writeToFile(excelfile);

Beispiel Transponierte Matrix von Daten in Excel-Datei herausschreiben

1let stageID = getCompByType('cylindrical_mesh')[0];
2let excelfile = "c:/example/excelfile.xlsx";
3let workbook = workbookFactory.createWorkbook(excelfile);
4let matrix = getAttr("local_methods_grid_pressure_z", stageID, RDAT);
5workbook.setValuesMatrixT("B3", matrix);
6workbook.writeToFile(excelfile);

let workbook = workbookFactory.createNewWorkbook();
print(workbook.getSupportedFunctionNames());

workbook.setFormula("A1", "_xlfn.SUM(A2;B2)");

Beispiel Formel in eine Excel Zelle schreiben und Ergebnis auswerten

let excelfile = "c:/example/excelfile.xlsx";
let workbook = workbookFactory.createWorkbook(excelfile);
workbook.setFormula("C12", "SUM(D2;A13)");
workbook.evaluateFormulaCell("C12");
workbook.writeToFile(excelfile);

Beispiel Relative Zellenadresse abfragen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let relativeAdress = workbook.getRelCellAddr("B3", 5, 3);
4println(relativeAdress);

Beispiel

Bevor Änderungen an der Excel-Datei herausgeschrieben werden, prüft das Skript, ob die Datei beschreibbar ist. Wenn nicht, wird in einem Dialog eine Meldung angezeigt, die den Benutzer auffordert, die Datei zu schließen. Wenn die Meldung mit OK quittiert wird und die Datei immer noch nicht beschreibbar ist, wird der Dialog erneut angezeigt. Wenn die Datei dann immer noch nicht beschreibbar ist, wird das Skript abgebrochen und eine Meldung auf dem Scripting-Monitor angezeigt.

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let messageCount = 0;
4while(workbook.isFileWriteable(excelfile) == false){
5    if(messageCount == 2){
6        stopScript("Script could not be executed")
        }
7	alert("Output file is still open. Please close.");
8	messageCount++;
    }
9workbook.writeToFile(excelfile);

Beispiel

let excelfile = "c:/example/excelfile.xlsx";
let workbook = workbookFactory.createWorkbook(excelfile);
workbook.evaluateAllFormulaCells();
workbook.writeToFile(excelfile);

Beispiel

let excelfile = "c:/example/excelfile.xlsx";
let workbook = workbookFactory.createWorkbook(excelfile);
workbook.evaluateFormulaCell("C12");
workbook.writeToFile(excelfile);

Beispiel

Prüfung, ob ein Arbeitsblatt mit dem Namen "results" existiert. Wenn ja, wird es als aktives Arbeitsblatt gesetzt. Wenn nein, wird ein neues Arbeitsblatt mit dem Namen "results" angelegt und als aktives Arbeitsblatt festgelegt.

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let sheetForResults = "results";
4if (workbook.isSheet(sheetForResults)) {    
5    workbook.setCurrentSheet(sheetForResults);
6}else {    
7    workbook.createSheet(sheetForResults, true);
    }
8workbook.writeToFile(excelfile);

Beispiel Arbeitsblatt setzen mit dem bearbeitet werden soll

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.setCurrentSheet("results");

Beispiel Namen des aktuellen Excel-Arbeitsblatts auf dem Scripting Monitor ausgeben

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3let workSheet = workbook.getCurrentSheet();
4println(workSheet);

Beispiel Neues Arbeitsblatt anlegen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.createSheet("Input data", true);
4workbook.writeToFile(excelfile);

Beispiel Arbeitsblatt löschen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.deleteSheet("Load spectrum");
4workbook.writeToFile(excelfile);

Beispiel Arbeitsblatt umbennen

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.renameCurrentSheet("Worksheet 123");
4workbook.writeToFile(excelfile);

Beispiel Namen des aktuellen Excel-Arbeitsblatts auf dem Scripting Monitor ausgeben

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3cloneSheet("Worksheet1", "Worksheet1Copy", true);
4workbook.writeToFile(excelfile);

Tabelle 105. Ändert die Hintergrundfarbe einer Zelle.

setBackgroundColor(CELL, colorindex);
Parameter	Typ	Beschreibung
CELL	string	Adresse der Excel Zelle (z.B. C12)
colorindex	int	Excel bietet standardmäßig 56 Farben an, die in einer Palette zusammengefasst sind. Diese können über den colorindex angesprochen werden. Die Standardpalette unterscheidet sich von einer Excel-Installation zur anderen. Das folgende Skript erstellt eine Excel-Datei, die die Farben der individuellen Palette enthält: let workbook = workbookFactory.createNewWorkbook(); for (i = 1; i < 56; i++) { let cell = workbook.getRelCellAddr("A1", 0, i); workbook.setBackgroundColor(cell, i); workbook.setValue(cell, "index: " + i); } workbook.writeToFile("c:/example/colorindex.xlsx");

Beispiel Hintergrundfarbe einer Excelzelle ändern

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.setBackgroundColor("B3", 3);
4workbook.writeToFile(excelfile);

Tabelle 106. Ändert die Textfarbe einer Zelle.

setFontColor(CELL, colorindex);
Parameter	Typ	Beschreibung
CELL	string	Adresse der Excel Zelle (z.B. C12)
colorindex	int	Excel bietet standardmäßig 56 Farben an, die in einer Palette zusammengefasst sind. Diese können über den colorindex angesprochen werden. Die Standardpalette unterscheidet sich von einer Excel-Installation zur anderen. Das folgende Skript erstellt eine Excel-Datei, die die Farben der individuellen Palette enthält: let workbook = workbookFactory.createNewWorkbook(); for (i = 1; i < 56; i++) { let cell = workbook.getRelCellAddr("A1", 0, i); workbook.setBackgroundColor(cell, i); workbook.setValue(cell, "index: " + i); } workbook.writeToFile("c:/example/colorindex.xlsx");

Beispiel Textfarbe einer Excelzelle ändern

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.setFontColor("B3", 4);
4workbook.writeToFile(excelfile);

Beispiel Zellen B3 bis D4 verbinden

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.mergeCells("B3", "D4");
4workbook.writeToFile(excelfile);

Beim Verbinden von Zellen bleibt nur der Wert der obersten linken Zelle erhalten. Alle anderen Werte werden verworfen. Per Default wird der Inhalt der verbundenen Zelle zentriert und unten ausgerichtet.

Um einen Wert in die verbundene Zelle zu schreiben oder das Layout anzupassen, muss die obere linke Zelladresse in den entsprechenden Funktionen angegeben werden.

Tabelle 108. Ändert die horizontale Ausrichtung einer Excel Zelle.

setCellAlign(CELL, alignment);
Parameter	Typ	Beschreibung
CELL	string	Adresse der Excel Zelle (z.B. C12)
alignment	string	Folgende Formatierungsoptionen stehen zur Verfügung: Links stehen die Werte, die alignment annehmen kann. Um die Zellenausrichtung auf den Defaultzustand zurückzusetzen, kann der Wert general verwendet werden.

Beispiel Inhalt einer Zelle horizontal zentrieren

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.setCellAlign("B4", "center");
4workbook.writeToFile(excelfile);

Tabelle 109. Ändert die vertikale Ausrichtung einer Excel Zelle.

setVCellAlign(CELL, alignment);
Parameter	Typ	Beschreibung
CELL	string	Adresse der Excel Zelle (z.B. C12)
alignment	string	Folgende Formatierungsoptionen stehen zur Verfügung: Links stehen die Werte, die alignment annehmen kann.

Beispiel Inhalt einer Zelle unten ausrichten

1let excelfile = "c:/example/excelfile.xlsx";
2let workbook = workbookFactory.createWorkbook(excelfile);
3workbook.setVCellAlign("B4", "bottom");
4workbook.writeToFile(excelfile);