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

Felder

Bezeichnung	Feldname	ErklärungErklä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öglichkeitMöglichkeit Berichte zu erstellen. Ein Beispiel fürfü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üpfenverknüpfen können.können.
Editierbares Raster		Nur sichtbar wenn "Ist Untertabelle" aktiviert ist. https://phamos.eu/kb/customizing/editierbares-raster

Felder (Fields)

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

Typ (Type)

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

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

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

Permissions

Bezeichnung	Feldname	ErklärungErklärung
Anzeige ist abhängigabhängig von	Display Depends On
Versteckt	Hidden
SchreibgeschütztSchreibgeschü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ähltengewählten Wert merken
XSS-Filter ignorieren	Ignore XSS Filter

Property Depends On

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

anzeigen (display)

Bild anhängenanhängen (Attach Image)

Permissions

Property Depends On

Barcode

Permissions

Property Depends On

SchaltflächeSchaltfläche (Button)

Permissions

Property Depends On

PrüfenPrü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ährungWä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üpfungVerknü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Ü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üpfungVerknü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ählenAuswä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äsentiertrepräsentiert die ID wie sie in der Datenbank hinterlegt wird.

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

Formulateinstellungen (Form Settings)

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

Bezeichnung	Feldname	ErklärungErklärung
Bildfeld	image_field	Hier könnenkönnen wir bestimmen welches Feld vom Typ FIXME aus der Feldertabelle als Bild fürfü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ängenAnhängen	max_no_of_attachments	Hier könnenkönnen wir mit einer Ganzzahl bestimmen wie viele AnhängeAnhänge an eine Instanz des DocTypes angehängtangehängt werden dürfen.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önnenkönnen wir am unteren Ende des DocTypes Ereignisse (Termine) erstellen
Automatische Wiederholung zulassen
AnhängeAnhänge im Standard als öffentlichöffentlich markieren	Make Attachments Public by Default	Wenn eine Datei hochgeladen wird, wird diese im Standard als öffentlichöffentlich gesetzt.

View Settings

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

Web View

ErklärungenErklärungen

View Settings

Title Field

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

ÜberÜber das Title Field könnenkönnen wir bestimmen, welcher Inhalt anstelle der Datenbank ID verwendet werden soll. Dies erhöhterhöht die Lesbarkeit fürfü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Übersetzung unberührt.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.Übersetzung.

WählenWä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Übersetzung existiert nicht übersetzt.übersetzt.

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

In diesem Bild ist die Maske in Deutsch und die VerknüpfungVerknüpfung zur Verkaufsphase (Sales Stage) in english.

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

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

Die Maske ist auf deutsch eingestellt und die VerknüpfungVerknüpfung wird ebenfalls deutsch angezeigt, da eine ÜbersetzungÜbersetzung existiert.

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

Die Maske ist auf englisch eingestellt und die VerknüpfungVerknüpfung wird in englisch angezeigt.

Search Fields

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

Tabellen könnenkö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