Węzły i atrybuty schematu

Omawiane tematy

Cztery typy elementów

Typ danych elementu pola

Odwołania do innych elementów

Uwagi dot. czasu standardowego

Atrybuty mapowania

Atrybuty opisowe

Stałe schematu

Ustawianie wartości domyślnych i zmienne systemowe

Węzły i atrybuty spłaszczania

Strefa wyszukiwania

Rozszerzenie zabezpieczeń na skrypt usługi

Czynność nadpisania usługi biznesowej

Określanie atrybutu searchBy dla usługi wyszukiwania

Uwzględnianie innych schematów

Atrybuty zgodności

Cztery typy elementów

Element schematu może należeć do jednego z czterech różnych typów struktur. Należy pamiętać, że są dostępne dwie klasy typów elementów: Grupa i lista węzłów strukturalnych oraz dane zawierające węzły pola oraz wartości niesformatowane.

<schema>
  <input type="group"
    <userId/>
  </input>
  <output type="group">
    <firstName/>
    <lastName/>
  </output>
</schema>

<parameters type="group" 
mapXML="BO_DATA_AREA" mdField=
"F1_TODOSUMEMAIL_PARM_LBL"/>
  <numberOfDays 
  mdField="F1_NBR_DAYS" 
  required="true"/>
  <frequency 
   mdField="F1_FREQUENCY"/>

<schema>
  <statesList type="list">
    <state isPrimeKey="true"/>
    <description/>
  </statesList>
</schema>

<xml>
  <statesList>
    <state>AK</state>
    <description>Alaska</description>
  </statesList>
  <statesList>
    <state>AL</state>
    <description>Alabama</description>
  </statesList>
...
</xml>

<sendDetail type="raw" />

<sendDetail>
  <messageInfo>
    <senderAddress>123 W. Main St,    Ontario, CA
    </senderAddress>
    <corpZone>3A</corpZone>
  </messageInfo>
</sendDetail>

Typ danych elementu pola

Spośród czterech różnych typów elementów, tylko pole może mieć typ danych.

<schema>
  <custName dataType="string"/>
</schema>

<schema>
  <count dataType="number"/>
</schema>

<schema>
  <taxRate dataType="number" 
   currencyRef="currency"/>
</schema>

<schema>
  <currency default="USD" 
    suppress="true"/>
  <balance dataType="money" 
   currencyRef="currency"/>
</schema>

<schema>
  <status dataType="lookup" 
   lookup="STATUS_FLG"/>
</schema>

<schema>
  <category dataType="lookupBO" 
   lookupBO="CM-BusinessCategory"/>
</schema>

<schema>
  <allowsEdit dataType="boolean"/>
</schema>

<schema>
  <startDate dataType="date"/>
</schema>

<schema>
  <startDateTime 
  dataType="dateTime"/>
</schema>

<schema>
  <startTime dataType="time"/>
</schema>

<schema>
  <exportDirectory dataType="uri"/>
</schema>

Odwołania do innych elementów

Dostępnych jest kilka atrybutów, które umożliwiają odwoływanie się do innego elementu w tym samym schemacie. Obsługiwana składnia odwołania XPath jest zawsze taka sama. W tej sekcji znajdują się przykłady zastosowania domyślnego atrybutu odwołania (defaultRef).

Odwołanie do elementu na tym samym poziomie:

<schema>
   <id mapField="ACCT_ID" required="true"/>
   <altId defaultRef="id" required="true"/>
</schema>

Odwołanie do elementu w wyższej grupie:

<schema>
   <id mapField="ACCT_ID" required="true"/>
   <msgInfo type="group" mapXML="XML_FIELD">
     <altId defaultRef="../id" required="true"/>
   </msgInfo>
</schema>

Odwołanie do elementu w niższej grupie:

<schema>
   <id mapField="ACCT_ID" defaultRef="msgInfo/altId" required="true"/>
   <msgInfo type="group" mapXML="XML_FIELD">
     <altId required="true"/>
   </msgInfo>
</schema>

Odwołanie do elementu w innej grupie:

<schema>
  <acctInfo type="group">
    <id mapField="ACCT_ID" required="true"/>
  </acctInfo>
   <msgInfo type="group" mapXML="XML_FIELD">
     <altId defaultRef="../acctInfo/altId" required="true"/>
   </msgInfo>
</schema>

Uwagi dot. czasu standardowego

