Trabalhar com arquivos e imagens

  • 9 minutos

O Dataverse tem tipos de dados de coluna específicos para arquivos e imagens. Ao usar esses tipos de dados, você deve usar ações separadas para modificar os valores da coluna e acessar o conteúdo completo dos dados da coluna.

Você usa a ação Carregar um arquivo ou imagem para modificar uma coluna de linha de dados existente com o conteúdo de um arquivo ou imagem. Ao criar novas linhas de dados, primeiro você usa a ação Adicionar uma linha para criar a linha e usa a ID da linha na ação de upload para modificar as colunas do arquivo ou da imagem.

Você usa a ação Baixar um arquivo ou imagem para obter acesso total ao conteúdo dos dados binários para qualquer tipo de dados. Você pode recuperar a miniatura e uma URL de imagem usando a ação Obter linha por id ou a ação Listar linhas ao trabalhar com colunas de imagem. A miniatura contém os dados binários para uma versão de imagem pequena; você pode usá-la nas etapas subsequentes da lista de conteúdo dinâmico. A miniatura está na lista de colunas de conteúdo dinâmico com um nome que corresponde ao nome de exibição da coluna de imagem, por exemplo, Imagem do Produto. Você também pode obter uma URL para baixar a imagem usando as ações obter ou listar linhas. Lembre-se de que a URL de download se destina a usuários autorizados e não seria apropriado expô-la a usuários que não sejam do Dataverse. Essa propriedade não é exibida no conteúdo dinâmico; portanto, você deve criar uma expressão de fluxo de trabalho para acessar o valor. O formato do item que você referenciaria é o nome lógico da coluna mais "_url". O seguinte presume um nome lógico de coluna de entityimage e obtém o valor dos resultados de uma ação Listar linhas.

item()?['entityimage_url']

Isso recuperaria a seguinte URL

/Image/download.aspx?Entity=sample_product&Attribute=entityimage&Id=27f5c0ed-b221-e811-a845-000d3a33a3ac&Timestamp=638371120614954283

Exercício: trabalhar com arquivos

No exercício a seguir, você cria um fluxo que cria uma nova linha da tabela Produto e carrega uma imagem para o produto. Em seguida, o fluxo consulta quaisquer novos produtos, baixa a imagem de cada um e usa o AI Builder para gerar uma descrição.

Pré-requisitos

Acesso a um ambiente com o Dataverse com aplicativos de exemplo instalados, caso você queira fazer o exercício a seguir.

Tarefa: criar fluxo

  1. Navegue até o Power Automate e selecione o ambiente correto.

  2. Selecione Criar na navegação esquerda e selecione Fluxo da nuvem instantâneo.

    Captura de tela mostrando o botão de criação de fluxo da nuvem instantâneo.

  3. Insira Adicionar Novo Produto para o Nome do fluxo, selecione Disparar manualmente um fluxo e selecione Criar.

    Captura de tela mostrando a caixa de diálogo de criação de fluxo instantâneo.

  4. Selecione o gatilho, altere o nome do gatilho para Adicionar produto e selecione Adicionar uma entrada.

    Captura de tela mostrando o botão adicionar uma entrada.

  5. Selecione Texto para o tipo de entrada.

  6. Nomeie a entrada como Nome do Produto e selecione Adicionar uma entrada novamente.

  7. Selecione Arquivo para o tipo de entrada.

  8. Agora o gatilho deve ter duas entradas. Selecione o botão Inserir uma nova etapa e selecione Adicionar uma ação.

    Captura de tela mostrando o botão adicionar uma ação.

  9. Procure "adicionar linha" e selecione Adicionar uma nova linha no conector do Microsoft Dataverse.

  10. Renomeie a etapa Adicionar uma nova linha de produto e selecione Produtos para Nome da Tabela.

  11. Digite / no campo Nome e selecione Inserir Conteúdo Dinâmico.

    Captura de tela mostrando a opção inserir conteúdo dinâmico.

  12. Selecione Product Name no painel de conteúdo dinâmico.

    Captura de tela mostrando o nome do produto selecionado.

  13. Selecione o botão Inserir uma nova etapa e selecione Adicionar uma ação.

  14. Procure a imagem de upload e selecione Carregar um arquivo ou imagem do conector do Microsoft Dataverse.

  15. Renomeie a ação Carregar imagem do produto, digite / no campo Nome do Conteúdo e selecione Inserir Conteúdo Dinâmico.

  16. Selecione File Content name no painel de conteúdo dinâmico.

  17. Selecione Produtos para Nome da Tabela, digite / no campo ID da Linha e selecione Inserir Conteúdo Dinâmico.

  18. Selecione Product no painel de conteúdo dinâmico.

  19. Selecione Imagem do Produto para Nome da Coluna.

  20. Digite / no campo Conteúdo e selecione Inserir Conteúdo Dinâmico.

  21. Selecione File Content contentBytes no painel de conteúdo dinâmico.

  22. Agora a ação de upload da imagem do produto deve ser semelhante a esta imagem. Selecione o botão Inserir uma nova etapa e selecione Adicionar uma ação.

    Captura de tela mostrando a ação de upload da imagem do produto.

  23. Procure linhas de lista e selecione Listar linhas no conector do Microsoft Dataverse.

  24. Renomeie a etapa Listar produtos, selecione Produtos para Nome da Tabela e selecione o botão Mostrar tudo.

  25. Cole esta expressão no campo Filtrar Linhas. Essa configuração filtra as linhas retornadas apenas para aquelas criadas hoje.

    Microsoft.Dynamics.CRM.Today(PropertyName='createdon')

    Captura de tela mostrando o valor das linhas de filtro.

  26. Selecione o botão Inserir uma nova etapa e selecione Adicionar uma ação.

  27. Pesquise baixar e selecione Baixar um arquivo ou imagem do conector do Microsoft Dataverse.

  28. Renomeie a etapa Baixar imagem do produto e selecione Produtos para Nome da Tabela.

  29. Digite / no campo ID da linha e selecione Inserir Conteúdo Dinâmico.

  30. Selecione Product da Lista de produtos no painel de conteúdo dinâmico.

    Captura de tela mostrando a ID do produto.

  31. O Power Automate deve criar For each e adicionar a ação Gerar descrição de uma imagem dentro de For each. Selecione Imagem do Produto para Nome da Coluna.

  32. Selecione o botão Inserir uma nova etapa dentro de For each e selecione Adicionar uma ação.

    Captura de tela mostrando Adicionar um botão de ação dentro de for each.

  33. Procure gerar e selecione Gerar descrição de uma imagem do conector do AI Builder.

  34. Digite / no campo Imagem e selecione Inserir Conteúdo Dinâmico.

  35. Selecione File or image content no painel de conteúdo dinâmico.

  36. Selecione o botão Inserir uma nova etapa dentro de For each e selecione Adicionar uma ação.

    Captura de tela mostrando o botão Adicionar uma ação após a etapa de geração de descrição.

  37. Procure a linha de atualização e selecione Atualizar uma linha no conector do Microsoft Dataverse.

  38. Renomeie a etapa Atualizar descrição do produto, selecione Produtos para Nome da Tabela, digite / no campo ID da linha e selecione Inserir Conteúdo Dinâmico.

  39. Selecione Product da Lista de produtos no painel de conteúdo dinâmico.

  40. Selecione Mostrar tudo.

  41. Localize o campo Descrição do Produto 1, digite / e selecione Inserir Conteúdo Dinâmico.

  42. Selecione a Descrição de Gerar descrição de uma imagem no painel de conteúdo dinâmico.

    Captura de tela mostrando a descrição da imagem do AI Builder.

  43. Agora o fluxo concluído deve ser semelhante a esta imagem. Selecione Salvar e aguarde até que o fluxo seja salvo.

    Captura de tela mostrando o fluxo concluído.

  44. Selecione Testar

  45. Selecione Manualmente e, em seguida, Testar.

  46. Digite Novo Surface Laptop para Nome do Produto e selecione Importar.

  47. Selecione qualquer imagem do computador.

  48. Selecione Executar fluxo após selecionar uma imagem.

  49. Selecione Concluído.

  50. A execução do fluxo deve ser bem-sucedida.

  51. Navegue até o Power App maker portal e selecione o ambiente correto.

  52. Selecione Aplicativos e inicie o aplicativo Check-out do Ativo.

  53. Localize a linha Novo Surface Laptop do fluxo criado e abra-a.

  54. Você deverá ver a imagem que carregou e a descrição gerada pelo AI Builder da imagem.

    Captura de tela mostrando a imagem carregada e a descrição gerada pelo AI Builder.