1c ajoute les détails du formulaire. Détails du formulaire géré (1Cv8). Caractéristiques du travail avec un arbre de valeurs

Détails du formulaire

Un ensemble de détails du formulaire décrit la composition des données affichées, modifiées ou stockées dans le formulaire. Dans le même temps, les détails du formulaire eux-mêmes n'offrent pas la possibilité d'afficher et de modifier des données. Les éléments de formulaire (voir la section « Éléments de formulaire » de ce chapitre) associés aux détails du formulaire sont utilisés pour l'affichage et l'édition. L’ensemble de tous les détails du formulaire sera appelé données du formulaire.

Important! Il ne faut pas oublier que, contrairement aux formulaires classiques, toutes les données d'un formulaire géré doivent être décrites sous forme de détails. Il n'est pas autorisé d'utiliser des variables de module de formulaire comme sources de données pour les éléments de formulaire.

Il est possible d'attribuer Détails du formulaire de base, c'est-à-dire les attributs qui détermineront la fonctionnalité standard du formulaire (extension de formulaire). Il faut rappeler qu’un formulaire ne peut avoir qu’un seul attribut principal.

Extension de formulaire– ce sont des propriétés, méthodes et paramètres de formulaire supplémentaires de l’objet ManagedForm, caractéristiques de l’objet qui est l’élément principal du formulaire.

Au cours du processus de développement du formulaire, vous pouvez définir explicitement la possibilité d'afficher et de modifier des détails spécifiques du formulaire, en termes de rôles, à l'aide des propriétés Afficher et Modifier (pour plus de détails, consultez la section « Paramètres du formulaire basé sur les rôles » de la section « Éditeurs). " chapitre). De plus, la disponibilité d'un attribut particulier dans le formulaire lui-même peut être configurée à l'aide d'options fonctionnelles (plus de détails sur les options fonctionnelles peuvent être trouvées dans le chapitre « Gestion de l'interface de configuration »).

Propriété d'attribut de formulaire Données enregistrées est un signe qu'une modification interactive des détails entraînera une tentative de blocage des données du formulaire pour l'édition, ainsi qu'au réglage automatique de l'indicateur de modification du formulaire.

Types de données disponibles dans un formulaire géré

Un formulaire géré diffère également d’un formulaire standard par les types de données avec lesquels il fonctionne. Si le formulaire normal fonctionne avec la plupart des types fournis par 1C:Enterprise (y compris les types DirectoryObject, DocumentObject, etc.), alors dans le formulaire géré, les catégories de types suivantes peuvent être distinguées :

• les types directement utilisés dans le formulaire sont les types qui existent du côté du client léger et du client Web (par exemple, Number, DirectoryLink.Products, GraphicScheme, TabularDocument) ;

• types qui seront convertis en types de données spéciaux : types de données de formulaire gérés. Ces types sont affichés dans la liste des détails du formulaire entre parenthèses, par exemple (DirectoryObject.Products) ;

• liste dynamique (pour plus de détails, voir la section « Liste dynamique » de ce chapitre).

Conversion d'objets d'application en données de formulaire

