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
A spreadsheet cell may contain arbitrary text or an expression. Technically, expressions must start with an equals '=' sign. However, the spreadsheet attempts to be intelligent; if you enter what looks like an expression without the leading '=', one will be added automatically.

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
Es werden Standardfunktionen der Trigonometrie und allgemeiner mathematischer Funktionen, sowie statistische Aggregatsfunktionen unterstützt (siehe Ausdrücke)

Wechselwirkung zwischen Tabellenkalkulationen und dem CAD Modell
Data in the cells of a spreadsheet may be used in CAD model parameter expressions. Thus, a spreadsheet may be used as the source for parameter values used throughout a model, effectively gathering the values in one place. When values are changed in the spreadsheet, they are propagated throughout the model.

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 Current Limitations.

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



Er hat mehrere Reiter. Die folgenden Eigenschaften können geändert werden:


 * Textfarbe sowie Hintergrundfarbe
 * horizontale und vertikale Textausrichtung
 * Textstile: fett, kursiv, unterstrichen
 * Die angezeigten Einheiten für diese Zelle. (Unbedingt den Abschnitt unten beachten.)
 * Einen Alias-Namen für diese Zelle festlegen. Der Alias-Name kann in den Zellformeln und auch in den FreeCAD-Ausdrücken verwendet werden.

Verweise 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):

Tabellenkalkulationsdaten in Ausdrücken
Um die die 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 Zellreferenz oder dem Zell-Alias benötigt. Die folgende Abbildung zeigt die Verwendung eines Aliasses "number" aus einem Tabellenblatt "MySheet" in einem Ausdruck in dem Arbeitsbereich PartDesign.



Durch eine Eintippen von "M" erreicht man die Anzeige von verfügbaren Namen, die mit "M" beginnen. Mit den Pfeiltasten kann "MySheet" ausgewählt werden.



Anschließendes Eintippen von "n" zeigt nun die Liste der verfügbaren Namen in MySheet, die mit "n" anfangen. Der Name "number" kann mit der Pfeilrunter-Taste ausgewählt werden. Wenn eine gültiger Formel angegeben ist, zeigt das Ergebnisfeld die berechnete Länge.



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 Tabellen verwenden Einheiten. Wenn eine Zahl eine Einheit hat, wird diese Einheit auch in den Berechnungen verwendet. Die Multiplikation von zwei Längen mit der Einheit mm ergibt eine Fläche mit der Einheit mm&sup2;.

If a cell contains a value which represents a dimension, it should be entered with its associated unit. While in many simple cases one can get by with a dimensionless value, it is unwise to not enter the unit. If a value representing a dimension is entered without its associated unit, there are some sequences of operations which cause FreeCAD to complain of incompatible units in an expression when it appears the expression should be valid. (This may be better understood by viewing this thread in the FreeCAD forums.)

Man kann die dargestellte Längeneinheit von Millimeter auf Inch in dem Eigenschaftsdialog ändern. Die Zelle zeigt danach die Länge in Inch. Der eigentliche Wert, der in den Berechnungen verwendet wird, hat sich dadurch nicht geändert. Die Ergebnisse einer Formel, die diesen Wert benutzen, werden durch die angezeigte Einheit nicht geändert. Das Resultat der besagten Formel benutzt immer noch den Wert der Länge in Millimeter.

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.

Manchmal ist es notwendig, die Einheit von einer Zahl zu entfernen. Dies kann nur 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 enthält keine Formeln, kann aber von den meisten anderen Tabellenkalkulationsprogrammen wie Microsoft Excel oder LibreOffice Calc gelesen und geschrieben werden. Wenn Dateien importiert werden, muss das Trennzeichen (das Zeichen, welches die Spalten trennt) das TAB-Zeichen sein. Dies kann üblicherweise in Tabellenkalkulationsprogrammen eingestellt werden. Der Import einer CSV-Datei ist über das Menü Spreadsheet/Importiere Kalkulationstabelle oder durch Klick auf das Symbol möglich. Diese Import-Funktion öffnet keine Excel-Dateien oder andere Tabellenkalkulationsformate.

Tabellen im Excel-format "xlsx" können über das Menü Datei/Importieren... in ein FreeCAD-Document importiert werden. Excel-Tabellen können auch durch FreeCAD mit Klick auf das Symbol im Menü Datei/Öffnen... 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 sowohl 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 angeben, 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 Tabellenkalkulations Erbe