Description
Cette opération permet de récupérer la valeur d'une colonne d'un enregistrement au format demandé.
Requête
SIMAXService a besoin obligatoirement de la colonne et de l'enregistrement dont on souhaite la valeur. Dans le cas d'une image, plusieurs informations peuvent être données en supplément comme par exemple les dimensions et les couleurs de fond.
Cette opération vous permet aussi de préciser l'encodage du résultat.
Aucun contexte d'action n'est nécessaire pour cette opération.
Liste des entêtes
Liste des paramètres
Exemple
=> On souhaite récupérer la valeur de la colonne 46716464 dans l'enregistrement 448522445214 encodé en base64 et convertit en png
<env:Envelope ...>
<env:Body>
<GetColInRecord>
<Col>46716464</Col>
<Record>448522445214</Record>
<Encoding>base64</Encoding>
<MineType>image/png</MineType>
</GetColInRecord>
</env:Body>
</env:Envelope>
Réponse
On récupère la valeur de la colonne demandée dans une balise Data.
Cette valeur est encodée comme demandé et/ou transformé dans le cas des images si on avait précisé des couleurs.
SIMAXService ouvre un nouveau contexte d'action si aucun n'a été donné. Pour optimiser vos requêtes, utilisez ce même contexte d'action si vous interrogez le même enregistrement.
Dans le header, vous retrouvez le formulaire et l'enregistrement lu pour répondre à votre requête. L'action renvoyée est alors l'action de consultation de cet enregistrement.
Liste des entêtes
Les valeurs de retour
Exemple
=> L'enregistrement a été lu et la colonne a été convertit comme demandé et renvoyé dans la balise Data
<env:Envelope ...
<env:Header>
<simax-context:ActionContext>2700047...</simax-context:ActionContext>
<simax-filename:FileName>image.bmp</simax-filename:FileName>
<simax-action:Action simax:title="Consulter ...." simax:typeAction="2390" simax:typeReturn="Record"> 638733...</simax-action:Action>
<simax-form:Form simax:title="...." Checksum="638658..."> 3687334345... </simax-form:Form>
<simax-element:Element simax:title="....">47654...</simax-element:Element>
</env:Header>
<env:Body>
<GetColInRecord>
<xml>
<Data simax:encoding="Base64" simax:size="1458" simax:typemime="image/png">
..les données au format demandé et dans l'encodage
</Data>
</xml>
</GetColInRecord>
</env:Body>
</env:Envelope>