GetColInRecord

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

Entête
CustomerInfos
SessionToken
UsernameToken
OptionDialogue
APIUser
APIUUID

Liste des paramètres

Paramètre
ColorFrom
ColorTo
MimeType
Encoding
TransColor
Record
Column
Heigth
WantContent
Width

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

Entête
ReturnType
CustomerInfos
Element
Action
Form
ActionContext

Les valeurs de retour

Xml

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>