Créer, exporter ou importer une solution non gérée
Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Créer, exporter ou importer une solution non gérée.
En plus d’être un composant requis pour créer une solution gérée, une solution non gérée permet pour regrouper un ensemble de personnalisations non gérées en un ensemble pouvant être transporté d’une organisation à une autre.
Pour plus d’informations : Utiliser des solutions pour vos personnalisations.
Créer une solution non gérée
Chaque solution requiert un éditeur. Si vous n’avez pas l’intention de distribuer votre solution, vous pouvez utiliser l’éditeur par défaut déjà créé pour votre organisation. Voir Créer un éditeur de solutions pour plus d’informations sur la création d’un éditeur de solutions.
Le tableau suivant répertorie les champs et les descriptions contenus par une solution.
| Étiquette de champ | Description |
|---|---|
| Nom complet | Nom de la solution. |
| Nom | Dynamics 365 Customer Engagement (on-premises) génère un nom unique basé sur le nom complet. Vous pouvez modifier le nom unique. Le nom unique contient uniquement des caractères alphanumériques ou des traits de soulignement. |
| Éditeur | Utilisez la recherche Éditeur pour associer la solution à un éditeur. |
| Version | Spécifiez une version avec le format suivant : principale.secondaire.build.révision, par exemple : 1.0.0.0. |
| Page de configuration | Si vous incluez une ressource Web HTML dans votre solution, vous pouvez utiliser cette recherche pour l’ajouter comme page de configuration désignée. Pour plus d’informations : Utiliser la page de configuration de la solution |
| Description | Utilisez ce champ pour inclure toutes les informations nécessaires sur votre solution. |
Après avoir créé une solution non gérée, vous pouvez ajouter des composants de solution en les créant dans le contexte de cette solution ou ajoutant des composants existants d’autres solutions. Pour plus d’informations sur la création d’une solution par programme, voir Créer une solution
Créer un éditeur de solution
Si vous souhaitez distribuer les solutions gérées, vous devez créer un Publisher. Le tableau suivant répertorie les champs et les descriptions contenus par un Publisher.
| Étiquette | Description |
|---|---|
| Nom complet | Nom à afficher dans le champ de recherche Éditeur de la solution. |
| Nom | Dynamics 365 Customer Engagement (on-premises) génère un nom unique basé sur le Nom d’affichage. Ce nom unique n’accepte que les caractères alphanumériques et les traits de soulignement.
Remarque : vous utilisez le Unique Name pour identifier de manière unique un Publisher. Les solutions gérées qui partagent le même éditeur peuvent se mettre à jour les unes les autres. |
| Description | Utilisez ce champ pour inclure toutes les informations nécessaires sur votre solution. |
| Préfixe | Le préfixe de personnalisation vous permet d’identifier l’éditeur ajouté à un composant de solution. Par exemple, le préfixe est ajouté au nom logique de tous les attributs ou entités créés dans le contexte d’une solution associée à cet éditeur. Le préfixe doit contenir entre deux et huit caractères et accepte uniquement des caractères alphanumériques. Elle ne peut pas commencer par « mscrm ». |
| Préfixe de valeur d’option | Cette valeur vous permet de distinguer les options que vous ajoutez aux groupes d’options pour prendre en charge les options de fusion. Une valeur est générée automatiquement en fonction du texte Préfixe pour le rendre plus unique. La valeur doit être comprise entre 10 000 et 99 999. Pour plus d’informations : Fusion des options du groupe d’options |
| Détails des contacts | Utilisez ces champs pour ajouter des informations qui permettront aux personnes qui installent la solution de vous contacter. |
Voir Créer un éditeur pour plus d’informations sur la création d’un éditeur par programme.
Utiliser la page de configuration de solution
La page de configuration de solution fournit un canevas qui vous permet d’afficher des informations ou qui permet aux clients d’effectuer des actions dans le contexte de votre solution. Définissez la page de configuration en utilisant le champ de recherche Page de configuration pour sélectionner une ressource web de page web (HTML) incluse de la solution. Ceci entraîne l’apparition d’un nouveau nœud Configuration dans la fenêtre de solution en dessous du nœud Informations et au-dessus du nœud Composants. Le nœud Configuration affiche la ressource web que vous définissez.
Vous pouvez utiliser la page de configuration de solution pour afficher les contrôles permettant de configurer votre solution. Par exemple, vous pouvez fournir certaines entités dans votre solution qui contrôlent le comportement de votre solution. À l’aide de l’API web pour l’accès aux données, vous pouvez fournir des contrôles personnalisés sur votre page de ressource web pour mettre à jour les données dans ces entités.
Exporter une solution non gérée
Vous pouvez exporter une solution non gérée dans les situations suivantes :
Vous devez modifier du contenu XML dans le fichier customizations.xml. Par exemple, vous pouvez modifier le plan de site ou créer des rubans personnalisés.
Vous souhaitez transporter votre solution non gérée d’une organisation à une autre.
Vous souhaitez créer une sauvegarde de votre ensemble actuel de personnalisations.
L’exportation d’une solution non gérée crée un fichier compressé (zippé) qui peut ensuite être importé dans une autre organisation ou dans la même organisation.
Seules les personnalisations publiées sont incluses lorsque vous exportez une solution, par conséquent assurez-vous de publier toutes les modifications avant d’exporter une solution.
Lorsque vous exportez une solution à l’aide de l’application web, si votre solution contient des composants requis manquants, l’étape Composants nécessaires manquants s’affiche. Vous pouvez ignorer cet avertissement uniquement si vous envisagez de la réimporter comme solution non gérée dans l’organisation d’origine. Sinon, suivez les instructions dans la boîte de dialogue pour annuler l’exportation et ajouter les composants nécessaires.
Utilisez le message ExportSolutionRequest pour exporter une solution par programme. Pour plus d’informations : Exporter ou créer un package de solution
Lorsque vous exportez une solution à l’aide de l’application Web, dans l’étape Paramètres système d’exportation (avancés), vous pouvez sélectionner les paramètres système à inclure dans votre solution. Les développeurs peuvent accéder à ces options en utilisant ExportSolutionRequest via les membres disponibles dans la demande. Consultez les remarques sur la demande pour obtenir des informations sur les paramètres inclus.
Vous pouvez choisir une version cible lors de l’exportation d’une solution. Vous pouvez exporter une solution compatible avec des versions antérieures. Plus d’informations : Exporter une solution pour une version Dynamics 365 Customer Engagement (on-premises).
Importer une solution non gérée
Vous devriez importer une solution non gérée dans les situations suivantes :
Vous souhaitez transporter un ensemble de personnalisations d’une organisation à une autre, et vous souhaitez autoriser la modification des composants de solution.
Vous souhaitez restaurer ou rétablir un ensemble antérieur de définitions de composants de solution.
L’importation d’une solution non gérée est un processus additif. L’importation d’une version antérieure d’une solution gérée ne supprime pas les composants de solution inclus dans une version plus récente. Toutefois, la définition de propriétés de composants de solution est remplacée avec la définition incluse dans la dernière solution non gérée que vous importez.
Important
Les modifications appliquées par l’importation d’une solution non gérée ne peuvent pas être annulées. N’installez pas une solution non gérée si vous souhaitez annuler les modifications.
Cette opération est effectuée par programme à l’aide du message ImportSolutionRequest. Vous pouvez écrire du code pour exécuter ce message de façon asynchrone. En savoir plus : Utiliser ExecuteAsync pour exécuter des messages en mode asynchrone. Vous pouvez suivre la progression de l’importation ou générer un rapport de la réussite de l’importation à l’aide de l’entité ImportJob. Pour plus d’informations : Installer ou mettre à niveau une solution
Important
L’installation de personnalisations de la solution ou de la publication peuvent compromettre le fonctionnement normal du système. Il est recommandé de planifier les importations de solutions à des moments où les utilisateurs seront moins perturbés.
Taille maximale de la solution à importer
Pour Dynamics 365 for Customer Engagement, la taille maximale d’une solution est de 29,296 Mo.
Pour les organisations locales, la taille maximale par défaut d’une solution est 6 Mo, mais elle peut être augmentée au besoin.
Modifiez la taille maximale autorisée en modifiant l’élément <httpRuntime> dans le fichier web.config pour l’application. Modifiez les attributs executionTimeout et maxRequestLength pour disposer de la taille nécessaire. Une fois que vous avez installé la solution, vous pouvez définir la taille souhaitée.
Voir aussi
Plan de développement de solutions
Empaqueter et distribuer les extensions à l’aide de la solution Dynamics 365 Customer Engagement (on-premises)
Schéma du fichier de solutions de personnalisation
Créer, installer et mettre à jour une solution gérée
Désinstaller ou supprimer une solution