> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/developers-guides/fr/scripting/extensions/actito.md).

# Scripts Actito

Référence du script de mappage de profil Actito, extensions.actito.profile.mapper : enregistrement, le gestionnaire MapFromActitoProfiles et un exemple.

Le connecteur Actito copie `prénom` et `nom de famille` depuis un profil Actito vers le compte Wallet. Le script de mappage de profil ajoute les autres attributs Actito dont une Carte a besoin, comme un niveau de segmentation ou un magasin préféré. Cette page est la référence pour `extensions.actito.profile.mapper`. Le connecteur lui-même est décrit sur la [page du connecteur Actito](https://docs.thewalletcrew.io/connectors/fr/marketing-automation/actito.md); les règles partagées par chaque script de connecteur se trouvent dans [Scripts du connecteur](https://docs.thewalletcrew.io/developers-guides/fr/scripting/extensions.md).

<details>

<summary><strong>Exemples concrets</strong></summary>

* Un commerçant affiche le niveau de fidélité stocké dans une colonne du profil Actito sur la Carte.
* Une marque copie le magasin préféré du profil Actito vers le compte, afin que la Carte affiche les données du magasin.

</details>

## Enregistrement

| Clé                                | Fichier des slots          | Méthodes (obligatoires en **gras**) |
| ---------------------------------- | -------------------------- | ----------------------------------- |
| `extensions.actito.profile.mapper` | `actito.profile.mapper.js` | **`MapFromActitoProfiles`**         |

Le fichier se trouve dans `server/scripts/`. L’emplacement est le **Mappage de profil** script de la **onglet Avancé** onglet des paramètres du connecteur Actito, lu et écrit avec `GET` et `PUT /api/{tenantId}/admin/extensions/actito/scripts`. Lorsqu’aucun script n’est enregistré, le mappage par défaut s’applique : `prénom` et `nom de famille` uniquement.

```js
export default function (context) {
  context.register('extensions.actito.profile.mapper', {
    MapFromActitoProfiles: (data, account) => {}
  });
}
```

## Quand il s’exécute

Le connecteur appelle le mappage à chaque fois que son fournisseur client (`actito.profile`) lit un profil Actito pour remplir le compte, juste après avoir copié `prénom` et `nom de famille` lorsque le profil les contient. Le fournisseur ne lit rien, et le mappage ne s’exécute pas lorsque le compte n’a pas d' `id.actito.profileId` identifiant. Le mappage n’a qu’un seul sens, d’Actito vers le compte. L’écriture vers Actito n’est pas effectuée par ce script.

## Gestionnaires

| Méthode                 | Paramètres          | Retours | Obligatoire | Synchrone ou asynchrone |
| ----------------------- | ------------------- | ------- | ----------- | ----------------------- |
| `MapFromActitoProfiles` | `données`, `compte` | rien    | Obligatoire | Synchrone               |

* `données` contient tous les attributs du profil Actito, chaque valeur sous forme de chaîne. Les clés sont les noms de colonne de la table de profil Actito nommée dans **Nom de la table de profil** dans la configuration du connecteur.
* `compte` est le compte Wallet, un dictionnaire plat (voir [Objets de données](https://docs.thewalletcrew.io/developers-guides/fr/scripting/data-objects.md)). Le script écrit les clés qu’il veut publier et ne change rien d’autre.

La méthode ne renvoie rien : elle modifie `compte` sur place.

## Erreurs et cas limites

* **Aucun script enregistré**: le mappage par défaut s’applique et rien n’est consigné comme erreur.
* **La méthode est manquante** dans l’objet enregistré : l’appel échoue avec `méthode MapFromActitoProfiles manquante` lorsque le connecteur l'atteint.
* **Un attribut est absent** du profil : `data['column']` se lit comme `indéfini`. Testez-la avant de la copier.
* **Le script lève**: l’erreur fait échouer la lecture du profil Actito, et avec elle l’entrée du fournisseur client qui l’a appelée.
* **Le gestionnaire est déclaré `async`**: elle n'est pas attendue, donc les modifications effectuées après un `await` sont perdues.

## Exemple

Le script conserve le mappage par défaut et ajoute un niveau et un magasin préféré. Les deux ne sont copiés que lorsque le profil les contient, de sorte qu’une colonne manquante n’efface jamais une valeur écrite par un autre fournisseur.

```js
function mapFromActito(data, account) {
  if (data['firstName']) {
    account['firstName'] = data['firstName'];
  }
  if (data['lastName']) {
    account['lastName'] = data['lastName'];
  }
  if (data['loyaltyTier']) {
    account['actito.tier'] = data['loyaltyTier'];
  }
  if (data['preferredStore']) {
    account['storeId'] = data['preferredStore'];
  }
}

export default function (context) {
  context.register('extensions.actito.profile.mapper', {
    MapFromActitoProfiles: mapFromActito
  });
}
```

Les noms de colonne `loyaltyTier` et `preferredStore` sont des espaces réservés : utilisez les noms de la table Actito propre à la marque.

## Pièges courants

* Les lignes d’enregistrement du script d’exemple sont encore commentées, donc le mappage par défaut s’applique.
* Le nom de colonne est saisi avec une casse différente de celle d’Actito : l’attribut se lit comme `indéfini`.
* Le mappage attend un nombre ou un booléen : chaque valeur de `données` est une chaîne.

## FAQ

<details>

<summary><strong>Le mappage peut-il réécrire dans Actito ?</strong></summary>

Non. Il s’exécute lorsque le profil est lu. L’état d’installation du Wallet est écrit dans Actito par le connecteur lui-même, sans script.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/developers-guides/fr/scripting/extensions/actito.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
