Spreadsheet Workbench/de

Einführung
Der Arbeitsbereich Tabellenkalkulation ermöglicht die Erstellung und Bearbeitung von Tabellen, Daten aus der Tabellenkalkulation als Parameter in einem Modell zu verwenden, die Tabellenkalkulation mit aus einem Modell abgerufenen Daten zu füllen, Berechnungen durchzuführen und die Daten in andere Tabellenkalkulationsprogramme wie LibreOffice oder Microsoft Excel zu exportieren.



Werkzeuge

 * Spreadsheet_CreateSheet.svg Blatt erstellen: Erstelle ein neues Arbeitsblatt.


 * Spreadsheet_Import.svg Import: eine Komma-getrennte Werte Datei (engl.: comma-separated values) (CSV) in ein Tabellenblatt importieren.
 * Spreadsheet_Export.svg Export: eine Komma-getrennte Werte Datei (engl.: comma-separated values) (CSV) aus einem Tabellenblatt exportieren.


 * Spreadsheet_MergeCells.svg Zellen zusammenführen: ausgewählte Zellen zusammenführen.
 * Spreadsheet_SplitCell.svg Zelle teilen: zuvor zusammengeführte Zellen teilen.


 * Spreadsheet_AlignLeft.svg Align left: den Inhalt der gewählten Zelle auf links ausrichten.
 * Spreadsheet_AlignCenter.svg Align center: den Inhalt der gewählten Zelle auf mittig horizontal ausrichten.
 * Spreadsheet_AlignRight.svg Align right: den Inhalt der gewählten Zelle auf rechts ausrichten.
 * Spreadsheet_AlignTop.svg Align top: den Inhalt der gewählten Zelle oben ausrichten.
 * Spreadsheet_AlignVCenter.svg Align vertical center: den Inhalt der gewählten Zelle mittig vertikal ausrichten.
 * Spreadsheet_AlignBottom.svg Align bottom: den Inhalt der gewählten Zelle unten ausrichten.


 * Spreadsheet_StyleBold.svg Style bold: den Inhalt der gewählten Zelle auf fett stellen.
 * Spreadsheet_StyleItalic.svg Style italic: den Inhalt der gewählten Zelle auf kursiv stellen.
 * Spreadsheet_StyleUnderline.svg Style underline: den Inhalt der gewählten Zelle auf unterstrichen stellen.


 * Spreadsheet_SetAlias.svg Set alias: die ausgewählte Zelle mit einem Alias benennen.


 * und bestimmen die Vorder- und den Hintergrundfarbe der gewählten Zellen.

Zellausdrücke
Eine Tabellenzelle kann beliebigen Text oder einen Ausdruck enthalten. Technisch gesehen müssen Ausdrücke mit einem Gleichheitszeichen '=' beginnen. Die Tabellenkalkulation versucht jedoch, intelligent zu sein. Wenn etwas eingegeben wird, das wie ein Ausdruck ohne das führende "="-Zeichen aussieht, wird automatisch das Zeichen hinzugefügt.

Cell expressions may contain numbers, functions, references to other cells, and references to properties of the model (But see Current Limitations below). Cells are referenced by their column (CAPITAL letter) and row (number). A cell may also be referenced by its alias-name (below). Example: B4 + A6

References to objects in the model are explained under References to CAD-Data below. Using spreadsheet cell values to define model properties are explained under Spreadsheet Data in Expressions below. For more specifics on how expressions are formed, see Expressions.

Unterstützte Funktionen
Trigonometrische Standardfunktionen und andere gebräuchliche mathematische Funktionen sowie statistische Aggregationsfunktionen werden unterstützt (siehe Ausdrücke).

Wechselwirkung zwischen Tabellenkalkulationen und dem CAD Modell
Daten in den Zellen einer Kalkulationstabelle können in CAD Modellparameterausdrücken verwendet werden. So kann eine Tabellenkalkulationstabelle als Quelle für Parameterwerte verwendet werden, die im gesamten Modell verwendet werden, die Werte effektiv an einem Ort zu sammeln. Wenn Werte in der Kalkulationstabelle geändert werden, werden sie im ganzen Modell übertragen.

Similarly, properties from CAD model objects may be used in expressions in spreadsheet cells. This allows use of object properties like volume or area in the spreadsheet. If the name of an object in the CAD model is changed, the change will automatically be propagated to any references in spreadsheet expressions using the name which was changed.

Es kann mehr als eine Tabelle in einem Dokument verwendet werden. Tabellen können, wie jedes andere Objekt, benannt/umbenannt werden.

FreeCAD prüft zyklische Abhängigkeiten. Siehe Aktuelle Einschränkungen.

