Stammdaten
Es wird davon ausgegangen, dass die Stammdaten bei einer Standardintegration nur gelesen werden. Somit ist nur wenig Verständnis über die internen Strukturen von VinX notwendig. Es wird empfohlen, sich für einen überblick die allgemeine VinX-Doku anzuschauen (https://i-ag.atlassian.net/wiki/x/AoAo).
Die Details der einzelnen Entitäten werden hier nicht generell beschrieben. Dies kann über die Abfrage der Metadaten der jeweiligen Entität erfolgen (siehe auch https://i-ag.atlassian.net/wiki/x/7wDu). Die meisten Installationen haben auch kundenindividuelle Erweiterungen, die so am einfachsten ermittelt werden können.
Alle Felder, die auf "ID" enden, sind Fremdschlüssel. Eine Abfrage der Metadaten gibt Auskunft über die Herkunftsentität.
Look-Up Werte
Es gibt Felder, die nicht selbsterklärend sind, wie z.B. ein numerischer Adresstyp. Diese Daten werden hier in kondensierter Form erläutert:
Entität | Feld | Datentyp | Beschreibung |
---|---|---|---|
Adresse | Mahncode | int | 10: Keine Mahnung drucken |
MWSTVerrechnung | int | 1: Inklusive | |
Sprache | string[2] | [DE, FR, IT, EN] | |
PreiseKonditionen | int | 10: Preise und Konditionen von Rechnungsadresse holen | |
SteuerlagerTyp | int | 0: Versteuert | |
Artikel | ArtikelinfoCode | int | 10: Keine Meldung |
Artikeltyp | int | 2: Wein | |
Rueckverguetung | int | 10: Nicht Bonusberechtigt | |
Beleg | Belegstatus | int | 10: Neu |
BelegartID | int | -50: Kreditor-Rechnung | |
VKSPezPreis | Berechungsart | int | 1: % 2: Betrag |
Prädestinierte Startpunkte für die Erkundung der Stammdaten sind die Entitäten Artikel und Adresse. Über die links-Eigenschaften in den Metadaten kann zu jeder verknüpften Entität navigiert werden.
Views
Werden Daten nur lesend gebraucht, können sie problemlos denormalisiert und vereinfacht dargestellt werden. Dies wird über Views erreicht. Dies sind in VinX vordefinierte Abfragen, die Daten aus allen Entitäten zusammensuchen, gruppieren, summieren etc. können.
Aktuell existieren diverse kundenspezifische Abfragen. Da alle ähnliche Bedürfnisse haben, wird zur Zeit der gemeinsame Nenner zusammengetragen und im Standard zur Verfügung gestellt.
Es kann sein, dass die Views Felder enthalten, die hier nicht explizit aufgeführt sind, oder im Verlauf der weiteren Entwicklung Felder dazu kommen. Bestehende Felder werden aus Gründen der Abwärtskompatibilität aber nicht verändert.
Folgende Views stehen zur Verfügung:
QListArtikelBase
Aufruf
URI | Methode |
---|---|
./view/QListArtikelBase | GET |
Beispielaufruf: ./view/qlistartikelbase?fields=aktiv,artikelnummer,bezeichnung&aktiv=true |
Felder
Feld | Abfrage / Herkunft | Typ | FilterName | Filter | Info |
---|---|---|---|---|---|
ID | Artikel.id | key | ID | MO | |
AbfuellungID | Artikel.AbfuellungID | ref | FK ./Abfuellung | ||
AbfuellungInhaltInCl | Artikel/Abfuellung.InhaltInCl | num[20,8] | |||
AbfuellungKuerzel | Artikel/Abfuellung.Kuerzel | string[20] | |||
AbfuellungSuchbegriff | Artikel/Abfuellung.Suchbegriff | string[30] | |||
AbfuellungPreis | Artikel/Abfuellung/GebindeArtikel.Grundpreis | num[20,4] | |||
Aktiv | Artikel.Aktiv | bool | Aktiv | EO | |
ArtikelNummer | Artikel.Artikelnummer | num[20,4] | ArtikelNummer | MO | |
Bezeichnung | Artikel.Bezeichnung | string[2G] | Ist mehrsprachig | ||
Bestand | Artikel/Lagerbestand.Sum(Bestand) | num[20,4] | |||
DatumErfassung | Artikel.DatumErfassung | date | |||
DatumMutation | Artikel.DatumMutation | date | |||
EAN1 | Artikel.EAN1 | num[12] | |||
GrossgebindeID | Artikel.GrossgebindeID | ref | FK ./Grossgebinde | ||
Grundpreis | Artikel.Grundpreis | num[20,4] | |||
Kategorie | Artikel/Artikelkategorie.Bezeichnung | string[24] | |||
MWSTID | Artikel.MWSTID | ref | FK ./MWST | ||
MWSTProzent | Artikel/MWST.Prozent | num[4,2] | |||
Suchbegriff | Artikel.Suchbegriff | string[30] | Suchbegriff | ET | |
EinhProGG | Artikel/Grossgebinde.EinhProGG | num[20,8] | GG = Grossgebinde | ||
KuerzelGG | Artikel/Grossgebinde.Kuerzel | string[20] | |||
SuchbegriffGG | Artikel/Grossgebinde.Suchbegriff | string[30] | |||
PreisInklAbfDepotGG | Artikel/Grossgebinde.InklAbfDepot | bool | |||
AnbruchErlaubtGG | Artikel/Grossgebinde.AnbruchErlaubt | bool | |||
PreisGG | Artikel/Grossgebinde/GebindeArtikel.Grundpreis | num[20,4] |