Certains types d'applications (comme DirectoryObject, etc.) n'existent pas côté client léger et Web (voir le chapitre Concept d'application gérée pour plus de détails). Par conséquent, pour représenter ces types d’applications dans le formulaire, la plateforme a introduit des types de données spéciaux conçus pour fonctionner dans des formulaires gérés. Cette fonctionnalité d'une application gérée nécessite de convertir les objets d'application en données de formulaire (et vice versa).

Les types de données suivants sont utilisés :

• Form DataStructure – contient un ensemble de propriétés d’un type arbitraire. Les propriétés peuvent être d'autres structures, des collections ou des structures avec des collections. Ce type est représenté, par exemple, sous la forme DirectoryObject.

• Un FormDataCollection est une liste de valeurs saisies, semblable à un tableau. Un élément de collection est accessible par index ou identifiant. L'accès par pièce d'identité peut ne pas être disponible dans certains cas. Cela est dû au type d’objet d’application représenté par cette collection. L'identifiant peut être n'importe quel nombre entier. Ce type est représenté par exemple sous la forme d'une partie tabulaire.

• Form DataStructureWithCollection est un objet qui est représenté à la fois comme une structure et une collection. Elle peut être traitée comme n’importe laquelle de ces entités. Ce type représente, par exemple, un ensemble d'enregistrements dans un formulaire.

• Form DataTree – un objet conçu pour stocker des données hiérarchiques.

Un objet d'application est représenté par un ou plusieurs éléments de données de formulaire. En général, la hiérarchie et la composition des données du formulaire dépendent de la complexité et de l'interconnexion des objets d'application du formulaire géré.

Par exemple, un document contenant une partie tabulaire sera représenté par un objet de type FormDataStructure (le document lui-même), auquel est subordonné un objet de type FormDataCollection (partie tabulaire du document).

Important! Lors du développement d'une configuration, il est important de se rappeler que les objets d'application sont disponibles uniquement sur le serveur, tandis que les objets de données de formulaire peuvent être utilisés à la fois sur le serveur et sur le client.

Transmission de données entre les parties client et serveur d'un formulaire géré

En fait, on peut dire que les données du formulaire sont une représentation unifiée des données de divers objets d'application avec lesquels le formulaire fonctionne de manière uniforme et qui sont présents à la fois sur le serveur et sur le client. Autrement dit, le formulaire contient une certaine « projection » des données de l'objet d'application sous la forme de ses propres types de données et effectue une conversion entre eux si nécessaire. Cependant, si le développeur de configuration implémente son propre algorithme de traitement des données, il doit alors effectuer la conversion des données (des types spécialisés vers les types d'application et vice versa) de manière indépendante.

Lors de l'édition des détails du formulaire dans un éditeur spécialisé (pour plus de détails, voir la section « Détails du formulaire » du chapitre « Éditeurs »), il est possible d'influencer le transfert de données entre le client et le serveur lors de l'exécution du formulaire. La colonne de l'éditeur de détails est utilisée à cet effet. Utilisez toujours. L'effet de cette propriété diffère pour trois types d'attributs :

• Pour un attribut subordonné à une liste dynamique (colonne de liste dynamique) :
  • propriété activée – l'attribut est toujours lu dans la base de données et inclus dans les données du formulaire ;
  • La propriété est désactivée : l'attribut est lu dans la base de données et inclus dans les données du formulaire uniquement lorsqu'il existe un élément de formulaire actuellement visible associé à l'attribut ou à son attribut subordonné.

• Pour les accessoires subordonnés à la collection de mouvements :
  • la propriété est activée – les mouvements de documents sont lus à partir de la base de données et seront présents dans les données du formulaire ;
  • La propriété est désactivée - les mouvements de documents ne seront pas lus dans la base de données et ne seront pas inclus dans les données du formulaire (s'il n'y a aucun élément de formulaire faisant référence aux mouvements de documents).

• Autres détails du formulaire :
  • la propriété est activée – l'attribut sera présent dans les données du formulaire, qu'il y ait ou non au moins un élément de formulaire associé à l'attribut ou à son attribut subordonné ;
  • La propriété est désactivée - l'attribut sera présent dans les données du formulaire uniquement s'il existe un élément de formulaire associé à l'attribut ou à son attribut subordonné. Contrairement aux attributs de liste dynamique, la visibilité de l'élément associé à l'attribut n'a pas d'importance ici.

Note. Il ne faut pas oublier que la propriété définie sur l'attribut parent affecte tous les attributs subordonnés. Par exemple, si la propriété Utiliser est toujours effacée pour la partie tabulaire du document, alors le système considère que cette propriété est également effacée pour tous les détails subordonnés (malgré l'état réel de la propriété).

Méthodes de conversion des données d'objet d'application en données de formulaire

Pour convertir des objets d'application en données de formulaire et inversement, il existe un ensemble de méthodes globales :

• ValueInFormData(),
• FormDataInValue(),
• CopierFormData().

Important! Les méthodes qui fonctionnent avec les objets d'application sont disponibles uniquement dans les procédures serveur. La méthode de copie des valeurs entre les données du formulaire est disponible sur le serveur et sur le client, car elle ne nécessite pas d'objets d'application comme paramètres.

Lors de la conversion des données d'un formulaire en objet d'application, vous devez tenir compte de leur compatibilité.

• ValueInFormData() – convertit un objet de type application en données de formulaire ;
• FormDataInValue() – convertit les données du formulaire en un objet de type application ;
• CopyFormData() – copie les données du formulaire qui ont une structure compatible. Renvoie True si la copie a réussi ou False si la structure de l'objet est incompatible.

