> 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/endpoints/customer-provider-obsolete.md).

# Clé de script customerProvider obsolète

Comment la clé obsolète runtime.scriptable.customerProvider continue de s’exécuter et comment migrer un script vers le fournisseur de données de carte.

{% hint style="warning" %}
**Obsolète.** Enregistrement `runtime.scriptable.passDataProvider.{scriptId}` à la place, comme décrit dans [Fournisseur de données de Carte](https://docs.thewalletcrew.io/developers-guides/fr/scripting/endpoints/pass-data-provider.md). Les anciens noms sont répertoriés dans [Noms neostore obsolètes](https://docs.thewalletcrew.io/developers-guides/fr/scripting/modules/obsolete-neo-names.md).
{% endhint %}

`runtime.scriptable.customerProvider.{scriptId}` est l’ancien nom du [fournisseur de données de Carte](https://docs.thewalletcrew.io/developers-guides/fr/scripting/endpoints/pass-data-provider.md). Les scripts enregistrés sous celui-ci continuent de fonctionner, mais le nom est obsolète : les nouveaux scripts s’enregistrent `runtime.scriptable.passDataProvider.{scriptId}`, et les scripts existants doivent être déplacés lors de leur prochaine modification. Cette page explique comment la clé obsolète est encore résolue, ce qui change avec la nouvelle clé (rien dans la configuration, davantage dans la console d’administration) et comment migrer un script en toute sécurité. Le `customerProviders` paramètre dans `server/account.yml` reste actif ; seule la clé du point de terminaison est obsolète.

<details>

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

* Un script de mappage CRM écrit il y a des années remplit le solde de points d’une Carte de fidélité ; il est renommé à la nouvelle clé en une ligne, et un `Décrire` est ajouté pour que l’éditeur de modèles de Carte liste ses champs.
* Un tenant a le même identifiant de script enregistré sous les deux clés après une migration partielle ; l’enregistrement ancien est supprimé afin qu’une seule implémentation demeure.

</details>

## Enregistrement

La clé obsolète est `runtime.scriptable.customerProvider.{scriptId}`. Elle est câblée exactement comme son remplacement, par les mêmes entrées de configuration, qui ne changent pas pendant une migration :

```yaml
# server/passes/<passType>.yml
dataProviders:
  - provider: script
    scriptId: crm
```

```yaml
# server/account.yml
customerProviders:
  - type: script
    scriptId: crm
```

Les gestionnaires sont eux aussi identiques : `Fill(entity)`, requis, et `Describe()`, facultative et synchrone. Leurs paramètres et valeurs de retour sont décrits sur la [fournisseur de données de Carte](https://docs.thewalletcrew.io/developers-guides/fr/scripting/endpoints/pass-data-provider.md) page.

## Quand il s’exécute

Chaque fois qu’une entrée avec `scriptId: crm` s’exécute, l’équipe Wallet recherche une implémentation dans cet ordre :

1. `runtime.scriptable.passDataProvider.crm`: lorsqu’il est enregistré, il s’exécute et la recherche s’arrête.
2. `runtime.scriptable.customerProvider.crm`: lorsque seule la clé obsolète est enregistrée, il s’exécute et un avertissement est consigné indiquant que le point de terminaison est obsolète et précisant la clé à enregistrer à la place.
3. Aucune des deux n’est enregistrée : l’entrée n’exécute rien et est considérée comme ayant trouvé des données.

Le même ordre s’applique à `Décrire`, que la console d’administration appelle pour lister les variables et identifiants du script.

L’avertissement est consigné une fois par version de la plateforme et par tenant pour chaque clé obsolète, plutôt qu’à chaque appel, afin qu’il reste visible dans la supervision de la plateforme sans l’inonder. L’éditeur de scripts de la configuration avancée marque également la clé obsolète comme obsolète dans ses types.

## Erreurs et cas limites

* **Les deux clés enregistrées pour le même identifiant de script**, dans un ou deux fichiers : le fournisseur de données Carte s’exécute quel que soit l’ordre de chargement, et l’enregistrement obsolète est ignoré, silencieusement. Laisser les deux en place est source de confusion, car modifier l’ancien ne change rien.
* **Un identifiant de script enregistré uniquement sous la clé obsolète**: il s’exécute, avec l’avertissement d’obsolescence.
* Les erreurs levées par `Fill` se comportent comme décrit sur la [fournisseur de données de Carte](https://docs.thewalletcrew.io/developers-guides/fr/scripting/endpoints/pass-data-provider.md#errors-and-edge-cases) page.

## Exemple

Déplacer un script consiste en une modification d’une ligne de la clé enregistrée. La configuration conserve son `scriptId`, donc les types de Carte et le fichier de compte n’ont pas besoin d’être modifiés.

Avant :

```js
async function fill(entity) {
  // lit le CRM et écrit les clés d’entité
  return true;
}

export default function (context) {
  context.register('runtime.scriptable.customerProvider.crm', {
    Fill: fill
  });
}
```

Après :

```js
async function fill(entity) {
  // lit le CRM et écrit les clés d’entité
  return true;
}

function describe() {
  return {
    namespace: 'crm',
    identifiers: [{ key: 'crm.customerId' }],
    fields: [{ path: 'loyaltyPoints', type: 'number', description: 'Solde de points actuel' }]
  };
}

export default function (context) {
  context.register('runtime.scriptable.passDataProvider.crm', {
    Fill: fill,
    Describe: describe
  });
}
```

Une migration sûre suit quatre étapes :

1. Recherchez dans la configuration avancée `runtime.scriptable.customerProvider.` pour trouver chaque enregistrement obsolète, y compris les doublons dans d’autres fichiers.
2. Modifiez la clé en `runtime.scriptable.passDataProvider.` avec le même identifiant de script, dans un seul fichier, et supprimez tout autre enregistrement du même identifiant de script.
3. Ajoutez éventuellement `Décrire`. Un `scriptId` avec un trait d’union n’est pas un namespace valide : soit renommez l’identifiant de script en camelCase dans la configuration et l’enregistrement, soit renvoyez un `espace de noms` depuis `Décrire`; sinon, les types de Carte qui répertorient le script ne peuvent pas être enregistrés.
4. Enregistrez la configuration et vérifiez une Carte avec l’inspection des données de la Carte (ci-dessous).

## Vérification du résultat

`GET /api/{tenantId}/passes/{passId}/data` renvoie, pour une Carte, chaque fournisseur de données avec son statut et les valeurs qu’il a écrites ; après la migration, l’entrée du script trouve toujours ses données et écrit les mêmes valeurs. Dans la console d’administration, l’éditeur de modèles de Carte liste le script avec son espace de noms et, une fois `Décrire` est ajouté, ses champs. L’avertissement d’obsolescence cesse d’apparaître dans la supervision de la plateforme dès qu’aucune entrée ne se résout vers l’ancienne clé.

## FAQ

<details>

<summary><strong>La migration modifie-t-elle les variables du modèle ?</strong></summary>

Non. Les valeurs sont publiées sous les mêmes clés et le même espace de noms qu’auparavant, tant que `Décrire` ne choisit pas un autre espace de noms. Lorsque `Décrire` renvoie un espace de noms différent de `scriptId`, les modèles qui lisent la forme avec espace de noms doivent être mis à jour vers le nouvel espace de noms.

</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/endpoints/customer-provider-obsolete.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.