Zelleigenschaften
Die Eigenschaften der Zellen der Tabelle können mit einem Rechtsklick auf einer Zelle geändert werden. Der folgende Dialog klappt auf:



Gemäß den Reitern können die folgenden Eigenschaften geändert werden:

Während mancher die Zeilen- und Spaltennummer einer Zelle in den Ausdrücken verwendet, um sich auf diese zu beziehen, stellt die Verwendung von Aliasnamen die beste Methode dazu dar. Wenn z.B. der Wert in der Zelle B1 die Länge des Objektes enthält, erlaubt die Verwendung des Aliasnamens Objektlaenge den Bezug auf die Zelle im Ausdruck Spreadsheet.Objektlaenge, anstatt des Ausdruckes Spreadsheet.B1. Allerdings ist beides möglich, jedoch weiß man mit dem Alias, welcher Wert sich darin befindet.
 * Farbe: Text- und Hintergrundfarbe
 * Ausrichtung: horizontale und vertikale Textausrichtung
 * Textstile: fett, kursiv, unterstrichen
 * Einheiten:  Anzeigeeinheiten für diese Zelle. Den Abschnitt Einheiten unten beachten.
 * Alias:  Einen Alias-Namen für diese Zelle festlegen. Der Alias-Name kann in den Zellformeln und auch in allgemeinen FreeCAD-Ausdrücken verwendet werden.

Referenzen auf CAD-Daten
Wie oben angegeben, kann man in Tabellenkalkulationsausdrücken auf Daten aus dem CAD Modell verweisen.

Computed expressions in spreadsheet cells start with an equals ('=') sign. However, the spreadsheet entry mechanism attempts to be smart. An expression may be entered without the leading '='; if the string entered is a valid expression, an '=' is automatically added when the final is typed. If the string entered is not a valid expression (often the result of entering something with the wrong case, e.g. "MyCube.length" instead of "MyCube.Length"), no leading '=' is added and it is treated as simply a text string.

Note: The above behavior (auto insert of '=') has some unpleasant ramifications:
 * If you want to keep a column of names corresponding to the alias-names in an adjacent column of values, you must enter the name in the label column before giving the cell in the value column its alias-name. Otherwise, when you enter the alias-name in the label column the spreadsheet will assume it is an expression and change it to "="; and the displayed text will be the value from the  cell.
 * If you make an error when entering the name in the label column and wish to correct it, you cannot simply change it to the alias-name. Instead, you must first change the alias-name to something else, then fix the text name in the label column, then change the alias-name in the value column back to its original.

One way to side-step these issues is to prefix text labels corresponding to alias-names with a fixed string, thereby making them different. Note that "_" will not work, as it is converted to "=". However, a blank, while invisible, will work.

Die folgende Tabelle zeigt einige Beispiele. Es wird dabei vorausgesetzt, dass das FreeCAD-Dokument ein Objekt Namens "Würfel" zum Beispiel aus der Arbeitsbereich Part enthält.(Anmerkung, dies ist der interne Name des Objekts, nicht das vom Benutzer zugewiesene Label):

Tabellendaten in Ausdrücken
Um Tabellendaten in anderen Teilen von FreeCAD benutzen zu können, wird ein vollständig definierter Name benötigt. Weil es möglich ist, mehrere Tabellenblätter in einem FreeCAD-Dokument zu haben, wird der Tabellenname zusammen mit der Zellenbezeichnung oder dem Zellen-Alias benötigt. Die folgende Abbildung zeigt die Verwendung einer Aliasbezeichnung aus einem Tabellenblatt "MySheet" in einem Ausdruck im Arbeitsbereich PartDesign.



Durch Eintippen von "M" werden die verfügbaren Namen mit "M" am Anfang angezeigt (siehe oben). Mit den Pfeiltasten kann "MySheet" ausgewählt werden. vervollständigt den Ausdruck. Es kann auch bis zum Ende eingetippt oder mit der Maus die Auswahl getroffen werden.



Durch Eintippen von "n" werden die verfügbaren Namen mit "n" am Anfang angezeigt (siehe oben). "number" kann nun, wie oben beschrieben, ausgewählt werden. Wenn ein Name mit einem gültigen Inhalt angegeben wurde, zeigt das Ergebnisfeld die berechnete Länge (siehe unten).



Weiteres Tippen, wie das Hinzufügen eines "+"-Zeichens, führen zu einem Ausdruck, der nicht mehr gültig ist, was angezeigt wird. Das Fortsetzen der Vervollständigung des Ausdrucks kann wieder zu einem gültigen Ausdruck führen.

