Come configurare smartphone e PC. Portale informativo

Requisiti del modulo 1c 8.3. Forma, controlli

l'oggetto della soluzione applicata può essere utilizzato per eseguire alcune azioni standard. Ad esempio, qualsiasi catalogo potrebbe dover visualizzare un elenco dei suoi elementi, visualizzare singoli elementi del catalogo, visualizzare un gruppo di catalogo, selezionare elementi e gruppi di elementi dal catalogo. Per qualsiasi documento, l'elenco di tali azioni sarà molto più piccolo: visualizzazione di un elenco di documenti, selezione da un elenco di documenti e visualizzazione di un documento separato.

Per garantire l'esecuzione di tali azioni standard con i dati degli oggetti della soluzione applicata, per ciascuno di essi esiste una serie di moduli di base che verranno utilizzati durante l'esecuzione delle azioni corrispondenti. Qualsiasi modulo subordinato a questo oggetto può essere assegnato come principale. Ad esempio, la directory Clienti può avere i seguenti moduli di base:

Una caratteristica importante del sistema 1C: Enterprise 8.0 è il meccanismo dei moduli predefiniti. Questo meccanismo libera lo sviluppatore dalla necessità di creare tutte le forme possibili per ciascuno degli oggetti della soluzione applicata. È sufficiente che lo sviluppatore crei un nuovo oggetto della soluzione applicata e il sistema stesso genererà, nei momenti necessari del lavoro dell'utente, i moduli necessari di default per visualizzare le informazioni contenute in questo oggetto. Pertanto, lo sviluppatore deve creare le proprie forme di oggetti della soluzione applicata solo se dovessero presentare differenze (diverso design o comportamento specifico) dalle forme generate dal sistema per impostazione predefinita.

Il requisito principale del modulo

L'appartenenza del form all'uno o all'altro oggetto di configurazione non determina in alcun modo la composizione dei dati che il form visualizzerà. Ad esempio, è possibile creare un modulo generale che non sarà subordinato a nessuno degli oggetti di configurazione, ma che, a seconda del contenuto, visualizzerà un elenco di riferimenti o consentirà di modificare il documento. Tuttavia, non sarà più possibile designare tale modulo come principale per l'esecuzione di determinate azioni.

La forma stessa e il suo controlli separato dagli oggetti di configurazione. Affinché il modulo possa visualizzare i dati, è necessario stabilire una connessione tra il modulo stesso e la maggior parte dei suoi controlli con dati. Quando si utilizza il designer del modulo, il configuratore crea automaticamente tali collegamenti. Se lo sviluppatore crea il modulo manualmente, può definire queste relazioni impostando le proprietà del modulo e dei controlli. In ogni caso, questi collegamenti possono essere modificati tramite il linguaggio integrato durante l'esecuzione del programma.

La connessione del form e dei controlli con i dati avviene tramite gli attributi del form.

Possibilità di collegare un modulo e controlli con dati diversi è il motivo per cui il modulo e i controlli hanno più estensioni. Un'estensione è un insieme di proprietà, metodi ed eventi aggiuntivi che vengono visualizzati su un oggetto. La presenza di questa o quella estensione è determinata o dal tipo di dati che visualizza

Forme in 1C: Enterprise sono progettati per visualizzare e modificare le informazioni contenute nel database. I moduli possono appartenere a oggetti di configurazione specifici o esistere separatamente da essi ed essere utilizzati dall'intera soluzione applicativa nel suo insieme.

Ad esempio, il riferimento Nomenclatura può avere diversi moduli che verranno utilizzati per scopi specifici: modifica di un elemento del catalogo, visualizzazione di un elenco, ecc.:

Insieme a questo, potrebbero esserci moduli generali che non appartengono a oggetti di configurazione specifici: moduli generali.

Forme di base

