Entender a arquitetura do aplicativo de exemplo Instruções (versão preliminar)
[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]
Neste artigo, você saberá mais sobre as coleções e variáveis globais usadas pelo aplicativo Instruções e entenderá como usá-las de maneira eficaz.
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
Modelo de dados
O diagrama a seguir mostra as tabelas, colunas e relacionamentos na solução do aplicativo Instruções:

Tabelas
| Tabela | Descrição |
|---|---|
| Demonstração de Item | O aplicativo Instruções foi projetado para ajudar novos criadores a aprender a criar Power Apps. Esta tabela é fornecida como um exemplo da tabela que os usuários criarão para armazenar itens que estão disponíveis para check-out. |
| Demonstração de Check-out de Item | O aplicativo Instruções foi projetado para ajudar novos criadores a aprender a criar Power Apps. Esta tabela é fornecida como um exemplo da tabela que os usuários criarão para armazenar registros de check-out de item. |
| Demonstração de Tipo de Item | O aplicativo Instruções foi projetado para ajudar novos criadores a aprender a criar Power Apps. Esta tabela é fornecida como um exemplo da tabela que os usuários criarão para armazenar tipos de item para classificação de itens. |
| Estágios do Aplicativo de Check-Out de Itens | Conforme o usuário passa pelas lições no aplicativo, o aplicativo armazenará o status de seu progresso por meio do aplicativo, permitindo que o usuário retome de onde parou. |
| Instruções de Check-out de Item | As instruções para prosseguir com o aplicativo estão armazenadas na tabela de instruções de check-out do item. |
Modelo de arquitetura
O diagrama a seguir ilustra a maneira como as pessoas, sistemas e dados interagem com os dados na solução do aplicativo Instruções

