Vytvorenie súborov šablóny spätného zápisu

Šablóna spätného zápisu je súbor vo formáte XML, ktorý obsahuje jednu alebo viacero šablón spätného zápisu.

Šablóna spätného zápisu pozostáva z prvku WebMessage, ktorý určuje názov šablóny, zo spoločnej oblasti pripojení a z príkazov SQL potrebných na vloženie a aktualizáciu záznamov v tabuľkách a stĺpcoch spätného zápisu, ktoré ste vytvorili. Keď návrhári obsahu aktivujú pre spätný zápis tabuľkové zobrazenie, musia zadať názov šablóny spätného zápisu, ktorá sa má použiť na vkladanie a aktualizáciu záznamov v tabuľkovom zobrazení.

Požiadavky na šablónu spätného zápisu

Šablóna spätného zápisu musí spĺňať nasledujúce požiadavky:

WebMessage: Zadajte názov pre šablónu spätného zápisu pomocou atribútu name v prvku WebMessage.

Na správne fungovanie spätného zápisu musí návrhár obsahu pri aktivácii tabuľkového zobrazenia pre spätný zápis zadať názov šablóny spätného zápisu, ktorá sa má použiť na vkladanie a aktualizáciu záznamov v zobrazení.

Tento príklad znázorňuje šablónu spätného zápisu s názvom SetQuotaUseID.
```
<WebMessage name="SetQuotaUseID">
```
connectionPool: Na splnenie požiadaviek zabezpečenia je potrebné zadať spoločnú oblasť pripojení spolu s príkazmi SQL na vloženie a aktualizáciu záznamov. Tieto príkazy SQL odkazujú na hodnoty, ktoré sú odovzdané do schémy spätného zápisu na generovanie príkazov SQL na modifikáciu databázovej tabuľky.
VALUES: Na hodnoty stĺpcov môže odkazovať ID stĺpca alebo pozícia stĺpca. Preferuje sa použitie ID stĺpca.

Hodnoty reťazca a dátumu vložte do jednoduchých úvodzoviek. Jednoduché úvodzovky nie sú potrebné pre numerické hodnoty.
- ID stĺpca - každé ID stĺpca je alfanumerické a náhodne generované. ID stĺpcov nájdete v definícii XML analýzy, ktorá je k dispozícii na karte Rozšírené v editore analýzy. Príklady hodnôt ID stĺpca: @{c5f6e60e1d6eb1098}, @{c3a93e65731210ed1}, '@{c6b8735ea60ff3011}'
  
  Keď používate ID stĺpca, spätný zápis neprestane fungovať, aj keď sa poradie stĺpcov zmení.
- Pozícia stĺpca - pozície stĺpcov sú číslované od čísla 1. Príklady hodnôt pozícií stĺpca: @1, @3, '@5'
  
  Ak sa poradie stĺpcov zmení, spätný zápis prestane fungovať a to je dôvod, prečo sú preferované ID stĺpcov.
Do šablóny je potrebné pridať prvok <insert> aj <update>. Ak do týchto prvkov nechcete pridať príkazy SQL, medzi počiatočnú a koncovú značku je potrebné vložiť medzeru. Prvok zadajte napríklad takto:
```
<insert> </insert>
```
Nie takto:
```
<insert></insert>
```
Ak medzeru vynecháte, zobrazí sa chybové hlásenie spätného zápisu, napríklad: "Systém nemôže prečítať šablónu spätného zápisu my_template".
Ak dátový typ parametra nie je celé číslo ani reálne číslo, vložte ho do jednoduchých úvodzoviek. Ak databáza nevykonáva potvrdenia automaticky, pridajte voliteľný uzol postUpdate za uzlami insert a update na vynútenie potvrdenia. Uzol postUpdate zvyčajne vyzerá takto:
```
<postUpdate>COMMIT</postUpdate>
```

Príklad súboru šablóny spätného zápisu so syntaxou ID stĺpca

Súbor šablóny spätného zápisu, ktorý odkazuje na hodnoty podľa ID stĺpca, môže vyzerať napríklad takto:

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
   <WebMessage name="SetQuotaUseID">
      <XML>
         <writeBack connectionPool="Supplier">
            <insert>INSERT INTO regiontypequota VALUES(@{c5f6e60e1d6eb1098},@{c5d7e483445037d9e},'@{c3a93e65731210ed1}','@{c6b8735ea60ff3011}',@{c0432jkl53eb92cd8})</insert>
            <update>UPDATE regiontypequota SET Dollars=@{c0432jkl53eb92cd8} WHERE YR=@{c5f6e60e1d6eb1098} AND Quarter=@{c5d7e483445037d9e} AND Region='@{c3a93e65731210ed1}' AND ItemType='@{c6b8735ea60ff3011}'</update>
         </writeBack>
      </XML>
   </WebMessage>
</WebMessageTable>
</WebMessageTables>

Príklad súboru šablóny spätného zápisu so syntaxou pozície stĺpca

Súbor šablóny spätného zápisu, ktorý odkazuje na hodnoty podľa pozície stĺpca, môže vyzerať napríklad takto:

<?xml version="1.0" encoding="utf-8" ?>
<WebMessageTables xmlns:sawm="com.siebel.analytics.web/message/v1">
<WebMessageTable lang="en-us" system="WriteBack" table="Messages">
   <WebMessage name="SetQuota">
      <XML>
         <writeBack connectionPool="Supplier">
            <insert>INSERT INTO regiontypequota VALUES(@1,@2,'@3','@4',@5)</insert>
            <update>UPDATE regiontypequota SET Dollars=@5 WHERE YR=@1 AND Quarter=@2 AND Region='@3' AND ItemType='@4'</update>
         </writeBack>
      </XML>
   </WebMessage>
</WebMessageTable>
</WebMessageTables>