Ciascun oggetto di configurazione può essere utilizzato per eseguire alcune azioni standard. Ad esempio, qualsiasi catalogo potrebbe dover visualizzare un elenco dei suoi elementi, visualizzare singoli elementi del catalogo, visualizzare un gruppo di catalogo, selezionare elementi e gruppi di elementi dal catalogo. Per qualsiasi documento, l'elenco di tali azioni sarà molto più piccolo: visualizzazione di un elenco di documenti, selezione da un elenco di documenti e visualizzazione di un documento separato.

Per garantire l'esecuzione di tali azioni standard con i dati degli oggetti della soluzione applicata, per ciascuno di essi esiste una serie di moduli di base che verranno utilizzati durante l'esecuzione delle azioni corrispondenti. Qualsiasi modulo subordinato a questo oggetto può essere assegnato come principale. Ad esempio, il riferimento Nomenclatura possono esistere le seguenti forme base:

E al documento Ricevimento di beni e servizi la composizione delle forme principali sarà diversa:

Quindi, se l'utente vuole vedere l'elenco delle directory Nomenclatura o elenco di documenti Ricevimento di beni e servizi, il sistema aprirà il modulo corrispondente assegnato come modulo elenco per questi oggetti.

Moduli generati automaticamente

Una caratteristica importante del sistema 1C: Enterprise 8 è il meccanismo dei moduli generati automaticamente. Questo meccanismo libera lo sviluppatore dal dover creare tutti i moduli possibili per ciascuno degli oggetti di configurazione. È sufficiente che lo sviluppatore aggiunga un nuovo oggetto di configurazione e il sistema stesso genererà i moduli necessari nei momenti necessari del lavoro dell'utente per visualizzare le informazioni contenute in questo oggetto.

Pertanto, lo sviluppatore deve creare le proprie forme di oggetti della soluzione applicata solo se dovessero presentare differenze (diverso design o comportamento specifico) dalle forme generate automaticamente dal sistema.

Collegamento di un modulo ai dati

L'appartenenza di un form all'uno o all'altro oggetto di configurazione non determina la composizione dei dati che vengono visualizzati nel form. Che il modulo appartenga, ad esempio, a una directory Nomenclatura, consente di assegnarlo a uno dei moduli principali per questa directory, ma non determina in alcun modo il tipo di dati che questo modulo visualizzerà e quale sarà il suo comportamento.

Per associare il modulo ai dati vengono utilizzati i dettagli del modulo, che indicano l'elenco dei dati visualizzati dal modulo. Tutti i moduli, di per sé, hanno lo stesso comportamento, indipendentemente dai dati visualizzati. Tuttavia, uno degli attributi del modulo può essere assegnato ad esso come principale (è evidenziato in grassetto), nel qual caso il comportamento standard del modulo e le sue proprietà saranno integrati a seconda del tipo di attributo del modulo principale:

Ad esempio, se un documento viene assegnato come attributo del modulo principale Ricevimento di beni e servizi, quindi quando chiudi il modulo, il sistema ti chiederà di confermare la registrazione e la pubblicazione di questo documento. Se assegniamo, ad esempio, un libro di riferimento come attributo principale del modulo Nomenclatura, quindi tale richiesta di conferma non si presenterà alla chiusura del modulo.

Struttura del modulo

La caratteristica principale dei moduli è che non vengono disegnati dallo sviluppatore in dettaglio, "pixel per pixel". Un modulo in una configurazione è una descrizione logica della composizione di un modulo. E il posizionamento specifico degli elementi viene eseguito automaticamente dal sistema quando viene visualizzato il modulo.

