> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Décrit comment transmettre des métadonnées utilisateur ou d'application entre les Actions login et post-login.

# Actions Transaction Metadata

Actions Transaction Metadata permet de stocker, de consulter et/ou de partager des métadonnées personnalisées dans une Action [post-login](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger) pendant toute la durée d'une transaction.

Auparavant, chaque Action fonctionnait de façon indépendante, ce qui compliquait la transmission d'informations entre elles. Avec Actions Transaction Metadata, il est maintenant possible de :

* Partager des données entre les Actions, comme des réponses d'API ou des calculs intermédiaires.
* Éliminer la nécessité de récupérer à nouveau ou de recalculer la même information dans différentes Actions.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Avant d'utiliser les métadonnées de transaction en développement, nous vous recommandons de consulter les limites. Pour en savoir plus, consultez [Actions Limitations](/docs/fr-ca/customize/actions/limitations).
</Callout>

<div id="how-it-works">
  ## Fonctionnement
</div>

Utilisez l’[objet API post-login](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/post-login-api-object) `api.transaction.setMetadata` pour définir une paire clé-valeur afin de stocker des métadonnées de transaction.

Utilisez l’[objet Event post-login](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/post-login-event-object) `event.transaction.metadata` pour accéder à une paire clé-valeur stockée dans la même Action ou dans des Actions ultérieures du trigger post-login, au cours d’une même exécution.

Les objets API et Event acceptent les paramètres suivants :

| Valeur  | Type                          | Description                                                                               |
| ------- | ----------------------------- | ----------------------------------------------------------------------------------------- |
| `Key`   | `String`                      | La clé de la propriété de métadonnées à définir.                                          |
| `Value` | `String`, `Number`, `Boolean` | La valeur de la propriété de métadonnées.<br />La définir à `null` supprime la propriété. |

Pour en savoir plus sur la création d’Actions, consultez [Write Your First Action](/docs/fr-ca/customize/actions/write-your-first-action).

<div id="latency">
  ## Latence
</div>

L’utilisation de Actions Transaction Metadata pourrait entraîner une légère latence supplémentaire. Cette latence serait proportionnelle à la taille de la charge utile de métadonnées et se manifesterait lors des suspensions d’Actions. Par exemple, le déclenchement de <Tooltip tip="" cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=MFA">MFA</Tooltip>, les redirections à partir de Actions ou le rendu de Forms pourraient causer des problèmes de latence, puisqu’il faut recharger les données à partir du stockage.

Cela dit, cette latence potentielle devrait rester inférieure à celle causée par des requêtes HTTP sortantes redondantes pour récupérer les données dont la séquence d’Actions a besoin.

<div id="examples">
  ## Exemples
</div>

<div id="access-metadata-immediately">
  ### Accédez immédiatement aux métadonnées de transaction
</div>

Définissez des paires clé-valeur dans les métadonnées de transaction et accédez immédiatement aux valeurs.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('hello', 'Auth0');

  console.log('Hello ', event.transaction?.metadata?.hello);
  /* Affiche « Hello Auth0 » */
};
```

<div id="set-supported-values">
  ### Définir les valeurs prises en charge
</div>

Définissez des valeurs des types suivants : `string`, `number` et `boolean`.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('string_value', 'Auth0');
  api.transaction.setMetadata('boolean_value', true);
  api.transaction.setMetadata('number_value', 12);

  console.log('string_value', event.transaction?.metadata?.string_value);
  /* Affiche "string_value Auth0" */
  console.log('boolean_value', event.transaction?.metadata?.boolean_value);
  /* Affiche "boolean_value true" */
  console.log('number_value', event.transaction?.metadata?.number_value);
  /* Affiche "number_value 12" */
};
```

<div id="serialize-values">
  ### Sérialiser des valeurs
</div>

