====== AddLookupKeyValue ======

Die Funktion **AddLookupKeyValue()** legt den Wert, wenn es ihn noch nicht gibt, als [[transformation:werteprovider:start]]((ValueProvider Entry)) an und ordnet ihn dem [[transformation:wertetabellentypen:anlegen|LookupTableKey]] zu, bzw. ändert den Value bei vorhandenem LookupTableKey.

{{:images:sign_warning.png|}}**Hinweis:** Bestehende Lookup Key-Value Paare werden mit dem neuen Value aktualisiert.

{{:images:sign_warning.png|}}**Hinweis:** Diese Funktion ist im [[transformation:mappings:debug|DEBUG]] Modus inaktiv. 


==== Syntax: ====

<code>AddLookupKeyValue('LookupTable', 'LookupTableKey', 'ValueProviderValue')</code>

==== Beispiel 1: ====

<code>AddLookupKeyValue('Hersteller-Haendler-Farben', '47A11', '992855')</code>


==== Beispiel 2: ====
Mit dieser Funktion lassen sich z.Bsp. Informationen im Konverter zwischenlagern, welche nicht über ein Hostsystem verarbeitet werden können. Der Handelspartner sendet hier ORDERS mit einer spezifischen Referenz die nicht in der ORDERS(INHOUSE) Platz hat.

**Vorbedingungen:**
Legen Sie einen [[transformation:werteprovider:start]]((ValueProvider)) an welcher die Referenzen aufnehmen kann. Dann lege Sie einen [[transformation:wertetabellentypen:start]] an und weisen diesem den vorher angelegten [[transformation:werteprovider:start]]((ValueProvider)) zu. Anschließend legen Sie hier noch eine neue [[transformation:wertetabellentypen:anlegen|LookupTable]] an. Geben Sie diesen Objekten einen sprechenden Namen(Hier im Beispiel wird 'MyLookUpTableName' für alle Objekte verwendet.).

Die Referenz kann nun mit einem eindeutigen Schlüssel als neuer Lookup Eintrag wie folgt angelegt werden:
<code>AddLookupKeyValue('MyLookUpTableName', concat($LocationGLN,$DocNumber), SG_1/RFF/DG_C506[@DE_1153='CR']/@DE_1154)</code>

Diese Referenz kann dann bei der Transformierung von eBiss.Industry.DespatchAdvise auf eBiss.MappingObjects.Edifact.D96A.Messages.DESADV.DESADV wieder ausgelesen werden,
indem hier der Eindeutige Schlüssel wieder mit z.Bsp.:
<code>concat(@DeliveryPartyGLN,@ReferenceBuyerOrder)</code>
erzeugt wird und mit und folglich mit:
<code>LookupGlobalValue('concat(@DeliveryPartyGLN,@ReferenceBuyerOrder)',$RFF_CR)</code>
wieder ermittelt wird und so an gewünschter Stelle im Zielobjekt weggeschrieben werden kann.



{{:images:sign_warning.png|}}**Hinweis:**  AddLookupKeyValue() kann auch zu den [[transformation:mappings:funktionen:schreibfunktionen:start]] hinzugezählt werden.