La parte visualizzata del form (visibile all'utente) è descritta come un albero contenente gli elementi del form.

Gli elementi possono essere campi di input, caselle di controllo, pulsanti di opzione, pulsanti e così via. Inoltre, un elemento può essere un gruppo che include altri elementi. Un gruppo può essere rappresentato come un pannello con una cornice, un pannello con pagine (schede), una pagina stessa, un pannello dei comandi. Inoltre, un elemento può essere una tabella, che include anche elementi (colonne). La struttura dell'elemento descrive come apparirà il modulo.

Tutte le funzionalità del form sono descritte sotto forma di attributi e comandi. I requisiti sono i dati con cui funziona il modulo e i comandi sono le azioni eseguite. Pertanto, lo sviluppatore nell'editor di moduli deve includere gli attributi e i comandi necessari nel modulo, creare elementi del modulo che li visualizzino e, se necessario, organizzare gli elementi in gruppi.

Sulla base di questa descrizione logica, il sistema genera automaticamente l'aspetto del modulo per la visualizzazione all'utente. Allo stesso tempo, il sistema tiene conto di varie proprietà dei dati visualizzati (ad esempio il tipo) al fine di disporre gli elementi del modulo nel modo più conveniente possibile per l'utente.

Lo sviluppatore può influenzare la disposizione degli elementi con impostazioni diverse. Può determinare l'ordine degli elementi, specificare la larghezza e l'altezza desiderate. Tuttavia, queste sono solo alcune informazioni aggiuntive per aiutare il sistema a visualizzare il modulo.

Nei moduli, lo sviluppatore può utilizzare non solo i comandi del modulo stesso, ma anche i comandi globali utilizzati nell'interfaccia di comando dell'intera configurazione. Inoltre è stata implementata la possibilità di creare comandi parametrizzabili che apriranno altri form in base ai dati specifici del form corrente. Ad esempio, può essere una chiamata del report sui saldi del magazzino attualmente selezionato sotto forma di fattura.

Il lavoro dell'utente con libri di riferimento e documenti in 1C consiste nel compilare i campi del modulo.

I dettagli 1C sono i campi del libro di riferimento e del documento che vengono visualizzati nel modulo per la compilazione da parte dell'utente.

Consideriamo in dettaglio l'argomento dei dettagli in 1C.

Quali sono i requisiti 1C?

Ciascun libro di riferimento e documento 1C è costituito da un insieme di campi. Tali campi sono chiamati dettagli 1C (per un programmatore 1C).

Nel configuratore, nell'albero di configurazione 1C, apri un qualsiasi riferimento o documento e vedrai il ramo Requisiti. Questo è un elenco dei requisiti (campi) della directory.

Dai un'occhiata a come appaiono gli stessi dettagli 1C sul modulo di riferimento 1C.

Ogni attributo 1C ha proprietà che indicano quale tipo di valore è memorizzato nell'attributo (stringa, numero, ecc.) e come l'utente lavorerà con esso.

Fare clic con il pulsante destro del mouse su qualsiasi proprietà 1C e fare clic su Proprietà. Nella finestra a destra si aprirà un elenco di proprietà dell'attributo selezionato.

Proprietà di base dei requisiti 1C:

Dettagli standard 1C

Come avrai notato, il modulo della directory contiene dettagli 1C che non sono elencati nel configuratore: gruppo, nome, BIC.

Nella forma dell'elenco delle directory, ci sono anche dettagli 1C che non sono nell'elenco: segno di cancellazione.

Questi sono dettagli 1C standard. Cos'è? Ciascuno ha una serie di dettagli 1C per impostazione predefinita. Per i libri di riferimento, questo è, ad esempio, un codice e un nome. Per i documenti, questa è la data e il numero.

I dettagli dello standard 1C possono essere visualizzati come segue:

  • Vai all'editor dell'oggetto 1C (libro di riferimento o documento) facendo doppio clic su di esso con il mouse
  • Nell'editor che si apre, seleziona la scheda Dati
  • Qui puoi configurare i dettagli standard Codice e Nome del libro di riferimento
  • Fare clic sul pulsante Dettagli Standard 1C per visualizzare l'elenco completo.

Dettagli generali 1C

A partire dalla versione 1C 8.2.14, un nuovo Object 1C è apparso in 1C - Dettagli generali di 1C. Usandolo, puoi aggiungere un attributo (campo), che sarà presente contemporaneamente in una varietà di directory e documenti.

Proprietà dei puntelli generali 1C:

  • Uso automatico: aggiunge un attributo 1C comune a tutte le directory e i documenti contemporaneamente
  • Composizione: consente di aggiungere un attributo 1C generale solo alle directory e ai documenti necessari (quindi utilizzare automaticamente nel valore Non utilizzare).

Come aggiungere oggetti di scena 1C

Fare clic con il pulsante destro del mouse sul ramo Requisiti 1C della directory richiesta e selezionare Aggiungi.

Dobbiamo inserire il nome della variabile 1C, ad esempio "Office Address" e il sinonimo "Office Address". Lascia il tipo predefinito come Stringa, ma seleziona la casella Lunghezza illimitata.

Aggiungiamo un altro attributo 1C allo stesso modo, basta selezionare il tipo booleano, chiamiamolo "WorksOnExit".

Come visualizzare i dettagli sul modulo 1C (client spessore 1C)

Apriamo il ramo Form della stessa directory. Per aprire il form selezionare l'elemento form e fare doppio clic su di esso con il mouse.

Trascina il mouse sul bordo della forma e allungala (elemento opzionale).

Nel pannello del configuratore, fai clic sul pulsante "Posizionamento dati". Puoi anche utilizzare il menu Modulo / Posizionamento dei dati.

Come puoi vedere, i nostri dettagli non vengono visualizzati nel modulo. Metti un segno di spunta su di loro. E anche caselle di controllo Inserisci etichette e Posiziona automaticamente.

Come visualizzare i dettagli sul modulo 1C (thin client 1C)

Apriamo il ramo Form della stessa directory. Seleziona la forma dell'elemento e fai doppio clic su di esso con il mouse.

Nella scheda Attributi, espandere la riga Oggetto. Vedrai un elenco di dettagli aggiunti in precedenza alla directory.

Ora trascina l'attributo richiesto dalla finestra di destra a quella di sinistra e apparirà sul modulo.

Dettagli modulo 1C

Nel thick client, la forma ha i suoi oggetti di scena. Si trovano nella scheda Dettagli.

Questi dettagli non vengono salvati nel database, ma possono essere utilizzati nel modulo per i campi necessari per lavorare con il modulo.

Ad esempio, hai aggiunto un segno di spunta a un modulo. Quando fai clic su di esso, accade qualcosa sul modulo. Il valore della casella di controllo non è importante per te (non è necessario annotarlo): viene utilizzato solo per cambiare il modulo quando si lavora con esso. In questo caso, non utilizzi un attributo del libro di riferimento come dati, ma un attributo del modulo.

Dettagli periodici 1C

Nella versione 1C 7.7, c'erano requisiti periodici. Il loro significato è il seguente: il significato degli oggetti di scena è diverso in date diverse. Ad esempio, il valore per il 1 settembre è uno, ma per il 1 ottobre è diverso. Avere gli stessi oggetti di scena.

Non ci sono requisiti periodici in 1C 8. Questo è implementato come segue:

Dettagli del modulo

L'insieme di attributi del modulo descrive la composizione dei dati visualizzati, modificati o archiviati nel modulo. Allo stesso tempo, i dettagli del modulo da soli non forniscono la possibilità di visualizzare e modificare i dati. Gli elementi del modulo (vedere la sezione "Elementi del modulo" di questo capitolo), associati agli attributi del modulo, vengono utilizzati per la visualizzazione e la modifica. L'insieme di tutti i dettagli del modulo verrà chiamato dati del modulo.

Importante! Ricorda che, a differenza dei moduli regolari, tutti i dati in un modulo gestito devono essere descritti come attributi. Non è consentito utilizzare le variabili del modulo del modulo come origini dati per gli elementi del modulo.

È possibile assegnare Il requisito principale del modulo, ovvero un props che definirà la funzionalità standard del form (estensione del form). Va ricordato che un form può avere un solo attributo principale.

Espansione del modulo- si tratta di proprietà, metodi e parametri aggiuntivi della form oggetto ManagedForm, caratteristica dell'oggetto che costituisce l'elemento principale della form.

Nel processo di sviluppo di un modulo, è possibile impostare in modo esplicito la possibilità di visualizzare e modificare dettagli specifici del modulo, in termini di ruoli, utilizzando le proprietà Visualizza e Modifica (per maggiori dettagli, vedere la sezione "Personalizzazione del modulo basato sui ruoli" nel capitolo "Editori"). Inoltre, la disponibilità di un particolare attributo nel modulo stesso può essere configurata utilizzando le opzioni funzionali (per maggiori dettagli sulle opzioni funzionali, vedere il capitolo "Gestione dell'interfaccia di configurazione").

Proprietà oggetti di forma Dati memorizzatiè un segno che una modifica interattiva dell'attributo porterà a un tentativo di bloccare i dati del modulo per la modifica, nonché di impostare automaticamente il segno di modifica del modulo.

Tipi di dati disponibili in forma gestita

Un modulo gestito differisce da un modulo normale anche per i tipi di dati con cui funziona. Se il modulo normale funziona con la maggior parte dei tipi forniti da 1C: Enterprise (incluso il tipo DirectoryObject, DocumentObject, ecc.), è possibile distinguere le seguenti categorie di tipi nel modulo gestito:

  • i tipi che vengono utilizzati direttamente nel form sono quelli che esistono sul lato thin e client Web (ad esempio, Number, ReferenceRef.Products, GraphicalSchema, TabularDocument);
  • tipi che verranno convertiti in tipi di dati speciali: tipi di dati del modulo gestito. Tali tipi vengono visualizzati nell'elenco degli attributi del modulo tra parentesi, ad esempio (ReferenceObject.Goods);
  • elenco dinamico (vedere la sezione "Elenco dinamico" di questo capitolo per maggiori dettagli).

Conversione di oggetti applicazione in dati modulo

Alcuni tipi di applicazioni (come DirectoryObject, ecc.) non esistono sul lato thin e client Web (per maggiori dettagli, vedere il capitolo "Il concetto di applicazione gestita"). Pertanto, per rappresentare tali tipi di applicazioni nel modulo, la piattaforma ha introdotto tipi di dati speciali progettati per funzionare in moduli gestiti. Questa funzionalità di un'applicazione gestita richiede la conversione degli oggetti dell'applicazione in dati del modulo (e viceversa).

Vengono utilizzati i seguenti tipi di dati:

  • FormDataStructure: contiene un insieme di proprietà di tipo arbitrario. Le proprietà possono essere altre strutture, raccolte o strutture con raccolte. Questo tipo è rappresentato, ad esempio, nella forma DirectoryObject.
  • Un FormDataCollection è un elenco di valori tipizzati, simile a una matrice. Si accede a un elemento in una raccolta tramite indice o identificatore. L'accesso tramite ID potrebbe non essere disponibile in alcuni casi. Ciò è dovuto al tipo di oggetto applicazione rappresentato da questa raccolta. L'identificatore può essere qualsiasi numero intero. Questo tipo è rappresentato, ad esempio, sotto forma di una sezione tabellare.
  • FormDataStructureCollection è un oggetto rappresentato contemporaneamente come struttura e insieme. Può essere trattato come una qualsiasi di queste entità. Questo tipo è rappresentato, ad esempio, sotto forma di un insieme di record.
  • FormDataTree: l'oggetto è progettato per memorizzare dati gerarchici.

Un oggetto applicazione è rappresentato da uno o più elementi di dati del modulo. In generale, la gerarchia e la composizione dei dati del modulo dipendono dalla complessità e dall'interconnessione degli oggetti dell'applicazione del modulo gestito.

Ad esempio, un documento contenente una sezione tabulare sarà rappresentato da un oggetto del tipo FormDataStructure (il documento stesso), al quale è subordinato un oggetto del tipo FormDataCollection (sezione tabulare del documento).

Importante! Quando si progetta una configurazione, è importante ricordare che gli oggetti dell'applicazione sono disponibili solo sul server, mentre gli oggetti dei dati del modulo possono essere utilizzati sia sul server che sul client.

Passaggio di dati tra lato client e back-end di un modulo gestito

Possiamo infatti affermare che i dati del form sono una rappresentazione unificata dei dati di vari oggetti applicativi, con i quali il form lavora in modo uniforme e che sono presenti sia sul server che sul client. Cioè, il modulo contiene una "proiezione" dei dati degli oggetti dell'applicazione sotto forma dei propri tipi di dati e converte tra di loro, se necessario. Tuttavia, se uno sviluppatore di configurazioni implementa il proprio algoritmo di elaborazione dei dati, allora deve eseguire la conversione dei dati (da tipi specializzati a quelli applicati e viceversa) in modo indipendente.

Quando si modificano gli attributi del modulo in un editor specializzato (per maggiori dettagli, vedere la sezione "Attributi del modulo" del capitolo "Editor"), è possibile influenzare il trasferimento dei dati tra il client e il server mentre il modulo è in esecuzione. Per fare ciò, utilizzare la colonna dell'editor degli attributi. Usa sempre... L'effetto di questa proprietà differisce per tre tipi di attributi:

  • Per un attributo subordinato a un elenco dinamico (colonna elenco dinamico):
    • proprietà on - l'attributo viene sempre letto dal database e incluso nei dati del modulo;
    • proprietà disattivata: l'attributo viene letto dal database ed è incluso nei dati del modulo solo quando è presente un elemento del modulo attualmente visibile associato all'attributo o al suo attributo subordinato.
  • Per oggetti di scena subordinati alla raccolta del movimento:
    • proprietà su - i movimenti del documento vengono letti dal database e saranno presenti nei dati del modulo;
    • la proprietà è disabilitata - i movimenti del documento non verranno letti dal database e non saranno inclusi nei dati del modulo (se non c'è un elemento del modulo che fa riferimento ai movimenti del documento).
  • Il resto dei dettagli del modulo:
    • proprietà abilitata - l'attributo sarà presente nei dati del modulo, indipendentemente dal fatto che ci sia o meno almeno un elemento del modulo associato all'attributo o al suo attributo subordinato;
    • proprietà off - l'attributo sarà presente nei dati del modulo solo se c'è un elemento del modulo associato all'attributo o al suo attributo subordinato. A differenza degli attributi di un elenco dinamico, la visibilità dell'elemento associato all'attributo non ha importanza qui.

Nota. Va ricordato che la proprietà impostata sull'attributo padre influisce su tutti gli attributi subordinati. Ad esempio, se la proprietà Use è sempre deselezionata per la sezione tabulare del documento, il sistema considera che questa proprietà è deselezionata per tutti gli attributi subordinati (nonostante lo stato effettivo della proprietà).

Metodi per convertire i dati dell'oggetto dell'applicazione in dati del modulo

Esiste una serie di metodi globali per convertire gli oggetti dell'applicazione in dati di moduli e viceversa:

  • Dati ValueInForm (),
  • FormDataValue(),
  • CopyFormData().

Importante! I metodi che funzionano con gli oggetti dell'applicazione sono disponibili solo nelle procedure server. Il metodo per copiare i valori tra i dati del modulo è disponibile sul server e sul client, poiché non richiede oggetti dell'applicazione come parametri.

Quando si convertono i dati del modulo in un oggetto applicazione, considerare la loro compatibilità.

  • FormDataValue() - converte un oggetto del tipo applicato in dati del modulo;
  • FormDataValue() - converte i dati del modulo in un oggetto del tipo applicato;
  • CopyFormData() - copia i dati del modulo con una struttura compatibile. Restituisce True se la copia è stata eseguita o False se la struttura degli oggetti è incompatibile.

Nota. Quando si eseguono azioni standard (apertura di un modulo, esecuzione del comando Scrivi standard, ecc.) di un modulo con gli attributi principali, la trasformazione viene eseguita automaticamente.

Ecco un esempio di come utilizzare la trasformazione dei dati nei tuoi algoritmi.

& Procedura AtServer OnCreateAtServer (Errore, Elaborazione standard)

ObjectGood = Libri di riferimento.Goods.FindByName ("Caffettiera") GetObject (); ValueVDataForm (OggettoOggetto, Oggetto);

Fine della procedura

& Procedura OnClient Scrivi ()

WriteOnServer ();

Fine della procedura

& AtServer Procedura WriteAtServer ()

ObjectGood = FormDataValue (Oggetto, Tipo ("DirectoryObject.Goods")); ObjectObject.Write ();

Fine della procedura

Inoltre, l'oggetto ManagedForm ha metodi disponibili sul server:

  • ValueBFormAttribute(): converte un oggetto del tipo applicato nell'attributo form specificato.
  • Form AttributeValue(): converte l'attributo dei dati del modulo in un oggetto del tipo applicato.

L'utilizzo di questi metodi è generalmente più conveniente, poiché dispongono, ad esempio, di informazioni sul tipo dell'attributo del modulo. Inoltre, il metodo FormPropsValue() esegue il mapping tra i dati del modulo e l'oggetto, utilizzato durante la generazione dei messaggi. Puoi leggere di più su questo nel capitolo "Opzioni del servizio di navigazione".

Diamo un esempio dell'utilizzo di questi metodi.

& AtServer Procedura RicalcolaAtServer ()

// Converte l'oggetto props in un oggetto applicazione. Document = AttributeFormVValue ("Oggetto"); // Esegue il ricalcolo utilizzando il metodo definito nel modulo del documento. Document.Ricalcola (); // Riconverte l'oggetto dell'applicazione in props. ValueVRequisitForm (Documento, "Oggetto");

Fine della procedura

Interfaccia di programmazione

FormDataTree (FormDataTree)

  • Trova per ID
  • Ottieni oggetti

Descrizione:

Progettato per modellare un albero in dati di moduli gestiti.

Questo oggetto può essere serializzato su/da XDTO. Il tipo XDTO corrispondente a questo oggetto è definito nello spazio dei nomi. Nome del tipo XDTO:

Ottieni oggetti

Sintassi:

GetElementi ()

Valore restituito:

Tipo: Raccolta FormDataTreeElement.

Descrizione:

Ottiene la raccolta di elementi nell'albero di primo livello.

Disponibilità: client, server, thin client, client web.

Trova per ID

Sintassi:

Trova per ID (<Идентификатор>)

Parametri:

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

Tipo: numero. L'identificatore dell'elemento albero.

Valore restituito:

Tipo: FormDataTreeElement.

Descrizione:

Ottiene un elemento della raccolta in base all'ID.

Disponibilità: client, server, thin client, client web.

FormDataTreeItem (FormDataTreeItem)

Proprietà:

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

  • GetId
  • GetParent
  • Ottieni oggetti
  • Proprietà

Descrizione:

Elemento dell'albero dei dati del modulo.

FormDataTreeItemCollection (FormDataTreeItemCollection)

Elementi della raccolta: FormDataTreeElement

Per un oggetto, la raccolta può essere attraversata utilizzando l'operatore Per ogni ... Da ... Ciclo. L'attraversamento seleziona gli elementi della raccolta. È possibile fare riferimento a un elemento della raccolta utilizzando l'operatore [...]. L'indice dell'elemento viene passato come argomento.

  • Inserire
  • Aggiungere
  • Indice (IndiceOf)
  • Contare
  • Chiaro
  • Ottieni (Ottieni)
  • Mossa
  • Eliminare

Descrizione:

Raccolta di elementi dell'albero.

Disponibilità: client, server, thin client, client web.

Guarda anche:

  • FormDataTreeElement, metodo GetElements
  • FormDataTree, metodo GetElements

Caratteristiche di lavorare con un albero di valori

Aggiornamento albero

C'è un problema cade piattaforme durante l'aggiornamento dell'albero.

Se un nodo è stato espanso nell'albero ed è stato selezionato un nodo subordinato, quando l'albero viene aggiornato con la funzione ValueInDataForm la piattaforma cade.

Soluzione: prima di eseguire l'aggiornamento, è necessario cancellare l'albero.

Ad esempio:

& AtServer Procedura ClearTree (elements) Per ogni elemento degli elementi Loop ClearTree (element.GetElements ()); Fine del ciclo; elementi.Clear (); Fine della procedura

& AtServer Procedura FillConceptionTree () dzConceptions = cpProperties.Construct ConceptTree (OnDate, Meta.CurrentIB ()); ClearTree (ConceptTree.GetElements ()); ValueVDataForms (concetto, albero dei concetti); Fine della procedura

& Procedura OnClient OnDateOnChange (Element) Fill ConceptTree (); Fine della procedura

Di seguito sono elencati i principali oggetti 1C utilizzati quando si lavora con i moduli gestiti. Vengono forniti brevi esempi di codice che dimostrano l'uso tradizionale di questi oggetti durante la scrittura di configurazioni 1C.

Questa forma

Utilizzato in un modulo modulo, nelle procedure& AtClient e & AtServer.

Consente l'accesso sia agli elementi che agli attributi del modulo.

Si accede a un elemento del modulo tramite un oggetto Elementi e assomiglia a questo:

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

Il riferimento al requisito presente nel modulo è il seguente:

ThisForm.Announcement text = "Ciao, compagni!";

Accesso semplificato agli elementi del modulo e agli oggetti di scena

In linea di principio, nel modulo form, puoi omettere la parola chiave Questa forma ... Puoi fare riferimento agli elementi e agli attributi del modulo in modo semplificato:

// Elemento del modulo

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

// Forma oggetti di scena

Testo dell'annuncio = "Salve, compagni!";

Funzionalità per ottenere i dettagli del modulo (importante!)

Se gli oggetti di scena del modulo sono di tipo semplice - Stringa, Numero, Data ... quindi puoi ottenere (impostare) il valore di un attributo semplicemente per nome:

Testo = nome del prodotto; // Il nome del prodotto è un attributo del modulo

Tuttavia, in questo modo è impossibile ottenere i dettagli del tipo "complesso" -Tabella dei valori, Albero dei valori ... Se provi a ottenere un oggetto di scena con questo tipo per nome, verrà restituito un oggetto del tipoDataFormsCollection.

Per ottenere il valore di un attributo di tipo "complesso", è necessario utilizzare la funzionePropsFormVValue():

CurrentTable = FormInValue ("SelectedConstructionObjects");

Per impostare il valore di una variabile "complessa" puoi usare la funzioneAttributo ValueBForm (<Значение>, <ИмяРеквизита>) Entrambi i parametri sono obbligatori.

Funzioni PropsFormVValue() e ValoreBForm Attributo ()disponibile solo sul Server.

Un oggetto

A rigor di termini, non esiste una parola chiave di questo tipo all'interno del modulo. È solo che quando viene creato un modulo, ad esempio un modulo elemento, 1C crea automaticamente un oggetto di scena con un nome sul modulo Un oggetto ... Questo attributo fornisce l'accesso alle proprietà dell'oggetto corrente, che viene modificato nel modulo.

o, un record più completo:

Questo oggetto

Contiene l'oggetto stesso. È inteso per ottenere un oggetto in un modulo oggetto o un modulo modulo.

Utilizzo: sola lettura.

Disponibilità: Server, Fat Client, Connessione esterna.

Principali articoli correlati