LIÇÃO 10Criando sua Primeira Tabela Customizada

Tabela: Produto Atendido

Vamos criar uma tabela para registrar o produto específico que gerou o caso — com número de série, modelo, data de instalação e garantia vigente. Essa informação não existe na tabela Case padrão e é fundamental para empresas de suporte técnico industrial.

Passo a passo

1. Abra sua Solução e crie a tabela

   → make.powerapps.com → Solutions → Minha Primeira Solução
   → Clique em + New → Table → Table

   Display Name: Produto Atendido
   Plural Display Name: Produtos Atendidos
   Primary column name: Nome do Produto

   Clique em Save. O Dataverse cria a tabela com o nome técnico pm_produtoatendido e a coluna primária pm_nomeproduto automaticamente.

   Sempre crie dentro de uma Solução: Criar a tabela fora de uma solução coloca-a na solução Default — dificulta o deploy futuro e a manutenção. Sempre abra sua Solução antes de criar qualquer componente.
2. Adicione a coluna Número de Série

   → Na tabela criada, clique em + New column

   Display Name: Número de Série
   Data type: Single line of text
   Required: Business Required

   Clique em Save.

   Business Required vs. System Required: Business Required exige preenchimento no formulário mas pode ser ignorado via API. System Required bloqueia em qualquer nível — inclusive via API e Power Automate. Use Business Required para campos obrigatórios nos formulários.
3. Adicione Modelo, Data de Instalação e Garantia

   Repita o processo para as três colunas restantes:

   Coluna 1: Modelo → Single line of text → Optional
   Coluna 2: Data de Instalação → Date Only → Optional
   Coluna 3: Garantia Vigente → Yes/No → Optional (padrão: No)

   Clique em Save após cada coluna.

4. Adicione o relacionamento com a tabela Case

   → Na tabela Produto Atendido, clique na aba Relationships
   → Clique em + New relationship → Many-to-one

   Related table (one): Case
   Lookup column display name: Caso Relacionado
   Lookup column name: pm_casorelacionado

   Clique em Done e depois em Save Table.

   Many-to-one (N:1): Muitos Produtos Atendidos podem estar relacionados a um Caso. Um produto tem um caso; um caso pode ter vários produtos. Este é o relacionamento mais comum no Dataverse.
5. Crie um registro de teste

   → Na tabela Produto Atendido, clique na aba Data
   → Clique em + Add row

   Nome do Produto: Motor Elétrico W22
   Número de Série: SN-20240001
   Modelo: W22-100L
   Data de Instalação: 01/03/2024
   Garantia Vigente: Yes

   Salve o registro. Você criou o primeiro dado em uma tabela 100% personalizada — que não existia antes desta lição.

6. Adicione o subgrid de Produtos Atendidos no formulário de Caso

   → make.powerapps.com → Tables → Case → Forms
   → Abra seu formulário customizado "Portal Pos-Venda"
   → No editor, clique em + Component no menu superior
   → Escolha Subgrid

   Table: Produto Atendido
   Default View: Active Produtos Atendidos
   Label: Produtos Atendidos neste Caso

   Arraste o subgrid para a posição desejada no formulário e clique em Save and Publish.

   O resultado: Agora, dentro de um Caso no Dynamics, existe uma seção "Produtos Atendidos neste Caso" onde o agente pode vincular um ou mais produtos ao chamado — com número de série, modelo, data de instalação e status de garantia.

Checklist

• Criou a tabela Produto Atendido dentro da sua Solução
• Adicionou as 5 colunas customizadas com os tipos corretos
• Criou o relacionamento N:1 com a tabela Case
• Inseriu um registro de teste na aba Data
• Adicionou o subgrid de Produtos Atendidos no formulário de Caso
• Sabe a diferença entre Business Required e System Required

Quando criar uma tabela customizada vs. adicionar colunas na tabela existente

Regra geral: se os dados têm vida própria (podem existir sem estar vinculados a um caso específico, ou podem estar vinculados a vários casos), crie uma tabela separada. Se os dados são atributos diretos do caso (só existem no contexto daquele caso), adicione colunas na tabela Case.