# DocType
## Einleitung
Zentraler Baustein von frappe und ERPNext ist der DocType. Das Wort in dieser Schreibweise ist ERPNext bzw. frappe eigen. Ein DocType ist ein Objekt, in welchem Datenfelder angelegt werden können.
## Felder
**Bezeichnung** | **Feldname** | **Erklärung** |
Module
| module
| Verknüpfung zum Modul in welches der DocType gehört/gehören soll.
|
Ist übertragbar
| is\_submittable
| Aktivieren wir diesen Haken wird der DocType übertragbar (buchbar/Submittable)
|
Ist Untertabelle | istable
| Wenn Aktiviert, ist der DocType eine Untertabelle. Er kann dann im Datentype Tabelle oder MultiSelect verwendet werden.
|
Ist einzeln
| is\_single
| Aktivieren wir diese Checkbox stellen wir ein, dass es von diesem DocType nur eine Instanz geben kann. Es gibt von diesem DocType so weder eine Listenansicht noch die Möglichkeit Berichte zu erstellen. Ein Beispiel für eine Seite mit der Eigenschaft "Ist einzeln" ist die [Systemverwaltung](https://doku.phamos.eu/books/erpnext-benutzerhandbuch/page/systemverwaltung-system-settings "Systemverwaltung (System Settings)").
|
Ist Baum
| is\_tree
| Aktivieren wir diese Checkbox kann der DocType in einem Baum dargestellt werden.
[![image-1665935262779.png](https://doku.phamos.eu/uploads/images/gallery/2022-10/scaled-1680-/image-1665935262779.png)](https://doku.phamos.eu/uploads/images/gallery/2022-10/image-1665935262779.png)
Damit dies funktioniert, legt das System automatisch ein Feld an, in welchem wir den Stamm verknüpfen können.
|
Editierbares Raster |
| Nur sichtbar wenn "Ist Untertabelle" aktiviert ist.
[https://phamos.eu/kb/customizing/editierbares-raster](https://phamos.eu/kb/customizing/editierbares-raster)
|
|
|
|
|
|
|
### Felder (Fields)
Dieser Abschnitt enthält die Tabelle, in welcher wir die Felder unseres DocTypes (Formulars) erstellen können.
[![image-1654776147809.png](https://doku.phamos.eu/uploads/images/gallery/2022-06/scaled-1680-/image-1654776147809.png)](https://doku.phamos.eu/uploads/images/gallery/2022-06/image-1654776147809.png)
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Typ
|
|
|
Name
|
| |
Virtual
|
|
|
Index
|
|
|
Standardeinstellungen
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Fetch only if value is not set
|
| |
Sichtbarkeit
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Versteckt
|
| |
Fett gedruckt
|
|
|
In Schnelleingabe zulassen
|
|
|
Beim Drucken verbergen
|
|
|
Bericht ausblenden
|
|
|
Faltbar
|
|
|
Rand ausblenden
|
|
|
Listen-/ Sucheinstellungen
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
In der Rasteransicht
|
| |
Im Listen-Filter
|
|
|
In der Vorschau
|
|
|
Im Filter
|
|
|
Berechtigungen
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Schreibgeschützt
|
| |
Änderungen zulassen wenn gebucht
|
|
|
Ignorieren von Benutzerberechtigungen
|
|
|
XSS-Filter ignorieren
|
|
|
Beschränkungen
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Einzigartig
|
| |
Keine Kopie
|
|
|
Nur einmal setzen
|
|
|
anzeigen
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Spalten
|
| |
#### Typ (Type)
Dieser Abschnitt war für die Doku von Version 13 gültig und ist hier nur noch als Referenz
Maßgeblich für die Auswahl in der Felder Tabelle sind die unterschiedlichen Feldtypen, die wir auswählen können. Die Sortierung folgt hier frappe. Die Reihenfolge ist in englisch und alphabetisch, daher schreiben wir hier führend den englischen Namen.
Weiter überschneiden sich einige Felder, welche Optionen für die unterschiedlichen Typen darstellen. Diese Optionen wiederholen sich also und werden jeweils immer nur einmal hier dokumentiert. Und zwar unter dem Typ, unter welchem Sie das erste Mal auftreten.
##### Attach
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
| label
|
|
| Type
|
|
| Name
|
|
| Length
|
|
| Mandetory
|
|
| Index
|
|
| In List View
|
|
Im Standard Filter | in\_standard\_filter
| Standardfilter werden in Listenansicht, Berichtsansicht und X angezeigt
[![image-1665147872583.png](https://doku.phamos.eu/uploads/images/gallery/2022-10/scaled-1680-/image-1665147872583.png)](https://doku.phamos.eu/uploads/images/gallery/2022-10/image-1665147872583.png)
|
| In Preview
|
|
| Allow in Quick Entry
|
|
| Bold
|
|
| Options
|
|
| Default
|
|
| Fetch From
|
|
| Fetch if Empty
|
|
**Permissions**
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
| Display Depends On |
|
| Hidden |
|
| Read Only |
|
| Unique |
|
| Set Only Once |
|
| Perm Level |
|
| Ignore User Permissions |
|
| Report Hide |
|
| Ignore XSS Filter |
|
**Property Depends On**
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
| Mandatory Depends On |
|
| Read Only Depends On |
|
**Display**
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
| In Filter |
|
Keine Kopie
| No Copy | Ist das Häkchen gesetzt wird beim duplizieren von Dokumenten der Wert des Feldes nicht mit kopiert.
|
| Print Hide |
|
| Print Width |
|
| Width |
|
| Columns |
|
| Description | Hier kann eine Feldbeschreibung eingestellt werden, welche für den Nutezer in der UI sichtbar ist:
[![image-1663069306036.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1663069306036.png)](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1663069306036.png)
Dies ist auch HTML fähig!
|
##### Attach Image
**Permissions**
**Property Depends On**
**Display**
##### Barcode
**Permissions**
**Property Depends On**
**Display**
##### Button
**Permissions**
**Property Depends On**
**Display**
##### Check
**Permissions**
**Property Depends On**
**Display**
##### Code
**Permissions**
**Property Depends On**
**Display**
##### Color
**Permissions**
**Property Depends On**
**Display**
##### Column Break
**Permissions**
**Property Depends On**
**Display**
##### Currency
**Permissions**
**Property Depends On**
**Display**
##### Data
**Permissions**
**Property Depends On**
**Display**
##### Datum
Hier bekommen wir eine Pop-Up in welchem wir eine Datum per Click auswählen können.
[![grafik.png](https://doku.phamos.eu/uploads/images/gallery/2023-06/scaled-1680-/grafik.png)](https://doku.phamos.eu/uploads/images/gallery/2023-06/grafik.png)
Über die [Systemverwaltung](https://doku.phamos.eu/books/erpnext-benutzerhandbuch-v14/page/systemverwaltung-system-settings "Systemverwaltung (System Settings)") können wir wählen welcher Tag zuerst angezeigt wird.
**Permissions**
**Property Depends On**
**Display**
##### Datatime
**Permissions**
**Property Depends On**
**Display**
##### Duration
**Permissions**
**Property Depends On**
**Display**
##### Dynamic Link
**Permissions**
**Property Depends On**
**Display**
##### Float
**Permissions**
**Property Depends On**
**Display**
##### Fold
**Permissions**
**Property Depends On**
**Display**
##### Geolocation
**Permissions**
**Property Depends On**
**Display**
##### Heading
**Permissions**
**Property Depends On**
**Display**
##### HTML
**Permissions**
**Property Depends On**
**Display**
##### HTML Editore
**Permissions**
**Property Depends On**
**Display**
##### Icon
**Permissions**
**Property Depends On**
**Display**
##### Image
**Permissions**
**Property Depends On**
**Display**
##### Int
**Permissions**
**Property Depends On**
**Display**
##### Link
**Permissions**
**Property Depends On**
**Display**
##### Long Text
**Permissions**
**Property Depends On**
**Display**
##### Markdown Editor
**Permissions**
**Property Depends On**
**Display**
##### Password
**Permissions**
**Property Depends On**
**Display**
##### Percent
**Permissions**
**Property Depends On**
**Display**
##### Read Only
**Permissions**
**Property Depends On**
**Display**
##### Rating
**Permissions**
**Property Depends On**
**Display**
##### Section Break
**Permissions**
**Property Depends On**
**Display**
##### Select
**Permissions**
**Property Depends On**
**Display**
##### Small Text
**Permissions**
**Property Depends On**
**Display**
##### Table
**Permissions**
**Property Depends On**
**Display**
##### Table MultiSelect
**Permissions**
**Property Depends On**
**Display**
##### Text
**Permissions**
**Property Depends On**
**Display**
##### Text Editor
**Permissions**
**Property Depends On**
**Display**
##### Time
**Permissions**
**Property Depends On**
**Display**
##### Signature
**Permissions**
**Property Depends On**
**Display**
### Naming
In diesem Abschnitt bestimmen wir wie das DocType bei der Erstellen benannt wird. Dies repräsentiert die ID wie sie in der Datenbank hinterlegt wird.
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Auto Name
|
| Reserviert sind:
- hash
|
Name Case
|
|
|
Allow Rename
|
|
|
Description
|
|
|
Documentation Link
|
|
|
### Formulateinstellungen (Form Settings)
In diesem Abschnitt können wir z.B. bestimmen, ob der DocType ein Bild tragen soll, wie viele Anhänge angehängt werden können und einiges mehr.
[![image-1666191982671.png](https://doku.phamos.eu/uploads/images/gallery/2022-10/scaled-1680-/image-1666191982671.png)](https://doku.phamos.eu/uploads/images/gallery/2022-10/image-1666191982671.png)
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Bildfeld
| image\_field
| Hier können wir bestimmen welches Feld vom Typ FIXME aus der Feldertabelle als Bild für das DocType verwendet werden soll. Das Bild wird links oben angezeigt
[![image-1666192188352.png](https://doku.phamos.eu/uploads/images/gallery/2022-10/scaled-1680-/image-1666192188352.png)](https://doku.phamos.eu/uploads/images/gallery/2022-10/image-1666192188352.png)
|
Timeline-Feld
| time\_line\_field
| Funktion aktuell unklar/tut nicht was es soll
|
Maximale Anzahl an Anhängen
| max\_no\_of\_attachments
| Hier können wir mit einer Ganzzahl bestimmen wie viele Anhänge an eine Instanz des DocTypes angehängt werden dürfen. Lassen wir es leer ist kein Limit gesetzt.
|
Seitenleiste und Menü ausblenden
|
|
|
Kopie ausblenden
|
|
|
Import erlauben (mit Datenimport-Werkzeug
|
|
|
Ereignisse in der Zeitleiste zulassen
|
| Aktivieren wir die, können wir am unteren Ende des DocTypes Ereignisse (Termine) erstellen
[![image-1666196150111.png](https://doku.phamos.eu/uploads/images/gallery/2022-10/scaled-1680-/image-1666196150111.png)](https://doku.phamos.eu/uploads/images/gallery/2022-10/image-1666196150111.png)
|
Automatische Wiederholung zulassen
|
|
|
Anhänge im Standard als öffentlich markieren
| Make Attachments Public by Default | Wenn eine Datei hochgeladen wird, wird diese im Standard als öffentlich gesetzt.
|
### View Settings
[![image-1662388758700.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662388758700.png)](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662388758700.png)
**Bezeichnung**
| **Feldname**
| **Erklärung**
|
Title Field
| title\_field
| Hier bestimmen wir welches Feld als DocType Titel verwendet werden soll.
|
Show Title in Link Fields
| show\_title\_in\_link\_fields
| Jeder Instanz eines DocTypes hat eine ID. Oft nutzt man aber zusätzlich einen Klarnamen. Dieses Feld Feld ändert die Anzeige der Verknüpfung zu dieser Instanz zu dem gewählten Klarnamen.
Detailierte Erklärung
|
Translate Link Fields
| translate\_link\_fields
| Ist die Option deaktiviert (standard) werden ausgewählte Verknüpfungen im DocType nicht übersetzt.
Ist die Option aktiviert wird der Titel des DocTypes bei der Auswahl in der Maske übersetzt.
[Detailierte Erklärung](https://doku.phamos.eu/link/1341#bkmrk-translate-link-field)
|
Search Fields
| search\_fields
| Hier können wir kommagetrennt Feldnamen angeben, welche in der Suche auftauchen.
|
Default Print Format
| default\_print\_format
| Hier können wir ein Druckformat verknüpfen welches als Standard gesetzt wird.
|
Default Sort Field
| default\_sort\_field
| Hier stellen wir ein, nach welchem Feld in der Listenansicht sortiert werden soll.
|
Default Sort Order
| default\_sort\_order
| Hier stellen wir ein in welche Richtung das default\_sort\_field sortiert werden soll.
- ASC für Aufsteigend
- DESC für Absteigend
|
Show in Module Section
|
| Auswahl aus
- *Leer*
- Document
- Setup
- System
- Other
|
Icon
|
| |
Color
|
| |
Show Preview Popup
| show\_preview\_popup
| Aktivieren wir dies können wir im System ein "Mouse Over" nutzen, welches uns Daten als Pop-Up zeigt. Die Daten werden in den einzelnen Feldern bestimmt.
|
Make "name" searchable in Global Search
|
| |
### EMail Settings
### Permission Rules
### Actions
Actions sind Weiterleitungen, die wir im Standard oben rechts am DocType finden. Hinter die Action kann ein einfacher Serverpfad oder aber ein Script hinterlegt werden.
### Linked Documents
In diesem Abschnitt können wir Rückverknüpfungen einstellen. Wollen wir in diversen DocTypes Rückverknüpfungen haben können wir dies hier einstellen.
### Web View
## Erklärungen
##### Ist übertragbar
**DocStatus**
| **Status Deutsch**
| **Status English**
| **Erklärung**
|
0
| Entwurf
| Draft
| Nächste Aktion: Buchen
|
1
| Gebucht
| Submitted
| Nächste Aktion: Abbrechen |
2
| Abgebrochen
| Cancelled
| Nächster Aktion: Abändern (Status Entwurf)
|
### View Settings
##### **Title Field**
Nicht alle DocTypes haben den gleichen Titel wie die ID in der Datenbank
[![image-1662388931202.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662388931202.png)](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662388931202.png)
Über das Title Field können wir bestimmen, welcher Inhalt anstelle der Datenbank ID verwendet werden soll. Dies erhöht die Lesbarkeit für uns Menschen im System.
##### **Show Title in Link Fields**
In diesem Beispiel nehmen wir ein Projekt mit der Projektnummer PROJ-0003 und dem Projektnamen "Pizza backen". Wir wollen nun, dass in Linkfeldern nicht mehr PROJ-0003 angezeigt wird sondern der Projektname "Pizaa backen".
[![image-1678791963598.png](https://doku.phamos.eu/uploads/images/gallery/2023-03/scaled-1680-/image-1678791963598.png)](https://doku.phamos.eu/uploads/images/gallery/2023-03/image-1678791963598.png)
Dazu gehen wir in das DocType Customizing und aktivieren wir den Haken #1 und stellen ein Titelfeld ein #2
[![image-1678789637998.png](https://doku.phamos.eu/uploads/images/gallery/2023-03/scaled-1680-/image-1678789637998.png)](https://doku.phamos.eu/uploads/images/gallery/2023-03/image-1678789637998.png)
Hier in einem Auftrag sehen wir nun das verknüpfte Projekt im Klarnamen:
[![image-1678791855081.png](https://doku.phamos.eu/uploads/images/gallery/2023-03/scaled-1680-/image-1678791855081.png)](https://doku.phamos.eu/uploads/images/gallery/2023-03/image-1678791855081.png)
Die verwendung von ID ist von Fall zu Fall unterschiedlich. Will man beides wird man nicht darum herum kommen entweder beide Felder zu verwenden oder ein Sonderlösung zu coden.
##### **Translate Link Fields**
**Dies wirkt sich nur auf den Titel eines DocTypes aus, wenn dies auch gleichzeitig der Name (Feld "name) ist. Nummernkreise bleiben von der Übersetzung unberührt.**
[![image-1662814076764.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662814076764.png)](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662814076764.png)
**Beispiel Verkaufsphase (Sales Stage)**
Wir erstellen vom DocType Verkaufsphase einen Eintrag der klar englisch gekennzeichnet ist, indem wir im Titel EN nutzen.
[![image-1662813311733.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662813311733.png)](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662813311733.png)
Zu diesem erstellen wir eine Übersetzung.
[![image-1662813358117.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662813358117.png)](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662813358117.png)
Wählen wir in einer neuen Chance den Eintrag finden wir diesen in der Suche. Er ist weiterhin in englisch.
[![image-1662813447635.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662813447635.png)Der Eintrag Sales Stage EN wird, obwohl die Systemsprache deutsch ist und eine Übersetzung existiert nicht übersetzt.](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662813447635.png)
Wurde der Eintrag ausgewählt ist er weiterhin english.
[![image-1662813142758.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662813142758.png)In diesem Bild ist die Maske in Deutsch und die Verknüpfung zur Verkaufsphase (Sales Stage) in english.](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662813142758.png)
Aktivieren wir die Option "Translate LInk Fields" über die Customize DocType und speichern wird das Feld wie gewünscht übersetzt.
[![image-1662813612675.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662813612675.png)Die Checkbox im Feld Translate Link Field wird gesetzt um die Verknüpfungen übersetzbar zu machen.](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662813612675.png)
[![image-1662813652142.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662813652142.png)Die Maske ist auf deutsch eingestellt und die Verknüpfung wird ebenfalls deutsch angezeigt, da eine Übersetzung existiert.](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662813652142.png)
Schalten wir die Systemsprache auf english sehen wir, dass er die englische Version der Verknüpfung übernimmt
[![image-1662813890946.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662813890946.png)Die Maske ist auf englisch eingestellt und die Verknüpfung wird in englisch angezeigt.](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662813890946.png)
##### **Search Fields**
Die Information die nach P-01001 in der Suche zu sehen ist #1 wird über die Search Fields gesteuert.
[![image-1662389687960.png](https://doku.phamos.eu/uploads/images/gallery/2022-09/scaled-1680-/image-1662389687960.png)](https://doku.phamos.eu/uploads/images/gallery/2022-09/image-1662389687960.png)
Tabellen können nicht als search\_field gesetzt werden!
## Hilfe Artikel
- [https://phamos.eu/kb/customizing](https://phamos.eu/kb/customizing)
- [https://phamos.eu/kb/core](https://phamos.eu/kb/core)