Sérialisez les valeurs sous forme de `chaînes de caractères` dans les [limites](/docs/fr-ca/customize/actions/limitations#transaction-metadata).

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Vous ne pouvez pas définir des valeurs de type `objet` ou `tableau`, mais vous pouvez les sérialiser en `chaînes de caractères`.
</Callout>

```text lines expandable theme={null}
exports.onExecutePostLogin = async (event, api) => {
  const serialized_object_value = JSON.stringify({
    string_value: 'Auth0',
    boolean_value: true,
    number_value: 12
  });

  api.transaction.setMetadata('serialized_object_value', serialized_object_value);

  const serialized_array_value = JSON.stringify([
    'Auth0',
    true,
    12
  ]);
  api.transaction.setMetadata('serialized_array_value', serialized_array_value);

  console.log('serialized_object_value',
    JSON.parse(event.transaction?.metadata?.serialized_object_value)
  );
  /* Affiche "serialized_object_value { string_value: 'Auth0', boolean_value: true, number_value: 12 }" */

  console.log('serialized_array_value',
    JSON.parse(event.transaction?.metadata?.serialized_array_value)
  );
  /* Affiche "serialized_array_value [ 'Auth0', true, 12 ]" */
};
```

<div id="share-values-between-actions">
  ### Partager des valeurs entre les Actions
</div>

Partagez des paires clé-valeur entre les Actions dans la même séquence d’exécution.

**Action 1**

Définissez la clé `hello` sur la valeur `Auth0` à l’aide de la méthode `setMetadata` de l’objet `api`.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('hello', 'Auth0');
};
```

**Action 2**

Consignez la valeur `Auth0` de la clé `hello` dans les métadonnées de transaction à l’aide de la propriété `transaction.metadata` de l’objet `event` pour accéder aux valeurs définies.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  console.log('Hello', event.transaction?.metadata?.hello);
  /* Affiche "Hello Auth0" */
};
```

<div id="update-metadata">
  ### Mettre à jour les métadonnées
</div>

Définissez une clé existante avec une valeur différente pour mettre à jour les métadonnées.

**Action 1**

Définissez la paire clé-valeur des métadonnées de transaction sur `custom_tx_id` et `xyz123`.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('custom_tx_id', 'xyz123');
};
```

**Action 2**

Consignez la clé `custom_tx_id` et la valeur `xyz123`. Ensuite, définissez `custom_tx_id` sur `abc456` pour consigner de nouveau la valeur la plus récente de `custom_tx_id` dans les métadonnées de transaction.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  console.log('custom_tx_id', event.transaction?.metadata?.custom_tx_id);
  /* Affiche "custom_tx_id xyz123" */

  api.transaction.setMetadata('custom_tx_id', 'abc456');

  console.log('custom_tx_id', event.transaction?.metadata?.custom_tx_id);
  /* Affiche "custom_tx_id abc456" */
};
```

**Action 3**

Consignez la valeur `abc456` de `custom_tx_id`.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  console.log('custom_tx_id', event.transaction?.metadata?.custom_tx_id);
  /* Affiche "custom_tx_id abc456" */
};
```

<div id="remove-metadata">
  ### Supprimer les métadonnées
</div>

Supprimez les valeurs des métadonnées de transaction en attribuant la valeur `null` à chaque clé concernée.

**Action 1**

Définissez `custom_tx_id` dans les métadonnées de transaction.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('custom_tx_id', 'xyz123');
};
```

**Action 2**

Définissez `custom_tx_id` sur `null` et consignez la valeur `null` de `custom_tx_id`.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  console.log('custom_tx_id', event.transaction?.metadata?.custom_tx_id);
  /* Affiche "custom_tx_id xyz123" */

  api.transaction.setMetadata('custom_tx_id', null);

  console.log('custom_tx_id', event.transaction?.metadata?.custom_tx_id);
  /* Affiche "custom_tx_id undefined" */
};
```

**Action 3**

Consigne la valeur `null` pour `custom_tx_id`.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  console.log('custom_tx_id', event.transaction?.metadata?.custom_tx_id);
  /* Affiche "custom_tx_id undefined" */
};
```

<div id="preserve-values-on-redirect-to-external-sites">
  ### Conserver les valeurs lors d’une redirection vers des sites externes
</div>

Conservez les métadonnées de transaction pendant les [redirections](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/redirect-with-actions). Les valeurs sont accessibles lorsque les utilisateurs reprennent le flux d’authentification.

**Action 1**

Définit un `custom_tx_id` dans les métadonnées de transaction.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('custom_tx_id', 'xyz123');
};
```

**Action 2**

Redirige vers un site externe en envoyant un jeton contenant le `custom_tx_id` issu des métadonnées de la transaction. Ensuite, compare la valeur de `custom_tx_id` dans les métadonnées de la transaction à celle transmise au site externe, puis renvoyée dans la charge utile d’un autre jeton.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  const token = api.redirect.encodeToken({
    secret: event.secrets.REDIRECT_SECRET,
    expiresInSeconds: 60, 
    payload: {
      custom_tx_id: event.transaction?.metadata?.custom_tx_id,
      continue_uri: `https://${event.secrets.TENANT_DOMAIN}/continue`
    },
  });

  api.redirect.sendUserTo(event.secrets.REDIRECT_URL, {
    query: { session_token: token }
  });
};

exports.onContinuePostLogin = async (event, api) => {
  const payload = api.redirect.validateToken({
    secret: event.secrets.REDIRECT_SECRET
  });

  console.log('Does custon_tx_id match?',
    payload?.custom_tx_id === event.transaction?.metadata?.custom_tx_id
  );
  /* Affiche "Does custon_tx_id match? True" */
};
```

<div id="preserve-values-on-forms-rendering">
  ### Préserver les valeurs lors de l’affichage des Forms
</div>

Les valeurs des [Forms affichés à l’aide d’Actions](/docs/fr-ca/customize/forms/render) et les valeurs des métadonnées de transaction seront conservées et resteront accessibles lorsque les utilisateurs poursuivent le flux d’authentification.

Pour en savoir plus sur l’utilisation de Forms avec Actions, consultez [Afficher des Forms à l’aide d’Actions](/docs/fr-ca/customize/forms/render).

**Action 1**

Définit un `custom_tx_id` dans les métadonnées de transaction.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('custom_tx_id', 'xyz123');
};
```

**Action 2**

Affiche un Form. Consigne ensuite le `custom_tx_id` conservé à la reprise de l'exécution d'Actions.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.prompt.render(event.secrets.FORM_ID);
};

exports.onContinuePostLogin = async (event, api) => {
  console.log('custon_tx_id', event.transaction?.metadata?.custom_tx_id);
  /* Affiche "custom_tx_id xyz123" */
};
```

<div id="share-values-with-forms">
  ### Partager des valeurs avec Forms
</div>

Vous pouvez utiliser Actions pour afficher des Forms et transmettre au Form des valeurs de métadonnées de transaction.

**Action 1**

Définit un `custom_tx_id` dans les métadonnées de transaction.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.transaction.setMetadata('custom_tx_id', 'xyz123');
};
```

**Action 2**

Affiche un Form en passant le `custom_tx_id` des métadonnées de la transaction comme paramètre `vars`. Il compare ensuite la valeur de `custom_tx_id` dans les métadonnées de la transaction à celle transmise au Form lorsque l’exécution des Actions se poursuit.

```text lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  api.prompt.render(event.secrets.FORM_ID, {
    vars: {
      custom_tx_id: event.transaction?.metadata?.custom_tx_id
    }
  });
};

exports.onContinuePostLogin = async (event, api) => {
  console.log('Does custon_tx_id match?',
    event.prompt?.vars?.custom_tx_id === event.transaction?.metadata?.custom_tx_id
  );
  /* Affiche "Does custon_tx_id match? True" */
};
```