Większość pól daty/czasu odzwierciedla czas "prawny", to znaczy czas zgodny ze zmianą czasu na letni/zimowy w danej strefie czasowej, pokazując w polu aktualnie obowiązującą datę/godzinę. Istnieją jednak pola daty/godziny, które powinny zawsze pokazywać czas standardowy w celu zapobiegania nieporozumieniom i dwuznaczności. Dobrym przykładem są data i godzina powiązane ze szczegółowymi danymi interwału. Więcej informacji zawiera sekcja Projektowanie stref czasowych.-

Podczas definiowania elementu za pomocą dataType="dateTime" można opcjonalnie skonfigurować stdTime="true", co oznacza, że pobierane przez element dane będą zawsze odzwierciedlać czas standardowy w "podstawowej" strefie czasowej. "Podstawową" strefę czasową określa się w Opcjach instalacji.

Przykład:

<schema>
  <startTime dataType="Time" stdTime="true"/>
</schema>

Jeśli strefa czasowa odzwierciedlająca pole daty/godziny nie jest strefą czasową instalacji, należy użyć opcjonalnego ustawienia stdTimeRef="XPath to time zone element" względem elementu daty/godziny w celu wskazania, że element odzwierciedla czas standardowy i wskazuje strefę czasową do użycia. Więcej informacji na temat obsługiwanej składni dotyczącej odwoływania się do innych elementów można znaleźć w sekcji Odwołania do innych elementów.

Przykład:

<schema>
  <alternateTimeZone fkRef="F1-TZONE" suppress="true"/>
  <startDateTime dataType="dateTime" stdTimeRef="alternateTimeZone"/>
</schema>

Możliwe są przypadki, w których data/godzina są pobierane jako czas standardowy w jednej strefie czasowej, ale powinny być wyświetlane za pomocą innej strefy czasowej. W takim przypadku można użyć atrybutu displayRef="XPath" wraz z odpowiednim atrybutem identyfikującym strefę czasową, z której pobierane są dane. Więcej informacji na temat obsługiwanej składni można znaleźć w sekcji Odwołania do innych elementów.

<schema>
  <displayTimeZone fkRef="F1-TZONE" suppress="true"/>
  <startDateTime dataType="dateTime" stdTime="true" displayRef="displayTimeZone"/>
</schema>

Atrybuty odwzorowania

Podczas tworzenia schematu można wybierać z pomiędzy następujących atrybutów odwzorowania.

<schema>
  <factId 
   mapField="FACT_ID"/>
</schema>

<persons type="list" 
   mapChild="CI_ACCT_PER"
  <personId mapField="PER_ID"/>
</persons>

<selectList type="list" 
  mapList="DE" 
  <value mapField="COL_VALUE"> 
    <row mapList="DE_VAL"> 
      <SEQNO is="2"/> 
    </row> 
  </value>  
</selectList>

<enrollmentRequest type="group" 
mapXML="CASE_CLOB">
  <messageID/>
  <sender/>
</enrollmentRequest>
<enrollmentKey 
mapXML="CASE_CLOB"/>
<enrollmentInfo type="list" 
mapChild="CI_CASE_CHILD">
  <sequence 
  mapField="CHILD_SEQ"/>
  <name 
  mapXML="CASE_CHILD_CLOB"/>
  <value 
  mapXML="CASE_CHILD_CLOB"/>
</enrollmentInfo>

<questionnaire 
type="list" mapXML="CASE_CLOB">
  <question 
  isPrimeKey="true"/>
  <answer/>
</questionnaire>

<questionnaire type="list" 
  orderBy="page/section, 
page/sequence" 
mapXML="CASE_CLOB">
<question isPrimeKey="true"/>
<answer/>
<page type="group">
  <section/>
  <sequence/>
</page>
</questionnaire>

Atrybuty opisowe

Następujących atrybutów można używać w celu opisywania elementu schematu oraz zapewniania dodatkowej konfiguracji powiązanej z elementem. Atrybuty te są zazwyczaj przydatne tylko w przypadku elementów pól.

<schema>
  <!-- This schema is used to 
capture business information 
only, please refer to the 
'HUMAN' BO for person 
information -->
</schema>

<schema>
  <active type="boolean" 
description="active account" 
label="Active"/>
</schema>

<schema>
  <active type="boolean" 
description="active account" 
label="Active"/>
</schema>

<schema>
  <logDate mapField="LOG_DT" 
default="%CurrentDate" 
required="true" 
private="true"
</schema>

<schema>
  <active 
mdField="CM_ACTIVE_SW"/>
</schema>

<schema>
  <person fkRef="PER" 
mapField="CHAR_VAL_FK1">
   <row mapChild="CI_SA_CHAR">
      <CHAR_TYPE_CD is="PER"/>
    </row>
  </person>
</schema>

<schema>
  <type mdField="SA_TYPE_CD" 
default="E1" private="true"/>
</schema>

