Effectuer une migration depuis l’ancienne fonctionnalité Commerce pour la France

Article
08/09/2024

Cet article explique comment effectuer la migration depuis la solution de signature numérique héritée dans la localisation de Microsoft Dynamics 365 Commerce pour la France vers la solution basée sur le cadre d’intégration fiscale du Commerce.

Si vous utilisez la solution de signature numérique héritée pour la France, vous devez effectuer la migration vers la solution d’intégration fiscale actuelle de Commerce pour tenir compte des changements et recevoir les mises à jour en temps voulu pour les fonctionnalités propres à la France. Aucune modification majeure n’est requise dans la logique d’extension que vous avez créée. Cependant, étant donné que cette mise à jour est une mise à jour majeure, certaines de vos personnalisations cesseront de fonctionner à moins que des modifications ne soient apportées de votre côté. Par conséquent, vous devez planifier, préparer et terminer l’adoption de votre environnement.

Processus de migration

Le processus de migration de l’ancienne solution de signature numérique vers la solution actuelle d’intégration fiscale repose sur le concept d’une mise à jour progressive. En d’autres termes, tous les composants de Commerce Headquarters et de Commerce Scale Unit doivent déjà être mis à jour avant que vous ne commenciez à mettre à jour le point de vente (POS).

Pour éviter les scénarios de double signature d’un événement ou d’une transaction (à la fois par l’extension héritée et l’extension actuelle), ou dans lesquels un événement ou une transaction ne peut pas être signé en raison d’une configuration incorrecte ou incomplète, nous vous recommandons de désactiver tous les appareils de PDV qui utilisent la solution héritée, puis de les mettre tous à jour simultanément. Par exemple, vous pouvez effectuer cette mise à jour simultanée magasin par magasin, en mettant à jour le profil de fonctionnalité de chaque magasin.

Procédez comme suit pour effectuer ce processus de migration :

Mettez à jour les composants de Commerce Headquarters.
Dans Commerce headquarters, configurez la fonctionnalité d’intégration fiscale pour la France.
Assurez-vous que toutes les transactions hors ligne sont téléchargées depuis les appareils Modern POS compatibles hors ligne vers la base de données des canaux.
Fermez les équipes et déconnectez-vous de tous les appareils de point de vente.
Mettez à jour les composants Commerce Scale Unit et activez les extensions de la solution actuelle.
Mettez à jour les composants du PDV et activez les extensions de la solution actuelle.
Note
- Vous ne devez activer Commerce runtime (CRT) et les extensions PDV que si vous utilisez Commerce version 10.0.28 ou antérieure. À partir de la version 10.0.29, tous les composants de canal de Commerce requis pour la France sont activés par défaut. Cependant, vous devez plutôt activer les fonctionnalités spécifiques à la France.
- Selon le type d’environnement, vous pouvez trouver plus de détails techniques sur le processus de migration dans la section Migration dans un environnement de développement ou la section Migration dans un environnement de production.
Ajustez les formats de tickets de caisse afin qu’ils utilisent des champs personnalisés mis à jour.
Activez la fonctionnalité d’intégration fiscale.
Redémarrez le PDV.

Configurer l’intégration fiscale

Pour configurer la fonctionnalité d’intégration fiscale pour la France, suivez les étapes de la section Configurer l’enregistrement fiscal et de la section Configurer les paramètres de signature numérique.

Important

N’activez pas l’intégration fiscale sur la page Paramètres partagés de Commerce à ce stade.

Ajuster les formats de tickets de caisse

Vous devez ajuster les formats de tickets de caisse afin qu’ils utilisent des champs personnalisés mis à jour. Pour des informations à jour sur les champs personnalisés pour la France, voir Configurer des champs personnalisés afin qu’ils puissent être utilisés dans des formats de tickets de caisse pour les tickets de caisse de vente.

Activer l’intégration fiscale

Lorsque vous êtes prêt à activer la fonctionnalité d’intégration fiscale dans Commerce Headquarters, procédez comme suit.

Accédez à Commerce et vente au détail > Configuration du Siège > Paramètres > Paramètres commerciaux partagés.
Dans l’onglet Général, définissez l’option Activer l’intégration fiscale sur Oui.
Accédez à Retail et Commerce > Paramétrage du canal > Paramétrage POS > Profils POS > Profils de fonctionnalité.
Sélectionnez un profil de fonctionnalité lié au magasin où le processus d’enregistrement doit être activé.
Sur le raccourci Processus d’enregistrement fiscal, sélectionnez le processus d’enregistrement fiscal que vous avez créé précédemment.
Sur le raccourci Services fiscaux, sélectionnez le profil technique du connecteur que vous avez créé précédemment.
Accédez à Commerce et vente au détail > Informatique Commerce et vente au détail > Programme de distribution.
Ouvrez le planning de distribution et sélectionnez les tâches 1070 et 1090 pour transférer des données vers la base de données des canaux.

