Plataforma 1C:Enterprise >> Aprendizaje >> Construyendo una aplicación móvil >> Comenzar a programar

   

Ahora proceda a agregar documentos que registren ingresos y gastos de dinero. El primer documento que agregará es Ingreso.

Los documentos se encuentran en la rama Documentos del árbol de objetos de configuración. Agregue un nuevo documento.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872814_1c_mobile_05-01.png

Figura 5-1. Agregar un nuevo documento

Nómbrelo Ingreso y luego proceda a la pestaña Datos.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752653_1c_mobile_05-02.png

Figura 5-2. Creando el documento de ingreso

Cada documento tiene dos atributos predeterminados, Número y Fecha, que indican el número secuencial del documento y la fecha en que se creó. Sin embargo, además de estos atributos, generalmente se requiere tener otra información relacionada con la actividad comercial específica en el documento. Por ejemplo, en esta clase magistral, los usuarios desearían ver cuál fue el motivo del ingreso de dinero, así como su cuenta y categoría.

Para poder realizar un seguimiento de los eventos por cuentas, es necesario crear dos atributos: Cuenta y Categoría. Para realizar un seguimiento del monto de las transacciones, cree el atributo Monto. Es posible que también necesite comentar cada ingreso. Agregue el atributo Comentario:

Después de realizar estas acciones, la pestaña Datos del documento se verá de la siguiente manera:

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872834_1c_mobile_05-03.png

Figura 5-3. Rellenando el documento con campos

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752673_1c_mobile_05-04.png

Figura 5-4. Atributo de cuenta

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872854_1c_mobile_05-05.png

Figura 5-5. Atributo de categoría

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872874_1c_mobile_05-06.png

Figura 5-6. Atributo de cantidad

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752693_1c_mobile_05-07.png

Figura 5-7. Atributo de memo

Y el paso final, pero el más importante: proceda a la pestaña Publicación.

Como se mencionó anteriormente, los documentos escriben datos en registros y luego se reciben datos útiles para futuros procesamientos de los registros. Si solo guarda los datos del documento sin publicarlos, no se cambian los datos del registro. Para realizar cambios en los registros, debe publicar el documento.

Los registros de documentos son registros que los documentos crean en los registros; en nuestro caso, los registros del documento Ingreso se crearán en el registro de Cuentas.

Expanda el nodo Registros de acumulación y seleccione la casilla de verificación del registro de acumulación Cuentas. Luego haga clic en Asistente de registros de registros y la plataforma lo ayudará a crear el algoritmo de escritura de datos para los registros.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752713_1c_mobile_05-08.png

Figura 5-8. Definición de registros de documentos

Se abrirá una ventana de Asistente de registros de registros. Deje sin cambios el Tipo de registro de registro, igual a Recibo, ya que este documento es un recibo de dinero. Luego haga clic en Llenar expresiones.

En la tabla en la parte inferior de la ventana, puede ver que la plataforma encontró automáticamente la correspondencia entre los atributos del registro de acumulación y los atributos del documento. El valor del atributo Cuenta del documento se colocará en la dimensión del registro de Cuenta. El valor del atributo Cantidad se colocará en el recurso del registro de Cantidad. El valor del atributo Categoría del documento se colocará en el atributo del registro de Categoría.

Después de completar y verificar la tabla de correspondencia, haga clic en Aceptar.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872894_1c_mobile_05-09.png

Figura 5-9. Asistente de registros de registros

El asistente generará el procedimiento para escribir registros de documentos, en otras palabras, para publicar el documento, y luego lo mostrará en la pantalla.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872934_1c_mobile_05-10.png

Figura 5-10. Procedimiento para publicar el documento

Como puedes ver, el procedimiento es bastante simple: se agrega un nuevo registro al registro y luego se llena el registro con los datos de los campos correspondientes del documento.

Puedes escribir este algoritmo tú mismo, pero para minimizar la cantidad de trabajo es mejor utilizar el Asistente de Registros de Registro. El asistente generó este código automáticamente, que se menciona en los comentarios al principio y al final del procedimiento.

Hemos terminado con Ingreso. Sin embargo, los usuarios también necesitan hacer un seguimiento de los gastos. Parece obvio que es necesario crear el documento de Gasto. Podrías crearlo fácilmente manualmente de la misma manera que ya lo hiciste con el documento de Ingreso existente porque la estructura de estos dos documentos es idéntica. Sin embargo, otra opción es utilizar la función de 1C:Enterprise 8 que te permite crear nuevos objetos de configuración basados en los existentes simplemente copiándolos.

Para hacer esto, haz clic en el documento de Ingreso existente en la lista de objetos de metadatos y haz clic en Agregar mediante clonación https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752733_1c_mobile_clone.png (F9).

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872954_1c_mobile_05-11.png

Figura 5-11. Agregar mediante clonación

Una vez que hagas clic en este botón, aparecerá un nuevo documento Ingreso1. Será una copia exacta de Ingreso.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752753_1c_mobile_05-12.png

Figura 5-12. Una copia del documento de Ingreso

Lo único que queda por hacer es cambiar el nombre del documento y editar algunas de sus propiedades. Hazlo.

Primero, abre la ventana del editor de propiedades y cambia el nombre del documento a Gasto. Luego ve a la pestaña Datos.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752793_1c_mobile_05-13.png

Figura 5-13. Documento de Gasto

En la pestaña Datos, utilizando Propiedades, cambia el nombre de Categoría a Propósito.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872974_1c_mobile_05-14.png

Figura 5-14. Cambio de nombre de Categoría a Propósito

Una pequeña explicación, los usuarios pueden reflejar dos tipos de operaciones con el documento Gasto:

Es decir, el documento Gasto puede registrar tanto la transferencia de dinero entre cuentas como el gasto de dinero por una categoría.

Para implementar nuestra idea, selecciona Tipo de dato compuesto: CatalogRef.Cuentas y CatalogRef.Categorías.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025872994_1c_mobile_05-15.png

Figura 5-15. Atributo Propósito

Si el propósito es una cuenta, el documento refleja una transferencia porque tanto la fuente (Cuenta) como el destino (Propósito) son cuentas. Si Propósito contiene una categoría, el documento refleja un gasto.

Mantén los atributos restantes sin cambios, ya que cumplen con los requisitos del proyecto.

Continúa a la pestaña Contabilización. Aquí cambiaremos la contabilización del documento. Por ahora, el algoritmo de contabilización se copia del documento Ingreso. Ese documento registra ingresos, pero el documento recién creado está diseñado para almacenar gastos.

Selecciona tanto los registros de Cuentas como de Gastos. Luego haz clic en Asistente de registros de registro. La plataforma te pedirá que confirmes que el script existente se reemplazará. Confírmalo.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752813_1c_mobile_05-16.png 

Figura 5-16. Asistente de registros de registro

Para el registro de Cuentas (se seleccionará automáticamente), completa todos los campos como en el documento anterior. Solo cambia el tipo de registro a Gasto y haz clic en Llenar expresiones.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752853_1c_mobile_05-17.png 

Figura 5-17. Asistente de registros de registro

Presta atención al campo de registro Categoría, que se deja vacío. El punto es que el asistente compara los atributos del documento y los campos de registro por nombres. Pero no tenemos el atributo Categoría en el documento Gasto. Ayuda al asistente, haz clic en la fila con el campo Categoría y luego haz doble clic en el atributo Propósito en el área de Atributos del documento.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025873014_1c_mobile_05-18.png Figura 5-18. Rellenando el campo Categoría

Eso no es todo lo que tenemos que hacer. El documento Ingreso agrega registros solo al registro Cuentas, pero el documento Gasto tiene que agregar registros a los registros Cuentas y Gastos, por eso, sin cerrar la ventana del Asistente de Registros de Registro, tienes que agregar el registro Categoría a la lista de Registros.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752873_1c_mobile_05-19.png

Figura 5-19. Agregando el registro Gastos

Haz clic en RegistroAcumulación.Gastos y luego haz clic en Llenar Expresiones.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025873034_1c_mobile_05-20.png

Figura 5-20. Rellenando los registros del registro Gastos

Como en el caso anterior, el campo Categoría no está lleno. Llénalo con el atributo Propósito como lo hiciste con el campo del registro Cuentas.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025873054_1c_mobile_05-21.png

Figura 5-21. Rellenando el campo del registro Categoría

Ahora todo está listo para generar registros de registro. Haz clic en Aceptar.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360025873074_1c_mobile_05-22.png 

Figura 5-22. Procedimiento de publicación generado por un asistente

Puedes ver que en lo que respecta al registro Cuentas hay diferencias mínimas entre los dos documentos. En el documento Gasto, el tipo de registro es Gasto. Además, el procedimiento de Publicación contiene un script que agrega registros al registro Gastos. Nada complicado aquí.

Lo único que requiere explicación es que el procedimiento de publicación actual implementa solo una rama del comportamiento del documento: gasto de dinero. Como dijimos antes, el documento también debe admitir la transferencia de dinero entre cuentas.

Aquí, por primera vez en nuestra clase magistral, tenemos que personalizar el script manualmente.

Es fácil determinar el tipo de documento: podemos averiguarlo con el atributo Propósito. Para esto, agrega una condición clásica Si-Entonces-Sino.

Si el valor del atributo Purpose es CatalogRef.Categories, entonces el documento refleja un gasto y ya tenemos el script de contabilización (ver figura 5-22).

Si el valor del atributo Purpose es CatalogRef.Accounts, entonces el documento debe agregar registros de transferencia al registro Accounts. Un registro debe disminuir la cantidad de dinero en una cuenta y otro debe agregar la misma cantidad a la otra cuenta. En este caso, no se agrega ningún registro al registro Expense.

Una vez que se realizan todos los cambios, el módulo se ve como en la figura 5-23.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/en_360026752913_1c_mobile_05-23.png

Figura 5-23. Procedimiento de contabilización personalizado

Puede encontrar el texto del módulo en el archivo Expense document module.txt en el directorio \demo\ext.

Antes de continuar con el siguiente paso, guarde su progreso. Haga clic en Actualizar configuración de la base de datoshttps://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/en_360025873094_1c_mobile_updatedc.png (F7). 

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/en_360026752933_1c_mobile_05-24.png

Figura 5-24. Actualizar configuración de la base de datos

La plataforma muestra los cambios en la configuración, haga clic en Aceptar.

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/en_360025873134_1c_mobile_05-25.png

Figura 5-25. Actualizar configuración de la base de datos

Ahora su configuración tiene catálogos para almacenar detalles de cuentas y categorías de ingresos y gastos. Tiene registros para recuperar rápidamente los datos requeridos y tiene documentos para reflejar ingresos y gastos.

Entonces, la base de su solución aplicada está lista. Cumple con los objetivos requeridos. Pero, ¿será fácil de usar? Para comprobarlo, inicie la aplicación en el modo 1C:Enterprise haciendo clic en Iniciar depuración https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/en_360026752953_1c_mobile_startd.png (F5).

https://kb.1ci.com/bin/download/OnecInt/KB/1C_Enterprise_Platform/Tutorials/Building_a_mobile_application/Start_programming/WebHome/es_360026752973_1c_mobile_05-26.png

Figura 6-26. Iniciar la depuración