Einheiten
Die Tabelle hat eine Konzept für Dimensionen (Einheiten), die mit Zellwerten verbunden sind. Eine Zahl ohne eine zugeordnete Einheit hat keine Dimension. Die Einheit sollte unmittelbar nach dem Zahlenwert ohne Zwischenraum eingegeben werden. Wenn einer Zahl eine Einheit zugeordnet ist, wird diese Einheit in allen Berechnungen verwendet. Zum Beispiel ergibt die Multiplikation von zwei Längen mit der Einheit mm eine Fläche mit der Einheit mm&sup2;.

Wenn eine Zelle einen Wert enthält, der eine Dimension repräsentiert, sollte sie mit der zugehörigen Einheit eingegeben werden. Während man in vielen einfachen Fällen auch mit einem dimensionslosen Wert auskommen könnte, sollte man trotzdem einen Wert mit der Einheit eingeben, wenn dieser eine Dimension darstellen soll.

Man kann die dargestellte Einheit einer Zelle im Eigenschaftsdialog Einheiten tab (sieh oben) ändern. Das ändert nicht den Wert in der Zelle, es konvertiert nur den existierenden Wert für die Anzeige. Der Wert für die Berechnung wird nicht geändert und das Ergebnis der Berechnung bleibt gleich. Zum Beispiel enthält eine Zelle den Wert "5.08cm". Er wird als "2in" angezeigt, wenn die Einheit auf der Registerkarte Einheiten in "in" geändert wird.

Eine Zahl ohne Einheit kann durch den Eigenschaftsdialog nicht in eine Zahl mit Einheit umgewandelt werden. Man kann eine Zeichenkette mit einer Einheitsbezeichnung eingeben, die dann auch angezeigt wird. Aber die Zelle enthält immer noch nur eine Zahl ohne Einheit. Um dies zu ändern, muss der Wert zusammen mit der Einheit erneut eingegeben werden.

Manchmal ist es notwendig, die Einheit von einer Zahl zu entfernen. Dies kann durch die Multiplikation einer 1 mit der reziproken Einheit erreicht werden.

Importieren und Exportieren
Tabellen können im CSV-Format importiert und exportiert werden. Dieses Format kann von den meisten anderen Tabellenkalkulationsprogrammen wie Microsoft Excel oder LibreOffice Calc gelesen und geschrieben werden. Wenn Dateien nach FreeCAD importiert werden, muss das Trennzeichen, welches die Spalten trennt, das TAB-Zeichen sein. Dies kann üblicherweise in den Tabellenkalkulationsprogrammen vor dem Export eingestellt werden. Der Import einer CSV-Datei ist über das Menü oder durch einen Klick auf das Symbol  möglich. Diese Import-Funktion öffnet keine Excel-Dateien oder andere Tabellenkalkulationsformate.

Tabellen im Excelformat "xlsx" können über das Menü importiert werden. Exceltabellen können auch durch den Menübefehl oder mit einem Klick auf das Symbol  geöffnet werden. In diesem Fall wird ein neues Dokument mit einer Tabelle erzeugt. Es werden die folgenden Eigenschaften unterstützt:


 * alle Funktionen, die auch in der FreeCAD Tabellenblatt verfügbar sind. Andere Funktionen führen nach dem Import zu einem Fehler in der entsprechenden Zelle.
 * Alias Namen für Zellen
 * Mehr als ein "Blatt" im Tabellenblatt. In diesem Fall wird für jede Excel-Tabelle eine FreeCAD Tabelle erstellt.

Andere Funktionalität wird nicht in die FreeCAD Tabellenblätter importiert. Der Excel-Import ist von FreeCAD.

Derzeitige Begrenzungen
FreeCAD prüft auf zyklische Abhängigkeiten. Nach dem Entwurf endet diese Prüfung auf der Ebene des Tabellenkalkulationsobjekts. Infolgedessen solltest du keine Tabellenkalkulation haben, die beides enthält Zellen, deren Werte zur Angabe von Parametern für das Modell verwendet werden, und Zellen, deren Werte die Ausgabe aus dem Modell verwenden. Du kannst z.B. keine Zellen haben, die die Länge, Breite und Höhe eines Objekts festlegen, und eine weitere Zelle, die das Gesamtvolumen der resultierenden Form referenziert. Diese Einschränkung kann durch zwei Tabellenkalkulationen überwunden werden: eine, die als Datenquelle für die Eingabeparameter des Modells dient und die andere verwendet für Berechnungen auf der Grundlage der resultierenden Geometriedaten.

Wenn Zellen kopiert werden, wird nur der Inhalt (Ausdruck/Wert) kopiert. Die oben beschriebenen Zelleigenschaften werden nicht kopiert.

Für frühere Versionen siehe Spreadsheet legacy