<schema>
    <ls mdField="LIFE_SUPPORT_FLG" 
default="N" suppress="true"/<
</schema>

<schema>
  <email mdField="EMAIL" 
suppress="blank"/>
</schema>

<schema>
  <email mdField="EMAIL" 
suppress="input"/>
</schema>

<schema>
  ...
  <version mapField="VERSION_NBR"
 noAudit="true"/>
  ...
  <workFields type="group"
 noAudit="true"
    <lastProcessedId/>
    <lastProcessedTime/>
  </workFields>
</schema>

<schema>
  <message type="group" storeEmptyNodes="true">
  ...
  </message>
</schema>

<schema emitEmptyGroups="true">
  <message type="group">
  ...
  </message>
</schema>

<schema>
  <messageNumber type="field" emitEmptyElements="true">
  ...
  </message>
</schema>

<schema>
  <messageNumber type="group" adheresToDA="DataAreaName">
  ...
  </message>
</schema>

Stałe schematów

Istnieją schematy należące do produktów, w przypadku których projekt wymaga domyślnej wartości w schemacie, ale w których wartość jest specyficzna dla wdrożenia i nie może być definiowana przez produkt. W takich sytuacjach produkt może zastosować techniką określaną mianem stałej schematu. Projekt schematu będzie uwzględniał zadeklarowaną stałą. W czasie wdrożenia zadanie konfiguracji zdefiniuje odpowiednią wartość dla stałej.

Załóżmy na przykład, że produkt dostarcza algorytm, który utworzy wychodzącą wiadomość po spełnieniu określonego warunku. Typ wiadomości wychodzącej musi zostać skonfigurowany przez wdrożenie. Aby wykorzystać stałą schematu do zdefiniowania typu wiadomości wychodzącej, podstawowy produkt skonfiguruje co następuje:

• Wartość z listy typu opcji dla listy wartości F1CN_​OPT_​TYP_​FLG. Przykład: M202 - typ wiadomości wychodzącej o ukończeniu działania z nazwą wartości Java outmsgCompletion

• Schemat bazowy, który jest używany do tworzenia komunikatów wychodzących "ukończonego działania" z odwołaniem do stałej schematu przy użyciu nazwy wartości Java wartości wyszukiwania typu opcji

  ...
  <outboundMessageType mapField="OUTMSG_TYPE_CD" default="%Constant(outmsgCompletion)"/>
  ...

W czasie wdrożenia użytkownicy o uprawnieniach administratora muszą skonfigurować odpowiedni typ komunikatu wychodzącego na potrzeby "ukończenia działania". Następnie należy przejść do Konfiguracji cechy, wybrać typ cechy Stałe schematów, wybrać typ opcji Typ wiadomości wychodzącej ukończenie działania i wprowadzić nowo utworzony typ wiadomości wychodzącej w wartości opcji.

Stałe schematów mogą być także używane w ramach składni spłaszczania w celu zdefiniowania elementów wiersza wymaganych do spłaszczenia.

Ustawianie wartości domyślnych i zmienne systemowe

Domyślny atrybut może być używany do ustalania wartości domyślnych w elementach pola oraz w elementach wiersza wymaganych do spłaszczania. Można ustawić wartość domyślną pola na wartość stałą lub na jedną z kilku zmiennych systemowych.

Jeśli element jest wymagany, wartość domyślna jest stosowana na poziomie serwera podczas dodawania lub zmiany rekordu, w którym nie podano wartości tego elementu.

Jeśli element jest opcjonalny, można skonfigurować wartość domyślną w taki sposób, aby podczas wypełniania rekordu w interfejsie użytkownika w trybie dodawania podawana była sugerowana wartość. Użytkownicy powinni mieć możliwość usunięcia wartości domyślnej dla tego typu elementu, a system nie będzie próbował jej wypełnić w momencie zapisywania.

<schema>
  <perType mapField="PER_OR_BUS_FLG" 
default="P" required="true"/>
</schema>

<schema>
  <frequency dataType="number" 
default="1" required="true"/>
</schema>

<schema>
  <logDate mapField="LOG_DT" 
default="%CurrentDate" required="true"/>
</schema>

<schema>
  <logDateTime mapField="LOG_DTTM" 
default="%CurrentDateTime" 
required="true"/>
</schema>

<schema>
  <startDateTime mapField="START_DTTM" 
default="%StandardDateTime" 
required="true"/>
</schema>

<schema>
  <billDate mapField="BILL_DT" 
default="%ProcessDate" 
required="true"/>
</schema>

<schema>
  <calcDateTime mapField="CALC_DTTM" 
default="%ProcessDateTime" 
required="true"/>
</schema>

