tüit Logo Direkt zum Hauptinhalt

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 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 glichkeit Berichte zu erstellen. Ein Beispiel 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üverknüpfen 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 nnen.

image-1654776147809.png

Typ (Type)

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

Weiter üüberschneiden sich einige Felder, welche Optionen 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)

image-1672430380732.png

image-1672430499609.png

Bezeichnung
Feldname
ErkläErklärung
Bezeichnung label

Typ Type

Name Name

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 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 

image-1673938809517.png

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

image-1675176135416.png

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 ngt von ab
Mandatory Depends On
Nur lesen ngt von ab
Read Only Depends On

anzeigen (display)

Bezeichnung
Feldname
ErkläErklärung
Im Filter
In Filter
Keine Kopie
No Copy Ist das 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 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 r den Nutezer in der UI sichtbar ist:

image-1663069306036.png

Dies ist auch HTML hig!

Bild anhäanhängen (Attach Image)

image-1672430583988.png

Permissions

Property Depends On

Display
Barcode

image-1672430617534.png

Permissions

Property Depends On

Display
SchaltfläSchaltfläche (Button)

image-1672430644844.png

Permissions

Property Depends On

Display
Prü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
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ä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ä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 nnen wir z.B. bestimmen, ob der DocType ein Bild tragen soll, wie viele AnhäAnhänge angehäangehängt werden nnen und einiges mehr.

image-1666191982671.png

Bezeichnung
Feldname
ErkläErklärung
Bildfeld
image_field

Hier nnen wir bestimmen welches Feld vom Typ FIXME aus der Feldertabelle als Bild 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äAnhängen
max_no_of_attachments
Hier nnen wir mit einer Ganzzahl bestimmen wie viele AnhäAnhänge an eine Instanz des DocTypes angehäangehängt werden 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, nnen wir am unteren Ende des DocTypes Ereignisse (Termine) erstellen

image-1666196150111.png

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

image-1662388758700.png


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 nnen wir kommagetrennt Feldnamen angeben, welche in der Suche auftauchen.
Default Print Format
default_print_format
Hier 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 r Aufsteigend
  • DESC r Absteigend
Show in Module Section

Auswahl aus

  • Leer
  • Document
  • Setup
  • System
  • Other
Icon


Color


Show Preview Popup
show_preview_popup

Aktivieren wir dies 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 nnen wir RückverknüRückverknüpfungen einstellen. Wollen wir in diversen DocTypes RückverknüRückverknüpfungen haben 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

image-1662388931202.png

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

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äausgewählt ist er weiterhin english.

image-1662813142758.pngIn 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.

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

image-1662813652142.pngDie 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

image-1662813890946.pngDie 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.

image-1662389687960.png

Tabellen nnen nicht als search_field gesetzt werden!

Email Settings

image-1677690397771.png

Dokumenterstellung per E-Mail zulassen

image-1677690491835.png

Absenderfeld

Themenfeld

Hilfe Artikel