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.
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.
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)
| 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
|
| 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
|
| 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
|
| 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:
|
| Spalten |
Columns | |
| Beschreibung |
Description |
Hier kann eine Feldbeschreibung eingestellt werden, welche für den Nutezer in der UI sichtbar ist:
Dies ist auch HTML fähig! |
Bild anhängen (Attach Image)
Permissions
Property Depends On
Barcode
Permissions
Property Depends On
Schaltfläche (Button)
Permissions
Property Depends On
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ä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ü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ü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ä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äsentiert die ID wie sie in der Datenbank hinterlegt wird.
| Bezeichnung |
Feldname |
Erklärung |
| Auto Name |
Reserviert sind:
|
|
| 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.
| 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
|
| 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
|
|
| 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
| 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. |
| 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.
|
| Show in Module Section |
Auswahl aus
|
|
| 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
Ü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.
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.
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ä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ählt ist er weiterhin english.
In 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.
Die Checkbox im Feld Translate Link Field wird gesetzt um die Verknüpfungen übersetzbar zu machen.
Die 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
Die 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.
Tabellen können nicht als search_field gesetzt werden!
Email Settings
Dokumenterstellung per E-Mail zulassen