<schema>
  <logUser mapField="LOG_USER" 
default="%CurrentUser" 
required="true"/>
</schema>

<schema>
  <timeZone 
default="%CurrentUserTimeZone" 
required="true"/>
</schema>

<schema>
  <custLanguage mapField="CUST_LANG" 
default="%CurrentUserLanguage" 
required="true"/>
</schema>

<schema>
  <currency mapField="CURRENCY_CODE" 
default="%InstallationCurrency" 
required="true"/>
</schema>

<schema>
  <country mapField="COUNTRY" 
default="%InstallationCountry" 
required="true"/>
</schema>

<schema>
  <language mapField="LANGUAGE" 
default="%InstallationLanguage" 
required="true"/>
</schema>

<language mapField="CUSTOMER_LANG" 
default="%Constant(customerLanguage)" 
required="true"/>

<source mapField="PER_ID" 
default="%Context(source)" 
required="true"/>

Węzły i atrybuty spłaszczania

Termin "spłaszczanie" opisuje czynność definiowania jednego lub wielu pojedynczych elementów schematu, które są w rzeczywistości częścią listy w ramach obiektu obsługi. Spłaszczanie jest możliwe wtedy, gdy istnieją inne atrybuty danej listy, które można zdefiniować w celu unikatowego opisania elementu lub elementów. Typowym przypadkiem użycia spłaszczania jest charakterystyka. Zamiast definiować charakterystyki obiektu za pomocą kolekcji, w której użytkownik musi wybrać typ charakterystyki, a następnie zdefiniować wartość, charakterystyki są definiowane jako elementy z od razu wyświetlaną odpowiednią etykietą. Ta technika umożliwia projektantowi schematu i interfejsu użytkownika na wyświetlenie oddzielnych charakterystyk w logicznych miejscach interfejsu użytkownika zamiast wrzucania ich wszystkich w jedno miejsce.

Identyfikowanie listy lub tabeli podrzędnej

Podczas spłaszczania tabeli podrzędnej wymagany jest węzeł wiersza do identyfikowania listy/tabeli podrzędnej, z której pochodzi element. W ramach węzła wiersza należy zdefiniować co najmniej jeden element z definicją is=, co zapewni, że element ten będzie unikatowym wierszem w bazie danych. Może także definiować elementy lub pola w wierszu, które są pominięte i uzupełnione za pomocą konfiguracji wykorzystującej wartość domyślną.

• W przypadku obiektu biznesowego węzeł wiersza definiuje tabelę podrzędną, do której należy pole spłaszczone.

  Składnia: <row mapChild="table name">. Ten przykład dotyczy listy osób w ramach konta w produkcie Customer Care and Billing. Jedną z osób można oznaczyć jako osobę "główną". Pokazuje to sposób, w jaki można zdefiniować jawny element ID głównej osoby w celu uproszczenia odwołań do tego pola. Wchodzi w skład tabeli podrzędnej CI_​ACCT_​PER. Wartością MAIN_​CUST_​SW jest true, co sprawia, że jest to sytuacja unikatowa (i tylko jeden wiersz może mieć tę wartość)

  <custId mapField="PER_ID" mdField="CM-MainCust">
    <row mapChild="CI_ACCT_PER">
      <MAIN_CUST_SW is="true" />
      <ACCT_REL_TYPE_CD default="MAIN" />
    </row>
  </custId>

  Uwaga: Powyższy przykład pokazuje, że węzeł wiersza może także definiować elementy w ramach listy, które są pominięte i przydzielone do wartości domyślnej. Tej składni nigdy nie używa się do identyfikowania określonego wiersza. Należy pamiętać, że wartość domyślna może być literałem lub zmienną systemową.

• W przypadku usługi biznesowej, węzeł wiersza identyfikuje nazwę listy, do której należy pole spłaszczone.

  Składnia: <row mapList="list name">. Ten przykład pokazuje dwa zapisy z listy spłaszczonej do wartości pola i opisu.

  <selectList type="list" mapList="DE"> 
      <value mapField="COL_VALUE"> 
  <row mapList="DE_VAL"> 
            <SEQNO is="2"/> 
  </row> 
      </value>  
    <description mapField="COL_VALUE"> 
  <row mapList="DE_VAL"> 
          <SEQNO is="3"/> 
  </row> 
    </description> 
  </selectList>

Unikatowe identyfikowanie pola spłaszczonego lub listy spłaszczonej

Składnia is= w wierszu lub elemencie rowFilter służy do unikatowego identyfikowania wiersza.