Conectores
Os conectores a seguir são usados no aplicativo Instruções:
- Microsoft Dataverse – usado para ler e gravar dados no Dataverse.
- Office 365 Users – usado para ler dados de perfis de usuários do Microsoft 365.
Coleções
A seguinte coleção é usada na solução do aplicativo Instruçõ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 |
Variáveis globais
As tabelas a seguir são as variáveis globais usadas no aplicativo Instruções.
| Nome de Variável | Digitar | Descrição |
|---|---|---|
| gblUserLanguage | Texto | Para verificar o Idioma do Usuário conectado. |
| 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. |
| 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. |
| 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. |
| gblCurrUserEmail | Registro | Variável global para armazenar o endereço de email do usuário atual. |
| gblCurrUser | Registro | Variável global para armazenar o registro do usuário atual. |
Aplicativo OnStart
Esta seção explica as coleções, variáveis e detalhes de execução usados no OnStart do aplicativo Instruções:
Coleções OnStart
As seguintes coleções são usadas no início do aplicativo:
| Nome da coleção | Descrição |
|---|---|
| colLocalization | Coleção de texto localizado com base no idioma do usuário. |
Variáveis OnStart
As seguintes variáveis são usadas no início 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. |
| gblCurrUserEmail | - variável global para armazenar o endereço de email do usuário atual. |
| gblCurrUser | - variável global para armazenar o registro do 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.
Tela de Boas-Vindas
Esta seção explica as coleções, variáveis e detalhes de execução usados na tela de boas-vindas:
Coleções da tela de boas-vindas
As coleções a seguir são usadas na tela de boas-vindas:
| Nome da coleção | Descrição |
|---|---|
| colLocalization | coleção de texto localizado com base no idioma do usuário. |
Variáveis da tela de boas-vindas
As variáveis a seguir são usadas na tela de boas-vindas:
| Nome da variável | Descrição |
|---|---|
| gblCurrUserEmail | Variável global para armazenar o endereço de email do usuário atual |
| 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. |
| gblAppColors | Variável global para armazenar as cores do design do aplicativo |
| gblAppSizes | Variável global para armazenar os tamanhos de aplicativo para aplicativos móveis e móveis na Web |
| gblAppStyles | Variável global para armazenar propriedades de estilo para todos os controles (definida no OnVisible da tela de carregamento). |
| 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. |
Detalhes de execução da tela de boas-vindas
Se gblAppStyles não está em branco (o que significa que a variável de estilo foi carregada).
A tela de carregamento irá inicializar todas as variáveis globais como gblAppStyles, gblAppSizes, gblAppColors para mostrar as configurações de tela e cores de acordo com a configuração do usuário, como modo escuro ou modo de alto contraste no Teams para área de trabalho ou no navegador.
Nesta tela, você encontrará Visualizar Aplicativo. Selecioná-lo redirecionará para a Tela Ativos.
Tela Itens
Esta seção explica as coleções, variáveis e detalhes de execução usados na tela de itens.
Coleções da tela Itens
As coleções a seguir são usadas na tela de itens do painel:
| Nome da variável | Descrição |
|---|---|
| colLocalization | Coleção de texto localizado com base no idioma do usuário. |
Variáveis da tela Itens
As variáveis a seguir são usadas na tela de itens do painel:
| Nome da variável | Descrição |
|---|---|
| locShowItems | Variável local para mostrar os itens com base no tipo de item. |
| locSelectedItemType | Variável local para mostrar os tipos de item selecionados. |
| 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. |
| gblAppColors | Variável global para armazenar as cores do design do aplicativo. |
| gblAppStyles | Variável global para armazenar propriedades de estilo para todos os controles (definida no OnVisible da tela de carregamento). |
Detalhes de execução da tela Itens
A tela de itens mostrará os tipos de item com o número de itens disponíveis em cada item que estão armazenados em galItemTypes_Demo.
Os itens serão mostrados em galItems_Demo quando o usuário selecionar qualquer um dos tipos de item em galItemTypes_Demo.
Tela de Check-out
Esta seção explica as coleções, variáveis e detalhes de execução usados na tela de check-out.
Coleções da tela Check-out
As coleções a seguir são usadas na tela de check-out:
| Coleções | Descrição |
|---|---|
| colLocalization | coleção de texto localizado com base no idioma do usuário. |
Coleções da tela Check-out
As variáveis a seguir são usadas na tela de check-out:
| Nome da variável | Descrição |
|---|---|
| gblAppStyles | variável global para armazenar propriedades de estilo para todos os controles. |
| gblThemeDark | variável global para armazenamento se o Teams estiver sendo executado no modo escuro. |
| locShowCheckoutConfirmation | variável local para mostrar a conexão embaralhando aleatoriamente o ID do usuário. |
| gblAppColors | variável global para armazenar as cores do design do aplicativo. |
| gblThemeHiCo | variável global para armazenamento se o Teams estiver sendo executado no modo de contraste. |
| locSelectedItem | variável global para armazenar o endereço de email do usuário atual. |
Detalhes de execução da tela Check-out
Quando o usuário seleciona qualquer um dos itens necessários, ele pode selecionar o check-out com base na disponibilidade do item que está armazenado no item locSelectedItem.
Depois que o item for retirado, a mensagem de confirmação será exibida em locShowCheckoutConfirmation.
Tela Meu Check-out
Esta seção explica as coleções, variáveis e detalhes de execução usados na tela Meu check-out.
Coleções da tela Meu check-out
As coleções a seguir são usadas na tela Meu check-out:
| Nome da variável | Descrição |
|---|---|
| colLocalization | coleção de texto localizado com base no idioma do usuário. |
Minhas variáveis de check-out
As variáveis a seguir são usadas na tela Meu check-out:
| Nome da variável | Descrição |
|---|---|
| gblAppStyles | Variável global para armazenar propriedades de estilo para todos os controles (definida no OnVisible da tela de carregamento). |
| 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. |
| gblAppColors | Variável global para armazenar as cores do design do aplicativo. |
| locShowReturnConfirmation | Variável local para mostrar a mensagem de confirmação de devolução quando o usuário seleciona o botão de devolução. |
| locSelectedItemType | Variável local para mostrar os tipos de item selecionados. |
| locShowItems | Variável local para mostrar os itens com base nos tipos de item. |
| gblCurrUser | Variável global para armazenar o registro do usuário atual. |
| locSelectedItemForReturn | Variável local para devolver o item selecionado aos itens. |
Detalhes de execução de Meu check-out
Todos os itens dos quais o usuário fez check-out serão mostrados nesta tela. O usuário terá a opção de devolver e mostrar os dias devidos para devolução
Depois que o usuário selecionar devolver, o item será devolvido à tela de itens.
Consulte também
- Usar o aplicativo de exemplo Instruções (versão preliminar)
- Personalizar aplicativos de exemplo
- Perguntas frequentes sobre aplicativos de exemplo
- Usar aplicativos de exemplo da loja do Microsoft Teams
Observação
Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)
A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).
Comentários
Enviar e exibir comentários de