Entender a arquitetura do aplicativo de exemplo Etapas
Neste artigo, você saberá mais sobre as coleções e variáveis globais usadas pelo aplicativo Etapas e entenderá como usá-las de maneira eficaz. Se você quiser saber mais sobre como instalar e usar o aplicativo de exemplo Etapas, acesse Aplicativo de exemplo Etapas.
Pré-requisitos
Para entender e usar as informações neste artigo, você precisará saber sobre os diferentes controles, recursos e capacidades dos aplicativos de tela.
- Criar e atualizar uma coleção em um aplicativo de tela
- Funções Collect, Clear e ClearCollect no Power Apps
- Princípios básicos sobre as variáveis de aplicativo de tela no Power Apps
- Adicionar e configurar um controle de aplicativo de tela no Power Apps
- Adicionar uma tela a um aplicativo de tela e navegar entre telas
Você também precisa saber como instalar e usar o aplicativo de exemplo Etapas.
Modelo de Dados
Modelo de arquitetura
O diagrama a seguir ilustra a maneira como os usuários e sistemas interagem com os dados nesta solução.
Conectores
O aplicativo Etapas usa os seguintes conectores:
Microsoft Dataverse para ler e gravar dados nas tabelas do Dataverse.
Usuários do Office 365 para ler os dados do perfil do usuário.
Tabelas
O aplicativo Etapas inclui as seguintes tabelas:
| Nome da tabela | Descrição |
|---|---|
| Project | Um projeto denota uma empresa individual ou colaborativa que é cuidadosamente planejada para atingir um objetivo específico. Detalhes como nome, quando e por quem foi criado ou modificado são armazenados na entidade Projetos. Um único projeto pode ter várias etapas, itens de trabalho, membros da equipe e atividades associadas a ele. |
| Etapa de projeto | Uma etapa de projeto é uma tarefa que descreve uma conquista importante em um Projeto. As etapas devem representar uma sequência de eventos que aumentam gradativamente até que o projeto seja concluído. Detalhes como o nome, o projeto ao qual está associado e a data em que a etapa deve ser concluída são armazenados na entidade Etapas do projeto. Uma etapa só pode fazer parte de um único projeto, mas pode ter vários itens de trabalho associados a ela. |
| Item de trabalho do projeto | Um item de trabalho indica o tipo de trabalho, o que precisa ser feito e a data em que deve ser concluído. Detalhes como nome, descrição, a quem foi atribuído, status, prioridade e data de destino definem um item de trabalho. Um item de trabalho pode fazer parte de uma única etapa e pode ter apenas um status, prioridade, categoria e membro da equipe associados a ele. Contudo, ele pode ter várias atividades associadas. |
| Status do Projeto | Status resume o status geral de um item de trabalho. Os valores de status padrão incluem Novo, Em andamento, Bloqueado e Concluído. Mais status podem ser adicionados na seção Configurações do aplicativo. Cada status possui um nome e uma cor associada. |
| Prioridades de Item de trabalho | Prioridade representa a ordem de importância em que um item de trabalho deve ser concluído quando comparado aos itens de trabalho restantes. As prioridades padrão incluem P0, P1, P2 e P3. Mais prioridades podem ser adicionadas na seção Configurações do aplicativo. Cada prioridade possui um nome e uma cor associada. |
| Categorias de item de trabalho | As categorias ajudam na classificação de itens de trabalho. As prioridades padrão incluem alta, média e baixa. Mais categorias podem ser adicionadas na seção Configurações do aplicativo. Cada categoria possui um nome e uma cor associada. |
| Membros da Equipe do Projeto | Os membros da equipe são indivíduos que trabalham em um ou mais itens de trabalho em um projeto. Um indivíduo que faz parte de vários projetos terá um registro de membro da equipe por projeto. |
| Atividades do projeto | As atividades são usadas para fornecer atualizações feitas nos itens de trabalho de um projeto. A Um único item de trabalho pode ter várias atividades. As atividades são criadas conforme os itens de trabalho são atualizados. Uma atividade também pode ser criada manualmente. |
| Configuração de usuário do projeto | As configurações do usuário são usadas para armazenar as preferências do usuário relativas à exibição da tela inicial do Power Apps toda vez que ele entrar no aplicativo. Existe um registro para cada usuário. |
Coleções
| Nome da Coleção | Descrição | Tela usada |
|---|---|---|
| colLocalization | Usado para criar uma Coleção de Localização com base no Idioma do Usuário. | Propriedade OnStart do aplicativo |
| colWorkItems | Usado para coletar os itens de trabalho. | |
| colUserSettings | Usado para coletar o registro do dataverse das Configurações do usuário, se houver. | Propriedade OnStart do aplicativo |
| colWorkItemHeaderIcons | Usado para coletar os ícones de cabeçalho de itens de trabalho. | Propriedade OnStart do aplicativo |
| colProjectCoverColors | Usado para coletar as cores da capa do projeto. | Propriedade OnStart do aplicativo |
| colStockImages | Coleção para coletar as imagens padrão usadas no aplicativo. | Propriedade OnStart do aplicativo |
| colNewProjectMilestones | Usado para coletar as informações padrão de uma etapa recém-adicionada. | Propriedade OnSelect da imagem Adicionar etapas na tela Projetos |
| colProjectTeamMembers | Usado para coletar os membros da equipe que fazem parte de um projeto. | Propriedade OnVisible da tela Configurações |
| colRemovedProjectTeamMembers | Usado para coletar os membros da equipe que foram removidos do projeto. | Propriedade OnSelect do botão Excluir nas configurações de Membros da Equipe |
| colRemovedProjectMilestones | Usado para coletar as etapas que foram removidas do projeto. | ND |
| colCategories | Usado para coletar as informações da categoria. | Propriedade OnSelect do botão Salvar na tela Configurações |
| colNewProjectTeamMembers | Usado para coletar os membros da equipe recém-adicionados a um projeto. | Propriedade OnSelect do botão Criar da tela Projetos |
| colProjectMilestones | Usado para coletar as informações das etapas de um projeto. | Propriedade OnSelect do botão de confirmação de exclusão |
| colRemovedCategories | Usado para coletar as categorias que estão sendo removidas. | Propriedade OnSelect do botão Salvar na tela Configurações |
| colPriorities | Usado para coletar as informações de prioridades. | Propriedade OnSelect do botão Salvar na tela Configurações |
| colRemovedPriorities | Usado para coletar as prioridades que estão sendo removidas. | Propriedade OnSelect do botão Salvar na tela Configurações |
| colStatuses | Usado para coletar as informações de status. | Propriedade OnSelect do botão Salvar na tela Configurações |
| colRemovedStatuses | Usado para coletar as prioridades que estão sendo removidas. | Propriedade OnSelect do botão Salvar na tela Configurações |
| colRemoveWorkItems | Usado para coletar os itens de trabalho que foram verificados para exclusão. | Propriedade OnSelect do botão Excluir do pop-up de confirmação da tela Projetos. |
| colRemovedMilestones | Usado para coletar os membros da equipe que foram removidos do projeto. | Propriedade OnSelect do botão Excluir na seção Detalhes do projeto na página de configurações. |
| colWorkItemStatuses | Usado para coletar os status disponíveis para itens de trabalho. | Propriedade de itens da caixa de combinação Status na tela Projeto |
Variáveis globais
| Nome de Variável | Digitar | Descrição |
|---|---|---|
| gblAppLoaded | Boolean | Para verificar se o Aplicativo está carregado. |
| gblUserLanguage | Texto | Para verificar o idioma do usuário conectado. |
| colCharsWidth | Tabela | Usado para armazenar a largura dos caracteres para diferentes fontes, pesos, tamanhos etc. |
| gblThemeDark | Boolean | Para verificar se o tema do Teams está definido como Escuro. |
| gblThemeHiCo | Boolean | Para verificar se o tema do Teams está definido como Alto Contraste. |
| gblMobileWidth | Número | Variável para definir a largura em dispositivos móveis. |
| gblMobileMode | Boolean | Variável para verificar se o aplicativo está sendo executado em dispositivos móveis. |
| gblAppSetting_inputMobileOnWeb | Boolean | Variáveis para dimensionar fontes para aplicativos baseados em dispositivos móveis, executados em desktop. |
| gblAppSetting_inputScaleFontsby | Número | Use esta variável para dimensionar todas as fontes em um valor fixo. |
| gblAppContext | Boolean | Para verificar o contexto de onde o aplicativo está sendo executado. |
| gblFirstRun | Boolean | Para verificar se o aplicativo está sendo executado pela primeira vez. |
| gblRecordUserSettings | Registro | Variável para usar o registro mais antigo, caso existam vários registros. |
| gblAppSetting_inputMobile | Boolean | Variáveis para dimensionar fontes para aplicativos baseados em dispositivos móveis. |
| gblAppColors | Registro | Variável para definir o valor de Cor no aplicativo. |
| gblAppSizes | Registro | Variável para definir o valor de Cor no aplicativo. |
| gblAppStyles | Registro | Variável para definir os valores de Estilo no aplicativo. |
| gblProject | Registro | Variável para armazenar um registro de projeto que está no contexto. |
Aplicativo OnStart
Esta seção explica as coleções, variáveis e detalhes de execução OnStart do aplicativo.
Coleções OnStart
Coleções usadas durante o OnStart do aplicativo:
| Nome da coleção | Descrição |
|---|---|
| colLocalization | Coleção de texto localizado com base no idioma do usuário. |
| colCharsWidth | Coleção de larguras para cada caractere usado para rótulos de largura automática. |
| colStockImages | Coleção de imagens de capa de projetos em estoque. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
| colWorkItemHeaderIcons | Coleção de ícones de cabeçalho para itens de trabalho. |
| colUserSettings | Coleção das configurações do usuário da tabela Configurações do usuário do projeto. |
Variáveis OnStart
Variáveis usadas durante o OnStart do aplicativo:
| Nome da variável | Descrição |
|---|---|
| gblAppLoaded | Variável global para verificar se o aplicativo foi carregado completamente. |
| gblUserLanguage | Variável global para armazenar o idioma do usuário. |
| gblThemeDark | Variável global para armazenamento se o Teams estiver sendo executado no modo escuro. |
| gblThemeHiCo | Variável global para armazenamento se o Teams estiver sendo executado no modo de contraste. |
| gblMobileWidth | Variável global para definir a largura do aplicativo móvel. |
| gblMobileMode | Variável global para armazenar se o aplicativo está sendo acessado de um dispositivo móvel. |
| gblAppSetting_inputMobileOnWeb | Variável global para dimensionar fontes para aplicativos baseados em dispositivos móveis, executados em desktop. |
| gblAppSetting_inputMobile | Variável global para dimensionar fontes para aplicativos baseados em dispositivos móveis. |
| gblAppSetting_inputScaleFontsBy | Variável global para dimensionar todas as fontes em um valor fixo. |
| gblAppContext | Variável global para verificar o contexto de onde o aplicativo está sendo executado. |
| gblFirstRun | Variável global para verificar se o aplicativo está sendo executado pela primeira vez. |
| gblRecordUserSettings | Variável global para armazenar os registros de configurações do usuário do projeto mais recentes para o usuário atual. |
Detalhes da execução do OnStart
Quando um usuário acessa o aplicativo, gblAppLoaded é definida como falsa. O código de idioma do usuário é armazenado em gblUserLanguage, com English - US como o padrão.
O idioma do usuário é então usado para coletar o texto localizado usado em todo o aplicativo (por exemplo, rótulo e texto do botão) em colLocalization.
O tema/modo do Microsoft Teams do usuário é verificado para ver se o tema é padrão, escuro ou alto contraste. As variáveis gblThemeDark e gblThemeHiCo são definidas apropriadamente.
As imagens em estoque e as cores da capa são coletadas em colStockImages e colProjectCoverColors respectivamente. colProjectCoverColors tem dois conjuntos de 14 cores. Para cada base, existem duas cores. Um é para o tema padrão e o outro é para o tema escuro. Por exemplo, #F4B9B9 é o modo padrão equivalente a #791818.
Os detalhes do usuário da tabela Configurações do usuário do projeto são coletados em colUserSettings. Se nenhum registro existir, um novo registro de configuração do usuário do projeto é criado e a variável gblFirstRun é definida como verdadeira. Isso, por sua vez, controla a visibilidade da caixa de diálogo inicial. Se houver vários registros de configuração do usuário do projeto, o registro mais antigo é selecionado e armazenado na variável gblRecordUserSettings.
Tela de carregamento
Esta seção explica coleções de tela de carregamento de aplicativo, variáveis e detalhes de execução.
Navegação até a tela Projetos
Variáveis envolvidas
As seguintes variáveis são usadas quando a tela de carregamento navega para a tela Projetos:
| Nome da variável | Descrição |
|---|---|
| gblAppLoaded | Variável global para verificar se o aplicativo foi carregado completamente. |
| gblAppStyles | Variável global para armazenar propriedades de estilo para todos os controles (definida no OnVisible da tela de carregamento). |
| gblAppContext | Variável global para verificar o contexto de onde o aplicativo está sendo executado. |
| gblFirstRun | Variável global para verificar se o aplicativo está sendo executado pela primeira vez. |
| gblRecordUserSettings | Variável global para armazenar os registros de configurações do usuário do projeto mais recentes para o usuário atual. |
| locShowFirstRun | Variável local para indicar se a execução atual do aplicativo é a primeira execução do usuário. |
| locShowPowerAppsPrompt | Variável local para indicar se o usuário configurou a preferência para ver o prompt do Power Apps como sim ou não. |
Detalhes de execução da navegação na tela do projeto
Se gblAppLoaded for verdadeiro (o que significa que os aplicativos OnStart foram concluídos), gblAppStyles não está em branco (o que significa que a variável de estilo foi carregada) e gblAppContext é verdadeiro (o que significa que o aplicativo está sendo acessado de dentro do Teams), então o usuário é direcionado para:
Tela de projetos móveis se o hostClientType (dispositivo sendo usado para acessar o aplicativo) for um Android ou iOS.
Tela Projetos se o hostClientType não for Android ou iOS. Duas variáveis são passadas durante a navegação para a tela Projetos:
locShowFirstRun: se a execução atual for a primeira execução do aplicativo conforme indicado por gblFirstRun, ela é definida como verdadeira; caso contrário, é falsa.
locShowPowerAppsPrompt: se o registro de configurações do usuário do projeto mais recente para o usuário atual (armazenado em gblRecordUserSettings) tiver um valor Sim para a coluna Display Splash (Power Apps), então ele é definido como verdadeira; caso contrário, é falso.
Se gblAppContext for falso, o usuário é direcionado à tela de contexto incorreto.
Tela de apresentação
Esta seção explica a experiência de primeira execução, coleções relevantes, variáveis e detalhes de execução do aplicativo.
Variáveis de experiência de primeira execução
As seguintes variáveis são usadas para controlar a experiência de primeira execução
| Nome da variável | Descrição |
|---|---|
| locShowFirstRun | Variável local para indicar se a execução atual do aplicativo é a primeira execução do usuário. |
| locShowPowerAppsPrompt | Variável local para indicar mostrar ou ocultar a tela inicial. |
Detalhes da experiência de primeira execução
Quando locShowFirstRun ou locShowPowerAppsPrompt for verdadeira, o contêiner conDialogWelcome se tornará visível.
Se locShowFirstRun for verdadeiro, o contêiner conDialogFirstRun se tornará visível e fornecerá uma visão geral do aplicativo.
Selecionar Continuar define locShowFirstRun como falso que oculta o contêiner conDialogFirstRun. Se locShowPowerAppsPrompt for verdadeiro, o contêiner conDialogSplash_PowerApps se tornará visível mostrando a tela inicial.
Marcar Não mostrar novamente e, em seguida, selecionar Entendi atualiza a coluna Display Splash (PowerApps) no registro Configurações do usuário do projeto do usuário atual para Não, que define locShowPowerAppsPrompt como falso em execuções subsequentes e oculta o tela inicial. Além disso, locShowPowerAppsPrompt e locShowFirstRun são definidos como falsos para que o usuário possa continuar com o aplicativo.
Selecione Entendi sem marcar a caixa de seleção Do not show again simplesmente define locShowPowerAppsPrompt e locShowFirstRun como falso para que o usuário possa continuar com o aplicativo. Nas execuções subsequentes, a tela inicial é exibida para os usuários até que eles marquem a caixa de seleção Não mostrar novamente.
A galeria Todos os Projetos e os itens de trabalho ficarão visíveis assim que o usuário selecionar Continuar.
Tela Projeto
Esta seção explica as coleções, variáveis e detalhes de execução usados na tela do projeto.
Exibição de variáveis de projetos
As seguintes variáveis são usadas quando um usuário visualiza projetos em Etapas.
| Nome da variável | Descrição |
|---|---|
| locAddProject | Variável local para controlar a visibilidade do contêiner conAddProject. |
| gblProject | Variável global para armazenar o projeto selecionado. |
| locProjectSortOrder | Variável local para controlar a ordem de classificação da lista de projetos. |
| locExpandProjectList | Variável local usada para controlar a visibilidade da lista de projetos (expandir e recolher). |
Exibição de detalhes de execução de projetos
Os projetos são exibidos em várias telas do aplicativo em vários contêineres, conforme mencionado abaixo:
conProjectList na tela Projetos
conProjectList_About na tela Sobre
conProjectList_Settings na tela Configurações
As galerias que listam projetos da tabela Projetos são:
galProjects na tela Projetos
galProjects_About na tela Sobre
galProjects_Settings na tela Configurações
Selecionar um projeto define a variável gblProject para o projeto selecionado e também coleta os itens de trabalho do projeto selecionado na coleção colWorkItems.
Selecione o botão + Novo projeto em qualquer uma das telas mencionadas acima para atualizar a variável locAddProject para verdadeiro e a variável locShowProjectTeamAssignment (para saber como essa variável é usada, acesse a seção Criar um novo projeto) para falso, exibindo assim a nova tela de criação de projeto.
A caixa de texto localizar projetos é usada para pesquisar projetos que contenham o texto inserido em seus nomes.
Selecione as atualizações do ícone de classificação locProjectSortOrder que é usado para classificar a lista de projetos com base no nome do projeto. Selecione o ícone para alternar a ordem de classificação de crescente para decrescente e vice-versa.
Selecione o ícone do menu para atualizar a variável locExpandProjectList alternando seu valor de verdadeiro para falso e vice-versa. Isso, por sua vez, expande e reduz a seção da lista de projetos.
Exibição e atualização da capa do projeto
Esta seção explica as variáveis e detalhes de execução usados ao exibir ou atualizar a imagem da capa de um projeto.
Variáveis de atualização da capa do projeto
As seguintes variáveis são usadas quando um usuário exibe ou atualiza a imagem da capa do projeto.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locVisibleCoverSelection | Variável local usada para controlar a visibilidade do contêiner das tampas do projeto. |
| locCoverImageSelected | Variável local para verificar se uma imagem de capa foi selecionada. |
| locCoverColorSelected | Variável local para verificar se uma cor de capa foi selecionada. |
| locCoverChanged | Variável local para verificar se a capa do projeto foi alterada. |
| locCustomImageSelected | Variável local para verificar se uma imagem personalizada foi carregada para a capa do projeto. |
Detalhes de execução da atualização da capa do projeto
A capa do projeto faz parte do contêiner conProjectHeader que exibe o nome dos projetos selecionados, a imagem da capa (se houver) e a cor da capa (se não houver imagem da capa) que é buscada usando a variável gblProject.
A galeria galProjectColors apresenta ao usuário uma lista de cores baseada no tema do Microsoft Teams. Isso é obtido filtrando a coleção colProjectCoverColors com base no tema do Teams.
Se o projeto selecionado tiver uma cor definida, essa cor é indicada com uma marca de seleção (imgColorSelected). A visibilidade deste ícone está definida como ThisItem.IsSelected. Por causa da propriedade Padrão de galProjectColors (descrita abaixo), a cor da capa do projeto selecionado é selecionada por padrão.
A propriedade padrão da galeria galProjectColors é usada para selecionar a cor da capa de gblProject. É definida da seguinte forma:
Se o tema do Teams for escuro, a cor da capa escura de gblProject é pesquisada. Se estiver em branco, significa que não há cor de capa do projeto.
Se o tema do Teams não for escuro, a cor da capa escura de gblProject é pesquisada. Se estiver em branco, significa que não há cor de capa do projeto.
Selecionar uma cor define locCoverImageSelected como falso, locCoverColorSelected como verdadeiro e locCoverChanged como verdadeiro.
A galeria galProjectCovers exibe uma lista de imagens de capa de projetos em estoque. Ela também permite que os usuários carreguem uma imagem personalizada usando um controle Add picture (addProjectCoverImage).
Selecionar uma imagem personalizada define locCoverChanged como verdadeiro e locCustomImageSelected como verdadeiro.
Selecionar uma imagem em estoque define locCoverImageSelected como verdadeiro, locCoverColorSelected como falso, locCoverChanged como verdadeiro e locCustomImageSelected como verdadeiro.
Se o projeto selecionado tiver uma das imagens em estoque como capa, essa imagem em estoque será destacada pela definição da cor de preenchimento de btnProjectCoverBackground.
Selecione Concluído para atualizar a capa do projeto da seguinte maneira:
Se locCoverImageSelected for verdadeiro e locCustomImageSelected também for verdadeiro, significa que uma imagem personalizada foi selecionada pelo usuário. Portanto, a foto da capa é atualizada com a imagem carregada e o ícone da capa, a cor da capa, a cor da capa escura estão todos em branco.
Se locCoverImageSelected for verdadeiro e locCustomImageSelected for falso, significa que uma imagem em estoque foi selecionada pelo usuário. Portanto, o ícone da capa é atualizado com a imagem em estoque e a foto da capa, a cor da capa, a cor da capa escura estão todas definidas como em branco.
Se locCoverColorSelected for verdadeiro, significa que uma cor de capa foi selecionada pelo usuário. Portanto, a foto da capa e o ícone da capa ficam em branco. A cor da capa e a cor da capa escura são atualizadas de acordo com a seguinte lógica:
Se o tema atual do Teams for escuro, a cor selecionada em galProjectColors é definida como cor de capa escura. Se o tema atual do Teams não for escuro, a cor selecionada em galProjectColors é usada para procurar a cor do modo escuro correspondente em colProjectCoverColors e essa cor é então definida como cor da capa escura. Isso ocorre porque, se o tema do Teams não for escuro, galProjectColors será preenchido com as cores do tema padrão.
Se o tema atual do Teams não for escuro, a cor selecionada em galProjectColors é definida como cor de capa. Se o tema atual do Teams for escuro, a cor selecionada em galProjectColors é usada para procurar a cor do modo padrão correspondente em colProjectCoverColors e essa cor é então definida como cor da capa. Isso ocorre porque, se o tema do Teams for escuro, galProjectColors será preenchido com cores escuras de tema.
Exibição de etapa/status da equipe
Esta seção explica as coleções, variáveis e detalhes de execução usados ao exibir etapas e dados de status
Coleções de exibição de etapas
A coleção a seguir é usada na exibição de etapas.
| Nome da coleção | Descrição |
|---|---|
| colWorkItemStatuses | - coleção de status de item de trabalho. |
Variáveis de exibição de etapas
As variáveis a seguir são usadas na exibição de etapas.
| Nome da variável | Descrição |
|---|---|
| locShowProjectStatusOptions | Usado para controlar a visibilidade da galeria de opções Status do projeto. |
| locProjectStatusSelection | Variável local para verificar qual seleção foi feita pelo usuário. |
| locCompletionStatus | Variável local para armazenar o status que pertence à conclusão do item de trabalho. |
Detalhes de execução de exibição de etapas
Existem quatro opções de status do projeto disponíveis:
Status da equipe que mostra a lista de membros da equipe juntamente com o número de itens de trabalho atribuídos a eles com base em seus status.
Status da etapa que mostra a lista de etapas juntamente com o número de itens de trabalho relacionados a eles com base em seus status.
A propriedade items da galeria galMilestones é definida para as etapas do projeto selecionado gblProject.
Existem 13 imagens no aplicativo usadas para denotar diferentes conclusões de porcentagem de etapas (0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 95, 99, 100). A imagem apropriada é mostrada com base na porcentagem de conclusão calculada pela divisão do número de itens de trabalho para a etapa no status Concluído (que é o primeiro status em colWorkItemStatuses, armazenado em locCompletionStatus na tela OnVisible de Projetos) pelo número total de itens de trabalho para essa etapa.
Os quatro rótulos sob o nome da etapa exibem a contagem de itens de trabalho nos primeiros quatro status de colWorkItemStatuses.
A propriedade items da galeria galTeamMembers é definida para os membros da equipe do projeto selecionado gblProject.
A foto do usuário para cada membro da equipe é exibida usando a função Office365Users.UserPhotoV2. Se não houver foto, o ícone de uma pessoa é mostrado por padrão.
O botão de seta para baixo próximo ao rótulo da opção é usado para alternar entre as opções Status da equipe e Status da etapa. Selecione a seta para atualizar o valor da variável locShowProjectStatusOptions alternando o valor de verdadeiro para falso e vice-versa controlando a visibilidade da galeria galProjectStatusOptions.
Exibição da lista de itens de trabalho
Esta seção explica as coleções, variáveis e detalhes de execução usados para exibir itens de trabalho.
Coleções de exibição de itens de trabalho
Essas coleções a seguir são usadas na exibição de itens de trabalho.
| Nome da coleção | Descrição |
|---|---|
| colWorkItems | Coleção de todos os itens de trabalho para o projeto selecionado. |
| colCharsWidth | Coleção de larguras para cada caractere usado para rótulos de largura automática. |
Variáveis de exibição de itens de trabalho
As variáveis a seguir são usadas na exibição de itens de trabalho.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locSortWorkItemBy | Variável local para definir a classificação por coluna. |
| locWorkItemSortOrder | Variável local para definir a ordem de classificação. |
| locShowSearchWorkItem | Variável local para controlar a visibilidade da caixa de pesquisa do item de trabalho. |
| locFilterWorkItems | Variável local para controlar a visibilidade da caixa de diálogo de filtro do item de trabalho. |
| locApplyFilter | Variável local para controlar a visibilidade da caixa de diálogo de filtro do item de trabalho. |
| locBackNavigation | Variável local a ser capturada se a navegação para a tela Projetos ocorrer no retorno da tela Sobre ou da tela Configurações. |
Detalhes de execução de exibição de item de trabalho
Selecionar um projeto na galeria de projetos resulta em duas coisas (que são definidas em OnSelect de galProjects):
Primeiro, o projeto selecionado é armazenado em gblProject.
Em segundo lugar, todos os itens de trabalho do projeto que se referem a este projeto são adicionados a uma coleção colWorkItems.
As etapas acima também acontecem na tela OnVisible do Projeto para que a lista de itens de trabalho para o primeiro projeto em galProjects seja exibida sem a necessidade de seleção no projeto quando um usuário é direcionado à tela Projetos pela primeira vez. O carregamento de itens de trabalho não acontece na navegação subsequente para a tela Projetos no retorno da tela Sobre ou da tela Configurações. Ele é controlado por locBackNavigation.
A classificação padrão por coluna (locSortWorkItemBy) é definida como eta (destino) e a ordem de classificação padrão (locWorkItemSortOrder) é definida como verdadeira (ou seja, ascendente). Eles são definidos na propriedade OnVisible da tela Projetos.
Existem 7 botões que são cabeçalhos da galeria de itens de trabalho (galWorkItems): Item de trabalho, Etapa, Categoria, Prioridade, Atribuído a, Destino e Status. Selecionar qualquer um deles atualiza a variável locSortWorkItemBy para definir a classificação apropriada por coluna e também alterna a ordem de classificação de crescente para decrescente ou vice-versa atualizando locWorkItemSortOrder.
A ordem de classificação é indicada por uma imagem de seta para baixo (imgSortWorkItem). Com base na classificação por coluna, sua posição X muda. Isso evita o uso de uma imagem por cabeçalho. Com base na ordem de classificação, sua propriedade ImageRotation muda. Isso evita o uso de uma imagem em ordem crescente e outra em ordem decrescente.
Os cabeçalhos e seus rótulos associados na galeria de itens de trabalho têm sua visibilidade com base na largura do contêiner. Por exemplo, a visibilidade do cabeçalho de status (btnStatusSort) é (Projects Screen.Size = ScreenSize.ExtraLarge || Projects Screen.Size = ScreenSize.Large) && Self.Width > 75
Os rótulos para etapa, categoria, prioridade e status na galeria de itens de trabalho têm sua largura configurada para uma fórmula que permite que a largura desses rótulos seja alterada com base em seus respectivos textos.
imgWorkItemAssignedTo mostra a imagem do membro da equipe a quem um item de trabalho é atribuído e imgWorkItemAssignedToDefault mostra a imagem padrão se o membro da equipe a quem um item de trabalho está atribuído não tiver uma imagem
Selecione o ícone de pesquisa para definir locShowSearchWorkItem como verdadeiro. Isso torna a caixa de pesquisa e um ícone X visíveis. Digitar na caixa de pesquisa faz uma pesquisa em colWorkItems usando o campo Nome. Selecionar o ícone X define locShowSearchWorkItem como falso e oculta a caixa de pesquisa.
Selecionar o ícone de filtro define locFilterWorkItems como verdadeiro para mostrar a caixa de diálogo do filtro e define locApplyFilter para filtrar para não aplicar filtros até que o usuário tenha confirmado.
conFilterWorkItems é o contêiner que possui todos os controles usados para filtrar a galeria de itens de trabalho. Existem cinco caixas de combinação, uma para cada uma das etapas, categorias, prioridades, membros da equipe e status. Todas apresentam opções de seleção múltipla. Uma vez que os valores foram selecionados, selecionar Apply define locApplyFilter como verdadeiro, que por sua vez filtra a galeria de itens de trabalho.
Exclusão de itens de trabalho
Esta seção explica as coleções, variáveis e detalhes de execução usados na exclusão de ordens de serviço.
Coleções de exclusão de itens de trabalho
As coleções a seguir são usadas na exclusão de itens de trabalho.
| Nome da coleção | Descrição |
|---|---|
| colWorkItems | Coleção de todos os itens de trabalho para o projeto selecionado. |
| colRemoveWorkItems | Coleção de itens de trabalho a serem excluídos. |
Variáveis de exclusão de itens de trabalho
As variáveis a seguir são usadas na exclusão de variáveis.
| Nome da variável | Descrição |
|---|---|
| locDeleteWorkItems | Variável local para controlar a visibilidade da caixa de diálogo de exclusão do item de trabalho. |
| locResetWorkItemCheckbox | Variável local para redefinir a caixa de seleção para selecionar um item de trabalho para exclusão. |
Exclusão de detalhes de execução de itens de trabalho
Marcar a caixa de seleção no cabeçalho da galeria de itens de trabalho marca a caixa de seleção para todos os itens de trabalho na galeria. Isso é controlado pela definição do valor padrão da caixa de seleção na galeria para chkSelectAllWorkItems.Value.
A propriedade Redefinir da caixa de seleção dentro da galeria é definida como locResetWorkItemCheckbox. Essa variável é usada para desmarcar a caixa de seleção quando o usuário decide cancelar a exclusão ou quando o usuário seleciona um projeto da galeria de projetos.
O ícone de exclusão permanece desabilitado até que pelo menos um item de trabalho seja selecionado. Depois de habilitado, selecionar o ícone excluir define locDeleteWorkItems como verdadeiro, o que torna a caixa de diálogo de exclusão do item de trabalho visível.
Na caixa de diálogo de exclusão, marcar a caixa de seleção Entendo habilita o botão de exclusão. O botão de exclusão primeiro coleta todos os itens da galeria que têm a caixa de seleção marcada em uma coleção colRemoveWorkItems. Em seguida, colRemoveWorkItems é usado para excluir todos os itens de trabalho selecionados. E, por fim, colWorkItems é preenchido novamente com a lista de itens de trabalho relacionados ao projeto selecionado (gblProject).
Edição de um item de trabalho
Esta seção explica as coleções, variáveis e detalhes de execução usados na edição de itens de trabalho.
Coleção de edição de itens de trabalho
As coleções a seguir são usadas na edição de um item de trabalho.
| Nome da coleção | Descrição |
|---|---|
| colWorkItems | Coleção de todos os itens de trabalho para o projeto selecionado. |
| colWorkItemStatuses | Coleção de status de item de trabalho. |
Variáveis de edição de item de trabalho
As seguintes variáveis são usadas na edição de itens de trabalho.
| Nome da variável | Descrição |
|---|---|
| locEditWorkItem | Variável local usada para controlar a visibilidade do contêiner conEditWorkItem. |
| locSelectedWorkItem | Variável local para armazenar o item de trabalho selecionado. |
| locNewWorkItem | Variável local que denota o item de trabalho que foi atualizado. |
Detalhes de execução de edição de item de trabalho
Selecione um item de trabalho na galeria de itens de trabalho (galWorkItems) exibe o contêiner conEditWorkItem cuja propriedade visível é controlada pela variável locEditWorkItem.
Selecionar o botão Concluído atualiza os detalhes do item de trabalho selecionado locSelectedWorkItem. O item de trabalho atualizado é armazenado em locNewWorkItem. Os itens de trabalho para gblProject são coletados novamente em colWorkItems.
Quando um ou mais campos de item de trabalho são atualizados, um registro é criado na tabela Atividades do Projeto para registrar qual foi a atualização.
Criação de um projeto
Esta seção explica as coleções, variáveis e detalhes de execução usados na criação de um projeto.
Coleções de criação de projetos
As coleções a seguir são usadas na criação de um projeto.
| Nome da coleção | Descrição |
|---|---|
| colNewProjectMilestones | Coleção de etapas para um novo projeto. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
| colNewProjectTeamMembers | Coleção de membros da equipe para o projeto a ser criado |
Variáveis de criação de projeto
As variáveis a seguir são usadas na criação de um projeto.
| Nome da variável | Descrição |
|---|---|
| locAddProject | - Variável local para controlar a visibilidade do contêiner conAddProject. |
| locMilestoneColorPicker | - Variável local para controlar a visibilidade do galMilestoneColorPicker. |
| locShowProjectTeamAssignment | - Variável local para controlar a visibilidade dos controladores de atribuição da equipe do projeto (visível após Selecionar Avançar). |
| locShowUsersGallery | - Variável local para controlar a visibilidade da galeria do usuário galAddTeamMembers. |
| galAddTeamMembers | - Variável local para armazenar o nome do usuário selecionado. |
| locNewProject | - Variável local para armazenar o projeto recém-criado. |
Detalhes de execução da criação do projeto
Um Novo Projeto pode ser criado selecionando o botão + Novo Projeto no contêiner conProjectList.
Selecionar o botão + Novo Projeto define locAddProject como verdadeiro, exibindo assim o contêiner conAddProject. Isso também adiciona 3 etapas por padrão a colNewProjectMilestones e adiciona o usuário atual como um membro da equipe a colNewProjectTeamMembers.
A galeria galAddMilestones exibe a lista de etapas usando colNewProjectMilestones.
Selecionar o botão de cor (btnMilestoneColor) define locMilestoneColorPicker como verdadeiro, exibindo assim a galeria galMilestoneColorPicker que tem uma lista de cores de capa (colProjectCoverColors).
Selecionar a cor desejada atualiza a cor da etapa e define o valor locMilestoneColorPicker como falso.
Selecionar o botão Fechar para definir locMilestoneColorPicker como falso, ocultando assim a galeria galMilestoneColorPicker.
Selecionar o ícone da lata de lixo para remover a etapa de colNewProjectMilestones.
Selecionar + Adicionar uma etapa cria uma etapa e a adiciona a colNewProjectMilestones juntamente com a redefinição da galeria galAddMilestones. O controle é redefinido para que a galeria role para baixo até a etapa recém-adicionada (a propriedade padrão de galAddMilestones ajuda a atingir esse comportamento).
Selecionar o botão Fechar define locShowProjectTeamAssignment e locAddProject como falsos, ocultando assim o contêiner conAddProject.
Depois que os detalhes necessários são preenchidos, selecionar o botão Avançar define locShowProjectTeamAssignment como verdadeiro e locAddProject como falso, exibindo assim a seção de atribuição do membro da equipe.
A caixa de pesquisa pode ser usada para pesquisar membros da equipe. Assim que uma entrada é fornecida, o valor de locShowUsersGallery é definido como falso, ocultando assim a galeria do usuário e exibindo os resultados com base na entrada fornecida.
Selecionar um novo usuário atualiza locUserPrincipalName e adiciona o usuário selecionado a colNewProjectTeamMembers.
Selecione o ícone de exclusão para remover o usuário de colNewProjectTeamMembers.
Selecionar o botão Voltar define locShowProjectTeamAssignment como falso, ocultando assim os campos de atribuição do usuário.
Selecionar o botão Criar define locShowProjectTeamAssignment como verdadeiro e locAddProject como falso. Isso também cria um registro de projeto e registros associados de Etapa do projeto e Membro da equipe do projeto.
Criação de um item de trabalho
Esta seção explica as coleções, variáveis e detalhes de execução usados na criação de um item de trabalho.
Coleções de criação de itens de trabalho
As coleções a seguir são usadas na criação de itens de trabalho.
| Nome da coleção | Descrição |
|---|---|
| colWorkItems | Coleção de todos os itens de trabalho para o projeto selecionado. |
Variáveis de criação de itens de trabalho
As seguintes variáveis são usadas na criação de itens de trabalho.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locAddWorkItem | Variável local para controlar a visibilidade do contêiner conAddProject. |
| locNewWorkItem | Variável local para armazenar o item de trabalho recém-criado. |
Detalhes de execução de criação de item de trabalho
Selecionar o botão + Novo item de trabalho define locAddWorkItem como verdadeiro que exibe o contêiner conAddWorkItem.
Depois que todos os detalhes forem inseridos, selecionar o botão Criar cria um item de trabalho e define locAddWorkItem como falso, ocultando assim o contêiner conAddWorkItem.
O item de trabalho recém-criado é armazenado em locNewWorkItem e adicionado a colWorkItems.
Uma nova atualização também é criada automaticamente para registrar a criação do item de trabalho.
Tela Sobre
Esta seção explica as coleções e detalhes de execução usados por processos na tela Sobre
Etapas detalhadas
Selecionar o botão Voltar no contêiner conNavigtion_About navega de volta para a tela Projeto.
Selecionar o botão Personalizar usando Power Apps no contêiner conHeader_About abre o link da ferramenta Power Apps no Microsoft Teams.
Há links de ajuda disponíveis na galeria galAbout_HelpLinks.
Selecionar o botão Saiba como personalizar este aplicativo navega até um link externo que explica como fazer personalizações no aplicativo.
Selecionar o botão Envie suas ideias navega até um link externo onde as ideias podem ser postadas para o aplicativo Etapas.
Selecionar o botão Interaja com a comunidade navega até a Comunidade do Power Apps.
O contêiner conAbout_AppVideo contém o link do vídeo que fornece uma visão geral do aplicativo Milestones.
A galeria galAbout_OtherApps contém os links para outros aplicativos da Microsoft.
Selecionar o botão Exibir aplicativo navega até a página do aplicativo na loja de aplicativos do Microsoft Teams.
Selecionar o botão Visão geral do aplicativo navega até o vídeo de visão geral do aplicativo no YouTube.
conAbout_Version fornece informações sobre o controle de versão do aplicativo.
Tela de configurações do projeto
Esta seção explica as coleções, variáveis e detalhes de execução usados pelos processos na tela de configuração.
Exibição da lista de etapas para um projeto
Esta seção explica as coleções, variáveis e detalhes de execução usados quando as etapas são exibidas.
Coleções de exibição de etapas
As coleções a seguir são usadas na exibição de etapas na tela de configurações.
| Nome da coleção | Descrição |
|---|---|
| colProjectMilestones | Coleção de todas as etapas para o projeto selecionado. |
Variáveis de exibição de etapas
As variáveis a seguir são usadas na exibição de etapas na tela de configurações.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locDefaultProjectMilestone | Variável local para armazenar a etapa padrão usado para reconfigurar a galeria de etapas. |
Detalhes de execução de exibição de etapas
As etapas do projeto selecionado (gblProject) na tela Projetos são adicionados a colProjectMilestones em OnVisible da tela Configurações.
A primeira etapa de colProjectMilestones é armazenada em locDefaultProjectMilestone; portanto, é a etapa selecionada por padrão.
Selecionar qualquer outro projeto em galProjects_Settings armazena o projeto selecionado em gblProject. Em seguida, todas as etapas que se referem a este projeto são adicionados a colProjectMilestones.
Edição de etapas
Esta seção explica as coleções, variáveis e detalhes de execução usados quando as etapas são editadas.
Coleções de edição de etapas
As coleções a seguir são usadas na edição de etapas na tela de configurações.
| Nome da coleção | Descrição |
|---|---|
| colProjectMilestones | Coleção de todas as etapas para o projeto selecionado. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
Variáveis de edição de etapas
As variáveis a seguir são usadas na edição de etapas na tela de configurações.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locEditMilestoneColorPicker | Variável local para controlar a visibilidade do seletor de cores. |
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
Detalhes de execução de edição de etapas
Selecionar as cores define locEditMilestoneColorPicker como verdadeiro e exibe a galeria do seletor de cores galEditProjectMilestoneColorPicker.
A propriedade padrão de galEditProjectMilestoneColorPicker é definida como a cor da etapa com base no tema atual do Teams. Isso torna o ícone de etapa de seleção visível na cor da etapa atual, pois sua visibilidade é definida como ThisItem.IsSelected.
Selecionar galEditProjectMilestoneColorPicker define locEditMilestoneColorPicker como falso e locSettingsChanged como verdadeiro.
Selecionar o botão Salvar salva todas as alterações na tela de configurações. Especificamente, no caso de etapas, as etapas existentes são filtradas com base na condição de que seu campo de ID não esteja em branco (o que significa que são registros existentes na tabela Etapas do projeto) e são atualizados usando uma instrução Patch.
A atualização das cores da etapa acontece da seguinte maneira:
Se o tema atual do Teams for escuro, as cores do modo escuro serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo padrão equivalente à cor selecionada pelo usuário. A coluna Cor escura é atualizada com a cor selecionada pelo usuário.
Se o tema atual do Teams for o padrão, as cores do modo padrão serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada com a cor selecionada pelo usuário. A coluna Cor escura é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo escuro equivalente à cor selecionada pelo usuário.
Adição de etapas
Esta seção detalha as coleções, variáveis e detalhes de execução usados quando as etapas são adicionados.
Coleções de criação de etapas
As coleções a seguir são usadas quando uma etapa é adicionada na tela de configurações.
| Nome da coleção | Descrição |
|---|---|
| colProjectMilestones | Coleção de todas as etapas para o projeto selecionado. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
Variáveis de criação de etapas
As variáveis a seguir são usadas quando uma etapa é adicionada na tela de configurações.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locDefaultProjectMilestone | Variável local para armazenar a etapa padrão usado para reconfigurar a galeria de etapas. |
Detalhes de execução de criação de etapas
Selecionar o botão + Nova Etapa adiciona uma nova etapa a colProjectMilestones. Isso também atualiza locDefaultProjectMilestone com essa nova etapa. A função Redefinir é então chamada em galEditMilestones para rolar até a etapa adicionada mais recentemente.
Selecionar o botão Salvar salva todas as alterações na tela de configurações. Especificamente, no caso de etapas, novas etapas são filtradas com base na condição de que seu campo de ID esteja em branco (o que significa que eles não existem na tabela Etapas do projeto) e são criadas usando uma instrução Patch.
As cores das novas etapas são definidas da seguinte maneira:
Se o tema atual do Microsoft Teams for escuro, as cores do modo escuro serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo padrão equivalente à cor selecionada pelo usuário. A coluna Cor escura é atualizada com a cor selecionada pelo usuário.
Se o tema atual do Microsoft Teams for o padrão, as cores do modo padrão serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada com a cor selecionada pelo usuário. A coluna Cor escura é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo escuro equivalente à cor selecionada pelo usuário.
Exclusão de etapas
Esta seção explica as coleções, variáveis e detalhes de execução usados quando as etapas são excluídas.
Exclusão de coleções de etapas
As coleções a seguir são usadas quando etapas são excluídas.
| Nome da coleção | Descrição |
|---|---|
| colProjectMilestones | Coleção de todas as etapas para o projeto selecionado. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
| colRemovedMiletones | Coleção de uma etapa ao selecionar o ícone de exclusão em relação a uma etapa. |
Exclusão de variáveis de etapas
As variáveis a seguir são usadas quando etapas são excluídas.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locDeleteSettings | Variável local para controlar a visibilidade da caixa de diálogo de exclusão da etapa. |
| locSettingType | Variável local para definir o tipo de configuração. |
Exclusão de detalhes de execução de etapas
Selecionar o ícone excluir define locDeleteSettings como verdadeiro, o que torna a caixa de diálogo de exclusão visível e adiciona a etapa que precisa ser excluída a colRemovedMiletones.
Na caixa de diálogo de exclusão, marcar a caixa de seleção Entendo habilita o botão de exclusão. O botão de exclusão remove a etapa selecionada em colProjectMilestones e remove a etapa selecionada da tabela Etapas do Projeto se a etapa selecionada tiver uma ID (o que significa que é um registro existente na tabela Etapas do projeto).
Gerenciamento de membros da equipe
Esta seção explica as coleções, variáveis e detalhes de execução quando um membro da equipe é adicionado, editado ou removido.
Gerenciamento de coleções de membros da equipe
As coleções a seguir são usadas quando um membro da equipe é adicionado, editado ou removido.
| Nome da coleção | Descrição |
|---|---|
| colWorkItems | Coleção de todos os itens de trabalho para o projeto selecionado. |
Gerenciamento de variáveis de membros da equipe
As variáveis a seguir são usadas quando um membro da equipe é adicionado, editado ou removido.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locDeleteProject | Variável local para controlar a visibilidade da tela de aviso de exclusão. |
| locProjectToDelete | Variável local para armazenar o projeto que está sendo excluído. |
| locTempNewSelectedProject | Variável local para armazenar temporariamente o novo projeto a ser selecionado assim que o projeto atual for excluído. |
Gerenciamento de detalhes de execução de membros da equipe
Selecionar o botão Excluir projeto define locDeleteProject como verdadeiro, exibindo assim o contêiner conWarning_Project.
Marcar a caixa de seleção Entendo habilita o botão de exclusão.
Selecionar Cancelar define locDeleteProject como falso, fechando assim a caixa de diálogo de aviso.
Selecionar Excluir resulta nas seguintes ações:
O projeto a ser excluído é primeiro armazenado em locProjectToDelete.
O primeiro projeto na lista de projetos excluindo o projeto que está sendo excluído é armazenado em locTempNewSelectedProject que, por sua vez, é usado para atualizar gblProject.
Depois que gblProject é atualizado, seus itens de trabalho são coletados em colWorkItems.
O projeto armazenado em locProjectToDelete é então usado para excluir todos os registros relacionados, ou seja, etapas, itens de trabalho, atividades, membros da equipe.
Depois que todos os registros relacionados forem excluídos, o próprio projeto será excluído.
Exclusão de um projeto
Esta seção explica a coleção, variáveis e detalhes de execução usados quando um projeto é excluído.
Coleções de exclusão de projetos
As coleções a seguir são usadas quando um projeto é excluído.
| Nome da coleção | Descrição |
|---|---|
| colProjectTeamMembers | Coleção de todos os membros da equipe do projeto. |
| colRemovedProjectTeamMembers | Coleção de membros da equipe a serem removidos. |
Variáveis de exclusão de projeto
As variáveis a seguir são usadas quando um projeto é excluído.
| Nome da variável | Descrição |
|---|---|
| gblProject | Variável global para armazenar o projeto selecionado. |
| locShowProjectTeamAssignment | Variável local para controlar a visibilidade dos controladores de atribuição da equipe do projeto (visível após a seleção de Avançar). |
| locShowUsersGallery | Variável local para controlar a visibilidade da galeria do usuário galAddTeamMembers. |
| galAddTeamMembers | Variável local para armazenar o nome do usuário selecionado. |
Detalhes de execução da exclusão do projeto
Os membros da equipe do projeto selecionado (gblProject) na tela Projetos são adicionados a colProjectTeamMembers em OnVisible da tela Configurações.
Selecionar qualquer outro projeto em galProjects_Settings armazena o projeto selecionado em gblProject. Em seguida, todas as etapas que se referem a este projeto são adicionadas a colProjectTeamMembers.
Inserir um texto de pesquisa define locShowUsersGallery como falso, oculta a galeria do usuário e exibe os resultados com base na entrada fornecida.
Selecionar um usuário atualiza locUserPrincipalName e adiciona o usuário selecionado a colProjectTeamMembers.
Selecionar o ícone excluir adiciona o membro da equipe a colRemovedProjectTeamMembers se ele tiver uma ID (o que significa que são registros existentes) e o remove de colProjectTeamMembers.
Selecionar Salvar remove todos os registros que estão em colRemovedProjectTeamMembers da tabela Membros da Equipe do Projeto. Todos os registros em colProjectTeamMembers com uma ID em branco são criados como novos registros na tabela Membros da Equipe do Projeto e estão relacionados ao projeto selecionado gblProject.
Tela Configurações
Esta seção explica as coleções, variáveis e detalhes de execução usados pelos processos na tela de configurações
Exibição e edição de categorias
Esta seção explica as coleções, variáveis e detalhes de execução usados quando uma categoria é exibida ou editada.
Coleções de edição de categorias
As coleções a seguir são usadas quando uma categoria é exibida ou editada.
| Nome da coleção | Descrição |
|---|---|
| colCategories | Coleção de categorias. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
Variáveis de edição de categorias
As variáveis a seguir são usadas quando uma categoria é exibida ou editada.
| Nome da variável | Descrição |
|---|---|
| locCategoryColorPicker | Variável local usada para mostrar e ocultar o seletor de cores ao editar a cor. |
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
Detalhes da execução de edição de categorias
Selecionar a cor define locCategoryColorPicker como verdadeiro, exibindo a galeria do seletor de cores galCategoryColorPicker.
A propriedade padrão de galCategoryColorPicker é definida como a cor da categoria com base no tema atual do Teams. Isso torna o ícone de etapa de seleção visível na cor da categoria atual, pois sua visibilidade é definida como ThisItem.IsSelected.
Selecionar galCategoryColorPicker define locCategoryColorPicker como falso e locSettingsChanged como verdadeiro.
Selecionar o botão Salvar salva todas as alterações na tela de configurações. Especificamente, no caso de categorias, as categorias existentes são filtradas com base na condição de que seu campo de ID não esteja em branco (o que significa que são registros existentes na tabela Categorias do projeto) e são atualizados usando uma instrução Patch.
A atualização da cor da categoria ocorre da seguinte maneira:
Se o tema atual do Teams for escuro, as cores do modo escuro serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo padrão equivalente à cor selecionada pelo usuário. A coluna Cor escura é atualizada com a cor selecionada pelo usuário.
Se o tema atual do Teams for o padrão, as cores do modo padrão serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada com a cor selecionada pelo usuário. A coluna Cor escura é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo escuro equivalente à cor selecionada pelo usuário.
Adição de categorias
Esta seção explica as coleções, variáveis e detalhes de execução usados quando uma categoria é adicionada por meio da tela de configurações.
Coleções de criação de categoria
As coleções a seguir são usadas quando uma categoria é criada.
| Nome da coleção | Descrição |
|---|---|
| colCategories | Coleção de categorias. |
Variáveis envolvidas
As variáveis a seguir são usadas quando uma categoria é criada.
| Nome da variável | Descrição |
|---|---|
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
| locGlobalSetting | Variável local para armazenar a configuração global que foi atualizada. |
| locGalleryDefaultCategory | Variável local usada para definir o valor da categoria padrão na galeria galCategories. |
| galAddTeamMembers | Variável local para armazenar o nome do usuário selecionado. |
| locCoverChanged | Variável local para verificar se a capa do projeto foi alterada. |
| locCustomImageSelected | Variável local para verificar se uma imagem personalizada foi carregada para a capa do projeto. |
Detalhes de execução da criação de categorias
Selecionar Adicionar adiciona uma nova categoria a colCategories e atualiza locSettingsChanged para verdadeiro, indicando que uma atualização foi feita na tela Configurações, permitindo assim o botão Salvar.
A galeria galCategories é redefinida usando a função Redefinir para rolar a galeria para a categoria recém-adicionada.
Selecionar o botão Salvar para criar registros na tabela Categorias de item de trabalho do projeto para cada registro em colCategories com uma ID em branco.
Exclusão de categorias
Esta seção explica as coleções, variáveis e detalhes de execução usados quando uma categoria é excluída por meio da tela de configurações.
Coleções de exclusão de categorias
As coleções a seguir são usadas na exclusão de uma categoria.
| Nome da coleção | Descrição |
|---|---|
| colCategories | Coleção de categorias. |
| colRemovedCategories | Coleção de categorias a serem removidas. |
Variáveis de exclusão de categoria
As variáveis a seguir são usadas na exclusão de uma categoria.
| Nome da variável | Descrição |
|---|---|
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
| locDeleteSettings | Variável local para controlar a visibilidade da tela de aviso de exclusão. |
| locSettingType | Variável local para determinar qual registro está sendo excluído. |
Detalhes de execução da exclusão de categorias
Selecionar o ícone de exclusão adiciona o registro de prioridade selecionado a colRemovedCategories e atualiza locDeleteSettings para verdadeiro, exibindo assim o contêiner conWarning_Settings.
Marcar a caixa de seleção Entendo habilita o botão Excluir.
Selecionar Cancelar define locDeleteSettings como falso, fechando assim a caixa de diálogo de aviso.
Selecionar Excluir remove a categoria selecionada de colCategories e da tabela Categorias de item de trabalho do projeto se ela tiver um ID (o que significa que é uma categoria existente).
Exibição e edição de prioridades
Esta seção descreve as coleções, variáveis e detalhes de execução usados quando uma prioridade é exibida ou editada.
Coleções de prioridades
As coleções a seguir são usadas quando uma prioridade é exibida ou editada.
| Nome da coleção | Descrição |
|---|---|
| colPriorities | Coleção de prioridades. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
Variáveis de prioridades
As variáveis a seguir são usadas quando uma prioridade é exibida ou editada.
| Nome da variável | Descrição |
|---|---|
| locPriorityColorPicker | Variável local usada para mostrar e ocultar o seletor de cores ao editar a cor. |
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
Detalhes da execução da prioridade
Selecionar a cor define locPriorityColorPicker como verdadeiro, exibindo assim a galeria do seletor de cores galPriorityColorPicker.
A propriedade padrão de galPriorityColorPicker é definida como a cor da propriedade com base no tema atual do Teams. Isso torna o ícone de etapa de seleção visível na cor da propriedade atual, pois sua visibilidade é definida como ThisItem.IsSelected.
Selecionar galPriorityColorPicker define locPriorityColorPicker como falso e locSettingsChanged como verdadeiro.
Selecionar o botão Salvar salva todas as alterações na tela de configurações. Especificamente, no caso de prioridades, as prioridades existentes são filtradas com base na condição de que seu campo de ID não esteja em branco (o que significa que são registros existentes na tabela Prioridades do projeto) e são atualizados usando uma instrução Patch.
A atualização da cor da prioridade ocorre da seguinte maneira:
Se o tema atual do Teams for escuro, as cores do modo escuro serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo padrão equivalente à cor selecionada pelo usuário. A coluna Cor escura é atualizada com a cor selecionada pelo usuário.
Se o tema atual do Teams for o padrão, as cores do modo padrão serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada com a cor selecionada pelo usuário. A coluna Cor escura é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo escuro equivalente à cor selecionada pelo usuário.
Adição de prioridades
Esta seção explica as coleções, variáveis e detalhes de execução usados na edição de prioridades.
Adição de coleções de prioridades
As coleções a seguir são usadas na adição de prioridades.
| Nome da coleção | Descrição |
|---|---|
| colPriorities | Coleção de prioridades. |
Adição de variáveis de prioridades
As variáveis a seguir são usadas na adição de prioridades.
| Nome da variável | Descrição |
|---|---|
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
| locGlobalSetting | Variável local para armazenar a configuração global que foi atualizada. |
| locGalleryDefaultPriority | Variável local usada para definir o valor da prioridade padrão na galeria galPriorities. |
Adição de detalhes de execução de prioridades
Selecionar Adicionar adiciona uma nova prioridade a colPriorities e atualiza locSettingsChanged para verdadeiro, indicando que uma atualização foi feita na tela Configurações e assim ativando o botão Salvar.
A galeria galPriorities é redefinida usando a função Redefinir para rolar a galeria para a prioridade recém-adicionada.
Selecionar o botão Salvar para criar registros na tabela Prioridades de item de trabalho do projeto para cada registro em colPriorities com uma ID em branco.
Exclusão de prioridades
Esta seção explica as coleções, variáveis e detalhes de execução usados na exclusão de prioridades.
Coleções de exclusão de prioridades
As coleções a seguir são usadas na exclusão de prioridades.
| Nome da coleção | Descrição |
|---|---|
| colPriorities | - coleção de prioridades. |
| colRemovedPriorities | - coleção de prioridades a serem removidas. |
Variáveis de exclusão de prioridade
As variáveis a seguir são usadas na exclusão de prioridades.
| Nome da variável | Descrição |
|---|---|
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
| locDeleteSettings | Variável local para controlar a visibilidade da tela de aviso de exclusão. |
| locSettingType | Variável local para determinar qual registro está sendo excluído. |
Detalhes de execução da exclusão da prioridade
Selecionar o ícone de exclusão adiciona o registro de prioridade selecionado a colRemovedPriorities e atualiza locDeleteSettings para verdadeiro, exibindo assim o contêiner conWarning_Settings.
Marcar a caixa de seleção Entendo habilita o botão de exclusão.
Selecionar Cancelar define locDeleteSettings como falso, fechando assim a caixa de diálogo de aviso.
Selecionar Excluir remove a prioridade selecionada de colPriorities e da tabela Prioridades de item de trabalho do projeto se ela tiver uma ID (o que significa que é uma prioridade existente).
Exibição e edição de status
Esta seção explica as coleções, variáveis e detalhes de execução usados ao exibir ou editar status.
Coleções de exibição e edição de status
As coleções a seguir são usadas quando os status são visualizados ou editados.
| Nome da coleção | Descrição |
|---|---|
| colStatuses | Coleção de status. |
| colProjectCoverColors | Coleção de cores de capa do projeto. |
Variáveis de exibição e edição de status
As variáveis a seguir são usadas quando os status são visualizados ou editados.
| Nome da variável | Descrição |
|---|---|
| locStatusColorPicker | Variável local usada para mostrar e ocultar o seletor de cores ao editar a cor. |
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
Detalhes de execução de exibição e edição de status
Selecionar a cor define locStatusColorPicker como verdadeiro, exibindo assim a galeria do seletor de cores galStatusColorPicker.
A propriedade padrão de galStatusColorPicker é definida como a cor do status com base no tema atual do Teams. Isso torna o ícone de etapa de seleção visível na cor do status atual, pois sua visibilidade é definida como ThisItem.IsSelected.
Selecionar galStatusColorPicker define locStatusColorPicker como falso e locSettingsChanged como verdadeiro.
Selecionar o botão Salvar salva todas as alterações na tela de configurações. Especificamente, no caso de status, os status existentes são filtrados com base na condição de que seu campo de ID não esteja em branco (o que significa que são registros existentes na tabela Status do projeto) e são atualizados usando uma instrução Patch.
A atualização da cor da prioridade ocorre da seguinte maneira:
Se o tema atual do Teams for escuro, as cores do modo escuro serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo padrão equivalente à cor selecionada pelo usuário. A coluna Cor escura é atualizada com a cor selecionada pelo usuário.
Se o tema atual do Teams for o padrão, as cores do modo padrão serão apresentadas ao usuário. Portanto, a coluna Cor é atualizada com a cor selecionada pelo usuário. A coluna Cor escura é atualizada por meio de uma pesquisa em colProjectCoverColors para encontrar o modo escuro equivalente à cor selecionada pelo usuário.
Adição de status
Esta seção explica as coleções, variáveis e detalhes de execução usados quando os valores de status são adicionados.
Adição de coleções de status
As coleções a seguir são usadas quando um status é adicionado.
| Nome da coleção | Descrição |
|---|---|
| colStatuses | Coleção de status. |
Adição de variáveis de status
As variáveis a seguir são usadas quando um status é adicionado.
| Nome da variável | Descrição |
|---|---|
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
| locGlobalSetting | Variável local para armazenar a configuração global que foi atualizada. |
| locGalleryDefaultStatus | Variável local usada para definir o valor da prioridade padrão na galeria galStatuses. |
Adição de detalhes de execução de status
Selecionar Adicionar adiciona um novo status a colStatuses e atualiza locSettingsChanged para verdadeiro, indicando que uma atualização foi feita na tela Configurações e assim ativando o botão Salvar.
A galeria galStatuses é redefinida usando a função Redefinir para rolar a galeria para o status recém-adicionado.
Selecionar o botão Salvar para criar registros na tabela Status do item de trabalho do projeto para cada registro em colStatuses com uma ID em branco.
Exclusão de status
Esta seção explica as coleções, variáveis e detalhes de execução usados quando um status é excluído.
Coleções envolvidas
As coleções a seguir são usadas quando um status é excluído.
| Nome da coleção | Descrição |
|---|---|
| colStatuses | Coleção de status. |
| colRemovedStatuses | Coleção de status a serem removidos. |
Variáveis envolvidas
As variáveis a seguir são usadas quando um status é excluído.
| Nome da variável | Descrição |
|---|---|
| locSettingsChanged | Variável local para armazenar se uma configuração de projeto foi alterada ou não. |
| locDeleteSettings | Variável local para controlar a visibilidade da tela de aviso de exclusão. |
| locSettingType | Variável local para determinar qual registro está sendo excluído. |
Exclusão de detalhes de execução de status
Selecionar o ícone de exclusão adiciona o registro de prioridade selecionado a colRemovedStatuses e atualiza locDeleteSettings para verdadeiro, exibindo assim o contêiner conWarning_Settings.
Marcar a caixa de seleção Entendo habilita o botão Excluir.
Selecionar Cancelar define locDeleteSettings como falso, fechando assim a caixa de diálogo de aviso.
Selecionar Excluir remove o status selecionado de colStatuses e da tabela Status de item de trabalho do projeto se ela tiver um ID (o que significa que é um status existente).
Consulte também
Comentários
Enviar e exibir comentários de