Avertissement

Une fois les étapes précédentes terminées, vos personnalisations précédentes de la fonctionnalité de signature numérique cesseront de fonctionner.

Migration dans un environnement de développement

Note

Vous ne devez mettre en oeuvre les étapes décrites dans cette section que si vous utilisez Commerce version 10.0.28 ou antérieure. À partir de la version 10.0.29, tous les composants de canal de Commerce requis pour la France sont activés par défaut. Cependant, vous devez plutôt activer les fonctionnalités spécifiques à la France.

Mettre à jour Commerce Runtime (développement)

Pour mettre à jour Commerce Runtime (CRT), suivez ces étapes.

Recherchez le fichier de configuration de l’extension pour CRT :
- Commerce Scale Unit : le fichier est intitulé CommerceRuntime.ext.config et est disponible dans le dossier bin\ext sous l’emplacement du site Commerce Scale Unit de Microsoft Internet Information Services (IIS).
- Local CRT sur Modern POS : le fichier est intitulé CommerceRuntime.MPOSOffline.Ext.config et est disponible dans le dossier bin\ext sous l’emplacement du courtier client CRT local.
Avertissement

Ne modifiez pas les fichiers CommerceRuntime.config et CommerceRuntime.MPOSOffline.config. Ces fichiers ne sont pas destinés à des personnalisations.
Dans le fichier de configuration de l’extension, recherchez et supprimez l’ancienne extension CRT, comme illustré dans l’exemple suivant.
```
<add source="assembly" value="Contoso.Commerce.Runtime.XZReportsFrance" />
```

Dans le fichier de configuration de l’extension, ajoutez les lignes suivantes pour enregistrer l’échantillon actuel des extensions CRT.

<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ReceiptsFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RegisterAuditEventFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.XZReportsFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RestrictShiftDuration" />

Mettre à jour Modern POS (développement)

Pour mettre à jour Modern POS, procédez comme suit.

Ouvrez la solution sur RetailSdk\POS\CloudPOS.sln.

Dans le fichier extensions.json, ajoutez les lignes suivantes pour activer l’échantillon actuel de l’extension POS.

{
    "baseUrl": "Microsoft/Receipts.FR"
}, 
{
    "baseUrl": "Microsoft/FifAuditEvent.FR"
}, 
{
    "baseUrl": "Microsoft/RestrictShiftDuration"
}

Mettre à niveau Cloud POS (développement)

Pour mettre à jour Cloud POS, procédez comme suit.

Ouvrez la solution sur RetailSdk\POS\ModernPOS.sln.

Dans le fichier extensions.json, ajoutez les lignes suivantes pour activer l’échantillon actuel de l’extension POS.

{
    "baseUrl": "Microsoft/Receipts.FR"
}, 
{
    "baseUrl": "Microsoft/FifAuditEvent.FR"
}, 
{
    "baseUrl": "Microsoft/RestrictShiftDuration"
}

Supprimer les personnalisations obsolètes de l’environnement de développement après les futures mises à jour

Après une future mise à jour, vous pouvez supprimer les personnalisations obsolètes de Retail Server et de PDV de votre environnement de développement. Les procédures suivantes décrivent comment supprimer en toute sécurité des extensions.

Supprimer les extensions CRT précédentes (développement)

Pour supprimer les précédentes extensions CRT, procédez comme suit.

Recherchez le fichier de configuration de l’extension pour CRT :
- Commerce Scale Unit : le fichier est intitulé CommerceRuntime.ext.config et est disponible dans le dossier bin\ext sous l’emplacement du site Commerce Scale Unit.
- Local CRT sur Modern POS : le fichier est intitulé CommerceRuntime.MPOSOffline.Ext.config et est disponible dans le dossier bin\ext sous l’emplacement du courtier client CRT local.
Avertissement

Ne modifiez pas les fichiers CommerceRuntime.config et CommerceRuntime.MPOSOffline.config. Ces fichiers ne sont pas destinés à des personnalisations.

Dans le fichier de configuration de l’extension, recherchez et supprimez les anciennes extensions CRT, comme illustré dans l’exemple suivant.

<add source="assembly" value="Contoso.Commerce.Runtime.CommonFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.ReceiptsFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.SalesPaymentTransExt" />
<add source="assembly" value="Contoso.Commerce.Runtime.SalesPaymentTransExtFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.SequentialSignatureFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.SequentialSignatureRegister" />
<add source="assembly" value="Contoso.Commerce.Runtime.DataSignatureKeyVaultSample" />

Supprimer l’extension précédente de Retail Server (développement)

Pour supprimer l’extension précédente de Retail Server, procédez comme suit.