<tdTypeCd 
  mapField="CHAR_VAL_FK1">
  <row 
    mapChild="F1_EXT_LOOKUP_VAL_CHAR">
    <CHAR_TYPE_CD 
   is="CM-TD-TYPE"/>
  </row>
</tdTypeCd>

<unitRate mapField="CHAR_VAL" 
  dataType="number">
  <row mapChild=
   "F1_EXT_LOOKUP_VAL_CHAR">
    <CHAR_TYPE is
   ="%Constant(cmRate)"/>
  </row>
</unitRate>

<schema>
  <mainPhone mapField="PHONE">
    <row mapChild="CI_PER_PHONE">
      <PHONE_TYPE_CD 
      is="%Constant(mainPhoneType)"/>
      <SEQ_NUMis="%1"/>
    </row>
  </mainPhone>
</schema>

Spłaszczanie predefiniowanego typu charakterystyki

Jeśli pole spłaszczone znajduje się w zbiorze charakterystyk, a typ charakterystyki jest predefiniowaną charakterystyką, automatyczne renderowanie interfejsu użytkownika spowoduje wygenerowanie listy rozwijanej dla listy prawidłowych wartości. Przykładowo poniższy schemat wygeneruje listę rozwijaną dla elementu "Użycie", który pokazuje prawidłowe wartości typu charakterystyki "Przyczyna statusu - użycie" (F1–SRUSG).

<usage mdField="STATUS_RSN_USAGE" mapField="CHAR_VAL">
  <row mapChild="F1_BUS_OBJ_STATUS_RSN_CHAR">
      <CHAR_TYPE_CD is="F1-SRUSG"/>
      <SEQ_NUM is="1"/>
  </row>
</usage>

Definiowanie wielu elementów z listy

Podczas uwzględniania wielu kolumn w ramach tej samej listy system podaje skrócony zapis do kopiowania reguł spłaszczania zdefiniowanych w innym elemencie celem zapewnienia, że reguły spłaszczania nie będą musiały być powtarzane. W tym celu węzeł wiersza zawiera atrybut rowRef, który wskazuje nazwę innego elementu, który definiuje informacje odwzorowania. Następujący przykład pokazuje spłaszczanie pól "ID klienta" oraz "Otrzymuje kopię faktury" z tej samej listy osób konta (gdzie MAIN_​CUST_​SW ma wartość true ).

<custId mapField="PER_ID">
  <row mapChild="CI_ACCT_PER">
      <MAIN_CUST_SW is="true" />
      <ACCT_REL_TYPE_CD default="MAIN" />
  </row>
</custId>
<copyBill mapField="RECEIVE_COPY_SW" rowRef="custId"/>

Należy pamiętać, że powyższy zapis pokazuje także, że atrybut rowRef można zdefiniować bezpośrednio w ramach definicji atrybutu elementu.

Spłaszczanie w ramach dwóch warstw

Jeśli obiekt obsługi lub usługa zawierają zagnieżdżone listy o głębokości dwóch warstw, system obsługuje spłaszczanie elementu w ramach spłaszczonego elementu. Ta technika także wykorzystuje atrybut rowRef. Spłaszczanie drugiego poziomu odwołuje się do spłaszczonego elementu na pierwszym poziomie. W poniższym przykładzie pokazano spłaszczanie charakterystyki do elementu o nazwie legalContact dla klienta "głównego". Należy zauważyć, że element legalContact zawiera dwa węzły wiersza: Jeden z nich odwołuje się do informacji o spłaszczaniu dotyczących rekordu nadrzędnego, a drugi służy do definiowania tabeli podrzędnej

<custId mapField="PER_ID">
  <row mapChild="CI_ACCT_PER">
    <MAIN_CUST_SW is="true" />
    <ACCT_REL_TYPE_CD default="MAIN" />
  </row>
</custId>
<legalContact mapField="CHAR_VAL_FK1">
  <row rowRef="custId">
    <row mapChild="CI_ACCT_PER_CHAR" >
       <CHAR_TYPE_CD is="LEGAL" />
    </row>
  </row>
</legalContact>

Należy pamiętać, że powyższy zapis pokazuje także, że atrybut rowRef można zdefiniować jako atrybut węzła wiersza zamiast bezpośrednio w ramach definicji atrybutu elementu.

Definiowanie listy spłaszczonej

W niektórych przypadkach lista lub tabela podrzędna obsługują wiele wartości tego samego "typu", które powinny być przedstawiane jako lista. Kontynuując przykład przedstawiony powyżej, na liście osób w ramach konta jedna osoba może być określona jako osoba "główna". Ta osoba została spłaszczona do pojedynczego elementu (a typ relacji konta otrzymał wartość domyślną i został pominięty). Aby obsługiwać pozostałe osoby powiązane z kontem, można zdefiniować listę, na której każdy wiersz będzie zawierać ID osoby oraz typ relacji konta.

