Créer, exporter ou importer une solution non gérée

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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, voir : TechNet : utilisation de solutions pour vos personnalisations.

Contenu de la rubrique

Créer une solution non gérée

Exporter une solution non gérée

Importer une solution non gérée

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. Pour plus d’informations sur la création d’un éditeur de solutions, voir Créer un éditeur de solution.

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	Microsoft Dynamics 365 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 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	Microsoft Dynamics 365 génère un nom unique basé sur le nom complet. Ce nom unique n’accepte que les caractères alphanumériques et les traits de soulignement. Notes 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. Il 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 :Fusionner les options d’un 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.

Pour plus d’informations sur la création d’un éditeur par programme, voir Créer un éditeur.

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 du point de terminaison OData pour Microsoft Dynamics 365, 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 empaqueter une 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.Pour plus d'informations :Exporter une solution pour une version Dynamics 365 spécifique.

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.Pour plus d'informations :Exécuter les messages en arrière-plan (de façon 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 Microsoft Dynamics 365 (Online), 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 des solutions
Customization solutions file schema
Créer, installer et mettre à jour une solution gérée
Désinstaller ou supprimer une solution

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright