Criar, atualizar, excluir e relacionar ações
Você pode usar o conector do Dataverse para criar novas linhas, modificar linhas existentes e relacionar dados usando os relacionamentos definidos. Quando necessário, você pode usar a ação de exclusão para remover linhas.
Criar novas linhas
Use a ação Adicionar uma nova linha para criar novas linhas em uma tabela do Dataverse. Você precisa escolher um nome de tabela, e a ação mostra dinamicamente as colunas superiores dessa tabela. As colunas obrigatórias são indicadas com um asterisco vermelho próximo ao nome da coluna. Não é possível salvar o fluxo sem fornecer informações para cada coluna obrigatória. Uma coluna obrigatória é qualquer coluna da tabela configurada como Obrigatória para Negócios. Se você marcar outras colunas como Obrigatória para Negócios após criar um fluxo, será necessário atualizar sua ação na próxima vez que atualizar a coluna para poder salvar o fluxo.
Apenas algumas colunas são exibidas automaticamente na guia Parâmetros de ação. As colunas restantes estão em parâmetros avançados.
Atualizar linhas
Use a ação Atualizar uma linha para atualizar uma linha de dados existente. Além disso, você pode usar a ação para upsert (atualizar ou inserir) quando a ID não corresponde a uma linha existente; a ação pode criar uma nova linha.
A ID da linha é necessária na ação Atualizar uma linha, e você só precisa atualizar o GUID da linha de dados. Se você estiver obtendo a ID da linha de outro gatilho ou ação do conector do Dataverse, a ID da linha deverá ter o mesmo nome que a tabela, e a descrição da coluna será o Identificador Exclusivo da tabela. Não use a coluna OData ID, que é diferente.
Diferentemente da ação Adicionar uma nova linha, que requer colunas, a ação Atualizar uma linha não requer colunas. No entanto, você só deverá alterar os valores das colunas quando os dados forem alterados. Por exemplo, passar a coluna Nome da conta quando ela não for alterada fará com que outras automações procurem alterações na tabela de contas a ser executada.
Para limpar um valor de coluna existente, altere a coluna na ação para usar uma expressão nula.
Relacionar dados
Você pode usar o Dataverse para criar relacionamentos um para muitos (ou muitos para um, se considerar o relacionamento na outra direção) e muitos para muitos entre linhas da tabela. Duas opções estão disponíveis para você relacionar linhas de dados, dependendo do tipo de relacionamento e da linha do relacionamento com a qual você está trabalhando.
Ao usar as ações Adicionar uma nova linha ou Atualizar uma linha, você pode atualizar colunas de pesquisa na linha de dados que está adicionando ou atualizando. Por exemplo, a tabela Conta tem uma coluna de pesquisa de contato principal que representa um relacionamento muitos para um com Contato. Ao adicionar ou atualizar uma conta, você também pode estabelecer o relacionamento com o contato na mesma ação. Você não poderá estabelecer esse relacionamento se estiver adicionando ou atualizando a linha Contato, pois ela não tem a coluna de pesquisa. A outra opção é usar a ação Relacionar linhas para estabelecer o relacionamento separadamente.
Você só pode estabelecer relacionamentos muitos para muitos usando a ação Relacionar linhas. O motivo é que nenhuma das linhas no relacionamento tem uma coluna de pesquisa para a qual você pode definir o valor nas ações Adicionar uma nova linha ou Atualizar uma linha.
Especificar a ID para cada linha
Ao relacionar linhas de dados, você precisa fornecer o GUID (identificador global exclusivo) da linha ou uma URL de linha. Observe a diferença, pois o fornecimento do GUID ou da URL errados resulta em erro.
Você pode obter o GUID (por exemplo, fd140aaf-4df4-11dd-bd17-0019b9312238) de uma linha que está na saída de uma etapa anterior do fluxo. Para isso, selecione o GUID do conteúdo dinâmico procurando a coluna com o mesmo nome de sua tabela e uma descrição que indica Identificador exclusivo para tablename.
Para obter a URL da linha, pesquise na lista de conteúdo dinâmico a OData ID com uma descrição de ID da linha do OData. Você pode compor manualmente uma URL de linha combinando o nome do conjunto de entidades OData da tabela com o GUID. O nome do conjunto de entidades geralmente é o nome lógico da tabela com a letra “s” adicionada. Assim, o nome lógico da tabela Conta é conta; portanto, o nome do conjunto de entidades seria contas. Uma maneira rápida de encontrar o nome de uma tabela é adicionar uma ação do Dataverse, definir a tabela com o nome da tabela cujo nome do conjunto de entidades você deseja saber e alternar para a exibição de código. Na exibição de código, o valor EntityName é o nome do conjunto de entidades necessário para criar uma URL de linha OData. A URL da linha OData deve ser semelhante ao seguinte exemplo:
contoso_projects(fd140aaf-4df4-11dd-bd17-0019b9312238)
Usar a ação Adicionar ou atualizar uma linha
Ao usar a ação Adicionar ou atualizar uma linha, você precisa especificar a URL da linha com a qual está criando o relacionamento.
A captura de tela a seguir mostra como definir o contato principal em uma linha de conta usando OData ID.
A captura de tela a seguir mostra como definir o contato principal em uma linha da conta usando a ID da linha.
Usar a ação Relacionar linhas para estabelecer um relacionamento um para muitos
Ao usar a ação Relacionar linhas para estabelecer um relacionamento entre duas linhas, você precisa determinar qual tabela selecionar na ação. Em um relacionamento um para muitos, você usaria a tabela de um lado do relacionamento. Por exemplo, considere uma situação em que as linhas da conta tenham um contato principal. A linha Conta pode estar relacionada a apenas uma linha de Contato desse relacionamento, o que coloca a linha Contato em um lado do relacionamento.
Em seguida, forneça a ID da linha da tabela que você configurou. Esse valor é um ID de linha, não uma URL; portanto, você precisa fornecer apenas o GUID (por exemplo, fd140aaf-4df4-11dd-bd17-0019b9312238).
As tabelas podem ter vários relacionamentos; portanto, você deve escolher qual relacionamento estabelecerá em seguida. Se precisar de ajuda para o nome, você poderá consultar as propriedades da tabela do relacionamento para encontrar o nome do relacionamento.
A última etapa é configurar a propriedade Relacionar com. Essa propriedade é uma URL de linha; portanto, você pode usar a coluna OData ID de uma etapa anterior ou fornecer a URL completa manualmente, como contoso_projectsfd140aaf-4df4-11dd-bd17-0019b9312238.
Use a ação Relacionar linhas para estabelecer um relacionamento muitos para muitos
Ao trabalhar com um relacionamento muitos para muitos, você pode determinar qual tabela especificar na ação observando as propriedades da tabela do relacionamento. A tabela que está na coluna Relacionar na lista de relacionamentos é o nome da tabela que você deve escolher ao estabelecer um relacionamento muitos para muitos entre duas linhas.
Para a opção Relacionar com, use a URL da linha da outra linha da tabela.