W przeciwieństwie do węzła wiersza, lista spłaszczona jest konfigurowana za pomocą elementu rowFilter. Poniższy schemat stanowi ilustrację opisanego przykładu. Węzeł listy definiuje tabelę podrzędną. Element rowFilter zawiera kryteria, które służą do identyfikowania wierszy w ramach uwzględnianej tabeli. Elementy listy są definiowane w ramach węzła listy, poza elementem rowFilter.

<custId mapField="PER_ID">
  <row mapChild="CI_ACCT_PER">
    <MAIN_CUST_SW is="true" />
    <ACCT_REL_TYPE_CD default="MAIN" />
  </row>
</custId>
<miscPersons type="list" mapChild="CI_ACCT_PER">
  <rowFilter>
    <MAIN_CUST_SW is="false" />
  </rowFilter>
  <relType mapField="ACCT_REL_TYPE_CD"/>
  <personId mapField="PER_ID"/>
</custId>

Należy pamiętać, że system waliduje, czy jeżeli schemat zawiera spłaszczone pojedyncze elementy oraz spłaszczone listy z tej samej tabeli podrzędnej, to czy kryteria definiujące ich unikatowość muszą być analogiczne.

Spłaszczanie listy o określonej dacie obowiązywania

W aplikacji znajdują się listy, które posiadają datę obowiązywania (a niektóre posiadają także datę i godzinę obowiązywania). Na przykład istnieją zbiory charakterystyk z datą obowiązywania. Projekt takich zbiorów zakłada pobranie pojedynczej wartości dla typu charakterystyki, która może ulec zmianie wraz z upływem czasu. Nie ma na celu obsługiwania wielu wartości charakterystyk obowiązujących jednocześnie.

Niektóre obiekty obsługi mają charakterystyki z datą obowiązywania i nie mają charakterystyk opartych na sekwencji. W przypadku tych obiektów we wdrożeniach może być wymagane użycie charakterystyki w celu zdefiniowania dodatkowego pola, które nie wymaga dat obowiązywania.

Projektując element schematu, który reprezentuje wartość w zbiorze z datą obowiązywania, należy rozważyć, czy wartość jest używana w procesach, w przypadku których istotne jest pobieranie zmian wartości w czasie (np. obliczanie faktury).

• Jeśli śledzenie zmian wartości nie jest istotne, zaleca się ustawienie daty obowiązywania na stałą wartość w schemacie. (Przykłady poniżej).
• Jeśli śledzenie zmian wartości jest ważne, należy rozważyć sposób projektowania schematu.
  • Jedną z opcji jest zdefiniowanie listy spłaszczonej w sposób opisany powyżej. Zarówno wartość, jak i data obowiązywania są elementami na tej liście. W tym przypadku użycia można zarządzać listą tak samo jak każdą inną listą. Można dodawać lub usuwać wartości.
  • Inną opcją jest zdefiniowanie pojedynczej spłaszczonej wartości w schemacie. W przypadku tej opcji podczas pobierania rekordu zwracana jest najnowsza obowiązująca wartość. W tym projekcie ważną kwestią jest sposób definiowania daty odwołania.

Elementy spłaszczone, w których zmiany nie są śledzone

Poniżej przedstawiono przykład spłaszczania elementu w zbiorze z datą obowiązywania, w którym wartość nie musi być mieć daty obowiązywania. W tym przypadku zaleca się trwałe zakodowanie daty w atrybucie is=.

<schema>
  <externalReference mapField="ADHOC_CHAR_VAL" mdField="CM_EXT_REF" dataType="string">
    <row mapChild="CI_SA_CHAR">
      <CHAR_TYPE is="CM_EXT_REF"/>
      <EFFDT is="2000-01-01"/>
    </row>
  </externalReference>
</schema>

Elementy spłaszczone, w których zmiany mają określoną datę obowiązywania

Jeśli schemat obiektu biznesowego ma spłaszczać wartość z datą obowiązywania, w przypadku której powinny być śledzone zmiany w czasie, wartość spłaszczona będzie reprezentować najnowszy obowiązujący zapis. W takim przypadku zaleca się jawne zdefiniowanie pola daty lub daty/godziny jako elementu. Następnie dostępna jest składnia atrybutu is= wskazująca, że jawne pole daty jest datą, której należy użyć w wartości.

<schema>
  <price mapField="CHAR_VAL" 
   dataType="number" required="true">
    <row mapChild="CI_SA_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDT 
   is="%effectiveDate(priceEdate)" />
    </row>
  </price>
<priceEdate mapField="EFFDT" 
  rowRef="price"/>
</schema>

<schema>
  <price mapField="CHAR_VAL" 
  dataType="number">
    <row mapChild="RATE_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDTTM 
  is="%effectiveDateTime(priceEdatetime)"/>
    </row>
  </price>
  <priceEdatetime mapField="EFFDTTM" 
  rowRef="price"/>
</schema>

Należy rozważyć, czy jawny element daty lub daty/godziny powinien być wyświetlany w interfejsie użytkownika, gdy pokazywane jest pole spłaszczone, czy też powinien być pomijany. Projektanci powinni również wziąć pod uwagę zastosowanie okna dialogowego użytkownika w celu aktualizacji wartości. Bardziej intuicyjne może być wyświetlanie tylko pola spłaszczonego i wprowadzenie osobnego okna dialogowego w celu aktualizacji wartości z datą obowiązywania.

W przypadku tej opcji sugeruje się, aby strona obsługi obiektu zawierała osobną strefę, w której pokazywana jest historia wartości z datami obowiązywania w czasie. Najnowsza wartość może być również uwzględniona w tej strefie.

Uwaga: W celu zapewnienia zgodności wstecznej system obsługuje również następujące opcje. Nie są one jednak zalecane. Data odwołania jest w nich pośrednio zdefiniowana jako data bieżąca przez cały czas. W przypadku zmiany wartości opcje te obsługują dodawanie nowych wierszy z datą obowiązywania. Technika ta powoduje jednak pojawienie się nowych wierszy z datą obowiązywania, gdy aktualizowane są inne elementy tego samego schematu. Nowe wiersze będą miały bieżącą datę lub datę/godzinę z tą samą wartością wiersza, ponieważ data lub data/godzina odwołania jest datą bieżącą, co stanowi zmianę. W produkcie nie zaleca się zarządzania charakterystyką z datą obowiązywania bez zdefiniowania daty lub daty/godziny jako elementu jawnego.

<schema>
  <price mapField="CHAR_VAL" 
  dataType="number">
    <row 
  mapChild="CI_SA_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDT
   is="%effectiveDate"/>
    </row>
  </price>
</schema>

<schema>
  <price mapField="CHAR_VAL" 
   dataType="number">
    <row mapChild="RATE_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDT 
    is="%effectiveDateTime" />
    </row>
  </price>
</schema>

Strefa wyszukiwania

Można skonfigurować element schematu interfejsu użytkownika w taki sposób, aby włączać okno dialogowe automatycznego wyszukiwania, gdy schemat jest dołączony do odwzorowania interfejsu użytkownika obsługi.

search="search zone"

Atrybutu wyszukiwania można używać w ramach schematu odwzorowania interfejsu użytkownika. Jest on używany do automatycznego generowania atrybutu odwzorowania interfejsu użytkownika oraSearch. Strefa wyszukiwania to strefa eksploratora skonfigurowana jako wyszukiwanie.

<person fkRef="PER" search="C1_PSRCH"/>

searchField="search field:element|'literal';"

Atrybutu searchField można używać tylko w połączeniu z atrybutem wyszukiwania. Atrybut searchField jest używany do tworzenia atrybutu odwzorowania interfejsu użytkownika oraSearchField. Wartość searchField służy do wypełniania filtra strefy wyszukiwania wartością początkową, gdy uruchamiana jest strefa wyszukiwania. Wartość początkowa może być także wartością literałową. Wartość searchField służy do dopasowywania mnemoniku filtra, który także nosi nazwę searchField.

Pole wyszukiwania: element|'literal'. Pole wyszukiwania odzwierciedla filtr strefy wyszukiwania, który należy uzupełnić podczas uruchamiania. Elementem jest element schematu odwzorowania, który służy do uzupełniania filtra. Element ten jest opcjonalny. Jeśli pozostanie pusty, przyjmie wartość domyślną elementu, dla którego określono dany atrybut. Atrybut searchField przyjmuje także "literał" jako wartość wejściową.

<person fkRef="PER" search="C1_PSRCH" searchField="PERSON; PER_TYPE:personType;"/>

searchOut="search field:element;"

Atrybutu searchOut można używać tylko w połączeniu z atrybutem wyszukiwania. Atrybut searchOut jest używany do tworzenia atrybutu odwzorowania interfejsu użytkownika oraSearchOut. Wartość searchOut służy do pobierania wybranej wartości ze strefy wyszukiwania i przenoszenia jej do elementu odwzorowania interfejsu użytkownika. Podana wartość searchOutpowinna być zgodna z mnemonikiem ELEMENT_​NAME w ramach parametru strefy wyniku wyszukiwania.

