Izrada datoteka predloška za upis rezultata

Datoteka predloška za upis rezultata je XML-formatirana datoteka koja sadrži jedan ili više predložaka za upis rezultata.

Predložak za upis rezultata sastoji se od elementa WebMessage koji definira naziv predloška, skup veza i SQL naredbe neophodne za umetanje i ažuriranje zapisa u stvorene stupce i tablice za upis rezultata. Kad dizajneri sadržaja omogućuju tablični prikaz za upis rezultata, moraju definirati naziv predloška za upis rezultata koji će se upotrijebiti za umetanje i ažuriranje zapisa u tabličnom prikazu.

Zahtjevi predloška za upis rezultata

Predložak za upis rezultata mora ispunjavati sljedeće zahtjeve:

WebMessage: Morate definirati naziv predloška za upis rezultata s pomoću atributa name u elementu WebMessage.

Za pravilno funkcioniranje upisa rezultata, pri omogućavanju tabličnog prikaza za upis rezultata, dizajner sadržaja mora definirati naziv predloška za upis rezultata koji će se upotrijebiti za umetanje i ažuriranje zapisa u prikazu.

U ovom primjeru prikazan je predložak za upis rezultata naziva SetQuotaUseID.
```
<WebMessage name="SetQuotaUseID">
```
connectionPool: Za potrebe ispunjavanja sigurnosnih zahtjeva, morate definirati skup veza zajedno sa SQL naredbama za umetanje i ažuriranje zapisa. Te SQL naredbe navode vrijednosti koje se prosljeđuju u shemu za upis rezultata te omogućavaju generiranje SQL naredbi za izmjenu tablice baze podataka.
VALUES: Vrijednosti stupca može navoditi ID stupca ili položaj stupca. Preferira se upotreba ID-a stupca.

Vrijednosti niza i datuma postavite u jednostruke navodnike. Jednostruki navodnici nisu obavezni za brojčane vrijednosti.
- ID stupca - Svaki ID stupca generira se alfanumerički i nasumično. ID-ove stupaca možete pronaći u XML definiciji analize koja je dostupna u kartici Napredno uređivača analize. Npr., vrijednosti ID-a stupaca kao što su: @{c5f6e60e1d6eb1098}, @{c3a93e65731210ed1}, '@{c6b8735ea60ff3011}'
  
  Ako upotrebljavate ID-ove stupaca, upis rezultata nastavit će biti aktivan čak i u slučaju promjene redoslijeda stupaca.
- Položaj stupca - Položaji stupaca započinju brojem 1. Npr., vrijednosti položaja stupaca kao što su: @1, @3, '@5'
  
  U slučaju promjene redoslijeda stupaca, upis rezultata više neće biti upotrebljiv i zbog toga se preferiraju ID-ovi stupaca.
U predložak morate uključiti oba elementa, <insert> i <update>. Ako u elemente ne želite uključiti SQL naredbe, morate umetnuti razmak između oznaka za otvaranje i zatvaranje. Npr., element morate unijeti kao:
```
<insert> </insert>
```
A ne:
```
<insert></insert>
```
Ako izostavite razmak, prikazat će vam se poruka s pogreškom upisa rezultata, npr. "Sustav ne može očitati predložak za upis rezultata 'moj_predložak'".
Ako vrsta podataka parametra nije cjelobrojna vrijednost ili realni broj, dodajte mu oznake jednostrukih navodnika. Ako baza podataka ne izvršava pohrane automatski, dodajte neobavezni čvor postUpdate nakon čvorova insert i update kako biste osigurali pokretanje pohrane. Čvor postUpdate tipično slijedi sljedeći primjer:
```
<postUpdate>COMMIT</postUpdate>
```

Primjer datoteke predloška za upis rezultata s pomoću sintakse ID stupca

Datoteka predloška za upis rezultata koja navodi vrijednosti uz ID stupca može naličiti sljedećem primjeru:

<?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>

Primjer datoteke predloška za upis rezultata s pomoću sintakse položaja stupca

Datoteka predloška za upis rezultata koja navodi vrijednosti uz položaj stupca može naličiti sljedećem primjeru:

<?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>