Les préfabriqués et les objets d'entité du monde qui sont instanciés ou copiés utilisent et partagent la fonctionnalité Verse par le biais du composant Verse.
À mesure que vous ajoutez de la fonctionnalité aux objets qui utilisent ou dépendent de composants Verse, vous pouvez modifier la fonctionnalité sous-jacente de vos objets d'entité. Récupérer vos données vous permet d'annuler les nouvelles modifications et de rétablir votre ancien ensemble de données.
Le système de récupération de données transfère les données des éléments suivants :
Champs
classes
Structures
Problèmes de sérialisation
Si vous ne récupérez pas vos données, toute modification apportée à un composant Verse établi entraînerait des défauts de sérialisation dans l'une des situations suivantes :
Renommage de propriétés
Suppression de propriétés
Modification du type d'une propriété
Dans l'exemple présenté dans ce document, une structure modifiable est utilisée pour exprimer les valeurs d'un float, d'une chaîne et d'un entier. Modifier le nom de la propriété de structure modifiable crée une propriété libre qui utilise également les données établies à partir du float, de la chaîne et de l'entier.
D'origine | Modifié |
Cliquez sur l'image pour l'afficher à sa taille réelle. | Cliquez sur l'image pour l'afficher à sa taille réelle. |
La récupération des données est utilisée pour rechercher des propriétés libres et placer une icône d'attention sur l'objet problématique.
Chaque version de l'objet modifiable conserve ses valeurs de données pour le float, la chaîne et l'entier. Vous pouvez ainsi sélectionner les données qui vous intéressent.
Problèmes identifiés
Les entités et les composants qui présentent des problèmes de sérialisation sont identifiés dans l'organiseur par une icône d'attention. Le survol de l'icône ouvre un message de sérialisation qui vous informe du type de problème de sérialisation rencontré par cet objet.
Le message d'avertissement dans l'image n'est pas représentatif du problème indiqué par le système actuel.
Sélectionner l'objet d'entité dans l'organiseur permet d'ouvrir les composants de l'entité dans le panneau Détails.
Des avertissements apparaissent également dans le panneau Détails pour les entités et les composants. Les composants présentant des problèmes de sérialisation ont une icône d'attention jaune en haut de la carte du composant.
Vous devez ouvrir les préfabriqués qui utilisent des composants dans le panneau Détails pour voir quels composants affectés sont signalés par un avertissement système.
Récupération des données
Lorsqu'une erreur a été commise ou qu'un changement ne vous est pas utile, vous pouvez récupérer les données en annulant les modifications apportées. Vous pouvez ajouter en toute sécurité la propriété précédemment supprimée pour récupérer les données perdues associées à la propriété précédente.
Cependant, si vous supprimez une classe ou que vous modifiez son nom, vous devez rétablir le code pour récupérer vos données. La restauration d'une classe rechargera le code et corrigera tous les problèmes signalés.
Renommer ou supprimer une classe entraîne un comportement de destruction.
Pour récupérer toutes les données que vous ne souhaitez pas écraser, procédez comme suit :
N'enregistrez pas vos modifications si vous avez renommé ou supprimé une classe, ou si des erreurs de compilation se sont produites.
Enregistrer votre code à ce stade entraînerait une perte de données permanente.
Ajoutez vos propriétés perdues à la classe d'origine.
Si vous décidez de conserver les modifications apportées, vous pouvez ignorer cette étape et passer à la troisième.
Rechargez l'UEFN ou recompilez votre code.
Examinez attentivement vos données. Lorsque vous êtes sûr d'avoir récupéré les valeurs de propriété que vous aviez perdues, vous pouvez procéder à l'enregistrement en toute sécurité.
Si vous décidez d'ignorer l'étape 2, l'avertissement persistera. Si les messages d'erreur persistants vous gênent, vous pouvez désactiver le système de récupération des données.
Le retour à vos noms et données de propriétés d'origine n'entraîne plus de messages d'erreur, et vous pouvez continuer à travailler sur votre niveau.