Pole wyszukiwania: element. Pole wyszukiwania odzwierciedla wynik strefy wyszukiwania przeniesiony ponownie do odwzorowania interfejsu użytkownika. Elementem jest element schematu odwzorowania, który ma zostać wypełniony. Element ten jest opcjonalny. Jeśli pozostanie pusty, przyjmie wartość domyślną elementu, dla którego określono dany atrybut.

<person fkRef="PER" search="C1_PSRCH" searchField="PER_ID" 
searchOut="PER_ID;PRIMARY_PHONE:personPhone;"/>

Rozszerzenie zabezpieczeń na skrypt usługi

Bezpieczeństwo usługi aplikacji będzie wymuszane wtedy, gdy obiekty biznesowy lub skrypt usługi zostanie wywołany z poziomu skryptu BPA lub odwzorowania interfejsu użytkownika, ale nie z poziomu skryptu usługi. Aby bezpieczeństwo było wymuszane podczas wywoływania obiektu biznesowego lub skryptu usługi z poziomu skryptu usługi, należy dodać następujący atrybut do schematu skryptu usługi.

appSecurity="true"

Atrybut appSecurity jest dostępny tylko dla schematów skryptów usług. Jeśli zostanie określony, dla każdego obiektu biznesowego lub skryptu usługi wywoływanego bezpośrednio przez skrypt usługi będzie przeprowadzana ocena usługi aplikacji pod kątem dostępu.

<schema appSecurity="true">
  ...
</schema>

Czynność nadpisania usługi biznesowej

Aby wywołać usługę biznesową za pomocą czynności innej niż "odczyt", należy podać atrybut czynności w ramach głównego węzła schematu usługi biznesowej.

pageAction="add, change, delete"

Atrybut czynności jest używany do nadpisywania domyślnej czynności odczytu w schemacie usługi biznesowej. Prawidłowe wartości to:

• dodawanie

• aktualizowanie (dozwolone tylko w przypadku usługi obiektu obsługi)

• zmiana (niedozwolone w przypadku usługi obiektu obsługi)

• kasowanie

• odczyt (domyślna czynność, jeśli nie określono atrybutu pageAction)

Przykład:

<schema pageAction="change">
  <parm type="group">
    <ele1/>
    <ele2/>
  </parm>
</schema>

Określanie atrybutu searchBy dla usługi wyszukiwania

Aby wywołać usługę wyszukiwania, należy jawnie określić atrybut searchBy zgodny z elementami odwzorowanymi w schemacie.

searchBy="MAIN"

Wartości atrybutu searchBy można znaleźć, wyświetlając schemat XML powiązany z usługą biznesową za pomocą adresu URL wyświetlania XML. Typowe wartości:

• MAIN

• ALT

• ALT2

• ALT3

• itp.

<schema searchBy="MAIN">
  <AccountID mapField="ACCT_ID"/>
  <Results type="list">
    <AccountID mapField="ACCT_ID"/>
  </Results>
</schema>

Uwzględnianie innych schematów

Nie ma ograniczeń w zakresie uwzględniania schematu w innych schematach - wszystkie typy można uwzględniać we wszystkich pozostałych typach. Uwzględnianie zagnieżdżone jest także dozwolone, a obecnie nie ma ograniczenia w zakresie głębokości zagnieżdżania.

Uwzględnienie schematu wymaga dwóch części:

1. Węzła uwzględnienia
2. Nazwy atrybutu

W poniższej tabeli znajdują się obsługiwane instrukcje uwzględniania.

<schema>
  <cust type="group">
<includeBO name="C1-Person"/>
</cust>
  <spouse type="group">
<includeBO name="C1-Person"/>
</spouse>
</schema>

<schema>
<includeBS name="F1-ReadMOLog"/>
</schema>

<schema>
<includeDA 
   name="F1CommonSchemaFieldData"/>
</schema>

<schema>
<includeMP 
   name="F1-DisplayRecordActions"/>
</schema>

<schema>
<includeSS name="F1-ActShowZn"/>
</schema>

Atrybuty zgodności

Te atrybuty zostały dodane w ramach uaktualnień z poprzednich wersji frameworku.

fwRel="2"

Ten atrybut został dodany do schematów utworzonych w frameworku 2 jako część uaktualnienia frameworku 4. Nowe schematy nie będą wymagały tego atrybutu. Nie zaleca się modyfikowania tego atrybutu bez zapoznania się z następującymi różnicami w sposobie działa, ponieważ niewłaściwe zmiany mogą być przyczyną błędów.

<schema fwRel="2"
    ...
</schema>