ACPFieldConcat

Beschreibung - ServerPlugin

Das FieldConcat ServerPlugIn kombiniert für 1:n Verknüpfungen alle Werte eines Felds auf der "n" Seite in ein Feld auf der "1" Seite. Das PlugIn reagiert auf Neuanlagen, Updates und Löschungen von Verknüpfungen und Datensätzen beider beteiligten Tabellen. Optional kann ein Filter konfiguriert werden.

Dadurch können z.B. für Listenansichten eine Zusammenfassung von verknüpften Datensätzen in einem einzelnen Feld angezeigt werden (Alle Eigentümer eines Flurstücks oder ähnliches).

Voraussetzungen

Es sind keine zusätzlichen Systemfelder notwendig.

Installation ServerPlugin

Installationsanleitung finden Sie hier

Update ServerPlugin

Updateanleitung finden Sie hier

Konfiguration ServerPlugin

Das ServerPlugin besteht aus zwei Dateien, der "RegisterSDKDataPlugInsCustomConcat.xml" und "WIConfigFieldConcat.xml". In der "RegisterSDKDataPlugInsCustomConcat.xml" wird konfiguriert auf welche Tabellen das Plugin reagieren soll und in der "WIConfigFieldConcat.xml" wird konfiguriert was passieren soll.

RegisterSDKDataPlugInsCustomConcat.xml

1. Im Datei-Explorer folgenden Pfad öffnen:

   C:\Program Files (x86)\Common Files\CAS-Software\Server
   

2. Datei "RegisterSDKDataPlugInsCustomConcat.xml" bearbeiten.

Beispiel

<sdkdataplugins>
    <partner name="ACP">
        <sdkdataplugin tablename="TABLERELATION">{505B4C6F-97FC-4609-A420-D45D919C6F6F}</sdkdataplugin>
        <sdkdataplugin tablename="PROJECT">{505B4C6F-97FC-4609-A420-D45D919C6F6F}</sdkdataplugin>           
    </partner>
</sdkdataplugins>

Beschreibung

• sdkdataplugin tablename:
  • Beschreibung: Name der Tabelle auf die das ServerPlugin reagieren soll. (GUID ist immer dieselbe)
  • Mögliche Werte: PROJECT; ADDRESS; etc.

WIConfigFieldConcat.xml

1. Im Datei-Explorer folgenden Pfad öffnen:

   C:\Program Files (x86)\Common Files\CAS-Software\Server
   

2. Datei "WIConfigFieldConcat.xml" bearbeiten. Beispiel

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<fieldConcat>
    <relations>
        <relation name="WI_FLR2ADR_07">
            <sourceTable>ADDRESS</sourceTable>
            <sourceField>WI_BEZEICHNUNG</sourceField>
            <targetTable>WI_FLURSTUECKE</targetTable>
            <targetField>WI_EIGENTUEMER</targetField>
            <targetSeparator>;</targetSeparator>
        </relation>
        <relation name="WI_VRT2FLR_01">
            <sourceTable>WI_VERTRAG</sourceTable>
            <sourceField uniqueFieldInputValues="true">WI_VERT_GEGENSTAND</sourceField>
            <sourceFilter><![CDATA[(GWSTYPE = 'Nutzungsvertrag') and (GWSSTATUS = 'unterzeichnet')]]></sourceFilter>
            <sourceUpdateFieldList>GWSTYPE;GWSSTATUS</sourceUpdateFieldList>
            <targetTable>WI_FLURSTUECKE</targetTable>
            <targetField>WI_NUTZUNGSRECHTE_AGGREGIERT</targetField>
            <targetSeparator>,</targetSeparator>
        </relation>
        <relation name="WI_VRT2FLR_01">
            <sourceTable>WI_VERTRAG</sourceTable>
            <sourceField uniqueFieldInputValues="true" uniqueSeparator=";">WI_VERT_GEGENSTAND_SONST</sourceField>
            <sourceFilter><![CDATA[(GWSTYPE = 'Nutzungsvertrag') and (GWSSTATUS = 'unterzeichnet')]]></sourceFilter>
            <sourceUpdateFieldList>GWSTYPE;GWSSTATUS</sourceUpdateFieldList>
            <targetTable>WI_FLURSTUECKE</targetTable>
            <targetField>WI_NUTZUNGSRECHTE_AGGREGIERT</targetField>
            <targetSeparator>;</targetSeparator>
    </relation>
    </relations>
</fieldConcat>

Beschreibung

• relation name:
  • Beschreibung: Name der ausgewerteten Verknüpfung
  • Mögliche Werte: Der Systemname einer beliebigen 1:n Verknüpfung.
• sourceTable:
  • Beschreibung: Quelltabelle
  • Mögliche Werte: Der Systemname der Tabelle auf der "n" Seite der konfigurierten Verknüpfung.
• sourceField:
  • Beschreibung: Quellfeld
  • Mögliche Werte: Der Systemname des Quellfelds auf der konfigurierten Quelltabelle.
  • optionale Attribute:
  • uniqueFieldInputValues: Durch das Attribut uniqueFieldInputValues="true" werden Duplikate verhindert. Der Default Wert ist false und muss nicht in der Konfiguration angegeben werden.
  • uniqueSeparator: Über das Attribut uniqueSeparator kann ein abweichender Separator angegeben werden. Der Default Wert ist "," und muss nicht in der Konfiguration angegeben werden. Dadurch ist es möglich die Prüfung auf einzigartige Feldwerte auch durchzuführen wenn ein Komma im Wert enthalten ist (z.B. Name, Vorname; Name2, Vorname2).
• targetTable:
  • Beschreibung: Zieltabelle
  • Mögliche Werte: Der Systemname der Tabelle auf der "1" Seite der konfigurierten Verknüpfung.
• targetField:
  • Beschreibung: Zielfeld
  • Mögliche Werte: Der Systemname des Zielfelds auf der konfigurierten Zieltabelle.
• targetSeparator:
  • Beschreibung: Trennzeichen
  • Mögliche Werte: ein beliebiges Zeichen zum Trennen der Werte aus dem Quellfeld (z.B. "," oder ";")
• sourceFilter: (Optional)
  • Beschreibung: Filter der auf die "n" Seite der konfigurierten Verknüpfung angewendet wird.
  • Mögliche Werte: eine Filterbedingung im SQL Syntax. Diese wird direkt in ein SQL Statement eingesetzt und muss wegen der XML Syntax daher in ein CDATA Knoten geschrieben werden.
• sourceUpdateFieldList: (Optional, zwingend bei Verwendung von sourceFilter)
  • Beschreibung: Feldliste die bei Updates berücksichtigt werden muss
  • Mögliche Werte: Semikolon getrennte Auflistung aller in in "sourceFilter" verwendeten Felder, damit das PlugIn auf Updates dieser Felder reagieren kann.