Note. Lors de l'exécution d'actions standards (ouverture d'un formulaire, exécution d'une commande d'écriture standard, etc.) d'un formulaire avec les principaux détails, la conversion est effectuée automatiquement.

Donnons un exemple de la façon d'utiliser la transformation des données dans vos propres algorithmes.

&OnServerProcedure lorsque CreateOnServer (échec, traitement standard)

ObjectProduct = Directories.Products.FindByName("Coffeepot").GetObject(); ValueInFormData (ObjectItem, Objet);

Fin de la procédure

&OnClient Procédure Write()

WriteOnServer();

Fin de la procédure

&OnServer Procédure WriteOnServer()

ObjectProduct = FormDataValue(Object, Type("DirectoryObject.Products")); ObjectItem.Write();

Fin de la procédure

L'objet ManagedForm dispose également de méthodes disponibles sur le serveur :

• ValueВFormAttribute() – convertit un objet de type d'application en l'attribut de formulaire spécifié.
• FormAttributeVValue() – convertit un attribut de données de formulaire en un objet d'un type d'application.

L'utilisation de ces méthodes est généralement plus pratique, car elles contiennent, par exemple, des informations sur le type de détails du formulaire. De plus, la méthode Form AttributesValue() définit la correspondance entre les données du formulaire et l'objet, qui est utilisé lors de la génération des messages. Vous pouvez en savoir plus à ce sujet dans le chapitre « Capacités de navigation des services ».

Donnons un exemple d'utilisation de ces méthodes.

&OnServer Procédure RecalculateOnServer()

// Convertit l'attribut Object en un objet d'application. Document = Formulaire AttributesValue("Objet"); // Effectue un recalcul en utilisant la méthode définie dans le module document. Document.Recalculate(); // Convertit l'objet d'application en accessoire. ValueВFormAttributes (Document, "Objet");

Fin de la procédure

Interface logicielle

Arbre de données de formulaire

• RechercherParId
• Obtenir des éléments

Description:

Conçu pour modéliser une arborescence dans des données de formulaire gérées.

Cet objet peut être sérialisé vers/depuis XDTO. Le type XDTO correspondant à un objet donné est défini dans l'espace de noms. Nom du type XDTO :

Obtenir des éléments

Syntaxe:

Obtenir des éléments()

Valeur de retour :

Type : Collection de données de formulaire d'éléments d'arborescence.

Description:

Obtient une collection d’éléments d’arborescence de niveau supérieur.

Disponibilité : client, serveur, client léger, client web.

RechercherParId

Syntaxe:

RechercherParId(<Идентификатор>)

Possibilités :

<Идентификатор>(requis)

Tapez : Numéro. Identificateur d’élément d’arbre.

Valeur de retour :

Tapez : FormDataTreeElement.

Description:

Obtient un élément de collection par ID.

Disponibilité : client, serveur, client léger, client web.

FormDataTreeItem

Propriétés:

<Имя свойства> (<Имя свойства>)

• Obtenir un identifiant (Obtenir un identifiant)
• ObtenirParent
• Obtenir des éléments
• Propriété

Description:

Élément d’arborescence de données de formulaire.

FormDataTreeItemCollection

Éléments de collection : DataFormTreeElement

Pour un objet, il est possible de parcourir la collection à l'aide de l'opérateur For each... From... Loop. Le parcours sélectionne les éléments de la collection. Il est possible d'accéder à un élément de collection à l'aide de l'opérateur [...]. L'index de l'élément est passé en argument.

• Insérer
• Ajouter
• Index (IndexDe)
• Compter
• Clair
• Obtenir
• Se déplacer
• Supprimer

Description:

Collection d'éléments en bois.

Disponibilité : client, serveur, client léger, client web.

Voir également:

• FormDataTreeElement, méthode GetElements
• DataFormTree, méthode GetItems

Caractéristiques du travail avec un arbre de valeurs

Mise à jour de l'arborescence

Il ya un problème chutes plates-formes lors de la mise à jour de l'arborescence.

Si un nœud de l'arborescence a été développé et qu'un nœud subordonné a été sélectionné, alors lors de la mise à jour de l'arborescence avec la fonction ValueInFormData la plate-forme tombe.

Solution : Vous devez effacer l'arborescence avant la mise à jour.

Par exemple:

&Sur la procédure serveur ClearTree(elements) Pour chaque élément des éléments Loop ClearTree(element.GetElements()); Fin du cycle ; éléments.Clear(); Fin de la procédure

&Sur la procédure du serveur, remplissez l'arbre conceptuel() dConcepts = srProperties.Build Concept Tree(OnDate, Meta.CurrentIB()); ClearTree(ConceptTree.GetItems()); ValueInFormData(dConcepts, ConceptTree); Fin de la procédure

&OnClient Procédure OnDateOnChange(Element) Fill ConceptTree(); Fin de la procédure

Comment ajouter des détails supplémentaires à un élément de répertoire dans 1C Comptabilité 8.3 (révision 3.0)

Il arrive que nous n'ayons pas les capacités déjà disponibles dans 1C. Et vous n’avez pas toujours besoin de contacter un programmeur. Je vais vous parler d'un de ces cas en relation avec le nouveau 1C : Comptabilité 8.3 (édition 3.0).

Ne disposons pas de suffisamment de champs pour saisir les informations sur nos contreparties. Et nous souhaitons ajouter un nouveau champ, qui s'appellera "Statut" et aura l'une des trois valeurs suivantes - "Élevé", "Moyen" et "Faible". Je vais vous expliquer ci-dessous étape par étape comment ajouter un tel champ sans passer par le configurateur.

1. Allez dans la rubrique « Administration » et sélectionnez « Paramètres généraux » () :

2. Recherchez et cochez la case « Détails et informations supplémentaires » si elle n'est pas déjà cochée. Cliquez sur le lien « Détails supplémentaires » :

3. Dans la partie gauche de la fenêtre des paramètres qui s'ouvre, sélectionnez « Compte ». Cliquez sur le bouton Nouveau dans la barre d'outils.

4. Une fenêtre de création de nouveaux détails pour les éléments du répertoire « Contreparties » s'est ouverte. Entrez « Statut » dans le champ Nom. Laissez "Valeur supplémentaire" comme type de valeur, mais à l'avenir, gardez à l'esprit que d'autres types de valeur sont possibles (chaîne, nombre, date, etc.). Mais ce dont nous avons besoin maintenant, c'est d'une valeur supplémentaire, puisque nous voulons offrir à l'utilisateur un choix limité de trois options.

5. Pour créer chaque option, allez dans l'onglet « Valeurs », cliquez ici sur le bouton « Créer », entrez le nom de la valeur (par exemple, « Élevé ») et cliquez sur le bouton « Enregistrer et fermer ».

6. Et ainsi de suite jusqu'à ce que les trois valeurs soient créées avec les noms « Élevé », « Moyen » et « Faible », comme indiqué dans la figure ci-dessous. Cliquez sur le bouton "Enregistrer et fermer".

7. Comme vous pouvez le constater, la contrepartie a désormais l'attribut Statut dans la liste des détails supplémentaires.

8. Maintenant, si nous allons sur n'importe quel élément du répertoire des contreparties, nous verrons tout en bas du formulaire un nouveau champ Statut ( Si vous ne le voyez pas, développez le groupe « Détails supplémentaires » réduit sur le formulaire.):

9. Dans ce champ, nous pouvons remplacer l'une des trois valeurs que nous avons créées. Vous pouvez effectuer une sélection à l'aide de ce champ sous forme de liste, elle peut être affichée dans des rapports, etc.

Détails généraux en 1C 8.3 est un objet de métadonnées de plateforme qui vous permet d'utiliser un attribut pour de nombreux objets de configuration (répertoires, documents, plans comptables, etc.). L'objet a été créé principalement pour faciliter le travail du développeur et séparer les données.

Les détails généraux ont été initialement implémentés dans la version 1C 7.7, mais les développeurs ne les ont pas immédiatement inclus dans la version 8 de la plateforme. Le mécanisme des détails généraux n'a été introduit par les développeurs 1C que dans la version 8.2.14.

Il est très pratique d'ajouter des détails généraux pour ne pas modifier les objets standards dans la configuration ; je les utilise souvent avec .

Après avoir ajouté un attribut général, il peut être utilisé dans les requêtes et affiché sur le formulaire objet - Extérieurement, ce n'est pas différent des accessoires ordinaires.

La seule limitation des détails généraux est l'impossibilité de les utiliser dans .

Examinons les paramètres de base et les propriétés des détails généraux qui diffèrent des autres objets de configuration :

Composé— une liste d'objets pour lesquels les détails généraux seront utilisés ; le décor rappelle la mise en place d'un plan d'échange ;

Obtenez 267 leçons vidéo sur 1C gratuitement :

Utilisation automatique— le paramètre détermine si les accessoires généraux seront utilisés pour les objets dont le mode d'utilisation « Automatique » est spécifié.

Séparation des données— nous considérerons ce paramètre séparément.

Séparation des données dans 1C en utilisant des détails communs

Séparation des données- un mécanisme similaire au mécanisme. Cependant, les performances de ce mécanisme sont plus efficaces et il est plus facile à configurer.

Le mécanisme permet de configurer l'affichage des seuls éléments visibles par l'utilisateur. Par exemple, vous pouvez distinguer tous les objets (documents, répertoires, etc.) sur lesquels une certaine organisation est installée.

Configuration de la séparation des données à l'aide des détails généraux de 1C

Pour configurer les détails généraux, vous devez spécifier la séparation des données - Diviser. Immédiatement après avoir cliqué, le système proposera de créer des paramètres comptables par défaut :

Dans ce cas, il sera nécessaire de spécifier les paramètres de session lors du démarrage du système ; comment procéder a été décrit avec un exemple dans l'article.

Ceci termine la configuration - l'utilisateur n'aura accès qu'aux informations spécifiées dans les paramètres de session sélectionnés.

Exemple d'utilisation d'accessoires courants

Regardons la configuration des accessoires généraux dans 1C 8.3 en utilisant l'exemple d'une configuration de cadre et d'accessoires Organisation:

Le système dispose de 3 documents où il est nécessaire d'indiquer les détails de l'organisation : il s'agit de la facture de réception, de la facture de dépenses et de la paie.

La configuration est simple :

1. Créez un nouvel attribut Général, spécifiez le type - DirectoryLink.Organization.
2. Dans la composition, nous organisons nos documents - Utiliser.

Ça y est, la configuration est terminée !

Voyons le résultat :

Le système affiche les détails généraux « comme s'il s'agissait des vôtres » : dans les demandes, dans les détails des formulaires et à d'autres endroits. C'est tellement magique ! 🙂

Les conditions générales 1C 8.3 ne sont pas ajoutées

Les détails du formulaire assurent sa connexion avec les données. Dans ce cas, un (et un seul) des détails peut être désigné comme principal ; il ne s'agit pas nécessairement du type de données vers lequel nous dessinons le formulaire. Mais le comportement du formulaire dépendra du type de données de l'attribut principal. En plus de modifier le comportement du formulaire, le contexte du module de formulaire change. Outre les méthodes et propriétés du formulaire, les méthodes et propriétés de l'objet, qui est la valeur de l'attribut principal, y deviennent disponibles. Il est important que les formulaires de type Free Form ne contiennent pas de détails de base. Dans ce cas, le comportement du formulaire est déterminé uniquement par les paramètres de l'utilisateur. Examinons les questions sur les détails de base.

Question 10.05 de l'examen 1C : Plateforme Professionnelle. À quoi sert l’attribut principal du formulaire ?

1. Définit la source de données pour le formulaire dans son ensemble
2. Définit les capacités standard de la plateforme pour travailler avec le formulaire avec des données du type spécifié dans l'attribut principal
3. Pour offrir la possibilité d'accéder par programme aux détails de l'objet à partir du contexte de formulaire local
4. Fournit une visualisation des détails de l'objet dans la boîte de dialogue du formulaire
5. 2 et 3 sont corrects
6. 1 et 2 sont corrects

La bonne réponse est la numéro six, voir ci-dessus.

1. Pour décrire le contenu des données affichées, modifiées ou stockées dans un formulaire
2. Pour afficher et modifier des données dans un formulaire
3. 1 et 2 sont corrects

La bonne réponse est la troisième – les deux.

Question 10.07 de l'examen 1C : Plateforme Professionnelle. Pour attribuer des attributs de base à une forme contrôlée arbitrairement...

1. Vous devez cocher la case "Détails de base" dans les propriétés des attributs du formulaire
2. vous devez remplir la propriété « Données » du formulaire en sélectionnant l'attribut de formulaire requis

La bonne réponse est la deuxième :

1. le formulaire doit devenir le formulaire principal, les détails principaux sont déterminés automatiquement
2. Vous devez cocher la case "Détails de base" dans les propriétés des attributs du formulaire
3. vous devez aller dans le menu "Modifier", sélectionner "Détails de base" et sélectionner la valeur souhaitée
4. vous devez remplir la propriété « Données » du formulaire en sélectionnant l'attribut de formulaire requis

La bonne réponse est la quatrième :

Les principaux détails sont mis en évidence en gras :

1. C'est impossible
2. C'est possible en attribuant la valeur appropriée à la propriété d'attribut du formulaire
3. Cela n'est possible que par programmation, lors de l'accès à l'objet "Formulaire".
4. Ceci est possible en ajoutant une autre valeur à la propriété de formulaire correspondante

La bonne réponse est la première, il y a strictement une condition principale, car le lien avec l'objet doit être sans ambiguïté.

Question 10.113 de l'examen 1C : Plateforme Professionnelle. Lequel des détails du formulaire présenté dans la figure est le principal ?

1. Liste des taux de change
2. ObjetAnnuaire
3. Les formulaires d'annuaire ne contiennent pas de détails de base
4. Les formulaires d'annuaire contiennent tous les détails de base

Vous trouverez ci-dessous les principaux objets 1C utilisés lorsque vous travaillez avec des formulaires gérés. De brefs exemples de code sont donnés qui démontrent l'utilisation traditionnelle de ces objets lors de l'écriture de configurations 1C.

Ce formulaire

Utilisé dans le module formulaire, dans les procédures&Sur le client et &Sur le serveur.

Vous permet d’accéder à la fois aux éléments et aux détails du formulaire.

L'élément de formulaire est accessible via un objetÉléments et ressemble à ceci :

ThisForm.Elements.VersionNumber.Header = "v."+ProgramVersion;

L'accès aux attributs qui existent sur le formulaire se produit comme ceci :

ThisForm.Advertisement Text="Bonjour camarades !";

Accès simplifié aux éléments et détails du formulaire

En principe, vous n’êtes pas obligé de préciser le mot-clé dans le module formulaire Ce formulaire . Vous pouvez accéder aux éléments et détails du formulaire de manière simplifiée :

// Élément de formulaire

Elements.VersionNumber.Header = "v."+ProgramVersion;

// Détails du formulaire

Advertisement Text="Bonjour camarades !";

Fonctionnalités d'obtention des détails du formulaire (important !)

Si l'attribut form a un type simple - Chaîne, numéro, date ... alors vous pouvez obtenir (définir) la valeur de l'attribut simplement par son nom :

Texte = Nom du produit ; // Le nom du produit est un attribut de formulaire

Cependant, de cette manière, il est impossible d'obtenir des détails de type « complexe » -Tableau des valeurs, Arbre des valeurs . Si vous essayez d'obtenir un attribut de ce type par son nom, un objet de type sera renvoyéCollection de formulaires de données.

Pour obtenir la valeur d'un attribut de type « complexe », il faut utiliser la fonctionFormAttributesValue():

CurrentTable=FormAttributesValue("SelectedConstructionObjects");

Pour définir la valeur d'un attribut « complexe », vous pouvez utiliser la fonctionValueInFormAttributes(<Значение>, <ИмяРеквизита>) , les deux paramètres sont requis.

Les fonctions FormAttributesValue() Et ValueInFormAttributes()disponible uniquement sur le serveur.

Un objet

À proprement parler, il n’existe pas de mot-clé de ce type dans le formulaire. Simplement, lorsqu'un formulaire est créé, par exemple un formulaire d'élément, 1C crée automatiquement un attribut sur le formulaire avec le nom Un objet . Grâce à cet attribut, les propriétés de l'objet en cours d'édition sur le formulaire sont disponibles.

ou, une notation plus complète :

CetObjet

Contient l'objet lui-même. Destiné à récupérer un objet dans un module objet ou un module formulaire.

Utilisation : Lecture seule.

Disponibilité : Serveur, client lourd, connexion externe.