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ökönnen.

Felder

Bezeichnung	Feldname	Erklä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öMöglichkeit Berichte zu erstellen. Ein Beispiel fü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. Damit dies funktioniert, legt das System automatisch ein Feld an, in welchem wir den Stamm verknüverknüpfen kökönnen.
Editierbares Raster		Nur sichtbar wenn "Ist Untertabelle" aktiviert ist. https://phamos.eu/kb/customizing/editierbares-raster

Felder (Fields)

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

Typ (Type)

MaßMaßgeblich füfür die Auswahl in der Felder Tabelle sind die unterschiedlichen Feldtypen, die wir auswäauswählen kökönnen. Die Sortierung folgt hier frappe. Die Reihenfolge ist in englisch und alphabetisch, daher schreiben wir hier füführend den englischen Namen.

Weiter üüberschneiden sich einige Felder, welche Optionen fü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äAnhängen (Attach)

Bezeichnung	Feldname	ErkläErklärung
Bezeichnung	label
Typ	Type
Name	Name
Lä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
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ökönnen wir Daten aus einem anderen DocType abholen. In der Datenansicht wird uns darüdarüber hinaus ein Mause-Over angezeigt aus welchem hervorgeht, wo die Daten herkommen
Abrufen, wenn leer	Fetch if Empty

Permissions

Bezeichnung	Feldname	ErkläErklärung
Anzeige ist abhäabhängig von	Display Depends On
Versteckt	Hidden
Schreibgeschü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
Berechtigungsebene	Perm Level
Ignorieren von Benutzerberechtigungen	Ignore User Permissions	Hebt die Anwendung des Sitzungsstandards auf
Bericht ausblenden	Report Hidereport_hide	Ist dieses Häkchen gesetzt, kann das feld in der Berichtsansicht nicht ausgewählt werden.
Zuletzt gewägewählten Wert merken
XSS-Filter ignorieren	Ignore XSS Filter

Property Depends On

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

anzeigen (display)

Bild anhäanhängen (Attach Image)

Permissions

Property Depends On

Barcode

Permissions

Property Depends On

SchaltfläSchaltfläche (Button)

Permissions

Property Depends On

PrüPrüfen (Check)

Permissions

Property Depends On

Code

Permissions

Property Depends On

Farbe (Color)

Permissions

Property Depends On

Spaltenumbruch (Column Break)

Permissions

Property Depends On

WäWährung (Currency)

Permissions

Property Depends On

Daten (Data)

Permissions

Property Depends On

Datum (Date)

Permissions

Property Depends On

Datum und Uhrzeit (Datatime)

Permissions

Property Depends On

Dauer (Duration)

Permissions

Property Depends On

Dynamische VerknüVerknüpfung (Dynamic Link)

Permissions

Property Depends On

Gleitkommazahl (Float)

Permissions

Property Depends On

Falz (Fold)

Permissions

Property Depends On

Geolokalisierung (Geolocation)

Permissions

Property Depends On

ÜÜberschrift (Heading)

Permissions

Property Depends On

HTML

Permissions

Property Depends On

HTML Editor

Permissions

Property Depends On

Symbol (Icon)

Permissions

Property Depends On

Bild (Image)

Permissions

Property Depends On

Int

Permissions

Property Depends On

VerknüVerknüpfung (Link)

Permissions

Property Depends On

Langer Text (Long Text)

Permissions

Property Depends On

Markdown Editor

Permissions

Property Depends On

Passwort (Password)

Permissions

Property Depends On

Prozent (Percent)

Permissions

Property Depends On

Read Only

Permissions

Property Depends On

Wertung (Rating)

Permissions

Property Depends On

Abschnittswechsel (Section Break)

Permissions

Property Depends On

AuswäAuswählen (Select)

Permissions

Property Depends On

Kleiner Text (Small Text)

Permissions

Property Depends On

Tabelle (Table)

Permissions

Property Depends On

Tabelle MultiSelect (Table MultiSelect)

Permissions

Property Depends On

Text

Permissions

Property Depends On

Text Bearbeiter (Text Editor)

Permissions

