From 983cbdad8ae7a6676419e21857a186b1bd5008e3 Mon Sep 17 00:00:00 2001
From: Julio Biason <julio.biason@pm.me>
Date: Mon, 10 Jan 2022 17:42:13 -0300
Subject: [PATCH] Added information about the template versioning

---
 content/research/decoding-fast.md    | 47 ++++++++++++++++++++++++++
 content/research/decoding-fast.pt.md | 50 +++++++++++++++++++++++++++-
 2 files changed, 96 insertions(+), 1 deletion(-)

diff --git a/content/research/decoding-fast.md b/content/research/decoding-fast.md
index 036175b..709d669 100644
--- a/content/research/decoding-fast.md
+++ b/content/research/decoding-fast.md
@@ -459,6 +459,52 @@ Map, [according to JetTek](https://jettekfix.com/education/fix-fast-tutorial/):
     </tr>
 </table>
 
+# Template Versioning
+
+I didn't mentioned this before, but now that I explained some things about the
+types and some information about the template, I can point that the template
+file allows multiple versions of the same message types.
+
+For example
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<templates xmlns="http://www.fixprotocol.org/ns/fast/td/1.1">
+  <template xmlns="http://www.fixprotocol.org/ns/fast/td/1.1" name="SomeRecordType" id="1">
+    <string name="MsgType" id="35">
+      <constant value="Z"/>
+    </string>
+    <string name="SomeField" id="1"/>
+  </template>
+
+  <template xmlns="http://www.fixprotocol.org/ns/fast/td/1.1" name="SomeRecordType" id="2">
+    <string name="MsgType" id="35">
+      <constant value="Z"/>
+    </string>
+    <string name="SomeField" id="1"/>
+    <string name="SomeOtherField" id="2">
+      <default value="A Value!"/>
+    </string>
+  </template>
+</templates>
+```
+
+The first thing you may notice is that there are two templates defined, one
+with ID "1" and another with ID "2". Both have the same name and the same
+constant value in the same field ID, but the initial data in the incoming block
+defines which one should be used.
+
+The incoming data starts with a Presence Map. The first bit on this is the
+"Template ID". With that Template ID, the decoder can find the list of fields
+that should be processed. This Presence Map also contains the map for the
+fields in the root sequence -- in our example, if the Template ID decodes to
+"2", the other bit in the Presence Map is the indication of the
+"SomeOtherField".
+
+{% note() %}
+So far, I didn't find any data that didn't had the bit set for the template ID,
+so I'm not actually sure what would happen if the bit is unset.
+{% end %}
 
 # Anomalies
 
@@ -542,3 +588,4 @@ mandatory sequences.
 ### Changelog:
 
 2022-01-10: First release.
+2022-01-10: Added information about the template versioning.
diff --git a/content/research/decoding-fast.pt.md b/content/research/decoding-fast.pt.md
index f771f69..69f531d 100644
--- a/content/research/decoding-fast.pt.md
+++ b/content/research/decoding-fast.pt.md
@@ -471,6 +471,53 @@ Presença, [de acordo com a JetTek](https://jettekfix.com/education/fix-fast-tut
     </tr>
 </table>
 
+# Versionamento de Templates
+
+Eu não mencionei isso antes, mas agora que eu expliquei algumas coisas sobre os
+tipos e algumas informações sobre o template, eu posso dizer que o arquivo de
+template permite que existam múltiplas versões das mesmas mensagens.
+
+Por exemplo
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<templates xmlns="http://www.fixprotocol.org/ns/fast/td/1.1">
+  <template xmlns="http://www.fixprotocol.org/ns/fast/td/1.1" name="SomeRecordType" id="1">
+    <string name="MsgType" id="35">
+      <constant value="Z"/>
+    </string>
+    <string name="SomeField" id="1"/>
+  </template>
+
+  <template xmlns="http://www.fixprotocol.org/ns/fast/td/1.1" name="SomeRecordType" id="2">
+    <string name="MsgType" id="35">
+      <constant value="Z"/>
+    </string>
+    <string name="SomeField" id="1"/>
+    <string name="SomeOtherField" id="2">
+      <default value="A Value!"/>
+    </string>
+  </template>
+</templates>
+```
+
+Uma coisa que você pode notar é que existem dois templates definidos, um com ID
+"1" e outro com ID "2". Ambos tem o mesmo nome e o mesmo campo com um valor
+constante, mas a informação inicial dos dados de entrada indica qual destes
+dois deve ser usada.
+
+Os dados de entrada começam com um Mapa de Presença. O primeiro bit deste mapa
+é o "Template ID". Com este Template ID, o decodificador pode encontrar a lista
+de campos que devem ser processados. Este mapa também tem os campos da
+sequência inicial -- no nosso exemplo, se o Template ID for "2", o outro bit no
+Mapa de Presença é o indicador do "SomeOtherField".
+
+{% note() %}
+Até agora, eu não vi dados de entrada que não tivessem o bit indicador do
+template ID ligado, então eu não tenho muita certeza do que fazer caso isso
+aconteça.
+{% end %}
+
 # Anomalias
 
 Eu chamo "anomalia" qualquer coisa que eu levei muito tempo para entender.
@@ -553,7 +600,8 @@ sequências mandatórias e opcionais.
 
 Changelog:
 
-2021-01-10: Primeira versão.
+2022-01-10: Primeira versão.
+2o22-01-10: Adicionada informações sobre o versionamento de templates.
 
 <!-- 
 vim:spelllang=pt: