tüit Logo Skip to main content

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


Ist Untertabelle

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.

Ist Baum
is_tree

Aktivieren wir diese Checkbox kann der DocType in einem Baum dargestellt werden.


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









Felder (Fields)

Dieser Abschnitt enthält die Tabelle, in welcher wir die Felder unseres DocTypes (Formulars) erstellen können.

image-1654776147809.png

Typ (Type)

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.

Anhängen (Attach)

image-1672430380732.png

image-1672430499609.png

Bezeichnung
Feldname
Erklärung
Bezeichnung label

Typ Type

Name Name

Länge Length

Zwingend notwendig Mandetory

Index Index

In der Listenansicht In List View

Im Standard-Filter in_standard_filter

Standardfilter werden in Listenansicht, Berichtsansicht und X angezeigt

image-1665147872583.png

In globaler Suche

In der Vorschau In Preview

In der Schnelleingabe zulassen Allow in Quick Entry

Fett gedruckt Bold

Optionen Options

Standard Default

Abholen von Fetch From

Über dieses Feld können wir Daten aus einem anderen DocType abholen.

In der Datenansicht wird uns darüber hinaus ein Mause-Over angezeigt aus welchem hervorgeht, wo die Daten herkommen 

image-1673938809517.png

Abrufen, wenn leer Fetch if Empty

Permissions

Bezeichnung
Feldname
Erklärung
Anzeige ist abhängig von Display Depends On
Versteckt Hidden
Schreibgeschützt Read Only
Einzigartig Unique
Nur einmal festlegen Set Only Once
Massenbearbeitung zulassen allow_bulk_edit

Erscheint nur bei der Auswahl des Types Tabelle

image-1675176135416.png

Berechtigungsebene Perm Level
Ignorieren von Benutzerberechtigungen Ignore User Permissions Hebt die Anwendung des Sitzungsstandards auf
Bericht ausblenden report_hide Ist dieses Häkchen gesetzt, kann das feld in der Berichtsansicht nicht ausgewählt werden.
Zuletzt gewählten Wert merken

XSS-Filter ignorieren Ignore XSS Filter

Property Depends On

Bezeichnung
Feldname
Erklärung
Obligatorisch Hängt von ab
Mandatory Depends On
Nur lesen hängt von ab
Read Only Depends On

anzeigen (display)

Bezeichnung
Feldname
Erklärung
Im Filter
In Filter
Keine Kopie
No Copy Ist das Häkchen gesetzt wird beim duplizieren von Dokumenten der Wert des Feldes nicht mit kopiert.
Beim Drucken verbergen
Print Hide
Druckbreite
Print Width
Breite
Width

Hier können wir einstellen wie breit das Feld als Spalte in der Berichtsansicht sein soll. Bsp:

image-1670828863263.png

Spalten
Columns
Beschreibung
Description

Hier kann eine Feldbeschreibung eingestellt werden, welche für den Nutezer in der UI sichtbar ist:

image-1663069306036.png

Dies ist auch HTML fähig!

Bild anhängen (Attach Image)

image-1672430583988.png

Permissions

Property Depends On

Display
Barcode

image-1672430617534.png

Permissions

Property Depends On

Display
Schaltfläche (Button)

image-1672430644844.png

Permissions

Property Depends On

Display
Prüfen (Check)

image-1672430674311.png

Permissions

Property Depends On

Display
Code

image-1672430699343.png

Permissions

Property Depends On

Display
Farbe (Color)

image-1672430722831.png

Permissions

Property Depends On

Display
Spaltenumbruch (Column Break)

image-1672431060995.png

Permissions

Property Depends On

Display
Währung (Currency)

image-1672431094761.png

Permissions

Property Depends On

Display
Daten (Data)

image-1672431128888.png

Permissions

Property Depends On

Display
Datum (Date)

image-1672431178112.png

Permissions

Property Depends On

Display
Datum und Uhrzeit (Datatime)

image-1672431208428.png

Permissions

Property Depends On

Display
Dauer (Duration)

image-1672431241889.png

Permissions

Property Depends On

Display


Permissions

Property Depends On

Display
Gleitkommazahl (Float)

image-1672431293044.png

Permissions

Property Depends On

Display
Falz (Fold)

Permissions

Property Depends On

