Beheer van koppeling links--relation-between-tables
Een koppeling beschrijft de koppeling tussen de ene tabel en de andere.
Hieronder worden ook de soorten verenigingen genoemd, die ook kardinaliteiten worden genoemd.
- Kardinaliteit 1-1: één instantie van de brontabel kan maximaal één overeenkomende instantie van de doeltabel hebben.
- Kardinaliteit 1-N: één voorkomen van de bronlijst kan verscheidene overeenkomstige voorkomen van de doellijst hebben, maar één voorkomen van de doellijst kan hoogstens één overeenkomstige voorkomen van de bronlijst hebben.
- Kardinaliteit N-N: één instantie van de brontabel kan meerdere corresponderende instanties van de doeltabel hebben, en omgekeerd.
In de gebruikersinterface worden kardinaliteiten weergegeven met een specifiek pictogram.
Voor het samenvoegen van relaties met een tabel/database voor campagnes:
-
-
-
Voor join-relaties met FDA (Federated Database Access):
-
-
Voor meer informatie over lijsten FDA, verwijs naar Toegang hebbend tot een extern gegevensbestand.
Een koppeling moet worden gedeclareerd in het schema met de externe sleutel van de tabel die is gekoppeld via het hoofdelement:
<element name="name_of_link" type="link" target="key_of_destination_schema">
<join xpath-dst="xpath_of_field1_destination_table" xpath-src="xpath_of_field1_source_table"/>
<join xpath-dst="xpath_of_field2_destination_table" xpath-src="xpath_of_field2_source_table"/>
...
</element>
Koppelingen voldoen aan de volgende regels:
-
De definitie van een verbinding is ingegaan op a verbinding - type
<element>met de volgende attributen:-
naam: naam van verbinding van de bronlijst
-
doel: naam van doelschema
-
etiket: etiket van verbinding
-
revLink (facultatief): naam van omgekeerde verbinding van het doelschema (die automatisch door gebrek wordt afgetrokken)
-
integriteit (facultatief): referentiële integriteit van het voorkomen van de bronlijst aan het voorkomen van de doellijst.
Mogelijke waarden zijn:- bepaalt: het is mogelijk om het bronvoorkomen te schrappen als het niet meer door een doelvoorkomen van verwijzingen wordt voorzien
- normaal: het schrappen van de broninstantie initialiseert de sleutels van de verbinding aan het doelvoorkomen (standaardwijze), initialiseert dit type van integriteit alle buitenlandse sleutels
- eigen: het schrappen van de broninstantie leidt tot de schrapping van het doelvoorkomen
- eigen exemplaar: het zelfde als (in het geval van schrapping) of dupliceert de voorkomen (in het geval van verdubbeling)
- neutraal: geen specifiek gedrag
-
revIntegrity (facultatief): integriteit op het doelschema (facultatief, "normaal"door gebrek)
-
revCardinality (facultatief): met waarde "enkel"bevolkt kardinaliteit met type 1-1 (1-N door gebrek)
-
externalJoin (facultatief): forceert buitenste zich aansluit
-
revExternalJoin (facultatief): krachten buitensluit zich op de omgekeerde verbinding aan
-
-
Een koppeling verwijst naar een of meer velden van de brontabel naar de doeltabel. De velden waaruit de samenvoeging bestaat (
<join>-element) hoeven niet te worden gevuld, omdat ze standaard automatisch worden afgetrokken met de interne sleutel van het doelschema. -
Er wordt automatisch een index toegevoegd aan de externe sleutel van de koppeling in het uitgebreide schema.
-
Een verbinding bestaat uit twee half-verbindingen, waar het eerste van het bronschema wordt verklaard en het tweede automatisch in het uitgebreide schema van het doelschema wordt gecreeerd.
-
Verbinden kan buiten zijn toetreden als externalJoin attribuut wordt toegevoegd, met de waarde "waar"(gesteund in PostgreSQL).
Voorbeeld: omgekeerde koppeling example-1
In het onderstaande voorbeeld declareren we een 1-N relatie tot de schematabel "cus:company":
<srcSchema name="recipient" namespace="cus">
<element name="recipient">
...
<element label="Company" name="company" revIntegrity="define" revLabel="Contact" target="cus:company" type="link"/>
</element>
</srcSchema>
Het gegenereerde schema:
<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
<element name="recipient" sqltable="CusRecipient">
<dbindex name="companyId">
<keyfield xpath="@company-id"/>
</dbindex>
...
<element label="Company" name="company" revLink="recipient" target="cus:company" type="link">
<join xpath-dst="@id" xpath-src="@company-id"/>
</element>
<attribute advanced="true" label="Foreign key of 'Company' link (field 'id')" name="company-id" sqlname="iCompanyId" type="long"/>
</element>
</schema>
De koppelingsdefinitie wordt aangevuld met de velden waaruit de verbinding bestaat, d.w.z. de primaire sleutel met zijn XPath ("@id") in het doelschema en de buitenlandse sleutel met zijn XPath ("@company-id") in het schema.
De buitenlandse sleutel wordt automatisch toegevoegd in een element dat de zelfde kenmerken zoals het bijbehorende gebied in de bestemmingslijst, met de volgende noemende overeenkomst gebruikt: naam van doelschema dat door naam van bijbehorend gebied ("bedrijf-identiteitskaart"in ons voorbeeld) wordt gevolgd.
Uitgebreid schema van het doel ("cus:company"):
<schema mappingType="sql" name="company" namespace="cus" xtkschema="xtk:schema">
<element name="company" sqltable="CusCompany" autopk="true">
<dbindex name="id" unique="true">
<keyfield xpath="@id"/>
</dbindex>
<key internal="true" name="id">
<keyfield xpath="@id"/>
</key>
...
<attribute desc="Internal primary key" label="Primary key" name="id" sqlname="iCompanyId" type="long"/>
...
<element belongsTo="cus:recipient" integrity="define" label="Contact" name="recipient" revLink="company" target="nms:recipient" type="link" unbound="true">
<join xpath-dst="@company-id" xpath-src="@id"/>
</element>
</element>
</schema>
Er is een omgekeerde koppeling naar de tabel "cus:receiving" toegevoegd met de volgende parameters:
- naam: automatisch afgetrokken van de naam van het bronschema (kan met het "revLink"attribuut in de verbindingsdefinitie op het bronschema worden gedwongen)
- revLink: naam van omgekeerde verbinding
- doel: sleutel van verbonden schema ("focus:ontvankelijk"schema)
- niet geconsolideerd: de verbinding wordt verklaard als inzamelingselement voor een kardinaliteit 1-N (door gebrek)
- integriteit: "bepaal"door gebrek (kan met het "revIntegrity"attribuut in de verbindingsdefinitie op het bronschema worden gedwongen).
Voorbeeld: eenvoudige koppeling example-2
In dit voorbeeld, verklaren wij een verbinding aan de "nms:adres"schemalijst. De join is een outer join en wordt expliciet gevuld met het e-mailadres van de ontvanger en het veld "@address" van de gekoppelde tabel ("nms:address").
<srcSchema name="recipient" namespace="cus">
<element name="recipient">
...
<element integrity="neutral" label="Info about email" name="emailInfo" revIntegrity="neutral" revLink="recipient" target="nms:address" type="link" externalJoin="true">
<join xpath-dst="@address" xpath-src="@email"/>
</element>
</element>
</srcSchema>
Voorbeeld: unieke kardinaliteit example-3
In dit voorbeeld maken we een 1-1 relatie met de schematabel "cus:extension":
<element integrity="own" label="Extension" name="extension" revCardinality="single" revLink="recipient" target="cus:extension" type="link"/>
Voorbeeld: koppelen naar een map example-4
In dit voorbeeld wordt een koppeling naar een map gedeclareerd ("xtk:folder"-schema):
<element default="DefaultFolder('nmsFolder')" label="Folder" name="folder" revDesc="Recipients in the folder" revIntegrity="own" revLabel="Recipients" target="xtk:folder" type="link"/>
De standaardwaarde retourneert de id van het eerste toepasselijke parametertype-bestand dat is ingevoerd in de functie "DefaultFolder('nmsFolder')".
Voorbeeld: een sleutel maken op een koppeling example-5
In dit voorbeeld, creëren wij een sleutel op een verbinding ("bedrijf"aan "focus:bedrijf"schema) met het xlink attribuut en een gebied van de ("e-mail") lijst:
<srcSchema name="recipient" namespace="cus">
<element name="recipient">
<key name="companyEmail">
<keyfield xpath="@email"/>
<keyfield xlink="company"/>
</key>
<attribute name="email" type="string" length="80" label="Email" desc="Recipient email"/>
<element label="Company" name="company" revIntegrity="define" revLabel="Contact" target="cus:company" type="link"/>
</element>
</srcSchema>
Het gegenereerde schema:
<schema mappingType="sql" name="recipient" namespace="cus" xtkschema="xtk:schema">
<element name="recipient" sqltable="CusRecipient">
<dbindex name="companyId">
<keyfield xpath="@company-id"/>
</dbindex>
<dbindex name="companyEmail" unique="true">
<keyfield xpath="@email"/>
<keyfield xpath="@company-id"/>
</dbindex>
<key name="companyEmail">
<keyfield xpath="@email"/>
<keyfield xpath="@company-id"/>
</key>
<attribute desc="Email address of recipient" label="Email" length="80" name="email" sqlname="sEmail" type="string"/>
<element label="Company" name="company" revLink="recipient" target="sfa:company" type="link">
<join xpath-dst="@id" xpath-src="@company-id"/>
</element>
<attribute advanced="true" label="Foreign key of link 'Company' (field 'id')" name="company-id" sqlname="iCompanyId" type="long"/>
</element>
</schema>
De definitie van de naamsleutel "companyEmail" is uitgebreid met de buitenlandse sleutel van de koppeling "bedrijf". Met deze sleutel wordt een unieke index voor beide velden gegenereerd.