Klucze fikcyjne służą do odwzorowywania pola kluczowego z elementu sterującego obiektu IDoc lub
obiektu biznesowego rekordu danych do właściwości dummyKey (Klucz fikcyjny) obiektu biznesowego najwyższego poziomu. Właściwość dummyKey (Klucz fikcyjny) jest używana do sterowania przepływem, a także na potrzeby logiki procesów biznesowych. Właściwości dummyKey (klucz fikcyjny) można użyć w sytuacji, gdy obiekt biznesowy najwyższego poziomu
ma uczestniczyć w relacji.
Adapter obsługuje odwzorowania kluczy fikcyjnych w następujący sposób:
- Dla właściwości dummyKey (klucz fikcyjny) specyficzne dla aplikacji informacje poziomu właściwości
należy skonfigurować jako wyrażenie XPATH właściwości,
z której wartość ma zostać ustawiona. Innymi słowy, specyficzne dla aplikacji informacje poziomu właściwości
ustawia się na wartość wyrażenia XPATH w hierarchii obiektów biznesowych atrybutu
odwzorowywanego na obiekt najwyższego poziomu.
- Jeśli w tej ścieżce zostaną znalezione obiekty o wielokrotnej liczności,
adapter użyje liczności zdefiniowanej w wyrażeniu XPATH. Dotyczy to wszystkich obiektów o wielokrotnej liczności niezależnie od ich miejsca występowania w hierarchii. Poniżej przedstawiono przykładowy wiersz
kodu wyrażenia XPATH:
<sapasi:ForeignBOKeyRef>Orders05/Orders05DataRecord/
Orders05E2edk14[1]/OrgID />
- Jeśli informacje specyficzne dla aplikacji są niepoprawne lub jeśli odwzorowana
wartość właściwości jest pusta, przetwarzanie zdarzenia przez adapter nie powiedzie się. Niepowodzeniem zakończy się również sytuacja, gdy informacje specyficzne dla aplikacji zostaną skonfigurowane do ustawienia typu obiektu jako wartości klucza fikcyjnego.
Uwaga: Należy pamiętać, że właściwość dummyKey (Klucz fikcyjny) może zawierać tylko
typ prosty.