Zusätzliche Schaltflächen in der Kontierung

Über der Kontierungstabelle stehen standardmässig diese Schaltflächen:

neue Kontierungs-Position hinzufügen,
Kontierungs-Vorlage auswählen,
Restbetrag auf die vorhandenen Positionen gleichmässig verteilen,
Restbetrag im bestehenden Verhältnis verteilen.

Weitere Schaltflächen richtest du über Einträge in der Tabelle conf.IrMenuEntry ein. Ein Klick darauf löst im Backend eine Aktion aus, die der Validierungs-Manager (IrValidationManager oder eine kundenspezifische Ableitung) anhand ihres Namens ausführt.

Eintrag in conf.IrMenuEntry

Spalte	Inhalt
`Type`	`AccountingMenu`. Daran erkennt der invoiceR, dass der Eintrag in die Kontierungs-Toolbar gehört.
`DisplayName`	Schlüssel der Übersetzung für die Beschriftung
`PermissionName`	Berechtigung, die ein Benutzer für die Schaltfläche braucht
`Icon`	Name eines DevExtreme-Icons
`RoleId`	optional: nur für Mitglieder dieser Rolle
`ActionName`	Name der Aktion, an dem das Backend sie erkennt
`ShowFileUpload`	`true`, wenn vor der Aktion ein Fenster zum Hochladen einer Datei erscheinen soll
`AllowedFileExtensions`	erlaubte Dateitypen (MIME-Typen, kommagetrennt) für den Upload
`AskForConfirmation`	`true`, wenn vor der Aktion eine Rückfrage erscheinen soll. Wirkt nicht zusammen mit `ShowFileUpload`.

Beispiel: Kontierungs-Positionen aus Excel importieren

Mit der Aktion UploadToAccountingLines lädt ein Benutzer eine Excel-Datei hoch, und der invoiceR legt daraus Kontierungs-Positionen an.

Schaltfläche

Lege in conf.IrMenuEntry einen Eintrag mit diesen Werten an:

Spalte	Wert
`Type`	`AccountingMenu`
`ActionName`	`UploadToAccountingLines`
`DisplayName`	`AccountingToolbarButtonExcelUpload` („Kontierung aus Excel Upload hinzufügen“)
`PermissionName`	`Actions.Accounting.AllowExcelUpload`
`Icon`	`xlsxfile`
`ShowFileUpload`	`true`
`AskForConfirmation`	`false`
`AllowedFileExtensions`	`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`

Gib der Rolle der Kontierer anschliessend die Berechtigung Excel Upload zur Massenkontierung (Actions.Accounting.AllowExcelUpload).

Zuordnung der Spalten

Wie die Excel-Spalten auf die Kontierungs-Position abgebildet werden, steht in einem Eintrag in conf.IrManagers:

Spalte	Wert
`Id`	neue GUID
`Enabled`	`true`
`InterfaceIdentifier`	`web_manager.EnioService.IrCaseLineGenerator.IIrCaseLineGeneratorManager`
`ClassIdentifier`	`enio.tool.Plugin.IrCaseLineGenerator.IrCaseLineGeneratorManager_fromXLSX`
`ConfigurationIdentifier`	`web_manager.EnioService.IrCaseLineGenerator.IrCaseLineGeneratorArgument`
`Configuration`	die Zuordnung als JSON, siehe unten
`Description`	zum Beispiel „Kontierungszeile aus Excel“

Die Konfiguration nennt die erste Datenzeile (die erste Zeile der Datei ist 1) und die Spalten (die erste Spalte ist 0):

{
  "FirstLineOfMapping": 2,
  "AccountingFormId": "<Id des Kontierungs-Formulars aus conf.AccountingForms>",
  "CostcenterColumn": 0,
  "AccountColumn": 1,
  "ProjectColumn": 2,
  "GrossAmountColumn": 3,
  "VatCodeColumn": 4,
  "PostingTextColumn": 5
}

Eintrag	Bedeutung
`FirstLineOfMapping`	erste Zeile mit Daten
`AccountingFormId`	Formular, mit dem die neuen Positionen angelegt werden
`CostcenterColumn`, `AccountColumn`, `ProjectColumn`	Spalten mit Kostenstellen-, Konto- und Projektnummer
`GrossAmountColumn`, `NetAmountColumn`, `VatCodeColumn`, `VatRateColumn`	Beträge und MwSt. Zwei der drei Angaben Brutto, Netto und MwSt-Code genügen.
`PostingTextColumn`	Spalte mit dem Buchungstext
`AdditionalStr1Column` bis `AdditionalStr5Column`	optionale Zusatzfelder