projekt kivitendo

h1. Webmasken individuell anpassen

Ich zeige hier einige Beispiele, wie Eingabemasken in kivitendo den eigenen Bedürfnissen angepasst werden können.
Ziel dabei:
* bessere Übersicht
* weniger Eingabefehler
* schnelleres Arbeiten

Als Beispiel verwende ich die Maske zum Erfassen und Editieren von KundInnen/LieferantInnen.
Die dafür benötigten Dateien finden wir im Pfad
@templates/webpages/customer_vendor/@

h2. Nicht benötigte Felder ausblenden:

Fax-Nummern von KundInnen und LieferantInnen werden nicht benötigt, da kein Fax vorhanden ist:

@./tabs/billing.html, Zeilen 140ff:@
<pre>
<!-- Fax auskommentiert
<tr>
<th align="right" nowrap>[% 'Fax' | $T8 %]</th>

<td>
[% L.input_tag('cv.fax', SELF.cv.fax, size = 30) %]
</td>
</tr>
-->
</pre>

h2. Felder umplatzieren:

Der Kundentyp soll direkt unter dem Kundennamen erscheinen, damit nicht vergessen wird, diesen auszufüllen:

1. ./tabs/billing.html, Zeilen 269ff auskommentieren und <tr> und </tr> Tags versetzen, um "Sprache" und "Lieferbedingungen" eine Zeile nach oben zu verschieben:

@./tabs/billing.html, Zeilen 257ff:@
<pre>
<!-- Tabellenzeilenbeginn nach oben verschoben -->
<tr>
[% IF ( SELF.all_currencies.size ) %]
<!-- <tr> -->
<th align="right">[% 'Currency' | $T8 %]</th>

<td>
[% L.select_tag('cv.currency_id', SELF.all_currencies, title_key = 'name', value_key = 'id', default = SELF.cv.currency_id) %]
</td>
<!-- </tr> -->
[% END %]

<!-- <tr> -->
<!-- Kunden- bzw. Lieferantentyp nach oben verschoben
[% IF ( !INSTANCE_CONF.get_vertreter ) %]
<th align="right">
[% IF ( SELF.is_vendor() ) %]
[% 'Type of Vendor' | $T8 %]
[% ELSE %]
[% 'Type of Customer' | $T8 %]
[% END %]
</th>

<td>
[% L.select_tag('cv.business_id', SELF.all_business, default = SELF.cv.business_id, value_key = 'id', title_key = 'description', with_empty = 1) %]
</td>
[% END %]
-->
<th align="right">[% 'Language' | $T8 %]</th>
</pre>

2. Kundentypfeld hinter Kundennamen einfügen:

@./tabs/billing.html, Zeilen 75ff:@
<pre>
<!-- Kundentyp hier eingefuegt -->
<tr>
[% IF ( !INSTANCE_CONF.get_vertreter ) %]
<th align="right">
[% IF ( SELF.is_vendor() ) %]
[% 'Type of Vendor' | $T8 %]
[% ELSE %]
[% 'Type of Customer' | $T8 %]
[% END %]
</th>

<td>
[% L.select_tag('cv.business_id', SELF.all_business, default = SELF.cv.business_id, value_key = 'id', title_key = 'description', with_empty = 1) %]
</td>
[% END %]
</tr>
</pre>

h2. Benutzerdefinierte Variablen in Hauptseite integrieren

Als benutzerdefinierte Variable wurde definiert: Datenfeldbezeichnung: "Vorname", Datenfeldname: "vorname", Typ: "Textzeile"
Diese soll unter dem Kundennamen, aber über dem neu platzierten Kundentyp eingefügt werden.

1. Benutzerdefinierte Variable "Vorname" in ./tabs/billing.html einfügen:

@./tabs/billing.html, Zeilen 75ff:@
<pre>
<!-- Vorname hier eingefuegt -->
[% FOREACH var = SELF.cv.cvars_by_config %]
[% IF ( var.config.name == 'vorname' ) %]
<tr>
<th align="right" valign="top" nowrap>[% var.config.description | html %]</th>

<td valign="top">
[% INCLUDE 'common/render_cvar_input.html'
cvar_name_prefix = 'cv_cvars.'
var_name = ''
%]
</td>
</tr>
[% END %]
[% END %]
</pre>

=> Da die Ausgabe der benutzerdefinierten Variablen in einer FOREACH-Schleife erfolgt, wird innerhalb der FOREACH-Schleife mit einer IF-Abfrage der gewüschte Datenfeldname abgefragt und nur dann der entsprechende HTML-Code erzeugt.

2. Benutzerdefinierte Variable "Vorname" im Tab "Benutzerdefinierte Variablen" nicht mehr anzeigen:
Dies ist wichtig, da sonst beim Speichern der Wert, der hier in der Maske steht die Eingabe im Haupt-Tab wieder überschreibt!

@./tabs/custom_variables.html, Zeilen 6ff:@
<pre>
[% FOREACH var = SELF.cv.cvars_by_config %]
<!-- Vorname ausschliessen -->
[% IF ( var.config.name != 'vorname' ) %]
<tr>
<th align="right" valign="top" nowrap>[% var.config.description | html %]</th>

<td valign="top">
[% INCLUDE 'common/render_cvar_input.html'
cvar_name_prefix = 'cv_cvars.'
var_name = ''
%]
</td>
</tr>
[% END %]
[% END %]
</pre>
=> Umgekehrtes Vorgehen wie oben: HTML-Ausgabe erfolgt nur, wenn der Datenfeldname ungleich 'vorname'.