HOWTO   Accueil

HOWTO développement Sashipa

 Définir une valeur par défaut en Sashipa.

Vous souhaitez définir une valeur qui s'affichera par défaut dans votre fiche en mode ajout. Et / ou vous souhaitez qu'une valeur soit ré-enregistrée à chaque modification de la fiche.

FkFields

Pour les fkField, c'est avec une liste d'internationalValues :

  <comboBoxFkField>
    <schemaFkRef .... />
    <defaultInternationalValueList>
      <internationalValue>1</internationalValue>
    </defaultInternationalValueList>
  </comboBoxFkField>

On précise autant d'internationalValue que de colonne dans la clef étrangère. Ici on a une clef étrangère composée d'une colonne (comme c'est le cas le plus souvent). Et la valeur par défaut est la ligne qui correspond à la valeur de clef primaire 1. Remarque: la valeur par défaut est un identifiant, et non un libellé.

Fields simples

Pour les fields simples, c'est avec une seule internationalValue :

  <textField>
    <schemaColumnRef .... />
    <defaultInternationalValue>Ma valeur par défaut</defaultInternationalValue>
  </textField>

Ici avec une colonne de type texte. Par contre, notez que pour un nombre réel il faut utiliser un point à la place d'une virgule, et pas d'espaces. Et pour une date, le format est AAAA-MM-JJ. Ou bien AAAA-MM-JJ HH-MIN-SS.

Fields simples : valeurs prédéfinies en mode ajout.

Les valeurs prédéfinies disponibles sont : currentDateTime, currentDate.

Pour qu'une valeur prédéfinie soit enregistrée une fois, lors de l'ajout, voici le code :

    <cardForm db='dbContact'>
      <!-- ... -->

      <fieldContainer>
        <textField readOnly='no' save='yes'>
          <schemaColumnRef schemaColumn='cta_DateAjout' />
          <defaultPredefinedValue data='currentDateTime' />
        </textField>
      </fieldContainer>
    </cardForm>

Remarques :

• Vous pouvez spécifier readOnly='yes' si vous souhaitez que l'utilisateur ne puisse pas modifier la valeur.
• La valeur par défaut sera sauvegardée lors de l'ajout telle qu'elle est affichée (et non pas recalculée lors de l'enregistrement).
• La valeur affichée est celle récupérée dans le SGBD. (Ici c'est la date système du SGBD)

Fields simples : valeurs prédéfinies ré-enregistrées à chaque modification.

Les valeurs prédéfinies disponibles sont : currentDateTime, currentDate.

Pour qu'une valeur soit ré-enregistrée à chaque modification, voici le code :

    <cardForm db='dbContact'>
      <!-- ... -->

      <fieldContainer>
        <textField readOnly='yes' save='no'>
          <schemaColumnRef schemaColumn='cta_DateDerniereModif' />
          <defaultPredefinedValue data='currentDateTime' />
        </textField>
      </fieldContainer>

      <hiddenSchemaValueSet>
        <hiddenSchemaValue schemaColumn='cta_DateDerniereModif' data='currentDateTime' />
      </hiddenSchemaValueSet>
    </cardForm>

Remarques :

• Il vaut mieux que le champ soit en lecture seule, puisque ici on n'enregistre pas sa valeur (save='no'). Donc rien ne sert de la modifier.
• La valeur sauvegardée est celle de l'élément <hiddenSchemaValue>. Elle est sauvegardée lors de l'ajout, puis re-sauvegardée à chaque modification de la fiche.
• La valeur enregistrée est celle récupérée dans le SGBD. (Ici c'est la date système du SGBD)
• La valeur enregistrée n'est pas celle affichée ! La valeur par défaut affichée lors de l'ouverture en mode ajout est donc uniquement à titre informatif. Et peut différer un peu de celle effectivement enregistrée.

Fields simples : valeurs calculées par défaut lors de l'ajout.

Il est possible de définir une requête d'agrégat, qui sera exécutée à chaque affichage de la fiche en mode ajout. La valeur renvoyée sera affichée dans le champ lors de l'ajout. Cette requête se définit dans un élément defaultSelectedValue :

  <textField>
    <schemaColumnRef .... />
    <defaultSelectedValue>
      <selectQueryBuilder> ... </selectQueryBuilder>
    </defaultSelectedValue>
  </textField>

Pour voir un exemple de requête selectQueryBuilder, reportez-vous à la FAQ sur l'élément selectValue.

Top

© Copyright 2003 Sashipa-Melba Team. Ce document de la technologie Sashipa-Melba est sous licence GNU FDL Vous pouvez le copier et modifier librement les copies tant que cette mention apparaît clairement.