Ejemplos de desarrollo simple 8.3.

AP Gabets, D.I. Goncharov 1C:Enterprise 8.0 Ejemplos de desarrollo simples Moscú 1C-Publishing LLC 2005 UDC 658.012.011.56:004.42 LBC 65.29 G12 Andrey Petrovich Gabets, Dmitry Igorevich Goncharov G12 1C:Enterprise 8.0. Ejemplos simples M.: 1C-Publishing LLC, 2005. - 420 p., il. desarrollo, ISBN 5-9677-0056-0 El libro es Guia de referencia ilustrando ejemplos simples de desarrollo de algoritmos en la plataforma 1C:Enterprise 8.0. La publicación será útil para desarrolladores novatos, administradores que implementan el sistema en la empresa y usuarios avanzados que desean perfeccionar soluciones de aplicaciones de forma independiente. el libro contiene un gran número de ejemplos prácticos, agrupados por tema de uso. Además, el libro contiene un indicador detallado de las propiedades, métodos y eventos del lenguaje integrado que se usa en los ejemplos. Este libro complementa, pero no reemplaza, la documentación estándar para el producto de software incluido en el paquete de entrega y le permite usar las capacidades del programa de manera más efectiva. Editado por M.G. Radchenko. 4601546 025616 ISBN 5-9677-0056-0 El derecho de reproducción y distribución del libro pertenece a la empresa "1C-Publishing". Se prohíbe la copia total o parcial de los materiales del libro sin el permiso por escrito de la empresa "1C-Publishing". 1C-Palishingm LLC, 2005 ÍNDICE Introducción 16 ¿Cómo trabajar con una publicación? Tipos primitivos, funciones del sistema 17 18 (D ¿Cómo especificar explícitamente la fecha requerida? ¿Cómo verificar una fecha para un valor vacío? ¿Cómo comparar dos fechas? (días) Cómo agregar un día a un mes de fecha Datos colocados en el almacén de valores Cómo permitir que el usuario seleccione un valor de un tipo compuesto Cómo aplicar el redondeo cuando se trabaja con campos numéricos calculados en una consulta Cómo mostrar un advertencia de varias líneas Cómo decirle al usuario la hora actual al procesar ¿Cómo mostrar el número en palabras en ruso, pero sin una parte fraccionaria? ¿Cómo imprimir el monto en dólares en palabras en inglés? ¿Cómo cargar un componente externo? ¿Cómo ejecutar un comando del sistema operativo? ¿Cómo implementar el código del procedimiento según el modo de ejecución (cliente, servidor, conexión externa)? ¿Cómo implementar la estrategia "o todo o nada" en el procesamiento grupal de objetos? ¿Cómo calcular la cantidad usando la fórmula de interés compuesto? Arreglos de colecciones genéricos (D ¿Cuándo se usan comúnmente los arreglos? ® ¿Cómo creo un arreglo? ¿Cómo creo un arreglo multidimensional? ¿Cómo agrego elementos a un arreglo? 30 31 32 32 32 32 33 34 Tabla de contenido Cómo determinar el tamaño de una matriz Cómo acceder a un elemento de una matriz ® Cómo recorrer los elementos de una matriz Cómo eliminar un elemento de una matriz Cómo eliminar todos los elementos de una matriz Cómo eliminar elementos duplicados de una matriz ¿Cómo copiar una matriz? ¿Cómo comprobar si dos matrices son idénticas? Los datos que contienen los nombres de las contrapartes se cargaron en la matriz. ¿Cómo ordenarlos? Hay una matriz en la que se descargan los valores del tipo DirectoryReference.Nomenclature. ¿Cómo eliminar todos los valores de matriz vacíos? ¿Cómo obtener una matriz de posiciones de artículos utilizadas en las secciones tabulares "Nomenclatura" y "Paquete" de la factura? Hay dos tablas de valores. ¿Cómo obtener una matriz de nombres de columna coincidentes? ¿Cómo hacer una selección en la solicitud por varias opciones para completar el atributo del tipo "ListingReference"? ¿Cómo obtener del registro de información "Nóminas de la Organización" en forma de una matriz de todas las nóminas de un determinado departamento de la organización? Estructura F ¿En qué situaciones se suelen utilizar objetos del tipo "Estructura"? q ¿Cómo crear una estructura? q ¿Cómo agregar elementos a la estructura? P ¿Cómo referirse a un elemento de estructura? q ¿Cómo iterar sobre los elementos de una estructura? q ¿Cómo eliminar un elemento de estructura? ¿Cómo establecer un valor para un elemento con una clave específica en una estructura? ¿Cómo obtener datos multidimensionales en una estructura? ¿Cómo recopilar información sobre las selecciones establecidas en el formulario de la revista? ¿Cómo determinar si hay un elemento con la clave "Cuenta" en la estructura, y si lo hay, pero contiene un valor de referencia vacío o Indefinido - eliminar este elemento? Cómo obtener todas las filas de la sección tabular "Bienes" del documento donde el valor del atributo "Precio" es igual a cero, y el valor del atributo "Tasa de IVA" es igual al valor de "IVA 18" de la enumeración “Tasa de IVA”? ¿Cómo obtener datos sobre la política contable vigente de la organización a partir del registro periódico de información en una fecha determinada? ¿Cómo formar la estructura de los nombres de los detalles de la parte tabular de un documento arbitrario? ¿Cómo obtener los datos de la parte tabular del documento por consulta, teniendo la estructura de los nombres de los detalles de la parte tabular? Correspondencia 34 34 35 36 37 37 38 39 40 41 42 43 44 45 47 47 47 48 48 49 50 50 51 52 53 53 55 55 57 Índice ¿En qué situaciones se suelen utilizar objetos de tipo "Conformidad"? q ¿Cómo puedo crear una coincidencia? q ¿Cómo agregar elementos para que coincidan? q ¿Cómo referirse al elemento de coincidencia? P ¿Cómo iterar sobre elementos coincidentes? q ¿Cómo elimino un elemento de coincidencia? ¿Cómo obtener datos del partido? ¿Cómo obtener una correspondencia de varios niveles de tipos de cálculo que tienen tipos de cálculo básicos? 57 57 57 58 58 59 59 60 Lista de valores, tabla de valores, árbol de valores 63 f ¿En qué situaciones se usan comúnmente listas de valores, tablas de valores, árbol de valores? q ¿Cómo crear una lista de valores? q ¿Cómo agrego elementos a una lista de valores? q ¿Cómo encontrar el elemento de la lista de valores? q ¿Cómo acceder a un elemento de una lista de valores? q ¿Cómo recorrer los elementos de una lista de valores? q ¿Cómo eliminar un elemento de una lista de valores? q ¿Cómo crear una tabla de valores y llenar sus campos? q ¿Cómo encontrar un valor en una tabla de valores? ® ¿Cómo recorrer las filas de una tabla de valores? q ¿Cómo eliminar filas (columnas) de la tabla de valores? ¿Cómo llenar la tabla de valores si los nombres de las columnas están contenidos en variables? ¿Cómo llenar toda la columna de la tabla de valores con el valor deseado? ¿Cómo llenar la tabla de valores "TableReceiver" con los datos de la tabla de valores "SourceTable"? ¿Cómo agregar columnas a la tabla de valores "ValueTable" con restricciones de tipo? ¿Cómo cambiar el tipo de valor de una columna de una tabla de valores obtenidos al descargar de una consulta? ¿Cómo poblar el árbol de valores usted mismo? Objetos de aplicación Libros de referencia F ¿Cómo crear un elemento (grupo) del libro de referencia? q ¿Cómo encontrar un elemento del directorio? q ¿Cómo eliminar una entrada del directorio? f ¿Cómo iterar sobre los elementos del directorio? q ¿Cómo seleccionar todos los elementos de un determinado grupo? F ¿Cómo iterar a través de los elementos de un directorio subordinado usando una consulta? F ¿Cómo iterar sobre los elementos de un directorio subordinado usando una selección del directorio? f ¿Cómo abrir el formulario de la lista (elemento) del directorio? 63 64 64 65 65 66 66 67 68 69 69 71 71 72 74 75 76 78 78 78 80 81 82 83 85 86 86 f ¿Cómo eliminar filas de la parte tabular del directorio? F ¿Cómo ordenar las filas de la parte tabular del directorio? P ¿Cómo crear un elemento en el grupo deseado? ¿Cómo puedo saber si el elemento actual tiene hijos? ¿Cómo saber el número de elementos subordinados del elemento del diccionario seleccionado? ¿Cómo averiguar el número de elementos subordinados del elemento del diccionario seleccionado, si el número de directorios subordinados es más de uno? ¿Cómo obtener todos los padres del elemento seleccionado del directorio? ¿Cómo obtener el código "completo" de los elementos del directorio por consulta, si el tipo de código es String? ¿Cómo obtener todos los elementos del diccionario que contienen una determinada subcadena en el nombre, con toda la jerarquía a la que pertenecen? ¿Cómo encontrar todos los elementos del directorio en los que no se completa el atributo de cadena? ¿Cómo transferir todos los elementos del directorio "Contratistas" de un grupo a otro? ¿Cómo organizar la selección programática de un elemento de directorio? ¿Cómo guardar la foto de un empleado en el directorio "Empleados"? Documentos ® ¿Cómo creo un nuevo documento? q ¿Cómo puedo encontrar un documento? F ¿Cómo abrir un formulario de documento? f ¿Cómo cambiar el valor del atributo y guardar el documento? F ¿Cómo agregar una línea a la parte tabular del documento, teniendo un enlace al documento? f ¿Cómo eliminar filas de la parte tabular del documento? q ¿Cómo recorrer las líneas de un documento? f ¿Cómo descargar la parte tabular del documento? f ¿Cómo calcular el total en la parte tabular del documento? q ¿Cómo publico un documento? q ¿Cómo ordenar los documentos? q ¿Cómo marco todas las facturas entrantes para su eliminación? ¿Cómo, teniendo un enlace a un documento, crear una copia del mismo en la base de datos? f ¿Cómo, teniendo un enlace a un documento, leer sus movimientos en el registro? ¿Cómo determinar en qué registros realizó movimientos el documento? ¿Cómo eliminar filas con un valor cero del atributo "Cantidad" en la parte tabular del documento? ¿Cómo borrar la columna "Tasa de IVA" en el campo de la tabla "Bienes" de un documento ya completado? ¿Cómo poblar los valores de propiedad de un nuevo documento basado en uno existente? 87 87 88 89 90 91 93 94 96 98 98 99 100 102 104 104 104 105 105 107 107 108 108 108 109 109 111 111 112 113 115 117 ¿Cómo obtener lista de recibos de cotización no ocupados? ¿Cómo determinar el tipo de cambio de la contabilidad de gestión en la fecha de la factura? La moneda de la contabilidad de gestión se almacena en el registro periódico de información ¿Cómo puedo llamarlo no operativo desde la forma de un documento? ¿Cómo obtener los saldos relevantes para la posición del documento en el procesamiento de contabilización? ¿Cómo determinar la cantidad de documentos y la cantidad de valores de atributos diferentes en la tabla de registros de documentos? La dimensión "Organización" se ha agregado a la secuencia "Contabilidad por lotes". ¿Cómo ahora obtener datos sobre los límites de la secuencia para cada valor de esta dimensión? Almacenamiento de información ® ¿Cómo agrego una entrada a un libro de información independiente no periódico? f ¿Cómo leer el contenido de un registro de información independiente no periódico? ¿"Contrapartes propias"? F ¿Cómo borrar todas las entradas del registro de información independiente? f ¿Cómo eliminar registros de un registro de información independiente con una selección para una organización específica? q ¿Cómo agregar una entrada al registro periódico de información independiente? f ¿Cómo leer (cambiar) registros en el registro periódico independiente de información? f ¿Cómo eliminar entradas en el registro periódico de información independiente? ¿Cómo eliminar todos los registros de monedas con los nombres "EUR" y "USD" en el registro periódico de información independiente "Tipos de cambio", cuyo período es inferior al 01 de enero de 2005? ¿Cómo leer datos relevantes para una fecha determinada del registro de información "Tipos de cambio" con selección por varias monedas (selección por dimensiones)? ¿Cómo cambiar el período para los registros de un registro independiente periódico que cumplen una serie de condiciones? ¿Cómo “hacer periódicos” los puntales de un directorio ya completado? q ¿Cómo agregar asientos al registro de información subordinado al registrador? f ¿Cómo leer (cambiar) las entradas en el registro de información subordinado al registrador? q ¿Cómo eliminar asientos del registro de información dependiente del registrador? Contabilidad F ¿Cómo crear contabilizaciones en el registro contable? q ¿Cómo obtengo el saldo de mi cuenta? q ¿Cómo obtener la facturación de la cuenta? q ¿Cómo obtengo los saldos de las cuentas? 118 119 120 121 122 123 124 124 125 126 126 127 128 128 129 131 132 134 137 138 139 140 140 142 143 143 ¿Cómo encontrar el primer documento que condujo a la aparición de un saldo acreedor en la cuenta? ¿Cómo seleccionar todas las cuentas cuyos análisis contienen el tipo de subconto "Contraparte" o el tipo de subconto "Acuerdo"? ¿Cómo seleccionar todas las cuentas cuyos análisis contienen tanto el subconto tipo "Contraparte" como el subconto tipo "Nomenclatura"? Cómo agregar el nuevo tipo subconto a la cuenta? ¿Cómo obtener el volumen de negocios solo en cuentas en moneda extranjera del registro contable "Autosuficiente"? ¿Cómo seleccionar en el registro contable los volúmenes de negocios "autosuficientes" en las cuentas "60", excluyendo los volúmenes de negocios internos entre ellos? ¿Cómo implementar el método "red storno" para el registro contable? Cálculos periódicos complejos (D ¿Cómo obtener la cantidad de acumulación para un tipo específico de cálculo para el empleado especificado en el período especificado? (D ¿Cómo obtener la suma de todas las acumulaciones para el empleado especificado en el período especificado? ¿Cómo obtener el tabla de recálculos para recálculos de varios registros Cómo determinar los números de línea para el documento "Nómina a empleados" Cómo crear un recibo de pago para un empleado Cómo organizar la reversión de liquidaciones pasadas que ya se han realizado Procesos comerciales otros objetos de aplicación ¿Cómo, sin abrir un formulario de procesamiento externo, ejecutar su procedimiento para un objeto específico? (D ¿Cómo obtener rápidamente información sobre todos los objetos que están dentro de la competencia de un gerente en particular) por ventas? Formularios y controles Trabajar con formularios (D ¿Cómo abrir un formulario de documento? F ¿Cómo abrir un formulario de procesamiento externo? (D ¿Cómo abrir un formulario de informe para que no se superponga con el formulario desde el que se abre? 144 145 146 147 147 149 151 152 154 154 155 156 157 158 159 162 162 167 169 169 169 172 172 172 172 173 ". ¿Cómo abrir el formulario del directorio "Acuerdos de contrapartes" subordinado a él? ¿Cómo mostrar en el formulario la imagen guardada? en los detalles del directorio? ¿Cómo seleccionar solo los documentos "Reclutamiento" en el diario de documentos "Contabilidad de personal"? ¿Cómo averiguar el intervalo de fechas en el diario actual abierto? ¿Cómo al abrir el directorio, hacer una selección por contrapartes incluidas en la lista? grupo abierto ¿"Compradores"? Campo de tabla f ¿Cómo evitar que el usuario cambie el orden de las columnas en un campo de tabla? P ¿Cómo evitar que el usuario cambie la configuración de cualquier columna de un campo de tabla? q ¿Cómo mostrar información sobre qué filtro está configurado en el diario de documentos? f ¿Cómo colocar el cursor sobre un elemento con un nombre conocido en forma de directorio? f ¿Cómo en forma de lista hacer una selección por el valor del atributo? ¿Cómo deshabilitar el mensaje: "Los datos ingresados ​​​​no se muestran en la lista porque no coinciden con la selección" al agregar nuevos elementos al directorio? q ¿Cómo llenar una celda de campo de tabla con datos? ¿Cómo cambiar el color de fondo de una celda de campo de tabla según el valor que se muestra en ella? ¿Cómo agregar una nueva columna "Contrato principal" al campo de la tabla "Contratistas seleccionados", completar sus valores y habilitar la apertura de estos valores? ¿Cómo establecer una lista de selección para la columna "Tipo de documento" de un campo de tabla? ¿Cómo garantizar la posibilidad de seleccionar y ordenar datos por detalles que no se muestran en el campo de tabla del formulario de lista de búsqueda? ¿Cómo implementar arrastrar y soltar entre controles? ¿Cómo mostrar los saldos de existencias en la lista de artículos? Otros controles ® El formulario tiene un panel con páginas. ¿Cómo colocar una imagen en un marcador? F ¿Cómo asegurarse de que al abrir el formulario de un elemento ya registrado del directorio "Contrapartes", la pestaña "Cuentas y acuerdos" del panel "Panel" esté activa? ¿Cómo organizar una selección de varias listas de documentos para abrir? ¿Cómo puedo organizar la sustitución de un recurso a una persona? 173 174 175 176 176 177 177 178 181 181 181 182 182 183 184 185 186 187 189 190 190 193 194 194 195 195 197 ¿Cómo asignar "teclas de acceso rápido" al botón creado? ¿Cómo implementar el llenado de posibles valores del campo de selección "ProcessedTablePart" al completar el campo de entrada "ProcessedDocument"? q Si el usuario ha especificado varias fechas en el campo del calendario, ¿cómo recorrerlas? q ¿Cómo organizar el trabajo con el indicador? ¿Cómo puedo cambiar la fuente de datos de un control? q ¿Cómo puedo configurar la representación de la fecha que se muestra en el campo de entrada de forma predeterminada? F ¿Cómo mostrar texto en el campo de la imagen si la imagen no está seleccionada? P ¿Cómo abrir un cuadro de diálogo de selección de color estándar para el usuario? ¿Cómo llenar una lista en un formulario con datos de consulta? q ¿Cómo mostrar un archivo de diagrama gráfico en un formulario? Interfaces, estilos f ¿Cómo configurar diferentes estilos para 1C:Enterprise para diferentes categorías de usuarios? Hay una lista de nombres de interfaz con notas. ¿Cómo hacer visibles las interfaces etiquetadas? ¿Cómo deshabilitar el controlador de espera global desde el formulario de procesamiento? Consultas, informes Consultas ¿Cómo obtener datos de la sección tabular de los documentos? ¿Cómo obtener datos de la parte tabular de los documentos y presentarlos en forma jerárquica? ¿Cómo contar el número de elementos idénticos en datos seleccionables? ¿Cómo aplicar condiciones para filtrar por valores de campo calculados como resultado de una función agregada? ¿Cómo limitar la selección de la mesa virtual? ¿Cómo sumar los datos por los mismos valores de uno de los campos en la selección? ¿Cómo obtener solo aquellos registros en los que el valor de un determinado campo supera el valor especificado? ¿Cómo hacer referencia a campos subordinados en una consulta? ¿Cómo combinar los resultados de múltiples consultas? ¿Cómo seleccionar datos de dos tablas que satisfagan una determinada condición? ¿Cómo complementar los datos de una tabla con datos seleccionados de otra tabla según una determinada condición? ¿Cómo combinar datos de dos tablas según una determinada condición? ¿Cómo mostrar algún valor en lugar de NULL en una consulta? 10 198 200 201 202 203 205 206 209 211 212 212 213 213 214 215 216 216 216 217 218 219 220 221 223 224 225 226 227 228 231 ¿Cómo obtener totales jerárquicos para un grupo de directorios? ¿Cómo encontrar el último documento “Recibo de Bienes y Servicios”, según el cual salió la nomenclatura, según el registro de “Saldos en Almacén” a una fecha determinada? ¿Cómo contar la cantidad de registros con el mismo valor de algún campo? ¿Cómo mostrar el número de registros diferentes en registros totales? ¿Cómo obtener el número de registros en el resultado de una consulta? ¿Cómo comprobar la suficiencia del saldo de mercancías en los almacenes especificados en el documento? ¿Cómo filtrar por valor de enumeración en una consulta? ¿Cómo obtener tipos de cambio para dos fechas interesantes? ¿Cómo obtener una tabla de discrepancias entre las tasas de liquidaciones mutuas de todos los documentos emitidos "Orden de Compra" con la tasa oficial con una sola solicitud? ¿Cómo escribir una consulta de tal manera que algunas funciones de resumen se consideren en un cierto nivel de la jerarquía de consultas y otras en otro nivel? ¿Cómo obtener una lista de documentos que trajeron los datos del registro periódico de información subordinado a un estado determinado? ¿Cómo establecer los parámetros de consulta si el texto de la consulta no se conoce de antemano? Análisis de datos ¿Cómo obtener datos sobre bienes vendidos juntos? (D ¿Cómo recomendar productos relacionados? (D ¿Cómo ver lo que se comprará en el futuro? Informe de resultados Documento de hoja de cálculo, documento de texto ¿Cómo mostrar el resultado de una consulta en un documento de hoja de cálculo? ¿Cómo mostrar datos en un documento de hoja de cálculo con la capacidad de contraer y expandir datos por ¿Cómo colapsar al enviar datos a un documento de hoja de cálculo todas las agrupaciones de salida? ¿Cómo, al enviar datos a un documento de hoja de cálculo, cómo determinar arbitrariamente la composición de agrupaciones colapsadas y expandidas? (D ¿Cómo descargar el resultado de una consulta que muestra el jerarquía? (D ¿Dónde y cómo puedo ver el diseño generado automáticamente por el generador de informes? F Cómo transferir datos desde el generador de informes 261 1 Tabla de contenido Cómo guardar la configuración del generador de informes hasta la próxima apertura del formulario de informe ¿Cómo organizar la visualización de notas en el documento de hoja de cálculo generado? f ¿Cómo asegurarse de que la primera columna y la primera línea del documento de hoja de cálculo "DocumentResult" no se impriman al ingresar la impresión? F ¿Cómo asegurarse de que la parte superior del documento de hoja de cálculo generado por el generador de informes se fije en el segmento del encabezado de la tabla? f El generador de informes genera el documento de hoja de cálculo. Al imprimir un documento de hoja de cálculo, ¿cómo asegurarse de que el encabezado de la tabla se muestre en cada página? q ¿Cómo imprimir el número de documento, la fecha y el número de página en los encabezados de página al imprimir un documento "largo"? ® El documento de hoja de cálculo se genera de acuerdo con el diseño generado automáticamente por el generador de informes. ¿Cómo configurar la orientación de la página al imprimir? El generador de informes genera el documento de hoja de cálculo. ¿Cómo configurar la salida sin una parte fraccionaria para todos los indicadores numéricos mostrados? q ¿Cómo puede un generador de informes combinar el propósito de su diseño y el uso de uno de los diseños de diseño estándar? ¿Cómo omitir solo los registros totales al obtener datos de una consulta? ¿Cómo omitir solo los totales jerárquicos al obtener datos de una consulta? f ¿Cómo mostrar una imagen en un documento de hoja de cálculo? ¿Cómo mostrar una imagen en un documento de hoja de cálculo sin cambiar el diseño? ¿Cómo trabajar con una tabla dinámica? ¿Cómo colocar datos mediante programación en una tabla dinámica y formatearla? Como crear formulario impreso con una plantilla de texto? Gráficos f ¿Cómo completo un gráfico con datos? ¿Cómo llenar una tabla de medidas con datos? q ¿Cómo mostrar el resultado de una consulta en un gráfico dinámico? q ¿Cómo llenar un diagrama de Gantt con datos? ¿Cómo vincular los intervalos del diagrama de Gantt? ¿Cómo manejar el cambio interactivo de los intervalos del diagrama de Gantt? ¿Cómo colocar etiquetas no periódicas en el diagrama de Gantt? ¿Cómo resaltar algunos intervalos de fondo del diagrama de Gantt? Esquema geográfico ¿Cómo visualizo un archivo de esquema geográfico en un formulario? q ¿Cómo visualizo un diseño de mapa en un formulario? q ¿Cómo cambio la escala del esquema geográfico? 12 266 268 271 271 272 273 273 274 276 276 278 279 280 280 282 283 287 287 289 291 293 295 296 298 300 301 301 301 301 ¿Cómo usar una tabla de valores como fuente de datos de esquema geográfico? Administración Ejecución de 1C:Enterprise desde la línea de comandos © ¿Cómo iniciar 1C:Enterprise desde la línea de comandos? ¿Cómo forzar a 1C:Enterprise a descargar la base de datos desde la línea de comando? ¿Cómo actualizar los cambios de configuración actuales en la configuración de la base de datos desde la línea de comandos? ¿Cómo probar y reparar una base de datos sin verificar la integridad referencial en modo automático? ¿Cómo realizar una comprobación de configuración en modo automático con la salida de los resultados de la comprobación en un archivo? ¿Cómo reducir el registro mediante programación? ¿Cómo descargar módulos de solución de aplicaciones como archivos de texto desde la línea de comandos? ¿Cómo cargar archivos de ayuda guardados en formato .htm en la solución de la aplicación? Varios q ¿Cómo cambio el valor de la fecha de trabajo? P ¿Cómo configurar/eliminar el modo exclusivo? q ¿Cómo hago una entrada en el registro de registro? q ¿Cómo obtener datos sobre los usuarios registrados de la infobase? q ¿Cómo puedo determinar la información general del sistema? ¿Cómo agregar programáticamente un usuario a la base de datos? ¿Cómo crear su propio archivo de registro para registrar los resultados del procesamiento externo? ¿Cómo mostrar una lista de usuarios que trabajan con esta base de datos en un formulario? ¿Cómo descargar el archivo de registro en formato XML? ¿Cómo forzar el cierre de todos los usuarios de la base de datos en el modo cliente-servidor? Integración 302 303 305 305 305 306 306 307 307 309 309 310 311 311 311 312 313 314 315 317 318 318 320 321 Archivo de texto 321 XML 324 f ¿Cómo descargar datos del directorio a un archivo de texto? q ¿Cómo cargar datos desde un archivo de texto? Trabajar con texto. Modelo de acceso secuencial ¿Cómo mover un documento de una base de datos a otra base de datos? 321 322 322 324 13 Índice ¿Cómo se puede formar un documento XML de estructura arbitraria? ¿Cómo convertir un documento XML en una cadena? ¿Cómo se pueden intercambiar datos utilizando la serialización XML a través de archivos de otros formatos? ¿Cómo puedo cargar un documento XML de estructura arbitraria? 326 327 328 329 Archivos DBF 331 Trabajando con documentos HTML 332 f ¿Cómo puedo construir una carga-carga usando archivos DBF? F Rellenar cuestionarios HTML Trabajar con archivos ¿Cómo organizar un cuadro de diálogo para seleccionar un archivo de texto? P ¿Cómo leer información sobre un archivo? q ¿Cómo obtener una lista de archivos en un directorio específico? ¿Cómo mover un archivo publicado en ftp a mi computadora local? ¿Cómo dividir un archivo grande en varios archivos de un tamaño específico? ¿Cómo poner archivos en un archivo? ¿Cómo comparar dos archivos de texto? ¿Cómo organizar el control de la generación de archivos por una aplicación externa? ActiveX P ¿Cómo uso los controles ActiveX? 331 332 335 335 336 336 337 337 338 338 340 341 341 Diseños de documentos activos 343 Trabajar con Internet 345 Trabajar con objetos COM 351 ¿Cómo crear un nuevo contrato basado en un archivo de Microsoft Word? 343 Trabajar con correo electrónico 345 ¿Cómo organizar el trabajo con correo electrónico a través de un cliente de correo instalado? 345 ¿Cómo organizar el trabajo con correo sin un cliente de correo instalado en la computadora del usuario? 346 Trabajar con archivos 349 Cargar archivos a través de FTP 349 Ejecutar una solicitud HTTP 350 f Cómo transferir el saldo de bienes de una base de datos 1C:Enterprise 8.0 a otra base de datos mediante una conexión COM Ejemplo de acceso al programa 1C:Enterprise 8.0 desde el MS Módulo de Excel a través de una conexión COM q ¿Cómo organizar la lectura de datos de archivos *.xls? Cómo ejecutar una macro grabada en libro microsoft¿sobresalir? Cómo crear un documento de programa Microsoft Excel no hay formato dado en otro documento? q ¿Cómo puedo descargar una lista de precios en un documento de Microsoft Word? 14 351 353 355 356 357 359 Índice f ¿Cómo consultar una base de datos SQL arbitraria? Cliente/Servidor de Automatización (OLE) ¿Cómo completar de forma interactiva un documento de una base de datos 1C:Enterprise 8.0 en otra base de datos utilizando Cliente/Servidor de Automatización (OLE)? ¿Cómo cargar una lista de elementos en 1C:Enterprise con la capacidad de editar desde una hoja de cálculo de Excel? El intercambio de datos<Э Как организовать работу удаленных складов? Как при создании начального образа управлять тем, какие виды объектов перегружаются, а какие нет? Как просмотреть объекты, для которых зарегистрированы изменения? Как организовать обмен данными между произвольными конфигурациями 1С:Предприятие 8.0? Как принудительно зарегистрировать изменения объектов? WEB-расширение ф Как в форме списка номенклатуры отменить все установленные отборы? Как запретить перенос содержимого ячеек в форме списка расходных накладных? Как открыть список расходных накладных с отбором, установленным по определенному складу? Как добавить кнопку для ввода документа на основании? Указатель 362 363 363 364 366 366 369 371 372 379 380 380 382 384 388 389 15 Введение Идея написать эту книгу возникла у нас не случайно. Платформа системы «1С: Предприятие 8.0» специально ориентирована на то, что ее будут использовать не только как средство разработки, но и как инструмент быстрой доработки «на месте». В таких случаях специалисту важно в сжатые сроки решить конкретную задачу без долгого изучения всех возможностей системы. Как преподаватели учебного центра - мы, разумеется, только за то, чтобы специалист был изначально методологически и всесторонне «подкован». Но как практикующие разработчики, кроме всего прочего, зачастую и сами с большей радостью используем описанные примеры решения тех или иных задач, нежели пытаемся воссоздать их по памяти или по методическим материалам. Собственно говоря, именно с целью помочь в подобных ситуациях, и была написана эта книга. Основой ее создания послужил опыт преподавания «программистских курсов» по системе, работа на конкретных внедрениях и активное общение в форумах, посвященных данному кругу проблем. Фактически книга составлена в результате анализа того, какие задачи приходится решать чаще всего как начинающим, так и продвинутым разработчикам. При подборе примеров мы исходили из того, что спектр навыков и знаний специалистов, которые будут работать с данным изданием, может быть очень широк. Поэтому пусть Вас не смущают некоторые особо «бородатые» советы или, наоборот, - отсутствие подробного описания тех или иных технологий. А для тех, кто практически не знаком с системой «1С:Предприятие 8.0», материал самых простых примеров, объясняющих азы использования объектов и механизмов системы, помечен специальным значком ф. Кроме этого, поскольку работа с настоящим изданием не требует досконального чтения всего материала, по тексту намеренно вставлены повторы некоторых приемов или предостережений в тех случаях, когда это имеет смысл. Также следует заметить, что мы стремились сделать именно сборник простых примеров, поэтому некоторые материалы вошли в издание в «разрезанном» виде. То есть вместо сложных и громоздких «сквозных» примеров, мы старались представить отдельные части, «кирпичики», из которых впоследствии можно собрать желаемое. 16 Введение Стиль изложения соответствует цели издания, поэтому материал предоставляется в форме вопросов и ответов, как, например, в следующем разделе: Как работать с изданием? Решение данного вопроса - многовариантно. Можно читать классическим способом. От начала до конца, помечая или закладывая понравившиеся места. Впоследствии, при возникновении конкретных вопросов, зрительная память или закладки помогут найти нужное решение. Можно читать выборочно. Любимая поговорка крутых программистов: «Мануал открывать надо уже в последний момент». То есть, проблема возникла - нашли раздел и попытались найти решение, или идею решения по аналогии. Но поговорку, на самом деле, мы совсем не одобряем! Можно вообще не читать. Не читать комментарии. А рассматривать издание как сборник «шпаргалок» кода, решающего те или иные вопросы. Остальные варианты использования издания или не очень нравятся авторам, или достаточно опасны. Например, не надо рассматривать эту книжку как замену полноценного обучения или работы с методическими материалами. 17 Примитивные типы, системные функции Как явно указать нужную дату? Для указания нужной даты можно пользоваться: литералом вида ТГГГММДДччммсс" встроенного языка; встроенной функцией преобразования значений Дата(); литералом типа Дата языка запросов. В таблице ниже приводится ряд возможностей явного указания даты при помощи встроенного языка: Выражение "20050308" Дата(2005, 1,1) Дата(1, 1, 1) Дата(2005, 1, 1, 10, 29, 50) Значение результата (тип) 08.03.2005 0:00:00 (Дата) 01.01.2005 0:00:00 (Дата) 01.01.0001 0:00:00 (Дата) 01.01.2005 10:29:50 (Дата) В случае же, если в тексте запроса необходимо жестко указать некую дату - используется литерал ДАТАВРЕМЯ(). Например, поле со значением "01.01.2005 0:00:00" можно получить так: Как проверить дату на пустое значение? Значение типа Дата не бывает «пустым». Если в явном виде значение переменной типа Дата не задано, она будет иметь значение по умолчанию: начало первого дня первого месяца первого года (00 часов 00 минут 00 секунд). Поэтому проверку проще сделать так: 18 Примитивные типы, системные функции Как сравнить две даты (дни)? Точность данных типа Дата - до секунды. А сравнивать нужно именно дни. Тогда проще предварительно для сравниваемых дат воспользоваться функцией, которая возвращает, например, дату начала дня. А потом уже сравнивать полученные значения. Как прибавить к дате день, месяц? Так как тип Дата содержит дату и время с точностью до секунды, то для того чтобы к некоторой дате прибавить один день, нужно увеличить ее значение на количество секунд, содержащихся в одном дне: Для увеличения или уменьшения даты на некоторое количество месяцев, можно использовать: функции работы со значением типа Дата во встроенном языке; функции работы со значением типа Дата в запросах. В таблице ниже приводится ряд возможностей использования функций встроенного языка: Выражение ДобавитьМесяц(Дата(2005, 1, 31), 1) ДобавитьМесяц(Дата(2005, 2, 28), -1) КонецМесяца(ДобавитьМесяц(Дата(2005, 2, 28), -1)) Значение результата (тип) 28.02.2005 0:00:00 (Дата) 28.01.2005 0:00:00 (Дата) 31.01.2005 23:59:59 (Дата) 19 Примитивные типы, системные функции А вот пример функции, добавляющей количество дней к исходной дате при помощи запроса: В тексте запроса используем функцию ДОБАВИТЬКДАТЕ(). В качестве параметров ей необходимо передать исходную дату, тип добавляемых периодов (в нашем случае жестко прописали «День») и количество добавляемых периодов. Первый и последний параметры передали запросу, считав их из параметров (заголовка) нашей функции. Далее запрос выполняется, и из него получаем значение выходного поля по первой (и единственной) строке. Результаты выполнения вышеприведенной функции будут такими: ПолучитьДень("20052802", 10) = 10.03.2005 0:00:00 ПолучитьДень("20042802", 10) - 09.03.2004 0:00:00, поскольку 2004 год был високосным! Как можно проверить тип значения переменной на равенство нужному? 20 Примитивные типы, системные функции ТипЗнч() - функция языка, возвращающая по значению его тип. Тип () - функция языка, возвращающая значение типа Тип по строковому имени типа. Как очистить реквизит формы, имеющий ссылочный тип? К примеру, реквизит (имя «Товар») имеет тип СправочникСсылка.Номенклатура. Для очистки значения в связанном с ним элементе управления на форме, необходимо выполнить строку кода: То есть необходимо установить значение по умолчанию. А им, в данном случае, будет пустая ссылка на элемент справочника «Номенклатура». Как очистить значение, имеющее тип «Хранилище значения»? Очистить значение, записанное в реквизит или ресурс «РеквизитХранилище») можно следующим образом: (имя Как проверить тип значения, помещенного в реквизит имеющий тип «Хранилище значения»? По причинам не связанным с возможностями системы 1С:Предприятие 8.0, в реквизит «Фотография» (тип ХранилищеЗначения) справочника «Сотрудники» помещалась либо Строка (преобразованная к типу ХранилищеЗначения), либо Картинка (преобразованная к типу ХранилищеЗначения). Как проверить, что было записано? 21 Примитивные типы, системные функции Проверку можно осуществить, используя следующие строки кода: Следует отметить, что в реквизит имеющий тип ХранилищеЗначения можно поместить только значение, имеющее тип ХранилищеЗначения. Работа со значением, помещенным в хранилище значения, может начаться только после его получения (метод Получить()). После получения значение «восстанавливает свой прежний тип». Если полученное значение равно Неопределено, то это означает, что никакое значение в реквизит не записывалось. Как сжать данные, помещаемые в хранилище значения? Допустим, в реквизит «СопроводительнаяИнформация» (тип значения - Хранилище значения) помещается значение переменной «ПомещаемоеЗначение». Нужно обеспечить максимальное сжатие данных закладываемого значения. Вторым параметром конструктора хранилища значения передается объект СжатиеДанных. Он тоже получен соответствующим конструктором, с указанием максимального уровня сжатия. 22 Примитивные типы, системные функции Как предоставить пользователю возможность выбора значения составного типа? Для реализации этой задачи необходимо воспользоваться конструктором объекта ОписаниеТипов. А для него необходимо передавать в качестве параметра массив разрешенных для вводимого значения типов значения. Когда конструктором «ОписаниеВозможныхТипов» собрано применяем функцию для вызова диалога ввода данных ВвестиЗначение(). Первым параметром функции необходимо указать доступную в данном модуле переменную для принятия введенного значения. Вторым - заголовок открываемого окна. Третьим - объект ОписаниеТипов. После ввода значения пользователем можно считать значение с переменной, переданной первым параметром. 23 Примитивные типы, системные функции Как применить округление при работе с вычисляемыми числовыми полями в запросе? Например, составляется запрос для оценок средней цены продажи по данным регистра «Продажи». Для получения данных с точностью до двух знаков после запятой текст запроса может выглядеть следующим образом: Источником для запроса является виртуальная таблица «РегистрНакопления.Продажи.Обороты», построенная по данным регистра в интервале между «ДатаНач» и «ДатаКон». В качестве выходных полей берем «Номенклатура» и результат деления значения полей источника «СтоимостьОборот» и «КоличествоОборот». Причем оператором ВЫРАЗИТЬ() тип последнего поля приводится к примитивному типу ЧИСЛО с определенным форматом (длинна 15, точность 2). Как вывести многострочное предупреждение? Переменные «Остаток» и «Зарезервировано» содержат значения, которые необходимо вывести в виде предупреждения. Кроме того, нужно еще вывести свободный остаток, вычисляемый по формуле: СвободныйОстаток = Остаток - Зарезервировано. Все это может быть выполнено следующим образом: 24 Примитивные типы, системные функции Процедура глобального контекста Предупреждение() выводит на экран модальное окно предупреждения. Текст предупреждения передается первым параметром, вторым - таймаут, содержащий указание количества секунд, через которое окно самостоятельно закроется (если раньше его не закроет пользователь), третьим - указывается заголовок окна. Многострочность предупреждения в нашем примере осуществляется за счет добавления значения ПС (перевод строки) системного набора значений СИМВОЛЫ в текст предупреждения. Обратите внимание на вычисление свободного остатка в скобках для обеспечения корректности выполнения арифметических действий и преобразования данных к типу Строка. Кроме того, хотелось бы предупредить об опасности попыток применения процедуры Предупреждение() в ходе проведения документов. Проведение документов выполняется в транзакции, поэтому использование каких либо интерфейсных решений, останавливающих работу системы, является совершенно неприемлемым. В подобных случаях лучше информировать пользователей посредством Сообщить(). Как при выполнении обработки сообщить пользователю текущее время? Метод ТекущаяДата() возвращает системную дату. Тип значения Дата. В его значение входит и дата и время. Для получения представления только времени можно применяем функцию Формат(). Как вывести число прописью по-русски, но без дробной части? Для этого используется функция ЧислоПрописью(). У нее могут быть указаны в качестве параметров: преобразуемое число; форматная строка; параметры предмета исчисления (вид этой форматной строки определяется значением кода локализации). 25 Примитивные типы, системные функции Все возможные варианты локализаций описаны в файле Locllnfo.txt, входящем в комплект поставки программы. Для решения нашей задачи можно использовать следующий текст: В форматной строке указываем код локализации - Русский(Россия). В параметрах предмета исчисления показываем, что дробная часть не должна содержать ни одного разряда. Для ВыводимоеЧисло = 234,4 результат будет: «Двести тридцать четыре». Как вывести число прописью по-русски, с указанием сотых в дробной части? В параметрах предмета исчисления указываем возможные спряжения и склонения слов «целая» и «сотая», а так же количество разрядов дробной части, которые будут выводиться прописью. В форматной строке указываются код языка локализации и необходимость вывода дробной части прописью. Для ВыводимоеЧисло - 123,45 результат будет: «Сто двадцать три целых сорок пять сотых». 26 Примитивные типы, системные функции Как вывести прописью число килограммов с указанием дробной части в граммах? В отличие от вышеприведенного примера здесь предметами исчисления являются килограммы и граммы, а количество разрядов дробной части - три. Для ВыводимоеЧисло = 12,345 результат будет: «Двенадцать килограммов триста сорок пять граммов» Как долларовую сумму вывести прописью поанглийски? Для ВыводимоеЧисло = 1 232,45 результат будет: «One thousand two hundreds thirty two dollars 45 cents» Какзагрузитьвнешнююкомпоненту? Загрузим компоненту, позволяющую работать со сканером штрихкодов: 27 Примитивные типы, системные функции В случае ошибки загрузки компоненты или создания объекта возникает исключительная ситуация, которую рекомендуется отрабатывать с помощью конструкции Попытка. Как выполнить команду операционной системы? К примеру, требуется удалить все файлы из указанного каталога. Для реализации данной возможности достаточно выполнить следующую строку кода: Для просмотра доступных команд можно в командной строке системы выполнить команду «help». Вызвать командную строку, можно выполнив строку кода: Кроме этого, для запуска внешнего приложения (или открытия файла с использованием ассоциированного с ним приложения) может быть использован метод глобального контекста ЗапуститьПриложение(). В этом случае запуск приложения будет осуществляться непосредственно, минуя командный интерпретатор. Например: 28 Примитивные типы, системные функции Как реализовать код процедуры в зависимости от режима выполнения (на клиенте, на сервере, во внешнем соединении) ? Если алгоритм должен выполняться по-разному в зависимости от места выполнения процедуры, то можно воспользоваться инструкциями препроцессора: 29 Примитивные типы, системные функции Как при групповой обработке объектов реализовать стратегию «либо все, либо ничего»? Требуется загрузить либо все данные по справочнику «Единицы измерения», либо, в случае возникновения ошибки, нужно чтобы ни один элемент не был записан. Для реализации стратегии «либо все, либо ничего» можно использовать следующий фрагмент кода: Если необходимо но мере накопления каких-либо признаков «искусственно» отменить действия, совершаемые в транзакции, можно использовать метод системы: МО Примитивные типы, системные функции Как посчитать сумму по формуле сложного процента? Возведение в степень реализуется функцией Pow(). Первым параметром передается основание степени, вторым - показатель степени. Замечание: кроме работы со степенями математический аппарат системы позволяет работать с корнями, логарифмами и тригонометрическими функциями. 31 Универсальные коллекции Массив В каких ситуациях обычно используются массивы? Массив является универсальной коллекцией, то есть объектом, предназначенным для работы с временными наборами данных в течение сеанса работы пользователя. Необходимость в его использовании возникает, когда требуется работать с временным набором данных. Чаще всего это промежуточные операции обработки информации: подготовка отборов, реализация поиска, подготовка группирования, передача параметров и проч. Массивы могут создаваться оператором Новый или получаться в результате применения методов некоторых объектов. Как создать массив? Создание массивов чаще всего происходит посредством оператора Новый: где «СозданныйМассив» - имя переменной, которая будет содержать созданный объект типа Массив. После создания к массиву можно добавлять элементы (произвольное количество). Если же мы хотим создать массив с заранее определенной размерностью, это можно сделать так: В результате в переменной «СозданныйМассив» будет создан массив с десятью значениями. Для такого массива можно потом сразу обращаться к любому из десяти значений (начиная с нулевого по девятое) для записи или для чтения. А при необходимости к такому массиву можно так же еще добавлять новые элементы. Первый же добавленный элемент получит индекс «10». 32 Массив Как создать многомерный массив? Массив является линейной динамической коллекцией с произвольным типом значений. Поэтому значениями массива могут выступать другие массивы. То есть создание массива массивов и решает задачу создания многомерного массива. Это можно делать при использовании конструктора массива: или в процессе добавления очередных элементов к массиву: И в том и в другом случае мы решим задачу создания двумерного массива размерностью 2x8. Чтение и запись значений такого массива можно производить посредством директивного указания индексов: или при помощи метода Получить(): Хотелось бы еще раз отметить, что создание массива определенной размерности конструктором ограничивает только количество возможных к заполнению значений массива, но не препятствует добавлению новых значений (в качестве которых могут выступать массивы произвольной размерности). 33 Универсальные коллекции Как добавить элементы в массив? Допустим, массив, к которому нужно добавить значение из переменной «НовоеЗначение», называется «НашМассив». Если нужно просто добавить очередной элемент (с индексом на единицу больше самого старшего) - действуем следующим образом: Если нужно, чтобы новые значения добавлялись с определенным индексом, то можно использовать метод Вставить(): Как определить размер массива? Чтобы определить можно сделать так: количество элементов массива «НашМассив» Однако имейте в виду, поскольку индексация элементов массива начинается с нуля - значение переменной «Размер» будет на единицу больше значения самого старшего индекса. Как обратиться к элементу массива? При обращении как для записи, так и для чтения элементов массива лучше пользоваться оператором , указывая индекс элемента. Помните, что индексация начинается с нуля. Пусть в переменную «ПервоеЗначение» нужно считать значение самого первого элемента массива, а в элемент массива с индексом «9» записать значение из переменной «ДесятоеЗначение»: 34 Массив Аналогичных результатов можно добиться при помощи методов Получить() и Установить(): Замечание: в любом случае, чтобы иметь возможность обратиться к элементу массива, он должен уже существовать. Иначе получим ошибку с сообщением о том, что индекс находится за границами массива. Как перебрать элементы массива? Если перебор элементов массива нужен для чтения данных из массива - проще всего организовывать посредством цикла перебора коллекции. Например, чтобы вывести сообщения о каждом числе, найденном в массиве «МассивЭлементов», достаточно сделать следующее: Обратите внимание, «ЭлементМассива» - это произвольное имя переменной, принимающей в себя очередное значение элемента коллекции при выполнении цикла. Если же при переборе элементов массива нужно их редактировать, то для этого нужно работать еще и с индексами элементов. Лучше тогда использовать так называемый «цикл-счетчик». Например, чтобы обнулить все числовые элементы массива, достаточно сделать следующее: 35 Универсальные коллекции «Сч» - это переменная, принимающее очередное значение счетчика на каждом выполнении цикла. Именно из нее и будем считывать значение индекса очередного элемента массива. Значение самого большого индекса массива определяется посредством метода ВГраница(). Как удалить элемент массива? Удаление отдельных элементов массива происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границы массива - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» массива приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Массив как бы «сомкнет ряды». Поэтому, например, один из наиболее простых вариантов удаления всех числовых элементов массива может выглядеть так: Сначала определяем самый старший индекс элементов массива. Цикл проверок и удалений чисел будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов массива проводится с конца, эффект «смыкания рядов» будет производиться только для уже проверенных элементов. 36 Массив ® Как удалить все элементы массива? Если требуется полное удаление элементов из массива, операция выполняется гораздо проще: Как удалить повторяющиеся элементы массива? Поскольку объект «массив» является одной из самых простых универсальных коллекций, методами поиска по значению он не обладает. Поэтому для того, чтобы удалить повторяющиеся элементы, следует перебрать все элементы массива и проверить их значения. Для выполнения поставленной задачи организуется два цикла: в первом цикле осуществляется перебор элементов массива и для каждого выбранного элемента осуществляется вложенный цикл сравнения 37 Универсальные коллекции текущего элемента с последующими элементами массива. В случае совпадения значений последующий элемент массива удаляется. Когда для очередного элемента с индексом «ТекущийИндекс» завершился вложенный цикл проверки с последующими - увеличиваем значение «ТекущийИндекс» на единицу с тем, чтобы следующий по индексу элемент попал в положение проверяемого. Как скопировать массив? Для получения копии массива в другом объекте (массиве) необходимо создать новый массив (массив-копию) конструктором. Далее в цикле перебора элементов исходного массива добавлять эти элементы в массив-копию. Массив Как проверить, что два массива идентичны? Это можно выполнить при помощи следующей функции. В качестве параметров ей передаются сами проверяемые массивы «ПервыйМассив» и «ВторойМассив». Сначала проверяем совпадение наибольших индексов в массивах, если совпадения нет - массивы уже не идентичны. Значит функция возвращает значение ЛОЖЬ. Далее необходимо произвести проверку идентичности элементов массивов с одинаковыми индексами. Поскольку индексация элементов массива начинается с нулевого значения - выполняем цикл-счетчик от нуля до значения наибольшего индекса массива. Внутри цикла при выполнении неравенства очередных элементов функция возвращает значение Ложь. Если цикл пройден до конца - значения всех элементов с одинаковыми индексами совпали. Значит функция может вернуть значение Истина. 39 Универсальные коллекции В массив выгружены данные, содержащие наименования контрагентов. Как их отсортировать? Список значений позволяет выполнять сортировки по представлению или по значению и, кроме того, обладает возможностями загрузки данных из массива и выгрузки в массив. Поэтому один из вариантов решения данной задачи может быть таким: Создаем список значений. Загружаем значения из массива «МассивНаименований». Сортируем список значений по значениям. Поскольку параметр не указали, направление сортировки будет - по возрастанию. Если нужно по убыванию - в качестве параметра надо передать соответствующее значение системного перечисления НаправлениеСорТИрОВКИ: После выполнения сортировки выгружаем значения из списка значений в массив. 40 Массив Есть массив, в который выгружены значения типа СправочникСсылка.Номенклатура. Как удалить все пустые значения массива? Получаем в виде параметра процедуры массив номенклатурных позиций. Устанавливаем нулевое значение счетчика - переменной «Счетчик». Организуем цикл, который будет выполняться, пока значение переменной «Счетчик» меньше количества элементов массива. Поскольку индексы элементов массива начинаются с нулевого значения, то наш цикл прервется в момент, когда значения индекса («Счетчик») и количества элементов совпадут. Внутри цикла проверяется условие, является ли ссылка, содержащаяся в очередном элементе массива - пустой. Если это так текущий элемент массива удаляется. В результате у следующих за ним элементов автоматически на единицу уменьшаться индексы. Кроме того, необходимо уменьшить на единицу значение переменной, отслеживающей количество элементов в массиве. Если же ссылка не пустая - увеличивается на единицу значение «Счетчик» с тем, чтобы на следующем ходе цикла работать уже со следующим элементом. 41 Универсальные коллекции Замечание: проверка на пустое значение для разных типов данных проводится по-разному. Только для ссылочных типов данных можно ее осуществлять посредством метода Пустая(). Как получить массив номенклатурных позиций, использованных в табличных частях «Номенклатура» и «Тара» накладной? Имеем ссылку на документ «СсылкаНаДокумент». Номенклатурные позиции могут быть указаны в колонке «Номенклат}фа» табличной части «Номенклатура» и в колонке «Номенклатура» табличной части «Тара». Тогда массив номенклатуры из обеих табличных частей можно получить следующим образом: Формируем массив «МассивНоменклатуры» посредством выгрузки колонки «Номенклатура» табличной части «Товары» документа. Аналогично формируем массив «МассивНоменклатурыТара» по табличной части «Тара». Далее в цикле перебора элементов второго массива добавляем их в первый. 42 Массив Есть две таблицы значений. Как получить массив совпадающих имен колонок? Данная операция может применяться для вспомогательного контроля перед загрузкой таблицы значений в таблицу записей регистра. Итак, есть «ТаблицаИсточник» PI «ТаблицаПриемник», требуется получить массив имен совпадающих по имени колонок. Создаем сначала конструктором «МассивСовпадающихКолонок». Далее выполняем цикл перебора колонок одной из таблиц. Внутри цикла в переменную «ИмяКолонки» получаем имя очередной колонки. Далее обращаемся к коллекции колонок другой таблицы значений и при помощи метода Найти() пытаемся найти такую же по имени колонку. Если поиск успехом не увенчается - метод выдаст значение Неопределено. А если удалось - добавляем очередной элемент к массиву «МассивСовпадающихКолонок». 43 Универсальные коллекции Как в запросе сделать отбор по нескольким вариантам заполнения реквизита типа «ПеречислениеСсылка»? Одним из приемов программирования, использующим массивы, является формирование коллекции возможных значений для заполнения параметров запроса. Это выполняется, например, когда в запросе используются отборы с операндами В или В ИЕРАРХИИ. Вот пример решения задачи: В параметр «МассивПричин» устанавливается значение - массив возможных причин, набранный из элементов перечисления « ПричиныОтсутствия». Замечание: для решения подобных задач (с операндами В и В ИЕРАРХИИ) можно передавать не только данные типа Массив, можно еще СписокЗначениЙ или вообще сформировать коллекцию возможных значений вложенным запросом в самом тексте запроса. Вариант выбора заполнения параметра зависит от конкретики самой задачи. 44 Массив Как из регистра сведений «РасчетчикиЗарплатыОрганизации» получить в виде массива всех расчетчиков зарплаты определенного подразделения организации? Периодический независимый регистр сведений «РасчетчикиЗарплатыОрганизации» имеет следующую структуру: Данную задачу можно решить посредством применения методов объектной модели или запросом. Пример решения посредством объектной модели: Создаем набор записей регистра. Устанавливаем отбор по значению измерения «ПодразделениеОрганизации». Читаем данные набора записей. Выгружаем колонку набора записей «Пользователь» в массив. Пример решения задачи посредством запроса: 45 Универсальные коллекции Источником в запросе будет таблица регистра «РегистрСведений.РасчетчикиЗарплатыОрганизации». Накладываем отбор по условию равенства поля «ПодразделениеОрганизации» определенному значению. В качестве выходных полей выбираем только «Пользователь». После выполнения запроса делаем выборку по результату запроса и в цикле перебора ее - формируем нужный массив. В данных примерах оба способа возвращают одинаковые результаты примерно за одинаковое время потому, что никаких дополнительных действий в процессе получения информации не требуется. Второй способ на первый взгляд кажется более длинным в отношении написания кода. Но если нам понадобится произвести отбор более чем по одному условию, или получить массив неповторяющихся значений - то вторым способом получить такие данные будет значительно легче и быстрее с точки зрения скорости исполнения. 46 Структура ® В каких ситуациях обычно используются объекты типа «Структура»? Структура является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в ее использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в массиве. Если элемент массива можно было характеризовать только числовым индексом и значением произвольного типа, то элемент структуры характеризуется строковым ключом и значением произвольного типа. Чаще всего структуры применяют в ситуациях, когда необходимо узнать или использовать имена реквизитов, свойств, полей, подчиненных объектов для тех или иных объектов; узнать или использовать значения реквизитов, свойств, полей, подчиненных объектов по их именам для тех или иных объектов. Кроме того, структуры удобно использовать для передачи параметров при работе с различными объектами. Структуры могут создаваться конструктором НОВЫЙ или получаться в результате применения методов некоторых объектов. Ввод элементов в структуру можно осуществлять как посредством параметров конструктора, так и посредством метода Вставить(). Как создать структуру? Создание структуры чаще всего происходит посредством оператора НОВЫЙ: где «СозданнаяСтруктура» - имя переменной, которая будет содержать созданный объект типа Структура. После вышеприведенного создания в структуру можно вставлять элементы (произвольное количество). 47 Универсальные коллекции Если же мы хотим создать структуру с заранее определенными элементами - это можно сделать, например, так: Первым параметром передается строка, в которой через запятую перечисляются ключи элементов структуры. Остальные параметры содержат значения для элементов структуры в том же порядке, в котором были перечислены ключи. Для такой структуры впоследствии можно обращаться к любому из элементов для записи или для чтения значения. А так же, при необходимости, к этой структуре можно еще добавлять новые элементы. Как добавить элементы в структуру? Для добавления элементов в структуру используется метод Вставить(). Первым параметром указывается ключ, вторым - значение нового элемента. Замечание: если в составе структуры уже был элемент с подобным ключом - то старый элемент будет замещен новым. Например: Как обратиться к элементу структуры? Для чтения значений элементов структуры можно использовать несколько вариантов написания кода. Для структуры «Оппонент», в составе которой есть элемент с ключом «Возраст» можно использовать явное указание значения ключа: 18 Структрура или передачу ключа в переменной: Также можно использовать метод СвоЙСТВО(), который получает значение элемента структуры по указанному ключу: Для записи значений элементов структуры использовать несколько вариантов написания кода. Если мы хотим изменить значение возраста в вышеописанного примера - можно это сделать так: также можно структуре из или так: или так: Как перебрать элементы структуры? Поскольку структура является коллекцией - перебрать элементы структуры можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов структуры «СтруктураПараметров», можно сделать следующее: 49 Универсальные коллекции Как удалить элемент структуры? Чтобы удалить элемент структуры - необходимо знать его ключ. Например, чтобы удалить из структуры «СтруктураПараметров» элемент с ключом «Номенклатура», достаточно сделать следующее: Если же нужно удалить все элементы структуры - применяется метод ОЧИСТИТЬ(): Как в структуре установить значение для элемента с определенным ключом? Все ключи элементов структуры - уникальны. Поэтому добавление новых элементов и замена (установка) значений для «старых» элементов выполняется одним и тем же методом Вставить^): Результатом примера выше будет структура, состоящая только из одного элемента: ключ у него - «Цвет», значение - «Синий» из системного набора значений \Л/еЬЦвета. Структрура Как получить в структуру многомерные данные? Как собрать информацию по установленным в форме журнала отборам? Для формы журнала документов установлены некие отборы. Чтобы сформировать многомерную структуру всех используемых отборов объекта «ЖурналДокументовСписок», можно сделать следующее: Создаем конструкторами две структуры. Структура «СтруктураОтборов» впоследствии будет содержать элементы, где в качестве ключа будет указано название отбора, а в качестве значения « СтруктураПараметровОтбора». В цикле перебора коллекции отборов объекта «ЖурналДокументовСписок» сначала проверяем, используется ли данный отбор. Если используется - заполняем структуру параметров данного отбора. Полученную структуру используем в качестве значения добавляемого элемента объекта «СтруктураОтборов». Впоследствии, если нам потребуется информация из полученной структуры, можно будет, например, перебрать элементы 51 Универсальные коллекции «СтруктураОтбора», а для каждого из этих элементов - перебрать элементы ее значения - структуры «ПараметрыОтбора» Как определить, есть ли в структуре элемент с ключом «Контрагент», и если есть, но содержит пустое значение справочника или Неопределено - удалить этот элемент? В качестве параметров метода СвоЙСТВО() можно указать ключ и переменную для получения значения по ключу. Кроме того, сам метод возвращает Истина, если элемент с данным ключом существует, и Ложь - если нет. Получив значение и проверив его на требуемые условия, удаляем элемент с указанным ключом из структуры. Замечание: кроме метода СвоЙСТВО() получить значения элемента структуры позволяют следующие варианты обращения по ключу: Структура-Контрагент или Структура[ "Контрагент" Структрура Как из табличной части «Товары» документа получить все строки, где значение реквизита «Цена» равно нулю, а значение реквизита «СтавкаНДС» равно значению «НДС18» перечисления «СтавкиНДС»? Для поиска строк, соответствующих условию определенного отбора, можно сделать следующее: СтруктураДляПоиска = Новый Структура("Цена, СтавкаНДС", О, Перечисления.СтавкиНДС.НДС 18); МассивСтрок = Товары. НайтиСтроки(СтруктураДляПоиска); Сначала создаем структуру для поиска. Далее посредством метода НаЙТиСтр0КИ() из табличной части документа «Товары» получаем массив строк, соответствующих отбору по структуре поиска. Обратите внимание, в данном примере был показан вариант добавления и заполнения элементов структуры непосредственно в конструкторе. Как получить данные о текущей учетной политике бухгалтерского учета организации из периодического регистра сведений на заданную дату? Периодический регистр сведений «УчетнаяПолитикаБухгалтерскийУчет» имеет следующую структуру: Тип значения измерения «Организация» СправочникСсылка. Организации. Ссылка на организацию находится в переменной «ЮрЛицо». Дата, на которую необходимо получить данные - переменная «ДатаПолучения». 53 Универсальные коллекции Получение необходимых данных можно организовать посредством метода ПолучитьПоследнее() менеджера регистра: Метод предназначен для получения данных наиболее поздней записи регистра, соответствующей указанным периоду и значениям измерений регистра. Значения измерений регистра должны предаваться в виде структуры. Каждый элемент структуры в качестве ключа должен использовать имя измерения. В качестве значения элемента структуры передаем значение отбора по этому измерению. Дату получения и полученную структуру отбора используем в качестве параметров для метода ПолучитьПоследнее(). Результатом применения метода к периодическому регистру сведений «УчетнаяПолитикаБухгалтерскийУчет» будет структура. Элементы полученной структуры состоят из названия ресурса в качестве ключа и значения ресурса в качестве значения. 54 Структрура Как сформировать структуру названий реквизитов табличной части произвольного документа? Пример функции, решающую данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ и имя табличной части документа. Конструктором создаем структуру « Стру ктураТабл ичнойЧасти Доку мента». В цикле перебора реквизитов нужной табличной части полученного документа вставляем в структуру элементы с названиями полученных реквизитов. Замечание: значения элементам структуры можно было и не указывать - все зависит от того, как в дальнейшем собираемся использовать полученную структуру. Как получить запросом данные табличной части документа, имея структуру названий реквизитов табличной части? Пример функции, решающей данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ или объект документа, имя табличной части и структуру названий реквизитов этой табличной части. 55 Универсальные коллекции Функция основана на сборе информации запросом, чей текст собирается «кусочками» из строковых переменных: Создаем переменную «ПоляРеквизитов». В цикле перебора элементов структуры имен полей табличной части добавляем к переменной «ПоляРеквизитов» «по кусочкам» будущие имена выходных полей запроса. Добавляются они через запятую. Далее формируем запрос, к тексту которого добавляем строку имен выходных полей запроса. Источником указываем таблицу нужной табличной части нужного документа. Кроме того, накладываем отбор по полю «Ссылка». Функция возвращает результат выполнения запроса. 56 Соответствие ф В каких ситуациях обычно используются объекты типа «Соответствие»? Соответствие является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в его использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в структуре. Если элемент структуры можно было характеризовать только строковым ключом и значением произвольного типа, то элемент соответствия характеризуется ключом произвольного типа и значением произвольного типа. Чаще всего соответствия применяют в ситуациях, когда необходимо хранить в оперативной памяти для последующей обработки данные с ключами произвольного типа. Кроме того, соответствия удобно использовать для передачи параметров при работе с различными объектами. Соответствия могут создаваться конструктором НОВЫЙ. ф Как создать соответствие? Создание соответствия происходит посредством оператора Новый: I СозданноеСоответствие = Новый Соответствие(); где «СозданноеСоответствие» «СозданноеСоответствие» - имя переменной, которая будет содержать созданный созданный объект типа типа Соответствие. Соответствие. содержать После вышеприведенного создания в соответствие можно вставлять элементы (произвольное количество). количество). элементы (произвольное ф Как добавить элементы в соответствие? Допустим к соответствию Допустим соответствию «ВозрастСотрудников» «ВозрастСотрудников» нужно добавить новый элемент. В качестве ключа должна выступать ссылка на сотрудника (ее можно считать из переменной «Сотрудник»), в качестве значения - возраст сотрудника (его можно считать из переменной «ВозрастСотрудника»). «ВозрастСотрудника»). 57 Универсальные коллекции Тогда добавление нового элемента можно произвести так: или так: Как обратиться к элементу соответствия? Запись значений элементов соответствия можно выполнять теми же способами, которые рассмотрены в вопросе «Как добавить элемент в соответствие?» на странице 57. А чтение значений элементов соответствия можно выполнять следующим образом: или так: В приведенных примерах из соответствия «ВозрастСотрудников» по ссылке на сотрудника в качестве ключа будет получено значение элемента соответствия. Как перебрать элементы соответствия? Поскольку соответствие является коллекцией - перебрать элементы соответствия можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов соответствия «Замены», можно сделать следующее: 58 Соответствие Как удалить элемент соответствия? Чтобы удалить элемент соответствия - необходимо знать его ключ. Например, чтобы удалить из соответствия «Замены» элемент со ссылкой на объект, содержащийся в переменной «УдаляемыйТовар», в качестве ключа, достаточно сделать следующее: Если же нужно удалить все элементы соответствия - применяется метод ОЧИСТИТЬ(): Как получить данные из соответствия? В соответствии «КурсыВалютДокумента» в качестве ключа используется значение валюты, а значениями являются структуры, содержащие «Курс» и «Кратность». Как получить курс и кратность валюты «УправленческаяВалюта» ? Сначала по ключу (ссылке на управленческую валюту) получаем значение соответствия. Поскольку значением является структура курса валют - далее получаем значения структуры по их названиям. 59 Универсальные коллекции Как получить многоуровневое соответствие видов расчетов, обладающих базовыми видами расчетов? Для плана видов расчетов «ОсновныеНачисления» необходимо получить соответствие «ВидыРасчетов», где в качестве ключей будут использоваться виды расчетов, обладающие базовыми. А в качестве значений - соответствия базовых видов расчетов. В качестве ключей последних - базовые виды расчета, в качестве значений - структуры, содержащие их свойства «Наименование» и «Предопределенный». Виды расчета Базовые виды расчета Оклад по дням Оклад по часам Ежегодный отпуск Оплата по часовому т арифу Оплата по дневному тарифу Оплата по произволе твенным нарядам Оклад по дням Надбавка за в редность Оклад по часам Оплата по произволе твенным нарядам Свойства базового вида расчета "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по часовому тарифу" "Предопределенный" - Ложь "Наименование" "Оплата по дневному тарифу" "Предопределенный" - Истина "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина Первичный сбор информации удобнее осуществить при помощи запроса с использованием итогов. Последующий перебор группировок результат запроса даст возможность сформировать необходимые объекты: 60 Соответствие Для запроса источником является таблица «ПланВидовРасчета.ОсновныеНачисленияОрганизации.БазовыеВидыРас чета». Выходными полями делаем все, необходимые для решения нашей задачи. Кроме того, вводим дополнительные итоги по полю «Ссылка» (ссылка на виды расчета). После выполнения запроса делаем выборку по верхнему уровню группировок результата запроса. 61 Универсальные коллекции Создаем конструктором три объекта - соответствие «ВидыРасчетов», в которое будем впоследствии добавлять виды расчетов, обладающие базовыми; соответствие «БазовыеВидыРасчетов», в которое будем добавлять базовые виды расчетов для каждого отдельного вида (владельца); структуру «СвойстваВидовРасчетов» для добавления информации о свойствах базовых видах расчетов. В цикле перебора верхнего уровня группировок (по видам расчета) сначала очищаем соответствие «БазовыеВидыРасчета». Далее открываем цикл перебора записей второго уровня группировки результата запроса (то есть уже по базовым видам расчетов определенного владельца). В этом цикле заполняем значения структуры «СвойстваВидовРасчетов» по ключам - названиям свойств. Далее добавляем сформированные структуры в качестве значений соответствия «БазовыеВидыРасчета» с конкретным базовым видом расчета в качестве ключа. По окончании вложенного цикла добавляем очередной элемент в соответствие «ВидыРасчетов» с заполнением значения ключа из поля «Ссылка», и заполненным соответствием «БазовыеВидыРасчета» в качестве значения. Список значений, таблица значений, дерево значений ® В каких ситуациях обычно используются списки значений, таблицы значений, дерево значений? Все эти объекты являются универсальными коллекциями, то есть объектами, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в использовании списка значений возникает, когда требуется работать с временным набором данных для решения интерфейсных задач. Дело в том, что в отличие от более простых универсальных коллекций (массива, структуры, соответствия) список значений состоит из объектов - ЭлементСпискаЗначениЙ. А элемент списка значений характеризуется следующим набором свойств: Значение; Представление. Содержит строковое пользовательское представление. То есть именно его пользователь увидит на экране. По умолчанию - генерируется автоматически; Пометка; Картинка; Применение списков значений для обычных задач универсальных коллекций, но не связанных с интерфейсными действиями, как правило - излишне. Обычно с этой функциональностью справляются объекты «попроще»: Массив, Структура, Соответствие. Таблицы значений позволяют работать с данными сущностей, представимых в виде таблиц, то есть «раскладываемых» на колонки и строки. А ведь с точки зрения многих систем автоматизации вообще «весь мир = совокупность таблиц». При этом можно добавлять/удалять данные (и колонки, и строки, и значения); искать данные (и колонки, и строки, и значения); сортировать данные (по любым колонкам); выгружать-загружать данные; подсчитывать итоги по колонкам; сворачивать данные и т.д. Дерево значений позволяет в добавление к вышеприведенным операциям еще вводить уровни иерархии для этих данных и оперировать в пределах уровней или игнорируя их. 63 Универсальные коллекции Подобный набор возможностей помогает решать самый широкий спектр задач промежуточной обработки данных произвольного типа. Как создать список значений? Список значений можно создать посредством оператора НОВЫЙ: где «СозданныйСписок» - имя переменной, которая будет содержать созданный объект типа СписокЗначении. Как добавить элементы в список значений? Например, требуется добавить в список значений «СписокСотрудников» новый элемент со значением ссылки на сотрудника (содержится в переменной «ТекущийСотрудник»), ФИО сотрудника в качестве представления (содержится в реквизите «ФИО» объекта «ТекущийСотрудник») и фотографии сотрудника в качестве картинки (содержится в переменной «Фото»): Если нужно, чтобы новые значения добавлялись с определенным индексом (переменная «Инд»), то можно использовать метод Вставить(): Если при этом в списке значений уже был элемент с таким индексом, то старый элемент получит индекс на единицу больше предыдущего; аналогично сдвинуться индексы у всех последующих. Если при использовании метода Вставить() указать индекс, выходящий за границы списка, - получим сообщение об ошибке. 64 Список значений, таблица значений, дерево значений Как найти элемент списка значений? Например, в списке значений «СписокСотрудников» надо найти элемент, в котором в качестве значения указан сотрудник, на которого ссылается переменная «ИскомыйСотрудник». Затем нужно сообщить индекс найденного элемента. Это можно выполнить следующим образом: Замечание: если искомое значение в списке может встретиться несколько раз - при таком подходе найдем только первый элемент, где оно содержится. Поэтому смотрите по ситуации. Поскольку список значения - объект, предназначенный, прежде всего для визуализации возможностей выбора пользователем, обычно при его заполнении уже сразу предотвращают возможность повторов. Если же такая возможность осмыслена, то получить все элементы списка значений, содержащие определенное значение можно, например, в цикле перебора элементов списка значений. Как обратиться к элементу списка значений? Если требуется получить доступ к элементу списка значений с определенным индексом (пусть содержится в переменной «Инд»), можно поступить так: или так: В любом случае - то, что получаем, еще не есть значение, заложенное в этот элемент списка (это еще не сотрудник), а именно объект типа ЭлементСпискаЗначений. 65 Универсальные коллекции Впоследствии с него можно считать значения свойств: Как перебрать элементы списка значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения всех элементов списка значений «СписокСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: Как удалить элемент списка значений? Удаление отдельных элементов списка значений происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границу индексов списка - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» списка приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Список значений - «сомкнет ряды». 66 Список значений, таблица значений, дерево значений Решим задачу удаления всех элементов списка «СписокОбъектов», содержащих числовые значения: значений Сначала определяем самый старший индекс элементов списка значений. Цикл проверок и удалений элементов будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов списка значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. ф Как создать таблицу значений и заполнить ее поля? Для создания таблицы значений используется оператор Новый: После этого молено создать колонки таблицы (при необходимости можно задать допустимые типы значений для колонки, заголовок и ширину колонки в символах). Затем можно добавить новую строку и установить значения в колонках таблицы: 67 Универсальные коллекции или так: Как найти значение в таблице значений? Если требуется «ТаблицаЗначений», сделать так: I найти первую где присутствует строку таблицы значений «ИскомоеЗначение», можно Найден наяСтрока = ТаблицаЗначений.Найти(ИскомоеЗначение); Если требуется найти первую строку, где «ИскомоеЗначение» может быть найдено, например, в колонках «Поставщик» и «Покупатель», то: Если же нужно найти все строки, где в колонке «Сотрудник» присутствует искомое значение, то это можно выполнить при помощи метода НаЙТиСтроки(): Сначала создаем структуру поиска, каждый элемент которой будет содержать название колонки таблицы значений в качестве ключа и искомое значение в этой колонке - в качестве значения. Далее структуру поиска передаем в качестве параметра методу НаЙТиСтроки(). Результат - массив строк таблицы значений, соответствующих структуре поиска. Список значений, таблица значений, дерево значений Замечание: если в этом примере в структуру поиска добавить поискнужного значения, например, еще и в колонке «Ответственный» - то в результате применения метода НаЙТиСтроки() получим все строки, где и «Сотрудник» и «Ответственный» равны искомому значению. Как перебрать строки таблицы значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения колонки «Сотрудник» всех строк таблицы значений «ТаблицаСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: ® Как удалить строки (колонки) таблицы значений? Удаление отдельных строк таблицы значений происходит с обязательным указанием удаляемой строки или индекса удаляемой строки. Если нужно удалить строку «УдаляемаяСтрока», входящую в таблицу значений «ТаблицаЗначений»: А так, например, будет удалена первая строка таблицы значений: 69 Универсальные коллекции Естественно, если указанный индекс будет выходить за границу индексов строк таблицы значений - получим сообщение об ошибке. Аналогично и для колонок. Только работать уже надо с коллекцией колонок таблицы значений. Доступ к ней - через свойство КОЛОНКИ таблицы значений. или Кроме того необходимо учитывать, что удаление строки (или колонки) «из середины» таблицы значений приведет к уменьшению на единицу индексов строк, стоявших «после» удаленной (эффект «смыкания рядов», вернее -«смыкание строк»). Например, решим задачу удаления всех строк таблицы значений «ТаблицаЗначений», содержащих числовые значения хотя бы в одной колонке: Сначала определяем самые старшие индексы строк и колонок таблицы значений. Цикл проверок и удалений строк будет выполняться, пока очередное значение индекса строки не окажется меньше нуля. Внутри цикла но строкам делаем цикл-счетчик перебора индексов колонок. Во вложенном цикле определяем тин значения элемента находящегося в строке с текущим индексом и в очередной колонке. Если 70 Список значений, таблица значений, дерево значений это число - удаляем строку таблицы значений и прерываем вложенный цикл. Кроме того, в любом случае на каждом шаге внешнего цикла уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор строк таблицы значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. Как заполнить таблицу значений, если имена колонок содержатся в переменных? Если имя колонки, для которой требуется установить значение, содержится в переменной, можно использовать оператор : В вышеприведенном коде: «ТаблицаЗначений» - имя таблицы значений; «ИмяКолонки» - строковая переменная, содержащая имя колонки, по которой нужно заполнить значение; «Значение» - переменная, содержащая само заполняемое значение. Как заполнить всю колонку таблицы значений нужным значением? Колонку «ФлагФискального Учета» в таблице «ТаблицаЗначений» необходимо заполнить значением Ложь. значений Применяем для таблицы значений метод ЗаполнитьЗначения(). Первым параметром передаем заполняемое значение. Вторым параметром - имя заполняемой колонки. Замечание: если нужно заполнить несколько колонок значением - их имена указывают через запятую во втором параметре. Если не указать второй параметр - значением заполнятся все поля таблицы. 71 Универсальные коллекции Как таблицу значений «ТаблицаПолучатель» заполнить данными таблицы значений «ИсходнаяТаблица»? Если «ТаблицаПолучатель» на момент выполнения операции еще не существует, или ее предыдущие колонки сохранять не нужно, можно создать ее, как полную копию исходной: Вариант второй: таблица «ТаблицаПолучатель» существует, и жалко терять ее колонки и ограничения на типы данных колонок. Но нужно заполнить данные по колонкам, имена которых совпадают с именами исходной таблицы. Тогда можно так: Для каждой строки исходной таблицы добавляется новая строка в таблицу получатель и выполняется заполнение значений в тех колонках новой таблицы, имена которых совпадают с именами колонок в исходной таблице. Замечание: если у таблиц не будет колонок с одинаковыми именами - таблица-получатель будет в результате содержать столько же строк с пустыми значениями, сколько строк было в таблице-источнике. Если у каких-то одноименных колонок тип значения данных из таблицы-источника не попадет в массив разрешенных типов колонки таблицы-получателя - в таких полях получим пустые значения. Рассмотрим третий случай. В случае одноименных колонок - колонку таблицы-получателя нужно привести в полное соответствие колонке таблицы-источника. 72 Список значений, таблица значений, дерево значений Нам придется заменить колонку в таблице получателе на новую, чьи свойства полностью будут соответствовать колонке таблицы-источника. Поэтому в случае обнаружения в таблице-получателе одноименной колонки собираем в переменных все свойства для новой колонки. Далее удаляем старую и создаем новую колонку. Далее выполняем цикл перебора строк исходной таблицы. В цикле добавляем к таблице-получателю новую строку и открываем цикл перебора имен колонок в массиве совпадающих колонок. Внутри этого вложенного цикла производим заполнение ячеек таблицы получателя данными ячейки таблицы-источника. 73 Универсальные коллекции Как добавить колонки к таблице значений «ТаблицаЗначений» с ограничениями по типу? При добавлении колонки можно просто указать ее имя, а второй параметр метода Добавить() - не трогать. В этом случае тип данных колонки - произвольный. Можно заполнить значение второго параметра. Туда необходимо передавать описание разрешенного для колонки типа. Само описание можно получить при помощи конструктора, передав последнему в качестве параметра строковое название типа (если много типов - через запятую) или массив допустимых типов. Если среди типов разрешенных к заполнению данных колонки есть строка - можно ограничить ее разрядность (длину), указать использование неременной или фиксированной длинны. Все это обеспечивается созданием объекта при помощи конструктора КвалификаторыСтроки. Далее этот объект будет использован в качестве одного из параметров конструктора ОписаниеТипов. Аналогичные действия можно квалификаторов числа и даты. 74 осуществлять в отношении Список значений, таблица значений, дерево значений Обратите внимание, описание типов можно строить конструктором как «с нуля», так и использовать как основу уже существующее описание типов. Как изменить тип значения колонки таблицы значений, полученной выгрузкой из запроса? Запросом собираются данные по документам «Посту плениеТоваров Услуг» PI выгружаются в таблицу значений «ТаблицаСсылок» (колонка «Ссылка»). Впоследствии к этой таблице значений будут добавляться еще строки. Как обеспечить возможность добавления в полученную таблицу значений в колонку «Ссылка» документов других видов («ОприходованиеТоваров», « ВозвратОтПокупателя») ? При выгрузке данных из запроса в таблицу значений тип значения колонок определяется типом значений колонок результата запроса. Поэтому одним из самых простых вариантов решения задачи может быть воздействие на запрос, а не на таблицу значений. 75 Универсальные коллекции Создаем пустые ссылки на документы «ОприходованиеТоваров» и «ВозвратОтПокупателя». Далее в запросе делаем объединение с записями, содержащими эти пустые ссылки. Причем в объединяемых запросах по пустым ссылкам применяем ПЕРВЫЕ 0 для того, чтобы впоследствии не удалять строки с пустыми ссылками из таблицы выгруженного результата запроса После выполнения и выгрузки запроса в таблицу значений «ТаблицаСсылок» тип значения колонки «Ссылка» будет составным: «NULL, ДокументСсылка ЛоступлениеТоваровУ слуг, ДокументСсылка. ОприходованиеТоваров, ДокументСсылка.ВозвратОтПокупателя». То есть - то, что и требовалось. Как самостоятельно заполнить дерево значений? Для иллюстрации данной возможности создадим обработку, в которой определен реквизит «Дерево» (тип ДеревоЗначениЙ). В диалоге определено табличное поле, связанное через свойство данные с реквизитом «Дерево» (имя элемента управления «Дерево»). Следующая процедура произведет запись данных в дерево значений. 76 Список значений, таблица значений, дерево значений Следующая процедура показывает один из вариантов установки текущего значения в элементе управления, связанного с деревом (табличном поле). 77 Прикладные объекты Справочники © Как создать элемент (группу) справочника? Создание нового элемента в неиерархическом справочнике можно выполнить при помощи следующего кода: Если справочник иерархический, то выполнение этого кода приведет к созданию нового элемента в корне справочника. Для того чтобы создать новый элемент в определенной группе иерархического справочника, необходимо также указать родителя создаваемого элемента: Если требуется создать новую группу в иерархическом справочнике, то для этого следует использовать метод менеджера справочника Создать Груп пу (). Если группа должна находиться внутри 78 Справочники определенной группы справочника, также следует указать и родителя создаваемой группы: Следует обратить внимание на тот факт, что у реквизитов, в которые будет производиться запись значений в свойстве «Использование» должно стоять одно из перечисленных ниже значений: Для группы Для группы и элемента Если для справочника установлен вид иерархии Иерархия элементов, то для создания новых элементов следует использовать метод СоздатьЭлемент() менеджера справочника, а иерархия создаваемых элементов будет определяться значением свойства Родитель объекта справочника: 79 Прикладные объекты Как найти элемент справочника? Для поиска элемента справочника можно использовать несколько способов. По коду: При организации поиска по коду обращайте внимание на тип кода справочника (Число или Строка). По наименованию: По реквизиту: Во всех методах поиска есть параметры позволяющие искать в нужной группе, в рамках подчинения определенному элементу справочника владельца и ряд других параметров. 80 Справочники Как удалить элемент справочника? Для корректного удаления элемента справочника необходимо убедиться в том, что другие данные не содержат ссылок на удаляемый элемент справочника. Например, в переменной «СсылкаНаУдаляемыйЭлемент» содержится ссылка на удаляемый элемент справочника: Для пометки элемента справочника на удаление можно использовать метод УстановитьПометкуУдаления() объекта справочника: Использование этого метода позволяет установить или снять пометку на удаление элемента справочника, причем будут инициированы события Перед записью и При записи объекта справочника, поскольку выполняется сохранение измененного свойства ПометкаУдаления объекта справочника. 81 Прикладные объекты Как перебрать элементы справочника? Для того чтобы перебрать элементы справочника, необходимо сформировать выборку элементов с нужными параметрами и затем обойти ее в цикле. Например, для перебора всех элементов справочника «Номенклатура» в иерархическом порядке, можно использовать следующий код: Аналогичного результата можно добиться, используя запрос: Благодаря использованию запроса можно формировать выборку элементов справочника более «гибко», поскольку запрос позволяет задать произвольные условия на выбираемые данные. 82 Справочники ® Как выбрать все элементы из определенной группы? Организуем выборку элементов справочника из группы, ссылка на которую определена в переменной «ПолеВводаРодитель»: В результате работы этого кода будут получены все дочерние элементы выбранного элемента справочника. Аналогичное действие, выполняемое с помощью запроса, будет выглядеть следующим образом: 83 Прикладные объекты Если необходимо получить не только дочерние элементы, но и все элементы, находящиеся в иерархии выбранного элемента, следует, при использовании объектной техники, выполнять метод ВыбратьИерархически() менеджера справочника: а при использовании запроса применять условие В ИЕРАРХИИ: 81 Справочники ® Как перебрать элементы подчиненного справочника с помощью запроса? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». Делаем запрос по таблице справочника «Контактные лица» с отбором по полю «Владелец». В качестве владельца передаем ссылку на элемент справочника «Контрагенты». 85 Прикладные объекты ® Как перебрать элементы подчиненного справочника с помощью выборки справочника? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». ф Как открыть форму списка (элемента) справочника? Для того чтобы открыть форму списка справочника, можно воспользоваться методом ПолучитьФормуСписка() менеджера справочника: Для того чтобы открыть произвольную форму справочника, можно использовать метод ПолучитьФорму() менеджера справочника: Однако следует помнить, что если методом ПолучитьФорму() выполняется получение формы элемента или группы справочника, то будет получена форма нового элемента (группы). Справочники Для того чтобы открыть форму существующего элемента или группы справочника, следует использовать метод ПолучитьФорму() ссылки или объекта справочника: ® Как добавить запись в табличную часть элемента справочника? Имеется ссылка на элемент справочника «Контрагенты». Как добавить запись в табличную часть «ВидыДеятельности» этого элемента? Модифицировать можно только объект справочника. Поэтому так: Получаем объект справочника от ссылки на элемент. Добавляем новую строку к табличной части полученного объекта. Заполняем реквизиты табличной части в данной строке. Записываем измененный элемент справочника. Как удалить строки из табличной части справочника? Для того чтобы полностью очистить табличную часть элемента справочника, можно воспользоваться методом ОЧИСТИТЬ() табличной части справочника: 87 Прикладные объекты Если требуется выборочное удаление строк табличной части (например, в зависимости от значения их реквизитов), можно сначала отобрать строки, удовлетворяющие условию, а затем удалить каждую из них методом Удалить() табличной части справочника. В следующем примере подразумевается, что переменная «ВыбранныйЭлемент» содержит ссылку на обрабатываемый элемент справочника, а переменная «ВыбранныйВидДеятельности» содержит ссылку на вид деятельности, который не должен присутствовать у обрабатываемого элемента: ф Как перебрать строки табличной части справочника? Табличная часть справочника представляет собой коллекцию строк, которую можно перебрать в цикле. Реквизиты табличной части будут доступны как свойства строки табличной части. Например, перебор строк табличной части «ВидыДеятельности» справочника «Контрагенты» может быть выполнен следующим образом: Справочники ® Как создать элемент в нужной группе? Необходимо создать элемент справочника номенклатура, так чтобы при этом он попал в нужную группу. Если группы с указанным кодом нет, то тогда такая группа должна быть создана. Можно использовать предопределенную группу, в этом случае вместо поиска и создания новой группы можно использовать строку: 89 Прикладные объекты Обратите внимание на тот факт, что механизм работает, только если в справочнике установлен вид иерархии «Иерархия групп и элементов». В противном случае код будет выглядеть следующим образом: Если вид иерархии справочника «Иерархия элементов», то понятие группы в нем отсутствует. Как узнать, есть ли у текущего элемента подчиненные? Пусть ссылка на текущий элемент справочника содержится в переменной «Владелец». Необходимо узнать, есть ли в справочнике «Единицы измерения» элементы, подчиненные текущему элементу. Если использовать объектную модель доступа: 90 Справочники Фактически получаем выборку всех подчиненных элементов и если в выборке есть хоть одна позиция, считаем, что подчиненные элементы существуют. Именно этот факт и говорит о неэффективности использования данного варианта (выбираемые данные мы не используем, а получаемый блок данных может быть большим). Лучше всего подобную проверку можно выполнить, используя возможности запросов: Так как не предполагается, что нам понадобятся данные о подчиненном элементе, выборку результата запроса в переменной не сохраняем. Как узнать количество подчиненных элементов у выбранного элемента справочника? Необходимо определить количество элементов в справочнике «ЕдиницыИзмерения» подчиненных элементу справочника, ссылка на который находится в переменной «Владелец». С помощью объектной модели: 91 Прикладные объекты Данное решение в общем случае является не эффективным. Связано это с тем, что выборка фактически получает все данные о подчиненных элементах справочника, а в рамках данной задачи нужно только количество элементов. Если решать задачу с помощью запроса, то решение выглядит следующим образом: В результате в переменной «КоличествоЗаписей» будет находиться нужная нам величина. Справочники Как узнать количество подчиненных элементов у выбранного элемента справочника, если количество подчиненных справочников больше чем один? Если у справочника есть несколько подчиненных справочников, то запрос может выглядеть следующим образом: Данный запрос позволяет получить количество записей в двух подчиненных справочниках. В качестве источника данных в основном запросе используется подзапрос («ВложенныйЗапрос»). Сам подзапрос состоит из двух запросов (происходит их объединение). Каждый из объединяемых запросов получает данные о количестве записей в одном из подчиненных справочников. В выборке результата запроса (в случае если у элемента справочника, ссылка на который находится в переменной «Владелец», есть подчиненные элементы) будет одна строка, в поле «КоличествоПодчиненныхЭлементов» которой содержится количество подчиненных элементов. 93 Прикладные объекты Как получить всех родителей выбранного элемента справочника? В переменной «СсылкаНаЭлемент» находится ссылка на элемент справочника. Необходимо получить всех родителей данного элемента Перебрать всех родителей можно используя строки кода: Данную задачу можно решить и с помощью запроса, однако следует учитывать, что в языке запросов не предусмотрено специальных средств для получения всех родителей элемента. Для выполнения задачи можно воспользоваться, например, иерархическими итогами, текст запроса будет выглядеть следующим образом: Результат запроса будет содержать одну «лишнюю» запись, которую легко «отсеять» проверкой свойства «ЭтоГруппа». 94 Справочники Однако получение иерархических итогов оптимизировано для построения итогов большого количества записей, и не вполне эффективно для получения родителей одного элемента. Для более эффективного получения всех родительских записей элемента, рекомендуется перебирать в цикле его родителей небольшими порциями, например, так: 95 Прикладные объекты В данном примере в окно служебных сообщений выводятся все родители для ссылки, записанной в переменную «ЭлементНоменклатура». В цикле выбирается по 5 родителей ссылки. Если число уровней в справочнике ограничено и невелико, то возможно получение всех родителей одним запросом без цикла. Как получить запросом «полный» код элементов справочника, если тип кода Строка? Понятие «Полный код» соответствует объектной модели системы. Это свойство объектов «СправочникСсылка» и «СправочникОбъект», содержащее указание кодов элемента и всех родителей его иерархии. Представляет собой строку, в которой указаны коды всех вышестоящих элементов иерархии, начиная с самого верхнего уровня и разделяемые символом «/» заканчивая кодом самого элемента. В табличной модели хранения информации никакого поля «ПолныйКод» для таблиц справочника не существует. Однако можно говорить о значении поля «Родитель» каждой из записей таблиц справочников и о значении поля «Код». Поэтому запрос по трехуровневому справочнику «Контрагенты» будет выглядеть следующим образом: Источником является таблица справочника. Из нее выбираем поле «Ссылка» и вычисляемое поле «ПолныйКод». Вычисление полного кода производим путем сборки его из значений кодов самого элемента и кодов всех вышестоящих родителей. Для этого для каждой записи сначала определяем ее уровень. 96 Справочники Уровень определяем следующим образом: для записей корневого уровня поле «Родитель» содержит пустую ссылку на элемент справочника, поэтому значение поля «Код» этого «Родителя» будет NULL. Если это условие выполнилось - значит, элемент находится на корневом уровне, и в качестве полного кода достаточно указать код. Если условие не выполнилось - проверяем аналогичным способом элемент на принадлежность к первому уровню. В случае выполнения условия - выводим уже код родителя и код самого элемента через «/». Таким же образом можно построить «сборку» поля «ПолныйКод» для случаев 4-х, 5-ти и т.д. уровневых справочников. В отношении возможных возражений о «неуниверсальности» подобного подхода: хотя, в общем случае, количество уровней справочника может быть не ограничено, сложно представить себе реальную практику использования справочника более чем с 10 уровнями вложенности из-за явного неудобства работы пользователя с таким «глубоким» справочником. Как получить все элементы справочника, содержащие в наименовании определенную подстроку, со всей иерархией, в которую они входят? Допустим, речь идет о справочнике «Контрагенты». Лучше всего с данной задачей справится запрос со следующим текстом: 97 Прикладные объекты Источником запроса является таблица справочника. Делаем отбор по наименованиям, в составе которых присутствует значение параметра «ЧастьНаименования». Условие отбора обеспечивается посредством оператора проверки строки на подобие шаблону. В шаблоне служебными символами «%» обозначается, что перед и после части строки, считанной из «ПолеВводаПодстрока», может встречаться произвольное количество других символов. Как найти все элементы справочника, в которых не заполнен строковый реквизит? Получить желаемое можно таким запросом: Проверка пустой строки выполняется за счет операции сравнения «=». В данном случае будут отобраны и элементы, в которых пользователь ничего не вводил и даже те, в которые он ввел только пробел (или пробелы). Но на некоторые реквизиты при работе с формой накладывают маску. В таких случаях случайный ввод хотя бы одного пробела уже не позволяет данному реквизиту быть пустым. Его значение будет содержать маску с пробелами. Для того, чтобы «защитить пользователя от самого себя» в подобных случаях запрос лучше немножко изменить. Например, для реквизита с маской «999-999-999 99» запрос будет выглядеть таким образом: Количество пробелов соответствовать маске. перед и между символами «-» должно Справочники Как перенести все элементы справочника «Контрагенты» из одной группы в другую? Для этого необходимо перезаполнить значением нового родителя реквизит «Родитель» у элементов, непосредственно являющихся «потомками» исходного родителя. Итак, пусть переменная «СтарыйРодитель» содержит старого, а «НовыйРодитель» - нового родителя. Получение элементов справочника, которым нужно поменять родителя, производим следующим образом: Источником для запроса является таблица справочника «Контрагенты». Делаем отбор непосредственно по полю «Родитель» и получаем таблицу ссылок на нужные нам элементы справочника. Далее: В цикле обработки результата запроса производим получение объекта по ссылке. Для каждого полученного объекта производим запись нового родителя в реквизит «Родитель» и непосредственную запись объекта с измененными данными. 99 Прикладные объекты Как организовать программный выбор элемента справочника? Требуется из одной формы (например, формы документа) открыть для выбора элемента форму справочника. После того, как значение будет выбрано в форме справочника, его необходимо получить для дальнейшей обработки в форме документа. Для получения выбранного значения используется обработчик события Обработка выбора формы владельца (в нашем случае формы документа). Вместо метода Открыть() объекта Форма Выбора в ряде случаев можно использовать метод ОткрытьМодально(). В этом случае окно откроется в модальном режиме и пока данная форма не будет закрыта

Se construyó una configuración simple para contabilizar el movimiento de cartuchos para equipos láser en una organización utilizando la plataforma 1C Enterprise 8.3 y la interfaz Taxi. Se tiene en cuenta el movimiento de cada cartucho (compra, recarga, restauración, reparación, instalación en la impresora, etc.) y el costo de fondos por cada cartucho. El objetivo principal es dominar el desarrollo de aplicaciones basadas en la plataforma 1C Enterprise 8.3 utilizando el ejemplo de la creación de una aplicación funcional y útil.

Soy un programador experimentado, pero nunca antes había estado involucrado seriamente en 1C. Para combinar lo agradable (conocimiento de 1C Enterprise 8.3) con lo útil (nadie canceló el trabajo), intentemos construir una configuración viable utilizando las capacidades de la nueva versión. Tal vez el proceso de desarrollo de la configuración sea útil para alguien y ayude a los principiantes a dominar 1C.

Trabajo en el departamento de TI de una gran organización con una gran cantidad de impresoras láser y dispositivos multifunción. Contabilizar el movimiento de cartuchos para ellos es una tarea urgente y un requisito de la gestión.

Formulación del problema.

La recarga de tóner, la restauración y la reparación de cartuchos la realiza un tercero. Es necesario tener en cuenta el movimiento de cada cartucho, es decir, compra, recarga de tóner, restauración, reparación, instalación en una impresora específica (MFP), ubicación actual, baja, etc. Además, es necesario tener en cuenta los costes de cada cartucho (costes de compra, recarga de tóner, etc.) por parte de los proveedores).

Negocios claros: todos los informes son necesarios. Por supuesto, para los usuarios, todo debe ser lo más simple y claro posible.

Plan de IMPLEMENTACION.

Utilizamos la plataforma 1C Enterprise 8.3 como la más moderna en este momento.

Para dominar la plataforma, intentaremos utilizar tantos objetos de configuración diferentes como sea posible y, por supuesto, la nueva interfaz Taxi. Intentaremos dar a los objetos nombres comprensibles y cercanos al propósito funcional. Por ahora, no tocaremos los aspectos "delgados" de la operación de 1C, como la optimización de la interacción cliente-servidor, la distribución de roles, etc.

Para empezar, supongamos que tenemos los siguientes objetos en nuestra configuración:

Libros de referencia:

Nomenclatura de Cartuchos

Cartuchos

NomenclaturaCartuchosPrecios

Impresoras

Nomenclatura de Impresoras

Proveedores

Documentación:

Recepción de Cartuchos

Reemplazo del cartucho

Cartuchos de cancelación

Enumeraciones:

No precisamente

Estado de los cartuchos

Razones para reemplazar los cartuchos

Registros de información:

CartuchosReemplazo

Registros de acumulación:

CartuchosPago

Algoritmo de trabajo.

El "actor" principal es la lista de cartuchos disponibles (Referencia Cartuchos). Inicialmente, la lista se llena con un documento Recepción de Cartuchos Nomenclatura de Cartuchos. Al comprar un valor de accesorios de cartucho Estado en el documento se selecciona como Nuevo. El precio de compra lo determina el directorio. NomenclaturaCartuchosPrecios fecha actual Número de serie). Accesorios Ubicación definido como "C tesoro".

La contabilización de recargas, restauración, reparación, etc. de cartuchos ya existentes también se lleva a cabo mediante un documento Recepción de Cartuchos. El tipo de cartuchos está determinado por el directorio. Nomenclatura de Cartuchos. El estado del cartucho se determina a partir de la enumeración Estado de los cartuchos. El precio de la obra (repostaje, restauración) lo determina el directorio NomenclaturaCartuchosPrecios. La singularidad del cartucho está determinada por su número de serie (accesorios Número de serie).

Al realizar un documento Recepción de Cartuchos a la sección tabular Sustitución de cartuchos directorio Cartuchos se agrega una línea con los detalles del documento actual y para los cartuchos correspondientes (con un número de serie del documento) en el directorio Cartuchos cambios de valor de atributo Estado Y Ubicación.

Además, en el registro de acumulaciones CartuchosPago

Contabilidad de reemplazo de cartucho para una impresora específica (Referencia Impresoras) se lleva a cabo por el documento Reemplazo del cartucho. El documento indica la impresora actual. La singularidad de la impresora está determinada por los accesorios. Número de serie. Especifica el cartucho que se instalará y reemplazará (números de serie del cartucho).

Al realizar un documento Reemplazo del cartucho en la parte tabular del directorio Impresoras para la impresora actual, se agrega una línea con los detalles del documento y se cambia el atributo Cartucho. en el directorio Cartuchos el valor de los atributos cambia para los cartuchos actuales Estado Y Ubicación. Para cartucho instalado en puntales Ubicación la impresora actual está registrada y el cartucho extraído tiene " Existencias".

Además, en el registro CartuchosReemplazo se registra el movimiento bajo este documento.

La cancelación de los cartuchos se realiza mediante un documento separado. Cartuchos de cancelación.

Por lo tanto, en el momento actual en el directorio Cartuchos cada cartucho tiene un estado bien definido (nuevo, recargado, vacío, etc.) y una ubicación específica ( "Existencias" o una impresora en concreto), que, mediante sencillos informes, permite evaluar la disponibilidad de cartuchos con un estado determinado y sacar una conclusión sobre la necesidad de compra, recarga, etc. Bueno, y por supuesto, tener en cuenta los costes.

Implementación.

Vayamos a la configuración real.

Creemos una base de datos vacía en el configurador, llámela con orgullo "especialista en TI" y organice un subsistema Inventario de cartuchos. No describiré paso a paso cómo hacer esto, ya que hay suficientes libros sobre este tema.

Agreguemos enumeraciones primero: No precisamente, Estado de los cartuchos Y Razones para reemplazar los cartuchos que necesitaremos más adelante. La composición de las enumeraciones es visible en la Fig. 2

Configuración de directorios simples Nomenclatura de Cartuchos Y Nomenclatura de Impresoras.

Accesorios Tipo de cartucho en el directorio NomenclaturaImpresoras asignar la referencia de tipo al directorio Nomenclatura de Cartuchos(Fig. 3). No olvides que todos los objetos de configuración que hemos creado deben estar incluidos en el subsistema ContabilidadCartuchos.

en el directorio Impresoras varios accesorios tienen tipo de enlace:

Para probar más el programa, completemos el modo Enterprise para varias líneas en los directorios que hemos abierto. Naturalmente, primero llenamos directorios simples, luego directorios con detalles de referencia. En el futuro, se supone que la descarga de datos reales completos de la empresa se llevará a cabo mediante el procesamiento de tablas de Excel.

Ahora es el momento de agregar documentos a la configuración. Configuremos el objeto de documento en el árbol de objetos de configuración Recepción de Cartuchos con detalles y parte tabular Nomenclatura del documento. Todavía no tenemos registros de acumulación en la configuración - marcador Movimienot porque el documento permanece vacío. Dado que necesitaremos escribir nuestro propio procesamiento del documento, y el código del programa está escrito en el módulo de formulario del documento, crearemos este mismo formulario (Fig. 9). Hacemos todo por defecto, como está escrito en los libros (Formulario - Añadir - FormularioDocumento).

Usaremos este documento cuando lleguen al almacén cartuchos nuevos y recargados (remanufacturados, reparados).

Finalmente, para contabilizar la recepción de cartuchos, iniciamos un registro de acumulación CartuchosPago con medidas, recursos y detalles (Fig.10) .

marcado registradores especificar nuestro documento Recepción de Cartuchos. Guardamos la configuración.

Regresando a través del árbol de objetos al documento Recepción de Cartuchos. Marcador Movimienot elegir registrarse CartuchosPago, inicie Motion Builder y complete el campo Expresión con los valores de los detalles del documento (Fig.11).

Haga clic en Aceptar y vaya a módulo de objetos código de programa (Fig.12).

Ahora, lo más interesante: debe agregar el código del programa al módulo de objetos para proporcionar la siguiente funcionalidad al publicar un documento Recepción de Cartuchos.

Cuando llega un nuevo cartucho (comprado) en la guía Cartuchos se debe agregar una línea con un número de cartucho único y los detalles correspondientes (del documento). Al mismo tiempo, los accesorios Condición del cartucho importará" Nuevo y accesorios Ubicación- significado " Existencias". Parte tabular del directorio. Cartuchos no está lleno.

De acuerdo con el algoritmo del programa, inicialmente es necesario ingresar cada cartucho con su número único en el directorio Cartuchos documento Recepción de Cartuchos.

Al recibir un cartucho lleno de tóner (remanufacturado, reparado, etc.), se considera que el cartucho con este número ya está en el directorio Cartuchos, y en este caso, al contabilizar el documento Recibo de Cartuchos, se agrega una fila a la tabla gasolineras y cambiar los valores de los atributos Ubicación Y Estado para el cartucho actual. El código agregado al módulo de objetos se muestra en la Figura 13.

Ahora puede realizar la primera prueba del rendimiento del programa. En la Enterprise creamos un documento Recepción de Cartuchos(Fig. 14). Presionamos el botón pasar y cerrar. Ir al directorio Cartuchos y vemos que en él apareció una línea con los detalles del cartucho comprado con una sección tabular vacía (Fig. 15).

Abramos el registro. CartuchosPago(opción del menú Registro de pago de cartuchos) y ver una línea similar allí.

Crear y publicar un segundo documento Recepción de Cartuchos con el mismo cartucho, pero rellenado (Fig.16).

Ir al directorio Cartuchos y vemos que el cartucho que hemos introducido tiene una línea en la sección tabular gasolineras y accesorios cambiados Estado(Fig. 17).

¡Hurra! ¡El programa funciona!

Por supuesto la funcionalidad del documento Recepción de Cartuchos hay que mejorar, por ejemplo, me gustaria que en el campo se sustituya automaticamente el ultimo precio del servicio Precio documento del directorio NomenclaturaCartuchosPrecios al elegir un proveedor y para un tipo de cartucho determinado.

Será más tarde, pero ahora nos ocuparemos del reemplazo de los cartuchos: crearemos un documento Reemplazo del cartucho y el registro de información correspondiente CartuchosReemplazo.

Detalles y parte tabular del documento. Nomenclatura del documento se muestra en la Fig. 18. Todavía no disponemos de registros de acumulación adecuados e información en la configuración, en la pestaña Movimienot no marcaremos nada para el documento. Dado que necesitaremos escribir nuestro propio procesamiento del documento, creamos el DocumentForm predeterminado.

Para contabilizar el reemplazo de cartuchos, iniciamos, para variar, un registro de información (no un registro de acumulaciones) CartuchosReemplazo con medidas y detalles (Fig.19) . Resultó hasta ahora sin recursos de alguna manera. .

marcado registradores especificar nuestro documento Reemplazo del cartucho.

Guardamos la configuración. Regresando a través del árbol de objetos al documento Reemplazo de cartuchos. Marcador Movimienot elegir registrarse CartuchosReemplazo, inicie Motion Builder y complete el campo Expresión con los valores de los detalles del documento. Haga clic en Aceptar y vaya a módulo de objetos documento, donde vemos el ya creado Registrar constructor de movimiento código de programa (Fig.20).

Ahora agrega a módulo de objetos código de programa para proporcionar la siguiente funcionalidad al publicar un documento Reemplazo del cartucho. en el directorio Impresoras para una impresora cuyo cartucho se está reemplazando, se debe agregar una línea en la sección tabular Sustitución de cartuchos con valores de atributo del documento y el valor del atributo cambiará Número de cartucho ahora. en el directorio Cartuchos los valores de los detalles cambiarán para los cartuchos retirados e instalados Ubicación Y Estado. Procedimiento de procesamiento de documentos mejorado Reemplazo del cartucho mostrado a continuación.

Manejo de procedimientos Ejecución (falla, modo)

// directorios usados

Impresoras = Referencias.Impresoras;

Cartuchos = Referencias.Cartuchos;

// fin de insertar directorios usados

//Registrar reemplazo de cartuchos

Movimientos.Reemplazo de cartuchos.Escribir = Verdadero;

Para cada TekRowDocumentNomenclatureFromDocumentNomenclature Loop

Movimiento = Movimiento.Reemplazo de cartuchos.Add();

Movimiento.CartuchoNomenclatura = CartuchoNomenclatura;

Movimiento.RemovedCartridgeNumber = CurrentLineDocumentNomenclature.RemovedCartridgeNumber;

Movimiento.Número de cartucho instalado=

Movimiento.ModeloImpresora = ModeloImpresora;

Movimiento.PrinterSerialNumber = CurrentStringDocumentNomenclature.PrinterSerialNumber;

Movimiento.PrinterInventoryNumber =

Movimiento.TipoCartucho = CurrentStringDocumentNomenclature.CartridgeType;

Movimiento.ReemplazoQuienHizo = ReemplazoQuienHizo;

Movement.ReasonReplacement = CurrentStringDocumentNomenclature.ReasonReplacement;

// cambiar el directorio de impresoras

NameString = CurrentStringDocumentNomenclature.PrinterSerialNumber;

Entonces ObjetoActual =

Printers.FindByAttributes("SerialNumber",NameString).GetObject();

ObjetoActual.NúmeroCartuchoAhora =

CurrentLineDocumentNomenclature.InstalledCartridgeNumber;

NewString = CurrentObject.ReplaceingCartridges.Add();

NewString.DateReplacement = Fecha;

NewString.CartridgeType = CurrentStringDocumentNomenclature.CartridgeType;

NewString.InstalledCartridgeNumber =

CurrentLineDocumentNomenclature.InstalledCartridgeNumber;

NewLine.RemovedCartridgeNumber =

CurrentLineDocumentNomenclature.RemovedCartridgeNumber;

NewString.QuiénReemplazó = ReemplazoQuiénHizo;

NewString.ReplacementReason = CurrentStringDocumentNomenclature.ReplacementReason;

ObjetoActual.Escribir();

Terminara si;

// cambiar el directorio Cartuchos - cartucho instalado

StringName = CurrentStringNomenclatureDocument.InstalledCartridgeNumber;

entonces ObjetoActual =

Cadena = "";

Cadena = Cadena + Modelo de Impresora + " " +

CurrentStringDocumentNomenclature.PrinterSerialNumber + " " +

CurrentStringDocumentNomenclature.PrinterInventoryNumber;

ObjetoActual.Ubicación = Cadena;

ObjetoActual.Escribir();

Terminara si;

// cartucho eliminado

StringName = CurrentStringNomenclatureDocument.RemovedCartridgeNumber;

Entonces ObjetoActual =

Cartuchos.FindBy Props("Número",NameString).GetObject();

ObjetoActual.Ubicación = "Almacén";

CurrentObject.Status = Enumeraciones.CartridgeState.Empty;

ObjetoActual.Escribir();

Terminara si;

// fin de cambiar directorios

FinCiclo;

FinalizarProcedimiento;

Para verificación, complete y publique el documento Reemplazo del cartucho(Fig.21) . vamos al directorio Impresoras y vemos que la impresora seleccionada tiene una línea añadida a la sección tabular gasolineras con los detalles del documento realizado por nosotros y los detalles Número de cartuchoAhora aceptado el valor del número del cartucho instalado (Fig.22).

en el directorio Cartuchos en el cartucho instalado en la impresora, en accesorios Ubicación se han escrito los datos de la impresora actual (Fig.23) . Y además, en el registro de información CartuchosReemplazo se registró el movimiento del documento (Fig. 24)

Así, de momento, tenemos una configuración que tiene en cuenta el movimiento de cartuchos para tecnología láser, que, en principio, ya se puede utilizar en obra.

Desde el punto de vista de la "ideología" de 1C, probablemente sea incorrecto cambiar los detalles de los directorios al almacenar documentos, usar el directorio para almacenar los precios actuales; esto afecta la experiencia previa con las tablas del autor del artículo. , y ¿por qué el directorio no es una tabla?

Naturalmente, es necesario mejorar la funcionalidad, agregar informes, corregir errores y depurar. Más sobre esto en la siguiente parte del artículo.

La versión completa del artículo se encuentra en el archivo Part1.doc

El libro electrónico se distribuye como un archivo que contiene:

• un archivo exe ejecutable que incluye tanto el libro en sí como el programa SunRav BookReader diseñado para ver este libro
• catálogo con materiales adicionales para el libro.
• el libro está diseñado para ser leído bajo el sistema operativo Windows

Libro 1C: Empresa 8.1. Ejemplos de desarrollo simples es un manual de referencia que ilustra ejemplos simples de desarrollo de algoritmos en la plataforma 1C:Enterprise 8.1.

La publicación será útil para desarrolladores novatos, administradores que implementan el sistema en la empresa y usuarios avanzados que desean perfeccionar soluciones de aplicaciones de forma independiente.

Libro 1C: Empresa 8.1. Ejemplos de desarrollo simples contiene un gran número de ejemplos prácticos agrupados por temas de uso.

Para ayudar a los desarrolladores de soluciones aplicadas, los códigos de los ejemplos descritos se adjuntan al libro. El código de ejemplo se presenta como un archivo de plantilla de texto 1C:Enterprise 8. Este archivo se puede conectar a cualquier configuración y los ejemplos se pueden arrastrar con el mouse o insertar en un módulo mediante autocorrección.

Después de confirmar el pago del libro, recibirás:

* Se recomienda que lea los archivos .epub en su computadora usando el lector Adobe Digital Editions. Al leer con otros programas, no se recomienda utilizar un modo de visualización que permita mostrar dos páginas al mismo tiempo; debido a la gran cantidad de imágenes, puede ocurrir una visualización incorrecta.

¿Por qué son mejores los productos descargables?

No es necesario pagar por la entrega, obtiene la revista en un par de clics en cualquier momento del día;

La velocidad de descarga depende solo de las capacidades de su conexión, los administradores de descarga son compatibles;

Si tiene algún problema para recibir su compra, puede contactar a nuestros asesores en línea;