Conocer la arquitectura de la aplicación de ejemplo Hitos
En este artículo, aprenderá sobre las colecciones y las variables globales que utiliza la aplicación Hitos y cómo usarlos de manera efectiva. Si desea obtener más información sobre cómo instalar y utilizar la aplicación de muestra Hitos en su lugar, vaya a la aplicación de muestra Hitos.
Requisitos previos
Para comprender y usar la información de este artículo, necesitará conocer los diferentes controles, características y capacidades de las aplicaciones de lienzo.
- Crear y actualizar una colección en una aplicación de lienzo
- Funciones Collect, Clear y ClearCollect en Power Apps
- Descripción de las variables de aplicación de lienzo en Power Apps
- Agregar y configurar un control de aplicaciones de lienzo en Power Apps
- Agregar una pantalla a una aplicación de lienzo y navegar por diferentes pantallas
También necesitará saber cómo instalar, y usar la aplicación de ejemplo Hitos.
Modelo de datos
Modelo de arquitectura
El siguiente diagrama muestra la forma en que los usuarios y los sistemas interactúan con los datos en esta solución.
Conectores
La aplicación Hitos usa los siguientes conectores:
Microsoft Dataverse para leer y escribir datos en tablas Dataverse.
Office 365 Users para leer datos de perfil de usuario.
Tablas
La aplicación Hitos incluye las siguientes tablas:
| Nombre de tabla | Descripción |
|---|---|
| Project | Un proyecto denota una empresa individual o colaborativa que se planifica cuidadosamente para lograr un objetivo particular. Los detalles como el nombre, cuándo y quién lo creó o modificó y almacenó en la entidad Proyectos. Un solo proyecto puede tener varios hitos, elementos de trabajo, miembros del equipo y actividades asociadas a él. |
| Hito de proyecto | Un hito del proyecto es una tarea que representa un logro importante en un proyecto. Los hitos deben representar una secuencia de eventos que incrementalmente se crean hasta que se completa un proyecto. Detalles como el nombre, el proyecto al que está asociado y la fecha cuando se debe completar el hito se almacenan en los hitos del proyecto entidad. Un hito sólo puede ser parte de un solo proyecto, pero puede tener varios elementos de trabajo asociados a él. |
| Elemento de trabajo de proyecto | Un elemento de trabajo indica el tipo de trabajo, lo que se debe realizar y la fecha en la que se debe completar. Detalles como el nombre, la descripción, a quién se ha asignado, el estado, la prioridad y la fecha de destino definen un elemento de trabajo. Un elemento de trabajo puede formar parte de un único hito y solo puede tener un estado, prioridad, categoría y miembro del equipo asociado a él. Sin embargo, puede tener varias actividades asociadas. |
| Estado del proyecto | Estado resume el estado general de un elemento de trabajo. Los valores de estado predeterminados incluyen Nuevo, En curso, Bloqueado y Completado. Se pueden agregar más estados desde la sección Configuración de la aplicación. Cada estado tiene un nombre y un color asociado. |
| Prioridades del elemento de trabajo | La prioridad representa el orden de importancia en el que se debe completar un elemento de trabajo en comparación con los elementos de trabajo restantes. Las prioridades predeterminadas incluyen P0, P1, P2 y P3. Se pueden agregar más prioridades desde la sección Configuración de la aplicación. Cada prioridad tiene un nombre y un color asociado. |
| Categorías del elemento de trabajo | Las categorías ayudan a clasificar los elementos de trabajo. Las prioridades predeterminadas incluyen alta, media y baja. Se pueden agregar más categorías desde la sección Configuración de la aplicación. Cada categoría tiene un nombre y un color asociado. |
| Miembros del equipo del proyecto | Los miembros del equipo son personas que trabajan en uno o varios elementos de trabajo de un proyecto. Una persona que forma parte de varios proyectos tendrá un registro de miembro del equipo por proyecto. |
| Actividades de proyecto | Las actividades se usan para proporcionar actualizaciones realizadas en los elementos de trabajo de un proyecto. A Un solo elemento de trabajo puede tener varias actividades. Actividades se crean como se actualizan los elementos de trabajo. Una actividad también se puede crear manualmente. |
| Configuración de usuario del proyecto | La configuración del usuario se utiliza para almacenar las preferencias del usuario relacionadas con la visualización de la pantalla de bienvenida de Power Apps cada vez que inician sesión en la aplicación. Hay un registro para cada usuario. |
Colecciones
| Nombre de colección | Descripción | Pantalla utilizada |
|---|---|---|
| colLocalization | Se utiliza para crear una colección de localización basada en el idioma del usuario. | Propiedad OnStart de la aplicación |
| colWorkItems | Se usa para recopilar los elementos de trabajo. | |
| colUserSettings | Se utiliza para recopilar la configuración del registro de configuración de usuario de Dataverse, si existe. | Propiedad OnStart de la aplicación |
| colWorkItemHeaderIcons | Se usa para recopilar los iconos de encabezado de Elementos de trabajo. | Propiedad OnStart de la aplicación |
| colProjectCoverColors | Se utiliza para recopilar los colores de portada del proyecto. | Propiedad OnStart de la aplicación |
| colStockImages | Colección para recopilar las imágenes de archivo utilizadas en la aplicación. | Propiedad OnStart de la aplicación |
| colNewProjectMilestones | Se utiliza para recopilar la información predeterminada de un hito recién agregado. | Propiedad OnSelect de la imagen Agregar hitos en la pantalla proyectos |
| colProjectTeamMembers | Se usa para recopilar los miembros de este equipo que forman parte de un proyecto. | Propiedad OnVisible de la pantalla Configuración |
| colRemovedProjectTeamMembers | Se utiliza para recopilar los miembros del equipo que se han quitado del proyecto. | Propiedad OnSelect del botón Eliminar en la configuración de Miembros del equipo |
| colRemovedProjectMilestones | Se utiliza para recopilar los hitos que se han quitado del proyecto. | No disponible |
| colCategories | Se utiliza para recopilar la información de categoría. | Propiedad OnSelect del botón Guardar en la pantalla Configuración |
| colNewProjectTeamMembers | Se usa para recopilar los miembros de este equipo recientemente agregados a un proyecto. | Propiedad OnSelect del botón Crear en la pantalla de proyectos |
| colProjectMilestones | Se utiliza para recopilar la información de hitos de un proyecto. | Propiedad OnSelect del botón de confirmación Borrar |
| colRemovedCategories | Se usa para recopilar las categorías que se eliminarán. | Propiedad OnSelect del botón Guardar en la pantalla Configuración |
| colPriorities | Se utiliza para recopilar la información de prioridades. | Propiedad OnSelect del botón Guardar en la pantalla Configuración |
| colRemovedPriorities | Se usa para recopilar las prioridades que se eliminarán. | Propiedad OnSelect del botón Guardar en la pantalla Configuración |
| colStatuses | Se utiliza para recopilar la información de estado. | Propiedad OnSelect del botón Guardar en la pantalla Configuración |
| colRemovedStatuses | Se usa para recopilar las prioridades que se eliminarán. | Propiedad OnSelect del botón Guardar en la pantalla Configuración |
| colRemoveWorkItems | Se usa para recopilar los elementos de trabajo que se han comprobado para su eliminación. | Propiedad OnSelect del botón Eliminar de la ventana emergente de confirmación de la pantalla Proyectos. |
| colRemovedMilestones | Se utiliza para recopilar los miembros del equipo que se han quitado del proyecto. | Propiedad OnSelect del botón Eliminar en la sección Detalles del proyecto de la página de configuración. |
| colWorkItemStatuses | Se usa para recopilar los estados disponibles para los elementos de trabajo. | Propiedad Items del cuadro combinado Estado de la pantalla Proyecto |
Variables globales
| Nombre de variable | Tipo | Descripción |
|---|---|---|
| gblAppLoaded | Booleana | Para comprobar si la aplicación está cargada. |
| gblUserLanguage | Texto | Para comprobar el idioma de los usuarios registrados. |
| colCharsWidth | Tabla | Se utiliza para almacenar el ancho de los caracteres para diferentes fuentes, pesos, tamaños, etc. |
| gblThemeDark | Booleana | Para comprobar si el tema de Teams está configurado en Oscuro. |
| gblThemeHiCo | Booleana | Para comprobar si el tema de Teams está configurado en Contraste alto. |
| gblMobileWidth | Número | Variable para establecer el ancho en el móvil. |
| gblMobileMode | Booleana | Variable para comprobar si la aplicación se está ejecutando en el móvil. |
| gblAppSetting_inputMobileOnWeb | Booleana | Variables para escalar fuentes para aplicaciones orientadas a dispositivos móviles, que se ejecutan en el escritorio. |
| gblAppSetting_inputScaleFontsby | Número | Utilice esta variable para escalar todas las fuentes en una cantidad fija. |
| gblAppContext | Booleana | Para comprobar el contexto de dónde se está ejecutando la aplicación. |
| gblFirstRun | Booleana | Para comprobar si la aplicación se ejecuta por primera vez. |
| gblRecordUserSettings | Grabar | Variable para utilizar el registro más antiguo en caso de que existan varios registros. |
| gblAppSetting_inputMobile | Booleana | Variables para escalar fuentes para aplicaciones orientadas a dispositivos móviles. |
| gblAppColors | Grabar | Variable para establecer el valor de color en la aplicación. |
| gblAppSizes | Grabar | Variable para establecer el valor de color en la aplicación. |
| gblAppStyles | Grabar | Variable para establecer los valores de estilo en la aplicación. |
| gblProject | Grabar | Variable para almacenar un registro de proyecto que está en contexto. |
OnStart de aplicación
Esta sección explica las colecciones, variables y detalles de ejecución OnStart de la aplicación.
Colecciones OnStart
Colecciones utilizadas durante OnStart de la aplicación:
| Nombre de colección | Descripción |
|---|---|
| colLocalization | Colección de texto localizado según el idioma del usuario. |
| colCharsWidth | Colección de anchos para cada carácter utilizado para etiquetas de ancho automático. |
| colStockImages | Colección de imágenes de cubierta de proyecto de valores. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
| colWorkItemHeaderIcons | Colección de iconos de encabezado para elementos de trabajo. |
| colUserSettings | Recopilación de la configuración de usuario de la tabla Configuración de usuario de proyecto. |
Variables OnStart
Variables utilizadas durante OnStart de la aplicación:
| Nombre de variable | Descripción |
|---|---|
| gblAppLoaded | Variable global para comprobar si la aplicación se ha cargado por completo. |
| gblUserLanguage | Variable global para almacenar el idioma del usuario. |
| gblThemeDark | Variable global para almacenar si Teams se ejecuta en modo oscuro. |
| gblThemeHiCo | Variable global para almacenar si Teams se ejecuta en modo de contraste. |
| gblMobileWidth | Variable global para definir el ancho de la aplicación para móviles. |
| gblMobileMode | Variable global para almacenar si se accede a la aplicación desde un dispositivo móvil. |
| gblAppSetting_inputMobileOnWeb | Variable global para escalar fuentes para aplicaciones orientadas a dispositivos móviles, que se ejecutan en el escritorio. |
| gblAppSetting_inputMobile | Variable global para escalar fuentes para aplicaciones orientadas a dispositivos móviles. |
| gblAppSetting_inputScaleFontsBy | Variable global para escalar todas las fuentes en una cantidad fija. |
| gblAppContext | Variable global para comprobar el contexto de dónde se ejecuta la aplicación. |
| gblFirstRun | Variable global para comprobar si la aplicación se está ejecutando por primera vez. |
| gblRecordUserSettings | Variable global para almacenar los últimos registros de configuración de usuario de proyecto para el usuario actual. |
Detalles de ejecución OnStart
Cuando un usuario accede a la aplicación, gblAppLoaded se establece en falso. El código de idioma del usuario se almacena en gblUserLanguage, con Inglés - EE. UU. siendo el valor predeterminado.
Luego, el idioma del usuario se usa para recopilar el texto localizado que se usa en toda la aplicación (por ejemplo, el texto de la etiqueta y el botón) en colLocalization.
El tema/modo de Microsoft Teams del usuario se comprueba para ver si el tema es predeterminado, oscuro o de alto contraste. Las variables gblThemeDark y gblThemeHiCo se establecen en consecuencia.
Las imágenes de archivo y los colores de portada se recopilan en colStockImages y colProjectCoverColors respectivamente. colProjectCoverColors tiene dos conjuntos de 14 colores. Para cada base, hay dos colores. Uno es para el tema predeterminado y el otro es para el tema oscuro. Por ejemplo, #F4B9B9 es el modo predeterminado equivalente a #791818.
Los detalles de usuario de proyecto de la tabla Configuración de usuario se recopilan en colUserSettings. Si no existe ningún registro, se crea un nuevo registro de configuración de usuario del proyecto y la variable gblFirstRun se establece en true. Esto, a su vez, controla la visibilidad del cuadro de diálogo de bienvenida. Si existen varios registros de configuración de usuario del proyecto, se selecciona el registro más antiguo y se almacena en la variable gblRecordUserSettings.
Pantalla de carga
Esta sección explica las colecciones, las variables y los detalles de ejecución de la pantalla de carga de la aplicación.
Navegar a la pantalla de proyectos
Variables implicadas
Las variables siguientes se utilizan cuando la pantalla de carga navega a la pantalla de proyectos:
| Nombre de variable | Descripción |
|---|---|
| gblAppLoaded | Variable global para comprobar si la aplicación se ha cargado por completo. |
| gblAppStyles | Variable global para almacenar propiedades de estilo para todos los controles (configurada en OnVisible de la pantalla de carga). |
| gblAppContext | Variable global para comprobar el contexto de dónde se ejecuta la aplicación. |
| gblFirstRun | Variable global para comprobar si la aplicación se está ejecutando por primera vez. |
| gblRecordUserSettings | Variable global para almacenar los últimos registros de configuración de usuario de proyecto para el usuario actual. |
| locShowFirstRun | Variable local para indicar si la ejecución actual de la aplicación es la primera ejecución para el usuario. |
| locShowPowerAppsPrompt | Variable local para indicar si el usuario ha establecido la preferencia para ver a Power Apps preguntar sí o no. |
Detalles de ejecución de navegación de la pantalla de proyecto
Si gblAppLoaded es verdadero (lo que significa que el OnStart de la aplicación se ha completado), gblAppStyles no está en blanco (lo que significa que se ha cargado la variable de estilo) y gblAppContext es verdadero (lo que significa que se accede a la aplicación desde Teams), entonces se lleva al usuario a:
Pantalla de proyectos móviles (dispositivo que se utiliza para acceder a la aplicación) es un Android o iOS.
Pantalla de proyectos si el hostClientType no es Android de iOS. Se pasan dos variables mientras se navega a la pantalla de proyectos:
locShowFirstRun: si la ejecución actual es la primera ejecución de la aplicación como lo indica gblFirstRun, esto se establece en verdadero, si no, entonces falso.
locShowPowerAppsPrompt: si el registro de configuración de usuario del proyecto más reciente para el usuario actual (almacenado en gblRecordUserSettings) tiene un valor de Sí para 'Display Splash (Power Apps) ', entonces esto se establece en verdadero, si no, entonces falso.
Si gblAppContext es falso, entonces se lleva al usuario a la pantalla de contexto incorrecta.
Experiencia de primera ejecución
Esta sección explica la experiencia de primera ejecución de la aplicación, colecciones relevantes, variables y detalles de ejecución.
Variables de experiencia de primera ejecución
Las siguientes variables se usan para controlar la primera experiencia de ejecución
| Nombre de variable | Descripción |
|---|---|
| locShowFirstRun | Variable local para indicar si la ejecución actual de la aplicación es la primera ejecución para el usuario. |
| locShowPowerAppsPrompt | Variable local para indicar mostrar u ocultar la pantalla de bienvenida. |
Detalles de ejecución de la experirencia de primera ejecución
Cuando locShowFirstRun o locShowPowerAppsPrompt es true, el contenedor conDialogWelcome se hace visible.
Si locShowFirstRun es true, el contenedor conDialogFirstRun se hace visible y proporciona información general de la aplicación.
Al seleccionar Continue, se establece locShowFirstRun en false, que oculta el contenedor conDialogFirstRun. Si locShowPowerAppsPrompt es true, el contenedor conDialogSplash_PowerApps se hace visible, mostrando la pantalla de presentación.
Al activar No mostrar de nuevo y, a continuación, seleccionar Entendido, se actualiza la columna Mostrar presentación (PowerApps) del registro Configuración de usuario del proyecto para el usuario actual en No, que establece locShowPowerAppsPrompt en false en las ejecuciones posteriores y oculta la pantalla de presentación. Además, locShowPowerAppsPrompt y locShowFirstRun se establecen en false para que el usuario pueda continuar con la aplicación.
Al seleccionar Entendido sin marcar la casilla No mostrar de nuevo simplemente se establece locShowPowerAppsPrompt y locShowFirstRun en false para que el usuario pueda continuar con la aplicación. En las ejecuciones posteriores, la pantalla de presentación se muestra a los usuarios hasta que marcan la casilla no volver a mostrar.
La galería Todos los proyectos y los elementos de trabajo estarán visibles una vez que el usuario seleccione continuar.
Pantalla del proyecto
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan en la pantalla del proyecto.
Visualización de variables de proyectos
Las siguientes variables se utilizan cuando un usuario ve proyectos en Hitos.
| Nombre de variable | Descripción |
|---|---|
| locAddProject | Variable local para controlar la visibilidad del contenedor conAddProject. |
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locProjectSortOrder | Variable local para controlar el orden de clasificaicón de la lista de proyectos. |
| locExpandProjectList | Variable local utilizada para controlar la visibilidad de la lista Project (expandir y contraer). |
Visualización de los detalles de ejecución de proyectos
Los proyectos se muestran en varias pantallas de la aplicación en varios contenedores como se menciona a continuación:
conProjectList en la pantalla proyectos
conProjectList_About en la pantalla Acerca de
conProjectList_Settings en la pantalla configuración
Las galerías que enumeran los proyectos de la tabla Proyectos son:
galProjects en la pantalla proyectos
galProjects_About en la pantalla Acerca de
galProjects_Settings en la pantalla configuración
Seleccionar un proyecto establece la variable gblProject en el proyecto seleccionado y también recopila los elementos de trabajo del proyecto seleccionado en la colección colWorkItems.
Seleccione el botón + Nuevo proyecto en cualquiera de las pantallas mencionadas anteriormente actualiza la variable locAddProject a true y la variable locShowProjectTeamAssignment (para obtener información sobre cómo se usa esta variable, vaya a crear una nueva sección de proyecto) a false, mostrando así la pantalla de creación del nuevo proyecto.
El cuadro de texto Buscar proyectos se utiliza para buscar proyectos que contengan el texto escrito en su nombre.
Seleccionar el icono de ordenación actualiza locProjectSortOrder, que se utiliza para ordenar la lista de proyectos en función del nombre del proyecto. Seleccionar el icono cambia el criterio de ordenación de ascendente a descendente y viceversa.
Seleccionar el icono de menú actualiza la variable locExpandProjectList, alternando su valor de true a false y viceversa. Esto, a su vez, se expande y contrae la sección de la lista de proyectos.
Visualización y actualización de la portada del proyecto
Esta sección explica las las variables y los detalles de ejecución que se utilizan al ver o actualizar la imagen de portada de un proeycto.
Variables de actualización de la portada del proyecto
Las siguientes variables se utilizan cuando un usuario ve o actualiza la imagen de portada del proyecto.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locVisibleCoverSelection | Variable local para controlar la visibilidad del contenedor de coberturas de proyecto. |
| locCoverImageSelected | Variable local para comprobar si se ha seleccionado una imagen de portada. |
| locCoverColorSelected | Variable local para comprobar si se ha seleccionado un color de portada. |
| locCoverChanged | Variable local para comprobar si ha cambiado una portada de proyecto. |
| locCustomImageSelected | Variable local para comprobar si se ha cargado para la portada del proyecto una imagen personalizada. |
Detalles de ejecución de la actualización de la portada del proyecto
La portada del proyecto forma parte del contenedor conProjectHeader, que muestra el nombre de los proyectos seleccionados, la imagen de portada (si existe) y el color de portada (si no hay ninguna imagen de portada) que se obtiene mediante la variable gblProject.
Al seleccionar la galería galProjectColors, presenta al usuario una lista de colores basada en el tema de Microsoft Teams. Esto se logra filtrando la colección colProjectCoverColors en función del tema Teams.
Si el proyecto seleccionado tiene un color definido, ese color se denota con una marca de graduación (imgColorSelected). La visibilidad de este icono se establece en ThisItem.IsSelected. Debido a la propiedad Default de galProjectColors (descrita a continuación), el color de portada de los proyectos seleccionados está seleccionado de forma predeterminada.
La propiedad predeterminada de la galería galProjectColors se utiliza para seleccionar el color de portada de gblProject. Se configura como indicamos a continuación:
Si el tema Equipos es oscuro, se busca Color de portada oscuro de gblProject. Si esto está en blanco, significa que no hay color de portada del proyecto.
Si el tema Equipos no es oscuro, se busca Color de portada oscuro de gblProject. Si esto está en blanco, significa que no hay color de portada del proyecto.
Al seleccionar un color, establece locCoverImageSelected en false, locCoverColorSelected en true y locCoverChanged en true.
La galería galProjectCovers muestra una lista de imágenes de portada de proyecto de stock. También permite a los usuarios cargar una imagen personalizada mediante un control agregar imagen (addProjectCoverImage).
Al seleccionar una imagen personalizada, se establece locCoverChanged en true y locCustomImageSelected en true.
Al seleccionar una imagen de stock, establece locCoverImageSelected en true, locCoverColorSelected en true, locCoverChanged en true y locCustomImageSelected en true.
Si el proyecto seleccionado tiene una de las imágenes de archivo como portada, esa imagen de archivo se resalta estableciendo el color de relleno de btnProjectCoverBackground.
Seleccione Listo actualiza la portada del proyecto de la siguiente manera:
Si locCoverImageSelected es true y locCustomImageSelected también es true, significa que el usuario seleccionó una imagen personalizada. Por lo tanto, la foto de portada se actualiza con la imagen cargada y el icono de portada, el color de portada, el color de portada oscuro están todos en blanco.
Si locCoverImageSelected es true y locCustomImageSelected es false, significa que el usuario seleccionó una imagen de stock personalizada. Por lo tanto, el icono de portada se actualiza con la imagen de stock y la foto de portada, el color de portada, el color de portada oscuro están todos en blanco.
Si locCoverColorSelected es true, significa que el usuario seleccionó un color de portada. Por lo tanto, la foto de portada y el icono de portada se establecen en blanco. El color de la cubierta y el color oscuro de la cubierta se actualizan según la siguiente lógica:
Si el tema de Teams actual es oscuro, el color seleccionado de galProjectColors se establece como Color de portada oscuro. Si el tema de los equipos actual no es oscuro, el color seleccionado de galProjectColors se utiliza para buscar el color de modo oscuro correspondiente en colProjectCoverColors y este color, a continuación, se establece como color de portada oscuro. Esto se debe a que si el tema de los equipos no es oscuro, galProjectColors se rellena con colores de tema predeterminados.
Si el tema de Teams actual no es oscuro, el color seleccionado de galProjectColors se establece como Color de portada. Si el tema de los equipos actual es oscuro, el color seleccionado de galProjectColors se utiliza para buscar el color de modo predeterminado correspondiente en colProjectCoverColors y este color, a continuación, se establece como color de portada. Esto se debe a que si el tema de los equipos es oscuro, galProjectColors se rellena con colores de tema oscuro.
Visualización del estado del hito/equipo
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al ver datos de hitos y estado
Colecciones de visualización de hitos
La siguiente colección se utiliza al visualizar hitos.
| Nombre de colección | Descripción |
|---|---|
| colWorkItemStatuses | - colección de estados de elementos de trabajo. |
Variables para mostrar hitos
Las siguientes variables se utilizan al visualizar hitos.
| Nombre de variable | Descripción |
|---|---|
| locShowProjectStatusOptions | Se usa para controlar la visibilidad de la galería de opciones Estado del proyecto. |
| locProjectStatusSelection | Variable local para comprobar qué selección ha realizado el usuario. |
| locCompletionStatus | Variable local para almacenar el estado correspondiente a la finalización del elemento de trabajo. |
Detalles de ejecución de visualización de hitos
Hay cuatro opciones de estado de proyecto disponibles:
Estado del equipo que muestra la lista de miembros del equipo junto con el número de elementos de trabajo que se les asignan en función de sus estados.
Estado de hitos que muestra la lista de hitos del equipo junto con el número de elementos de trabajo relacionados con ellos en función de sus estados.
La propiedad items de la galería galMilestones se establece en los hitos del proyecto seleccionado gblProject.
Hay 13 imágenes en la aplicación que se usan para denotar diferentes porcentajes de finalización de hitos (0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 95, 99, 100). La imagen adecuada se muestra en función del porcentaje de finalización calculado dividiendo el número de elementos de trabajo para el hito en el estado Listo (que es el primer estado de colWorkItemStatuses, almacenado en locCompletionStatus en la pantalla OnVisible de proyectos) por el número total de elementos de trabajo para ese hito.
Las cuatro etiquetas bajo el nombre del hito muestran el recuento de elementos de trabajo en los primeros cuatro estados de colWorkItemStatuses.
La propiedad de elementos de la galería galTeamMembers se establece en los miembros del equipo del proyecto seleccionado gblProject.
La foto de usuario de cada miembro del equipo se muestra mediante la función Office365Users.UserPhotoV2. Si no hay ninguna foto, se muestra un icono de persona de forma predeterminada.
El botón de flecha abajo situado junto a la etiqueta de la opción se utiliza para alternar entre las opciones Estado del equipo y Estado del hito. Seleccione la flecha actualiza el valor de la variable locShowProjectStatusOptions, alternando el valor de true a false y viceversa controlando la visibilidad de la galería galProjectStatusOptions.
Mostrar la lista de elementos de trabajo
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan para ver elementos de trabajo.
Colecciones de presentación de elementos de trabajo
Las siguientes colecciones se utilizan al ver elementos de trabajo.
| Nombre de colección | Descripción |
|---|---|
| colWorkItems | Colección de todos los elementos de trabajo para el proyecto seleccionado. |
| colCharsWidth | Colección de anchos para cada carácter utilizado para etiquetas de ancho automático. |
Variables de presentación de elementos de trabajo
Las siguientes variables se utilizan al visualizar elementos de trabjao.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locSortWorkItemBy | Variable local para definir la ordenación por columna. |
| locWorkItemSortOrder | Variable local para definir la ordenación. |
| locShowSearchWorkItem | Variable local para controlar la visibilidad del cuadro de búsqueda de elementos de trabajo. |
| locFilterWorkItems | Variable local para controlar la visibilidad del cuadro de diálogo de filtro de elementos de trabajo. |
| locApplyFilter | Variable local para controlar si los filtros seleccionados se deben aplicar a los elementos de trabajo. |
| locBackNavigation | Variable local para capturar si la navegación a la pantalla de proyectos es volviendo de la pantalla Acerca de o la pantalla de configuración. |
Detalles de ejecución de visualización de elementos de trabjao
Seleccionar un proyecto en la galería de proyectos da como resultado dos cosas (estas se definen en OnSelect de galProjects):
En primer lugar, el proyecto seleccionado se almacena en gblProject.
En segundo lugar, todos los elementos de trabajo del proyecto que buscan este proyecto se agregan a una colección colWorkItems.
Los pasos anteriores también se producen en el OnVisible de la pantalla de proyecto para que la lista de elementos de trabajo para el primer proyecto en galProjects se muestra sin necesidad de seleccionar en el proyecto cuando un usuario se navega a la pantalla de proyectos por primera vez. La carga de elementos de trabajo no se produce en la navegación posterior a la pantalla proyectos volviendo de la pantalla Acerca de o la pantalla Configuración. Esto lo controla locBackNavigation.
La ordenación predeterminada por columna (locSortWorkItemBy) se establece en eta (Target) y el criterio de ordenación predeterminado (locWorkItemSortOrder) se establece en true (es decir, ascendente). Se establecen en la propiedad OnVisible de la pantalla de proyectos.
Hay 7 botones que son encabezados para la galería de elementos de trabajo (galWorkItems): elemento de trabajo, hito, categoría, prioridad, asignado a, destino y estado. Seleccione cualquiera de estas actualizaciones la variable locSortWorkItemBy para definir la ordenación adecuada por columna y también cambia el criterio de ordenación de ascendente a descendente o viceversa actualizando locWorkItemSortOrder.
El criterio de ordenación se indica mediante una imagen de flecha abajo (imgSortWorkItem). En función de la ordenación por columna, su posición X cambia. Esto evita el uso de una imagen por encabezado. Según el criterio de ordenación, cambia su propiedad ImageRotation. Esto evita el uso de una imagen para el orden ascendente y otra para el orden descendente.
Los encabezados y sus etiquetas asociadas dentro de la galería de elementos de trabajo tienen su visibilidad basada en el ancho del contenedor. Por ejemplo, la visibilidad del encabezado de estado (btnStatusSort) es (Projects Screen.Size = ScreenSize.ExtraLarge || Projects Screen.Size = ScreenSize.Large) && Self.Width > 75
Las etiquetas de hito, categoría, prioridad y estado dentro de la galería de elementos de trabajo tienen su ancho establecido en una fórmula que permite que el ancho de estas etiquetas cambie en función de su texto respectivo.
imgWorkItemAssignedTo muestra la imagen del miembro del equipo al que se asigna un elemento de trabajo e imgWorkItemAssignedToDefault muestra la imagen predeterminada si el miembro del equipo al que se asigna un elemento de trabajo no tiene una imagen
Seleccione el icono de búsqueda establece locShowSearchWorkItem en true. Esto hace que el cuadro de búsqueda y un icono X sean visibles. Al escribir en el cuadro de búsqueda, se realiza una búsqueda en colWorkItems mediante el campo Nombre. Seleccione el icono X establece locShowSearchWorkItem en false y oculta el cuadro de búsqueda.
Seleccione el icono de filtro establece locFilterWorkItems en true para mostrar el cuadro de diálogo de filtro y establece locApplyFilter para filtrar para no aplicar filtros hasta que el usuario haya confirmado.
conFilterWorkItems es el contenedor que tiene todos los controles utilizados para filtrar la galería de elementos de trabajo. Hay cinco cuadros combinados, uno para cada uno de los hitos, categorías, prioridades, miembros del equipo y estados. Todos ellos son de selección múltiple. Una vez seleccionados los valores, al seleccionar Aplicar se establece locApplyFilter en true, que a su vez filtra la galería de elementos de trabajo.
Eliminar elementos de trabajo
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al eliminar órdenes de trabajo.
Colecciones de eliminación de elementos de trabajo
Las siguientes colecciones se utilizan al eliminar elementos de trabajo.
| Nombre de colección | Descripción |
|---|---|
| colWorkItems | Colección de todos los elementos de trabajo para el proyecto seleccionado. |
| colRemoveWorkItems | Colección de elementos de trabajo que se van a eliminar. |
Variables de elliminación de elementos de trabajo
Las siguientes variables se utilizan al eliminar variables.
| Nombre de variable | Descripción |
|---|---|
| locDeleteWorkItems | Variable local para controlar la visibilidad del cuadro de diálogo de eliminación de elementos de trabajo. |
| locResetWorkItemCheckbox | Variable local para restablecer casilla de verificación para seleccionar un elemento de trabajo para su eliminación. |
Eliminación de detalles de ejecución de elementos de trabajo
Active la casilla de verificación en el encabezado de la galería de elementos de trabajo, activa la casilla de verificación de todos los elementos de trabajo de la galería. Esto se controla estableciendo el valor predeterminado de la casilla de verificación dentro de la galería en chkSelectAllWorkItems.Value.
La propiedad Reset de la casilla de verificación de la galería se establece en locResetWorkItemCheckbox. Esta variable se utiliza para desactivar la casilla de verificación cuando el usuario decide cancelar la eliminación o cuando el usuario selecciona un proyecto de la galería de proyectos.
El icono de eliminación permanece deshabilitado hasta que se selecciona al menos un elemento de trabajo. Una vez habilitado, al seleccionar el icono de eliminación se establece locDeleteWorkItems en true, que hace visible el cuadro de diálogo eliminar elemento de trabajo.
En el cuadro de diálogo eliminar, si selecciona la casilla de verificación Entiendo, habilita el botón Eliminar. El botón Eliminar recopila primero todos los elementos de la galería que tienen activada la casilla de verificación en una colección colRemoveWorkItems. A continuación, colRemoveWorkItems se utiliza para eliminar todos los elementos de trabajo seleccionados. Y, por último, colWorkItems se rellena de nuevo con la lista de elementos de trabajo relacionados con el proyecto seleccionado (gblProject).
Editar un elemento de trabajo
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan para editar elementos de trabajo.
Colecciones de edición de elemento de trabajo
Las siguientes colecciones se utilizan al editar elementos de trabajo.
| Nombre de colección | Descripción |
|---|---|
| colWorkItems | Colección de todos los elementos de trabajo para el proyecto seleccionado. |
| colWorkItemStatuses | Colección de estados de elementos de trabajo. |
Variables de edición de elementos de trabajo
Las siguientes variables se utilizan al editar elementos de trabjao.
| Nombre de variable | Descripción |
|---|---|
| locEditWorkItem | Variable local para controlar la visibilidad del contenedor conEditWorkItem. |
| locSelectedWorkItem | Variable local para almacenar el elemento de trabajo seleccionado. |
| locNewWorkItem | Variable local que denota el elemento de trabajo que se actualizó. |
Detalles de ejecución de edición de elementos de trabjao
Al seleccionar un elemento de trabajo en la galería de elementeos de trabajo (galWorkItems) se muestra el contenedor conEditWorkItem, cuya propiedad visible se controla mediante la variable locEditWorkItem.
Seleccione el botón Listo para actualizar los detalles del elemento de trabajo seleccionado locSelectedWorkItem. El elemento de trabajo actualizado se almacena en locNewWorkItem. Los elementos de trabajo para gblProject se recopilan de nuevo en colWorkItems.
Cuando se actualizan uno o más campos de elemento de trabajo, se crea un registro en la tabla Actividades del proyecto para registrar cuál fue la actualización.
Crear un nuevo proyecto
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al crear un nuevo proyecto.
Colecciones de creación de proyectos
Las siguientes colecciones se utilizan al crear un proyecto.
| Nombre de colección | Descripción |
|---|---|
| colNewProjectMilestones | Colección de hitos para un nuevo proyecto. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
| colNewProjectTeamMembers | Colección de miembros del equipo para el proyecto que se va a crear |
Variables de creación del proyecto
Las siguientes variables se utilizan al crear un proyecto.
| Nombre de variable | Descripción |
|---|---|
| locAddProject | - Variable local para controlar la visibilidad del contenedor conAddProject. |
| locMilestoneColorPicker | - Variable local para controlar la visibilidad de galMilestoneColorPicker. |
| locShowProjectTeamAssignment | - Variable local para controlar la visibilidad de los controladores de asignación del equipo del proyecto (visible después de Seleccionar siguiente). |
| locShowUsersGallery | - Variable local para controlar la visibilidad de la galería del usuario galAddTeamMembers. |
| galAddTeamMembers | - Variable local para almacenar la el nombre de usuario seleccionado. |
| locNewProject | - Variable local para almacenar el proyecto recién creado. |
Detalles de ejecución de creación de proyecto
Se puede crear un nuevo proyecto seleccionando el botón + Nuevo proyecto en el contenedor conProjectList.
Seleccione el botón + Nuevo proyecto para establecer locAddProject en true, mostrando así el contenedor conAddProject. También agrega 3 hitos de forma predeterminada a colNewProjectMilestones y agrega el usuario actual como miembro del equipo a colNewProjectTeamMembers.
La galería galAddMilestones muestra la lista de hitos mediante colNewProjectMilestones.
Seleccione el botón de color (btnMilestoneColor) para establecer locMilestoneColorPicker en true, mostrando así la galería galMilestoneColorPicker que tiene una lista de colores de portada (colProjectCoverColors).
Seleccione el color deseado actualiza el color del hito y establece el valor de locMilestoneColorPicker en false.
Seleccione el botón cerrar establece locMilestoneColorPicker en false, ocultando así la galería galMilestoneColorPicker.
Seleccione el icono de la papelera a continuación elimina el hito de colNewProjectMilestones.
Select + Agregar un hito para crear un nuevo hito y agregarlo a colNewProjectMilestones junto con el restablecimiento de la galería galAddMilestones. El control se restablece para que la galería se desplace hacia abajo hasta el hito recién agregado (la propiedad Default de galAddMilestones ayuda a lograr este comportamiento).
Seleccione el botón cerrar establece locShowProjectTeamAssignment y locAddProject en false, por lo tanto, oculta el contenedor conAddProject.
Una vez rellenados los detalles necesarios, el botón Seleccionar siguiente establece locShowProjectTeamAssignment en true y locAddProject en false, mostrando así la sección de asignación de miembros del equipo.
El cuadro de búsqueda se puede usar para buscar miembros del equipo. Tan pronto como una entrada que proporcionó, el valor de locShowUsersGallery se establece en false, ocultando así la galería de usuarios y mostrando los resultados basados en la entrada proporcionada.
Al seleccionar un nuevo usuario, se actualiza locUserPrincipalName y se agrega el usuario seleccionado a colNewProjectTeamMembers.
Seleccione el icono de eliminación quita el usuario de colNewProjectTeamMembers.
Seleccione el botón Atrás establece locShowProjectTeamAssignment en false, ocultando así los campos de asignación de usuario.
Seleccione el botón crear establece locShowProjectTeamAssignment en true y locAddProject en false. También crea un nuevo registro de proyecto y los registros asociados de hito del proyecto y miembro del equipo del proyecto.
Crear un nuevo elemento de trabajo
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al crear un nuevo elemento de trabajo.
Colecciones de creación de elementos de trabajo
Las siguientes colecciones se utilizan al crear elementos de trabajo.
| Nombre de colección | Descripción |
|---|---|
| colWorkItems | Colección de todos los elementos de trabajo para el proyecto seleccionado. |
Variables de creación de elementos de trabajo
Las siguientes variables se utilizan al crear elementos de trabjao.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locAddWorkItem | Variable local para controlar la visibilidad del contenedor conAddProject. |
| locNewWorkItem | Variable local para almacenar el elemento de trabajo recién creado. |
Detalles de ejecución de creación de elementos de trabjao
Seleccione el botón + Nuevo elemento de trabajo para establecer locAddWorkItem en true, que muestra el contenedor conAddWorkItem.
Una vez ingresados todos los detalles, seleccione el botón Crear para crear un nuevo elemento de trabajo y establecer locAddWorkItem en falso, ocultando así el contenedor conAddWorkItem.
El elemento de trabajo recién creado se almacena en locNewWorkItem y se agrega a colWorkItems.
También se crea automáticamente una nueva actualización para registrar la creación del elemento de trabajo.
Pantalla Acerca de
Esta sección explica las colecciones y los detalles de ejecución usados por procesos en la pantalla acerca de
Pasos detallados
Al seleccionar el botón Atrás en el contenedor conNavigtion_About navega de regreso a la pantalla del proyecto.
Seleccionando Personalizar usando el botón Power Apps en el contenedor conHeader_About se abre el vínculo de la herramienta de Power Apps en Microsoft Teams.
Hay vínculos de ayuda disponibles en la galería galAbout_HelpLinks.
Seleccione el botón Aprender cómo personalizar esta aplicación para navegar a un enlace externo que explica cómo realizar personalizaciones en la aplicación.
Seleccione el botón Envíenos sus ideas para navegar a un enlace externo donde se pueden publicar ideas para la aplicación Milestones.
Seleccione el botón Interactuar con la comunidad para navegar a la comunidad de Power Apps.
El contenedor conAbout_AppVideo contiene el enlace de video que proporciona una descripción general de la aplicación Hitos.
La galería galAbout_OtherApps contiene los vínculos a otras aplicaciones de Microsoft.
Seleccione el botón Ver aplicación para navegar a la página de la aplicación en la tienda de aplicaciones de Microsoft Teams.
Seleccione el botón Descripción general de la aplicación para navegar al vídeo de descripción general de la aplicación en YouTube.
conAbout_Version proporciona información sobre el control de versiones de la aplicación.
Pantalla de configuración del proyecto
Esta sección explica las colecciones, las variables y los detalles de ejecución usados por procesos en la pantalla de configuración.
Visualización de la lista de hitos de un proyecto
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al ver hitos.
Colecciones de visualización de hitos
Las siguientes colecciones se utilizan al mostrar hitos en la pantalla de configuración.
| Nombre de colección | Descripción |
|---|---|
| colProjectMilestones | Colección de todos los hitos para el proyecto seleccionado. |
Variables para mostrar hitos
Las siguientes variables se utilizan al mostrar hitos en la pantalla de configuración.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locDefaultProjectMilestone | Variable local para almacenar el hito predeterminado utilizado para restablecer la galería de hitos. |
Detalles de ejecución de visualización de hitos
Hitos del proyecto seleccionado (gblProject) en la pantalla de proyectos se agregan a colProjectHitos en OnVisible de la pantalla de configuración.
El primer hito de colProjectHitos se almacena en locDefaultProjectMilestone, por lo que es el hito que se selecciona de forma predeterminada.
Seleccione cualquier otro proyecto en galProjects_Settings para almacenar el proyecto seleccionado en gblProject. Luego, todos los hitos que miran a este proyecto se agregan a colProjectHitos.
Editar hitos
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al editar hitos.
Colecciones de edición de hitos
Las siguientes colecciones se utilizan al editar hitos en la pantalla de configuración.
| Nombre de colección | Descripción |
|---|---|
| colProjectMilestones | Colección de todos los hitos para el proyecto seleccionado. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
Variables de edición de hitos
Las siguientes variables se utilizan al editar hitos en la pantalla de configuración.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locEditMilestoneColorPicker | Variable local para controlar la visibilidad del selector de colores. |
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
Detalles de ejecución de edición de hitos
Al seleccionar el color, se establece locEditMilestoneColorPicker en true para mostrar la galería del selector de color galEditProjectMilestoneColorPicker.
La propiedad predeterminada galEditProjectMilestoneColorPicker se establece en el color del hito según el tema actual de Teams. Esto hace que el icono de la marca de verificación sea visible en el color del hito actual, ya que su visibilidad se establece en ThisItem.IsSelected.
Al seleccionar galEditProjectMilestoneColorPicker se establece locEditMilestoneColorPicker en falso y locSettingsChanged en verdadero.
Seleccione el botón Guardar para guardar todos los cambios en la pantalla de configuración. Específicamente, para los hitos, los hitos existentes se filtran en función de la condición de que su campo de ID no esté en blanco (lo que significa que son registros existentes en la tabla Hitos del proyecto) y se actualizan mediante una declaración de parche.
La actualización de los colores de los hitos se realiza de la siguiente manera:
Si el tema actual de Teams es oscuro, los colores del modo oscuro se presentan al usuario. Entonces, la columna Color se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo predeterminado equivalente al color seleccionado por el usuario. La columna Color oscuro se actualiza con el color seleccionado por el usuario.
Si el tema actual de Teams es el predeterminado, los colores del modo perdeterminado se presentan al usuario. Así, la columna Color oscuro se actualiza con el color seleccionado por el usuario. La columna Color oscuro se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo oscuro equivalente al color seleccionado por el usuario.
Agregar hitos
Esta sección detalla las colecciones, las variables y los detalles de ejecución que se utilizan al agregar hitos.
Colecciones de creación de hitos
Las siguientes colecciones se utilizan al agregar un hito en la pantalla de configuración.
| Nombre de colección | Descripción |
|---|---|
| colProjectMilestones | Colección de todos los hitos para el proyecto seleccionado. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
Variables de creación de hitos
Las siguientes variables se utilizan al agregar un hito en la pantalla de configuración.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locDefaultProjectMilestone | Variable local para almacenar el hito predeterminado utilizado para restablecer la galería de hitos. |
Detalles de ejecución de creación de hitos
Seleccione el botón + Nuevo hito para agregar un nuevo hito a colProjectHitos. También actualiza locDefaultProjectMilestone con este nuevo hito. La función Reiniciar luego se llama en galEditMilestones para desplazarse hasta el hito agregado más recientemente.
Seleccione el botón Guardar para guardar todos los cambios en la pantalla de configuración. Específicamente, para los hitos, nuevos hitos se filtran en función de la condición de que su campo de ID no esté en blanco (lo que significa que no existen en la tabla Hitos del proyecto) y se crean mediante una declaración de parche.
Los colores para los nuevos hitos se establecen de la siguiente manera:
Si el tema actual de Microsoft Teams es oscuro, los colores del modo oscuro se presentan al usuario. Entonces, la columna Color se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo predeterminado equivalente al color seleccionado por el usuario. La columna Color oscuro se actualiza con el color seleccionado por el usuario.
Si el tema actual de Microsoft Teams es el predeterminado, los colores del modo perdeterminado se presentan al usuario. Así, la columna Color oscuro se actualiza con el color seleccionado por el usuario. La columna Color oscuro se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo oscuro equivalente al color seleccionado por el usuario.
Eliminar hitos
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al eliminar hitos.
Eliminar colecciones de hitos
Las siguientes colecciones se utilizan al eliminar hitos.
| Nombre de colección | Descripción |
|---|---|
| colProjectMilestones | Colección de todos los hitos para el proyecto seleccionado. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
| colRemovedMiletones | Recopilación de un hito al seleccionar el icono de eliminación con respecto a un hito. |
Eliminando variables de hitos
Las siguientes variables se utilizan al eliminar hitos.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locDeleteSettings | Variable local para controlar la visibilidad del cuadro de diálogo de eliminación de hitos. |
| locSettingType | Variable local para definir el tipo de configuración. |
Detalles de ejecución de eliminación de hitos
Seleccione el icono Eliminar para establecer locDeleteSettings en verdadero, lo que hace que el cuadro de diálogo de eliminación de hitos sea visible y agrega el hito que debe eliminarse para colRemovedMiletones.
En el cuadro de diálogo eliminar, si selecciona la casilla de verificación Entiendo, habilita el botón Eliminar. El botón eliminar elimina el hito seleccionado de colProjectMilestones y elimina el hito seleccionado de la tabla Proyecto Hitos tabla si el hito seleccionado tiene un ID (lo que significa que es un registro existente en la tabla Hitos del proyecto).
Administrar miembros del equipo
Esta sección explica las colecciones, las variables y los detalles de ejecución cuando se agrega, edita o quita un miembro del equipo.
Administrar colecciones miembros de equipo
Las siguientes colecciones se utilizan cuando se agrega, edita o elimina un miembro del equipo.
| Nombre de colección | Descripción |
|---|---|
| colWorkItems | Colección de todos los elementos de trabajo para el proyecto seleccionado. |
Administrar variables de miembros de equipo
Las siguientes variables se utilizan cuando se agrega, edita o elimina un miembro del equipo.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locDeleteProject | Variable local para controlar la visibilidad de la pantalla de advertencia de eliminación. |
| locProjectToDelete | Variable local para almacenar el proyecto que se elimina. |
| locTempNewSelectedProject | Variable local para almacenar temporalmente el nuevo proyecto que se seleccionará una vez que se elimine el proyecto actual. |
Administrar detalles de ejecución de miembro de equipo
Seleccione el botón Eliminar proyecto para establecer locDeleteProject en true, mostrando así el contenedor conWarning_Project.
La casilla de verificación Entiendo, habilita el botón Eliminar.
Seleccionando Cancelar establece locDeleteProject en falso, cerrando así el diálogo de advertencia.
Seleccionando Borrar resulta en las siguientes acciones:
El proyecto que se va a eliminar se almacena primero en locProjectToDelete.
El primer proyecto de la lista de proyectos excluyendo el proyecto que se está eliminando se almacena en locTempNewSelectedProject, que a su vez se utiliza para actualizar gblProject.
Una vez que gblProject se actualiza, sus elementos de trabajo se recopilan en colWorkItems.
El proyecto almacenado en locProjectToDelete se utiliza para eliminar todos los registros relacionados, es decir, hitos, elementos de trabajo, actividades, miembros del equipo.
Una vez eliminados todos los registros relacionados, se elimina el propio proyecto.
Eliminando un proyecto
Esta sección explica la colección, las variables y los detalles de ejecución que se utilizan al eliminar un proyecto.
Colecciones de eliminación de proyectos
Las siguientes colecciones se utilizan al eliminar un proyecto.
| Nombre de colección | Descripción |
|---|---|
| colProjectTeamMembers | Colección de todos los miembros del equipo del proyecto. |
| colRemovedProjectTeamMembers | Colección de miembros del equipo que se van a quitar. |
Variables de eliminación del proyecto
Las siguientes variables se utilizan al eliminar un proyecto.
| Nombre de variable | Descripción |
|---|---|
| gblProject | Variable global para almacenar el proyecto seleccionado. |
| locShowProjectTeamAssignment | Variable local para controlar la visibilidad de los controladores de asignación del equipo del proyecto (visible después de seleccionar Siguiente). |
| locShowUsersGallery | Variable local para controlar la visibilidad de la galería del usuario galAddTeamMembers. |
| galAddTeamMembers | Variable local para almacenar la el nombre de usuario seleccionado. |
Detalles de ejecución de eliminación de proyecto
Los miembros del equipo del proyecto seleccionado (gblProject) en la pantalla de proyectos se agregan a colProjectTeamMembers en OnVisible de la pantalla de configuración.
Seleccione cualquier otro proyecto en galProjects_Settings para almacenar el proyecto seleccionado en gblProject. Luego, todos los hitos que miran a este proyecto se agregan a colProjectTeamMembers.
Al escribir un texto de búsqueda, locShowUsersGallery se establece en false y se oculta la galería de usuarios y se muestran los resultados en función de la entrada proporcionada.
Al seleccionar un usuario, se actualiza locUserPrincipalName y se agrega el usuario seleccionado a colProjectTeamMembers.
Al seleccionar el icono de eliminación, se agrega el miembro del equipo a colRemovedProjectTeamMembers si tienen un identificador (lo que significa que son registros existentes) y lo quita de colProjectTeamMembers.
Seleccione Guardar para quitar todos los registros que están en colRemovedProjectTeamMembers de la tabla Miembros del equipo del proyecto. Todos los registros de colProjectTeamMembers con un identificador en blanco se crean como nuevos registros en la tabla Miembros del equipo del proyecto y están relacionados con el proyecto seleccionado gblProject.
Pantalla de configuración
Esta sección explica las colecciones, las variables y los detalles de ejecución usados por los procesos en la pantalla de configuración
Visualización y edición de categorías
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al mostrar o editar una categoría.
Colecciones de edición de categoría
Las siguientes colecciones se utilizan al editar o ver una categoría.
| Nombre de colección | Descripción |
|---|---|
| colCategories | Colección de categorías. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
Variables de edición de categorías
Las siguientes variables se utilizan al editar o ver una categoría.
| Nombre de variable | Descripción |
|---|---|
| locCategoryColorPicker | Variable local utilizada para mostrar y ocultar el selector de color al editar el color. |
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
Detalles de ejecución de edición de categoría
Al seleccionar el color, locCategoryColorPicker se establece en true, mostrando la galería de selectores de color galCategoryColorPicker.
La propiedad predeterminada galCategoryColorPicker se establece en el color de la categoría según el tema actual de Teams. Esto hace que el icono de la marca de verificación sea visible en el color de la categoría actual, ya que su visibilidad se establece en ThisItem.IsSelected.
Al seleccionar galCategoryColorPicker se establece locCategoryColorPicker en falso y locSettingsChanged en verdadero.
Seleccione el botón Guardar para guardar todos los cambios en la pantalla de configuración. Específicamente, para las categorías, las categorías existentes se filtran en función de la condición de que su campo de ID no esté en blanco (lo que significa que son categorías existentes) y se actualizan mediante una declaración de parche.
La actualización de los colores de las categorías se realiza de la siguiente manera:
Si el tema actual de Teams es oscuro, los colores del modo oscuro se presentan al usuario. Entonces, la columna Color se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo predeterminado equivalente al color seleccionado por el usuario. La columna Color oscuro se actualiza con el color seleccionado por el usuario.
Si el tema actual de Teams es el predeterminado, los colores del modo perdeterminado se presentan al usuario. Así, la columna Color oscuro se actualiza con el color seleccionado por el usuario. La columna Color oscuro se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo oscuro equivalente al color seleccionado por el usuario.
Agregar categorías
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al agregar una categoría desde la pantalla de configuración.
Colecciones de creación de categorías
Las siguientes colecciones se utilizan al crear una categoría.
| Nombre de colección | Descripción |
|---|---|
| colCategories | Colección de categorías. |
Variables implicadas
Las siguientes variables se utilizan al crear una categoría.
| Nombre de variable | Descripción |
|---|---|
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
| locGlobalSetting | Variable local para almacenar la configuración global que se actualizó. |
| locGalleryDefaultCategory | Variable local utilizada para establecer el valor de categoría predeterminado en la galería galCategories. |
| galAddTeamMembers | Variable local para almacenar la el nombre de usuario seleccionado. |
| locCoverChanged | Variable local para comprobar si ha cambiado una portada de proyecto. |
| locCustomImageSelected | Variable local para comprobar si se ha cargado para la portada del proyecto una imagen personalizada. |
Detalles de ejecución de la creación de categorías
Seleccione Agregar agrega una nueva categoría a colCategories y actualiza locSettingsChanged a true, lo que indica que se ha realizado una actualización en la pantalla Configuración, habilitando así el botón Guardar.
La galería galCategories se restablece mediante la función Restablecer para desplazar la galería a la categoría recién agregada.
Seleccione el botón Guardar crea nuevos registros en la tabla Categorías de elementos de trabajo del proyecto para cada registro de colCategories con un identificador en blanco.
Eliminar categorías
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al eliminar una categoría desde la pantalla de configuración.
Colecciones de eliminación de categorías
Las siguientes colecciones se utilizan al eliminar una categoría.
| Nombre de colección | Descripción |
|---|---|
| colCategories | Colección de categorías. |
| colRemovedCategories | Colección de categorías que se van a quitar. |
Variables de eliminación de categorías
Las siguientes variables se utilizan al eliminar una categoría.
| Nombre de variable | Descripción |
|---|---|
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
| locDeleteSettings | Variable local para controlar la visibilidad de la pantalla de advertencia de eliminación. |
| locSettingType | Variable local para determinar qué registro se está eliminando. |
Detalles de ejecución de la eliminación de categorías
Seleccione el icono de eliminación agrega el registro de prioridad seleccionado a colRemovedCategories y actualiza locDeleteSettings a true, mostrando así el contenedor conWarning_Settings.
La casilla de verificación Entiendo, habilita el botón Eliminar.
Seleccionando Cancelar establece locDeleteSettings en falso, cerrando así el diálogo de advertencia.
Seleccionar Eliminar quita la categoría seleccionada de colCategories y de la tabla Categorías de elementos de trabajo del proyecto si tiene un identificador (lo que significa que es una categoría existente).
Visualización y edición de prioridades
Esta sección describe las colecciones, las variables y los detalles de ejecución que se utilizan al ver o editar una prioridad.
Colecciones prioritarias
Las siguientes colecciones se utilizan al editar o ver una prioridad.
| Nombre de colección | Descripción |
|---|---|
| colPriorities | Colección de prioridades. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
Variables de prioridad
Las siguientes variables se utilizan al editar o ver una prioridad.
| Nombre de variable | Descripción |
|---|---|
| locPriorityColorPicker | Variable local utilizada para mostrar y ocultar el selector de color al editar el color. |
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
Detalles de ejecución de prioridades
Al seleccionar el color, locPriorityColorPicker se establece en true, mostrando la galería de selectores de color galPriorityColorPicker.
La propiedad predeterminada galPriorityColorPicker se establece en el color de la prioridad según el tema actual de Teams. Esto hace que el icono de la marca de verificación sea visible en el color de la prioridad actual, ya que su visibilidad se establece en ThisItem.IsSelected.
Al seleccionar galPriorityColorPicker se establece locPriorityColorPicker en falso y locSettingsChanged en verdadero.
Seleccione el botón Guardar para guardar todos los cambios en la pantalla de configuración. Específicamente, para las prioridades, las prioridades existentes se filtran en función de la condición de que su campo de ID no esté en blanco (lo que significa que son prioridades existentes) y se actualizan mediante una declaración de parche.
La actualización de los colores de las prioridades se realiza de la siguiente manera:
Si el tema actual de Teams es oscuro, los colores del modo oscuro se presentan al usuario. Entonces, la columna Color se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo predeterminado equivalente al color seleccionado por el usuario. La columna Color oscuro se actualiza con el color seleccionado por el usuario.
Si el tema actual de Teams es el predeterminado, los colores del modo perdeterminado se presentan al usuario. Así, la columna Color oscuro se actualiza con el color seleccionado por el usuario. La columna Color oscuro se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo oscuro equivalente al color seleccionado por el usuario.
Agregar prioridades
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al agregar prioridades.
Agregar colecciones de prioridades
Las siguientes colecciones se utilizan al agregar prioridades.
| Nombre de colección | Descripción |
|---|---|
| colPriorities | Colección de prioridades. |
Adición de variables de prioridades
Las siguientes variables se utilizan al agregar prioridades.
| Nombre de variable | Descripción |
|---|---|
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
| locGlobalSetting | Variable local para almacenar la configuración global que se actualizó. |
| locGalleryDefaultPriority | Variable local utilizada para establecer el valor de prioridad predeterminado en la galería galPriorities. |
Agregar detalles de ejecución de prioridades
Al seleccionar Agregar agrega una nueva prioridad a colPriorities y actualiza locSettingsChanged a true, lo que indica que se ha realizado una actualización en la pantalla Configuración, habilitando así el botón Guardar.
La galería galPriorities se restablece mediante la función Restablecer para desplazar la galería a la prioridad recién agregada.
Al seleccionar el botón Guardar se crean nuevos registros en la tabla Prioridades de elementos de trabajo del proyecto para cada registro de colPriorities con un identificador en blanco.
Eliminación de prioridades
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al eliminar prioridades.
Colecciones de eliminación de prioridades
Las siguientes colecciones se utilizan al eliminar prioridades.
| Nombre de colección | Descripción |
|---|---|
| colPriorities | - colección de prioridades. |
| colRemovedPriorities | - colección de prioridades que se van a quitar. |
Variables de eliminación de prioridades
Las siguientes variables se utilizan al eliminar prioridades.
| Nombre de variable | Descripción |
|---|---|
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
| locDeleteSettings | Variable local para controlar la visibilidad de la pantalla de advertencia de eliminación. |
| locSettingType | Variable local para determinar qué registro se está eliminando. |
Detalles de ejecución de la eliminación de prioridades
Seleccionar el icono de eliminación agrega el registro de prioridad seleccionado a colRemovedPriorities y actualiza locDeleteSettings a true, mostrando así el contenedor conWarning_Settings.
La casilla de verificación Entiendo, habilita el botón Eliminar.
Seleccionando Cancelar establece locDeleteSettings en falso, cerrando así el diálogo de advertencia.
Seleccionar Eliminar quita la prioridad seleccionada de colPriorities y de la tabla Prioridades de elementos de trabajo del proyecto si tiene un identificador (lo que significa que es una prioridad existente).
Visualización y edición de estados
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al ver o editar los estados.
Visualización de estado y edición de colecciones
Las siguientes colecciones se utilizan al editar o ver estados.
| Nombre de colección | Descripción |
|---|---|
| colStatuses | Colección de estados. |
| colProjectCoverColors | Colección de colores de portada de proyecto. |
Visualización de estado y edición de variables
Las siguientes variables se utilizan al editar o ver estados.
| Nombre de variable | Descripción |
|---|---|
| locStatusColorPicker | Variable local utilizada para mostrar y ocultar el selector de color al editar el color. |
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
Visualización de estado y edición de detalles de ejecución
Al seleccionar el color, locStatusColorPicker se establece en true, mostrando la galería de selectores de color galStatusColorPicker.
La propiedad predeterminada galStatusColorPicker se establece en el color del estado según el tema actual de Teams. Esto hace que el icono de la marca de verificación sea visible en el color del estado actual, ya que su visibilidad se establece en ThisItem.IsSelected.
Al seleccionar galStatusColorPicker se establece locStatusColorPicker en falso y locSettingsChanged en verdadero.
Seleccione el botón Guardar para guardar todos los cambios en la pantalla de configuración. Específicamente, para los estados, los estados existentes se filtran en función de la condición de que su campo de ID no esté en blanco (lo que significa que son estados existentes) y se actualizan mediante una declaración de parche.
La actualización de los colores de las prioridades se realiza de la siguiente manera:
Si el tema actual de Teams es oscuro, los colores del modo oscuro se presentan al usuario. Entonces, la columna Color se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo predeterminado equivalente al color seleccionado por el usuario. La columna Color oscuro se actualiza con el color seleccionado por el usuario.
Si el tema actual de Teams es el predeterminado, los colores del modo perdeterminado se presentan al usuario. Así, la columna Color oscuro se actualiza con el color seleccionado por el usuario. La columna Color oscuro se actualiza haciendo una búsqueda en colProjectCoverColors para encontrar el modo oscuro equivalente al color seleccionado por el usuario.
Agregar estados
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al agregar valores de estado.
Agregar colecciones de estados
Las siguientes colecciones se utilizan al agregar un estado.
| Nombre de colección | Descripción |
|---|---|
| colStatuses | Colección de estados. |
Agregar variables de estado
Las siguientes variables se utilizan al agregar un estado.
| Nombre de variable | Descripción |
|---|---|
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
| locGlobalSetting | Variable local para almacenar la configuración global que se actualizó. |
| locGalleryDefaultStatus | Variable local utilizada para establecer el valor de prioridad predeterminado en la galería galStatuses. |
Agregar detalles de ejecución de estados
Al seleccionar Agregar agrega un nuevo estado a colStatuses y actualiza locSettingsChanged a true, lo que indica que se ha realizado una actualización en la pantalla Configuración, habilitando así el botón Guardar.
La galería galStatuses se restablece mediante la función Restablecer para desplazar la galería al estado recién agregado.
Al seleccionar el botón Guardar se crean nuevos registros en la tabla Estados de elementos de trabajo del proyecto para cada registro de colStatuses con un identificador en blanco.
Eliminación de estados
Esta sección explica las colecciones, las variables y los detalles de ejecución que se utilizan al eliminar un estado.
Colecciones involucradas
Las siguientes colecciones se utilizan al eliminar un estado.
| Nombre de colección | Descripción |
|---|---|
| colStatuses | Colección de estados. |
| colRemovedStatuses | Colección de estados que se van a quitar. |
Variables implicadas
Las siguientes variables se utilizan al eliminar un estado.
| Nombre de variable | Descripción |
|---|---|
| locSettingsChanged | Variable local para almacenar si se ha cambiado o no la configuración de un proyecto. |
| locDeleteSettings | Variable local para controlar la visibilidad de la pantalla de advertencia de eliminación. |
| locSettingType | Variable local para determinar qué registro se está eliminando. |
Eliminar detalles de ejecución de estados
Seleccione el icono de eliminación agrega el registro de prioridad seleccionado a colRemovedStatuses y actualiza locDeleteSettings a true, mostrando así el contenedor conWarning_Settings.
La casilla de verificación Entiendo, habilita el botón Eliminar.
Seleccionando Cancelar establece locDeleteSettings en falso, cerrando así el diálogo de advertencia.
Seleccionar Eliminar quita el estado seleccionado de colStatuses y de la tabla Estados de elementos de trabajo del proyecto si tiene un identificador (lo que significa que es un estado existente).
Consultar también
Comentarios
Enviar e ver os comentarios