Recherchez le fichier de configuration pour Retail Server. Le fichier s’appelle web.config et se trouve dans le dossier racine sous l’emplacement du site IIS Retail Server.
Dans le fichier de configuration, recherchez l’ancienne extension de Retail Server dans la section extensionComposition et supprimez-la, comme illustré dans l’exemple suivant.
```
<add source="assembly" value="Contoso.RetailServer.SalesTransactionSignatureSample" />
```

Désactiver l’ancienne extension Modern POS (développement)

Pour désactiver l’ancienne extension Modern POS, procédez comme suit.

Ouvrez la solution sur RetailSdk\POS\ModernPOS.sln.

Dans le fichier extensions.json, supprimez les lignes suivantes pour désactiver l’extension POS précédente.

{
    "baseUrl": "Microsoft/AuditEvent.FR"
},
{
    "baseUrl": "SalesTransactionSignatureSample"
},
{
    "baseUrl": "SequentialSignature"
},
{
    "baseUrl": "AuditEventSignatureSample"
},
{
    "baseUrl": "SalesTransBuildNumberSample"
}

Désactiver l’ancienne extension Cloud POS (développement)

Pour désactiver l’ancienne extension Cloud POS, procédez comme suit.

Ouvrez la solution sur RetailSdk\POS\ModernPOS.sln.

Dans le fichier extensions.json, supprimez les lignes suivantes pour désactiver l’extension POS précédente.

{
    "baseUrl": "Microsoft/AuditEvent.FR"
},
{
    "baseUrl": "SalesTransactionSignatureSample"
},
{
    "baseUrl": "SequentialSignature"
},
{
    "baseUrl": "AuditEventSignatureSample"
},
{
    "baseUrl": "SalesTransBuildNumberSample"
}

Migration dans un environnement de production

Note

Mettre à jour CRT (production)

Pour mettre à jour CRT, procédez comme suit.

Dans les fichiers de configuration CommerceRuntime.ext.config et CommerceRuntime.MPOSOffline.Ext.config sous le dossier RetailSdk\Assets, supprimez l’extension CRT précédente, comme indiqué dans l’exemple suivant.
```
<add source="assembly" value="Contoso.Commerce.Runtime.XZReportsFrance" />
```

Dans les fichiers de configuration CommerceRuntime.ext.config et CommerceRuntime.MPOSOffline.Ext.config sous le dossier RetailSdk\Assets, apporter les modifications suivantes pour activer les extensions CRT actuelles.

<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ReceiptsFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RegisterAuditEventFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.XZReportsFrance" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.RestrictShiftDuration" />

Mettre à jour Modern POS (production)

Pour mettre à jour Modern POS, procédez comme suit.

Ouvrez la solution sur RetailSdk\POS\CloudPOS.sln.
Dans le fichier extensions.json, sous le dossier RetailSDK\POS\Extensions, ajoutez les lignes suivantes pour activer l’échantillon actuel de l’extension POS.
```
{
    "baseUrl": "Microsoft/Receipts.FR"
}, 
{
    "baseUrl": "Microsoft/FifAuditEvent.FR"
}, 
{
    "baseUrl": "Microsoft/RestrictShiftDuration"
}
```

Mettre à jour Cloud POS (production)

Pour mettre à jour Cloud POS, procédez comme suit.

Ouvrez la solution sur RetailSdk\POS\ModernPOS.sln.
Dans le fichier extensions.json, sous le dossier RetailSDK\POS\Extensions, ajoutez les lignes suivantes pour activer l’échantillon actuel de l’extension POS.
```
{
    "baseUrl": "Microsoft/Receipts.FR"
}, 
{
    "baseUrl": "Microsoft/FifAuditEvent.FR"
}, 
{
    "baseUrl": "Microsoft/RestrictShiftDuration"
}
```

Créer des packages déployables (production)

Pour créer des packages déployables, procédez comme suit.

Exécutez msbuild pour l’intégralité du kit de développement logiciel (SDK) Retail afin de créer des packages déployables.
Appliquer les packages via Microsoft Dynamics Lifecycle Services (LCS) ou manuellement.

Pour plus d’informations, voir Package du kit Retail SDK.

Supprimer les personnalisations obsolètes de l’environnement de production après les futures mises à jour

Après une future mise à jour, vous pouvez supprimer les personnalisations obsolètes de Retail Server et de PDV de votre environnement de production. Les procédures suivantes décrivent comment supprimer en toute sécurité des extensions.

Supprimer l’extension CRT précédente (production)

Dans les fichiers de configuration CommerceRuntime.ext.config et CommerceRuntime.MPOSOffline.Ext.config sous le dossier RetailSdk\Assets, supprimez l’extension CRT précédente.