Display
Geolokalisierung (Geolocation)

image-1672431372284.png

Permissions

Property Depends On

Display
Überschrift (Heading)

image-1672431407533.png

Permissions

Property Depends On

Display
HTML


Permissions

Property Depends On

Display
HTML Editor
image-1672431522919.png image-1672431545265.png




Permissions

Property Depends On

Display
Symbol (Icon)

image-1672431446708.png

Permissions

Property Depends On

Display
Bild (Image)

image-1672431634795.png

Permissions

Property Depends On

Display
Int

image-1672431670581.png

Permissions

Property Depends On

Display

image-1672431773887.png

Permissions

Property Depends On

Display
Langer Text (Long Text)

image-1672431869552.png

Permissions

Property Depends On

Display
Markdown Editor

image-1672431946302.png

image-1672431962502.png

Permissions

Property Depends On

Display
Passwort (Password)

image-1672431991530.png

Permissions

Property Depends On

Display
Prozent (Percent)

image-1672432018966.png

Permissions

Property Depends On

Display
Read Only

Permissions

Property Depends On

Display
Wertung (Rating)

image-1672432421921.png

Permissions

Property Depends On

Display
Abschnittswechsel (Section Break)

image-1672432469493.png

Permissions

Property Depends On

Display
Auswählen (Select)

image-1672432492763.png

Permissions

Property Depends On

Display
Kleiner Text (Small Text)

image-1672432548606.png

Permissions

Property Depends On

Display
Tabelle (Table)

image-1672432575692.png

Permissions

Property Depends On

Display
Tabelle MultiSelect (Table MultiSelect)

image-1672432629017.png

Permissions

Property Depends On

Display
Text

image-1672432678813.png

Permissions

Property Depends On

Display
Text Bearbeiter (Text Editor)

image-1672432817539.png

Permissions

Property Depends On

Display
Zeit (Time)

image-1672432842241.png

Permissions

Property Depends On

Display
Signatur (Signature)

image-1672432873653.png

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

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

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

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


Bezeichnung
Feldname
Erklärung
Title Field
title_field
Hier bestimmen wir welches Feld als DocType Titel verwendet werden soll.
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

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

Bezeichnung
Feldname
Erklärung
Standard E-Mail Vorlage


Dokumenterstellung per E-Mail zulassen

 
Absenderfeld

Hier bestimmen wir ein Feld aus der Feldliste welches eine E-Mailadresse enthalten wird. Diese E-Mail ist dann der ersteller des Dokuments (muss überprüft werden stand 03.2023).
Themenfeld

Hier bestimmen wir ein Feld aus der Feldliste welches den Titel des DocTypes bestimmen soll.

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

View Settings

Title Field

Nicht alle DocTypes haben den gleichen Titel wie die ID in der Datenbank

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.

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

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

Zu diesem erstellen wir eine Übersetzung.

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.pngDer Eintrag Sales Stage EN wird, obwohl die Systemsprache deutsch ist und eine Übersetzung existiert nicht übersetzt.

Wurde der Eintrag ausgewählt ist er weiterhin english.

image-1662813142758.pngIn diesem Bild ist die Maske in Deutsch und die Verknüpfung zur Verkaufsphase (Sales Stage) in english.

Aktivieren wir die Option "Translate LInk Fields" über die Customize DocType und speichern wird das Feld wie gewünscht übersetzt.

image-1662813612675.pngDie Checkbox im Feld Translate Link Field wird gesetzt um die Verknüpfungen übersetzbar zu machen.

image-1662813652142.pngDie Maske ist auf deutsch eingestellt und die Verknüpfung wird ebenfalls deutsch angezeigt, da eine Übersetzung existiert.

Schalten wir die Systemsprache auf english sehen wir, dass er die englische Version der Verknüpfung übernimmt

image-1662813890946.pngDie Maske ist auf englisch eingestellt und die Verknüpfung wird in englisch angezeigt.

Search Fields

Die Information die nach P-01001 in der Suche zu sehen ist #1 wird über die Search Fields gesteuert.

image-1662389687960.png

Tabellen können nicht als search_field gesetzt werden!

Email Settings

image-1677690397771.png

Dokumenterstellung per E-Mail zulassen

image-1677690491835.png

Absenderfeld

Themenfeld

Hilfe Artikel