Property Depends On

Zeit (Time)

Permissions

Property Depends On

Signatur (Signature)

Permissions

Property Depends On

Naming

In diesem Abschnitt bestimmen wir wie das DocType bei der Erstellen benannt wird. Dies reprärepräsentiert die ID wie sie in der Datenbank hinterlegt wird.

Bezeichnung	Feldname	ErkläErklärung
Auto Name		Reserviert sind: hash
Name Case
Allow Rename
Description
Documentation Link

Formulateinstellungen (Form Settings)

In diesem Abschnitt kökönnen wir z.B. bestimmen, ob der DocType ein Bild tragen soll, wie viele AnhäAnhänge angehäangehängt werden kökönnen und einiges mehr.

Bezeichnung	Feldname	ErkläErklärung
Bildfeld	image_field	Hier kökönnen wir bestimmen welches Feld vom Typ FIXME aus der Feldertabelle als Bild füfür das DocType verwendet werden soll. Das Bild wird links oben angezeigt
Timeline-Feld	time_line_field	Funktion aktuell unklar/tut nicht was es soll
Maximale Anzahl an AnhäAnhängen	max_no_of_attachments	Hier kökönnen wir mit einer Ganzzahl bestimmen wie viele AnhäAnhänge an eine Instanz des DocTypes angehäangehängt werden düdürfen. Lassen wir es leer ist kein Limit gesetzt.
Seitenleiste und MenüMenü ausblenden
Kopie ausblenden
Import erlauben (mit Datenimport-Werkzeug
Ereignisse in der Zeitleiste zulassen		Aktivieren wir die, kökönnen wir am unteren Ende des DocTypes Ereignisse (Termine) erstellen
Automatische Wiederholung zulassen
Anhä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

Bezeichnung	Feldname	Erklä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äausgewählte VerknüVerknüpfungen im DocType nicht üübersetzt. Ist die Option aktiviert wird der Titel des DocTypes bei der Auswahl in der Maske üübersetzt. Detailierte ErkläErklärung
Search Fields	search_fields	Hier kökönnen wir kommagetrennt Feldnamen angeben, welche in der Suche auftauchen.
Default Print Format	default_print_format	Hier kökönnen wir ein Druckformat verknü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üfür Aufsteigend DESC fü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ö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ä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üü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ökönnen wir RückverknüRückverknüpfungen einstellen. Wollen wir in diversen DocTypes RückverknüRückverknüpfungen haben kökönnen wir dies hier einstellen.

Web View

ErkläErklärungen

View Settings

Title Field

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

ÜÜber das Title Field kökönnen wir bestimmen, welcher Inhalt anstelle der Datenbank ID verwendet werden soll. Dies erhöerhöht die Lesbarkeit füfür uns Menschen im System.

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üunberührt.

Beispiel Verkaufsphase (Sales Stage)

Wir erstellen vom DocType Verkaufsphase einen Eintrag der klar englisch gekennzeichnet ist, indem wir im Titel EN nutzen.

Zu diesem erstellen wir eine ÜÜbersetzung.

WäWählen wir in einer neuen Chance den Eintrag finden wir diesen in der Suche. Er ist weiterhin in englisch.

Der Eintrag Sales Stage EN wird, obwohl die Systemsprache deutsch ist und eine ÜÜbersetzung existiert nicht üübersetzt.

Wurde der Eintrag ausgewäausgewählt ist er weiterhin english.

In diesem Bild ist die Maske in Deutsch und die Verknü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ügewünscht üübersetzt.

Die Checkbox im Feld Translate Link Field wird gesetzt um die VerknüVerknüpfungen üübersetzbar zu machen.

Die Maske ist auf deutsch eingestellt und die Verknü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üVerknüpfung üübernimmt

Die Maske ist auf englisch eingestellt und die Verknü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.

Tabellen kökönnen nicht als search_field gesetzt werden!

Email Settings

Dokumenterstellung per E-Mail zulassen

Absenderfeld

Themenfeld

Hilfe Artikel

• https://phamos.eu/kb/customizing
• https://phamos.eu/kb/core