<add source="assembly" value="Contoso.Commerce.Runtime.CommonFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.ReceiptsFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.SalesPaymentTransExt" />
<add source="assembly" value="Contoso.Commerce.Runtime.SalesPaymentTransExtFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.SequentialSignatureFrance" />
<add source="assembly" value="Contoso.Commerce.Runtime.SequentialSignatureRegister" />
<add source="assembly" value="Contoso.Commerce.Runtime.DataSignatureKeyVaultSample" />

Dans le fichier de configuration de la personnalisation de packages Customization.settings sous le dossier BuildTools, supprimez les lignes suivantes pour exclure l’extension CRT précédente des packages déployables.

<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.CommonFrance.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.ReceiptsFrance.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.SalesPaymentTransExt.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.SalesPaymentTransExtFrance.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.SequentialSignatureFrance.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.SequentialSignatureRegister.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.SequentialSignatureRegister.dll.config" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.SequentialSignatureRegister.Contracts.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.XZReportsFrance.dll" />
<ISV_CommerceRuntime_CustomizableFile Include="$(SdkReferencesPath)\Contoso.Commerce.Runtime.DataSignatureKeyVaultSample.dll" />

Dans la section ItemGroup, supprimez les lignes suivantes pour exclure l’extension Retail Server des packages déployables.

<ISV_RetailServer_CustomizableFile Include="$(SdkReferencesPath)\Contoso.RetailServer.SalesTransactionSignatureSample.dll" />

Mettez à jour le fichier de configuration Retail Server. Dans le dossier web.config sous le dossier RetailSDK\Packages\RetailServer\Code, supprimez les lignes suivantes de la section extensionComposition.
```
<add source="assembly" value="Contoso.RetailServer.SalesTransactionSignatureSample" />
```

Désactiver l’ancienne extension Modern POS (production)

Ouvrez la solution sur RetailSdk\POS\ModernPOS.sln.
Désactivez l’ancienne extension POS :
- Dans le fichier tsconfig.json, ajoutez les dossiers suivants à la liste d’exclusion :
  - SalesTransactionSignatureSample
  - SequentialSignature
  - AuditEventSignatureSample
  - SalesTransBuildNumberSample
- Dans le fichier extensions.json, sous le dossier RetailSDK\POS\Extensions, supprimez les lignes suivantes.
```
{
    "baseUrl": "Microsoft/AuditEvent.FR"
},
{
    "baseUrl": "SalesTransactionSignatureSample"
},
{
    "baseUrl": "SequentialSignature"
},
{
    "baseUrl": "AuditEventSignatureSample"
},
{
    "baseUrl": "SalesTransBuildNumberSample"
}
```

Désactiver l’ancienne extension Cloud POS (production)

Ouvrez la solution sur RetailSdk\POS\CloudPOS.sln.
Désactivez l’ancienne extension POS :
- Dans le fichier tsconfig.json, ajoutez les dossiers suivants à la liste d’exclusion :
  - SalesTransactionSignatureSample
  - SequentialSignature
  - AuditEventSignatureSample
  - SalesTransBuildNumberSample
- Dans le fichier extensions.json, sous le dossier RetailSDK\POS\Extensions, supprimez les lignes suivantes.
```
{
    "baseUrl": "Microsoft/AuditEvent.FR"
},
{
    "baseUrl": "SalesTransactionSignatureSample"
},
{
    "baseUrl": "SequentialSignature"
},
{
    "baseUrl": "AuditEventSignatureSample"
},
{
    "baseUrl": "SalesTransBuildNumberSample"
}
```

Créer des packages déployables (production)

Exécutez msbuild pour l’intégralité du kit de développement logiciel (SDK) Retail afin de créer des packages déployables.
Appliquer les packages via Lifecycle Services (LCS) ou manuellement.

Pour plus d’informations, voir Package du kit Retail SDK.

Partager via

Effectuer une migration depuis l’ancienne fonctionnalité Commerce pour la France

Processus de migration

Configurer l’intégration fiscale

Ajuster les formats de tickets de caisse

Activer l’intégration fiscale

Migration dans un environnement de développement

Mettre à jour Commerce Runtime (développement)

Mettre à jour Modern POS (développement)

Mettre à niveau Cloud POS (développement)

Supprimer les personnalisations obsolètes de l’environnement de développement après les futures mises à jour

Supprimer les extensions CRT précédentes (développement)

Supprimer l’extension précédente de Retail Server (développement)

Désactiver l’ancienne extension Modern POS (développement)

Désactiver l’ancienne extension Cloud POS (développement)

Migration dans un environnement de production

Mettre à jour CRT (production)

Mettre à jour Modern POS (production)

Mettre à jour Cloud POS (production)

Créer des packages déployables (production)

Supprimer les personnalisations obsolètes de l’environnement de production après les futures mises à jour

Supprimer l’extension CRT précédente (production)

Désactiver l’ancienne extension Modern POS (production)

Désactiver l’ancienne extension Cloud POS (production)

Créer des packages déployables (production)

Commentaires

Ressources supplémentaires