ACPFieldAndRelationSync

Beschreibung

Das ACPFieldAndRelationSync ServerPlugIn ermöglicht die Synchronisierung auf Basis von Verknüpfungen zwischen Datensätzen. Neben Feldwerten können auch weitere Verknüpfungen erzeugt werden. Das PlugIn reagiert hierfür auf Neuanlagen und Löschungen von Verknüpfungen sowie auf Updates der beteiligten Datensätze.

Changelog

Changelog hier.

Voraussetzungen

Es sind keine zusätzlichen Systemfelder notwendig. Bei den Feldsynchronisierungen ist darauf zu achten, dass die Typen und Längen der Felder auch synchronisierbar sind.

Installation ServerPlugin

Installationsanleitung finden Sie hier

Update ServerPlugin

Updateanleitung finden Sie hier

Konfiguration ServerPlugin

Die Konfiguration des PlugIn erfolgt über zwei Dateien, "RegisterSDKDataPlugInsACPSync.xml" und "ACPSync.xml".

RegisterSDKDataPlugInsACPSync.xml

ACHTUNG

Der Eintrag "TABLERELATION" ist in allen Fällen zwingend notwendig. Als weitere Tabellen müssen alle erfasst werden, die in der Datei "ACPSync.xml" als keepSynchronized="true" erfasst sind (der "sourceTableName" ist in allen Fällen zwingend notwendig, der Eintrag unter "targetTableName" wird nur benötigt wenn ein entsprechendes Feld für einen reSync konfiguriert ist unter "triggerResyncTargetFieldName") .

Beispiel

<sdkdataplugins>
    <partner name="ACP">
        <sdkdataplugin tablename="TABLERELATION">{7E834BF2-7BB8-426D-B334-084B4DC5AAAC}</sdkdataplugin>
        <sdkdataplugin tablename="PROJECT">{7E834BF2-7BB8-426D-B334-084B4DC5AAAC}</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.

ACPSync.xml

Beispiel

<ACPSync>
    <configVersion>1.0.1.1</configVersion>
    <syncJob triggerRelationName="ITDTSKPRJ" triggerResyncTargetFieldName="WI_PING">
        <table sourceTableName="PROJECT" targetTableName="TASK" sourceTableSign="PRJ" targetTableSign="TSK" keepSynchronized="true">
            <fields>
                <field sourceFieldName="KEYWORD" targetFieldName="KEYWORD"/>
                <field sourceFieldName="WI_TEST" targetFieldName="WI_TEST"/>
                <field sourceFieldName="WI_TEST2" targetFieldName="WI_TEST2"/>
                <field sourceFieldName="WI_TEST3" targetFieldName="WI_TEST3"/>
            </fields>
            <relations>
                <relation sourceRelationName="L2UEXTPROJMAN" sourceRelationTableName="ADDRESS" sourceRelationTableSign="ADR" targetRelationName="WI_TSK2ADR_01"/>
            </relations>
        </table>
    </syncJob>
</ACPSync>

Beschreibung

• syncJob:
  • triggerRelationName:
    • Beschreibung: Name der ausgewerteten Verknüpfung
    • Mögliche Werte: Der Systemname einer beliebigen Verknüpfung.
  • triggerResyncTargetFieldName
    • Beschreibung Änderungen an diesem Feld lösen einen vollständigen Resync dieses Jobs aus (z.B. zur Nachpflege von Bestandsdaten)
    • Mögliche Werte Name des Felds auf der TargetTable das den Resync auslöst
• table:
  • sourceTableName:
    • Beschreibung: Quelltabelle
    • Mögliche Werte: Der Systemname der Tabelle auf der lesenden Seite der Synchronisierung.
  • sourceTableSign:
    • Beschreibung: Kürzel der Quelltabelle
    • Mögliche Werte: Das Kürzel der Tabelle auf der lesenden Seite der Synchronisierung.
  • targetTableName:
    • Beschreibung: Zieltabelle
    • Mögliche Werte: Der Systemname der Tabelle auf der schreibenden Seite der Synchronisierung.
  • targetTableSign:
    • Beschreibung: Kürzel der Zieltabelle
    • Mögliche Werte: Das Kürzel der Tabelle auf der schreibenden Seite der Synchronisierung.
  • keepSynchronized
    • Beschreibung: steuert die Synchronisierung nach der initialen Übertragung
    • Mögliche Werte:
      • true: Updates auf die "sourceTableName" und Löschungen von Verknüpfungen werden synchronisiert;
      • false: Nur initiale Übertragung bei Anlage der Verknüpfung unter "triggerRelationName", Updates und Löschungen werden nicht behandelt (einmaliges Abbild bei Anlage, z.B. bei Belegen)
• fields/field:
  • sourceFieldName:
    • Beschreibung: Name des Felds auf der lesenden Seite der Synchronisierung
    • Mögliche Werte: Der technische Name des Felds auf der Tabelle die unter "sourceTableName" konfiguriert ist
  • targetFieldName:
    • Beschreibung: Name des Felds auf der schreibenden Seite der Synchronisierung
    • Mögliche Werte: Der technische Name des Felds auf der Tabelle die unter "targetTableName" konfiguriert ist
• relations/relation:
  • sourceRelationName:
    • Beschreibung: Name der Quellverknüpfung
    • Mögliche Werte: Der technische Name der Verknüfung die als Grundlage für die neue Verknüpfung unter "targetRelationName" dient
  • sourceRelationTableName:
    • Beschreibung: Name der Quelltabelle der Quellverknüpfung
    • Mögliche Werte: Der technische Name der Tabelle, die als Quelle in der vorhandenen Verknüfung dient
  • sourceRelationTableSign:
    • Beschreibung: Kürzel der Quelltabelle
    • Mögliche Werte: Das Kürzel der Tabelle, die als Quelle in der vorhandenen Verknüpfung dient
  • targetRelationName:
    • Beschreibung: Name der Zielvernküpfung
    • Mögliche Werte: Der technische Name der neu anzulegenden Verknüpfung