Invoice-Parameter

Invoice enthält in der Auslieferung viele Standard-Prüfungen mit Standard-Einstellungen und viele von diesen Einstellungen können über Parameter verändert werden. Hierdurch erspart sich der Consultant Programmieraufwand. Ein Parameter hat einen technischen Namen und eine Kurzbeschreibung. Die Standard-Konfiguration für die mit dem Standard ausgelieferten Parameter kann nicht verändert werden! Bei einem Klick auf das Stift-Symbol erscheint eine entsprechende Fehlermeldung. Bei der Anlage projektspezifischer Parameter wird die Checkbox "Projektspezifisch?" gesetzt. Über die Spalte "Seit Version" wird die Invoice-Versions-Nummer angegeben, ab welcher der Parameter zur Verfügung steht.

Parameter-Werte

Pro Parameter können bis zu 3 Werte definiert werden. Durch einen Doppelklick auf einen Parameter öffnet sich eine neue Ansicht zur Angabe der Parameter-Werten. Die Funktion der einzelnen Parameter-Werte wird in dieser Ansicht genauer beschrieben. die Beschreibung enthält auch den Standard-Wert und den Typ des Standard-Werts.

Bei der Angabe eines neuen Eintrags muss zu jedem Parameter-Wert eine Angabe erfolgen! Wenn nur ein Wert vom Standard abweicht müssen die anderen beiden Werte auf die Standard-Werte gesetzt werden! Damit für unterschiedliche Belege unterschiedliche Parameter-Werte greifen können pro Eintrag bis zu 3 Feldwerte abgefragt werden. Sobald alle Feld-Abfragen zutreffen werden die Parameter-Werte der Zeile verwendet. Falls kein spezifischer Eintrag zutrifft greifen die Standard-Werte. Die Einträge werden nach absteigender Gewichtung überprüft.

Die Standard-Parameter und die projektspezifischen Parameter können in den projektspezifischen Skripten verwendet werden. Das folgende Beispiel zeigt wie alle 3 Parameter-Werte zu einem Parameter ermittelt werden können. Der jeweilige Standard-Wert wird explizit nochmal als Wert mitgegeben, damit die Funktion selbst dann noch den korrekten Wert zurückliefert, wenn der Parameter nicht existiert.

var docFile = context.file;
var paramObj  = docFile.getParamObject("TechnischerParameterName");
var standardValue1 = true;
var standardValue2 = "Standard String";
var standardValue3 = 1.5;
var paramVal1 = docFile.getParamValue(paramObj, 1, standardValue1, "boolean");
var paramVal2 = docFile.getParamValue(paramObj, 2, standardValue2, "string");
var paramVal3 = docFile.getParamValue(paramObj, 3, standardValue3, "decimal");

Globale Parameter

Parameter werden in den meisten Fällen im Kontext einer Rechnung aufgerufen. Einige wenige Parameter werden global ohne einen direkten Bezug zu einer Rechnung verwendet. Bei einem globalen Parameter können die Werte entsprechend nur auf einen fixen Wert ohne Feld-Abfragen und ohne Gewichtung gesetzt werden. Bei den globalen Parametern wird die Checkbox "Globaler Parameter?" gesetzt.

Die globalen Parameter-Werte müssen direkt über das Parameter-Objekt ermittelt werden:

var p = new Param("JobScriptUser", "Invoice");
      p.Value1Specific; // 1st specific value as string
      p.Value2Specific; // 2nd specific value as string
      p.Value3Specific; // 3rd specific value as string