Gerir dados na sua aplicação (pré-visualização)

As aplicações frequentemente precisam de dados, como tarefas, ativos, pedidos ou registos de clientes. Quando cria uma aplicação no Microsoft Copilot Studio, pode começar com dados de exemplo, guardar informações no navegador ou ligar a aplicação a uma fonte de dados organizacional.

Este artigo explica as formas comuns como uma aplicação funciona com dados e como as ligações, identidade e permissões afetam as pessoas que a utilizam.

Formas comuns como as aplicações funcionam com dados

Uma aplicação pode usar uma ou mais das seguintes abordagens.

Algumas aplicações não precisam de armazenamento de dados. Por exemplo, uma calculadora ou conversor unitário pode produzir resultados sem os guardar. Uma aplicação pode também usar múltiplas fontes, sujeitas às capacidades e políticas do seu ambiente.

Escolha uma abordagem baseada em dados

Use as seguintes perguntas para decidir como a aplicação deve funcionar com os dados:

Comece com dados de amostra

Se não ligares uma fonte existente, o Copilot Studio pode gerar dados de amostra que correspondem à aplicação que descreveste. Os dados de exemplo facilitam a visualização e o teste de uma versão inicial da aplicação.

Trate os dados de exemplo como conteúdo representativo, não como um local para armazenar registos empresariais. Alterações feitas ao usar dados de amostra podem reiniciar quando a aplicação recarrega ou quando o Copilot Studio regenera parte da aplicação.

Registos de amostra também podem ser incluídos na própria aplicação gerada. Como resultado, atualizar a pré-visualização da aplicação não é uma forma fiável de determinar onde uma aplicação armazena os seus dados. Revise os Dados e Ligações da aplicação antes de confiar nela para reter a informação.

Armazene os dados da aplicação no navegador

Algumas aplicações autónomas podem armazenar informação no navegador. Os dados locais do navegador podem permanecer após uma atualização, mas não são o mesmo que dados organizacionais ligados.

Dados locais do navegador em geral:

• Está disponível apenas no perfil do navegador onde o criaste
• Não é partilhado automaticamente com outros utilizadores da aplicação
• Pode não estar disponível noutro dispositivo
• Não é gerido como um registo de dados do SharePoint, do Dataverse ou de outros dados ligados

Use uma fonte de dados organizacional quando precisar de partilhar registos, gerir dados centralmente ou disponibilizar dados entre dispositivos.

Armazenar e utilizar dados organizacionais

Os dados organizacionais ligados podem suportar dois fluxos de trabalho relacionados:

• Armazenar registos que as pessoas criam ou atualizam através da aplicação
• Trabalhar com tabelas que a sua organização já utiliza

A configuração pode variar consoante a fonte de dados. O Copilot Studio gere o processo de ligação suportado e gera a configuração da aplicação necessária para trabalhar com os dados selecionados. Uma tabela ligada pode conter registos existentes e continuar a receber novos registos da aplicação.

Use listas do SharePoint

Use listas do SharePoint quando a sua aplicação precisar de dados simples e em forma de lista da equipa. Dependendo do cenário de pré-visualização suportado, o Copilot Studio pode ligar a aplicação a uma lista existente ou criar novas listas num site SharePoint que possa usar.

O Copilot Studio poderá perguntar que registos da aplicação pretende armazenar, se pretende utilizar um site do SharePoint existente e a que site as listas devem pertencer. Criar ou utilizar uma ligação pode exigir a sua aprovação e a sua permissão para o site e as listas selecionados.

Utilizar dados de tabelas Dataverse existentes

Use o Dataverse quando a aplicação deve funcionar com dados organizacionais estruturados que a sua organização já gere num ambiente Power Platform. Em pré-visualização, o Copilot Studio liga aplicações a tabelas Dataverse existentes.

O Copilot Studio pode pedir-lhe para selecionar um ambiente, tabela e ligação do Dataverse. Deve ter permissão para usar a tabela selecionada e realizar as operações que a aplicação exige.

Compare listas SharePoint e Dataverse

Tanto as listas SharePoint como o Dataverse armazenam dados organizacionais sob governação de administrador, mas servem necessidades diferentes. Se ambas as opções estiverem disponíveis, utilize a comparação seguinte para escolher a que melhor se adequa.

Depois de ligar uma tabela SharePoint ou Dataverse, reveja os Dados e Ligações da aplicação para confirmar qual a fonte que utiliza.

Liga-te a outras tabelas existentes

Se a sua organização já tiver os dados que a aplicação precisa, peça ao agente para ligar a aplicação a essa fonte. Para além do SharePoint e do Dataverse, uma aplicação pode trabalhar com outras fontes tabulares disponíveis no seu ambiente, como Excel ou SQL.

As ligações de dados permitem que uma aplicação leia ou escreva linhas numa fonte estruturada. A configuração exata varia consoante a origem, mas o Copilot Studio orienta-te na seleção dos dados e da ligação que a aplicação deve usar.

Saiba mais sobre as diferentes formas como uma aplicação pode usar um ficheiro Excel ou CSV em Trabalhar com ficheiros Excel e CSV. Outras fontes tabulares também podem estar disponíveis. A disponibilidade depende do ambiente da aplicação. Revise e teste o resultado antes de publicar a aplicação, especialmente quando os utilizadores podem adicionar, atualizar ou eliminar registos.

Alterar ou atualizar uma ligação de dados

Se a fonte, a estrutura da tabela ou a ligação mudarem, peça ao agente para atualizar a ligação de dados da aplicação. Revise os campos atualizados e teste a aplicação novamente antes de publicar. Evite alterar diretamente o código de ligação gerado.

Disponibilidade de ligação e políticas de administrador

As aplicações podem usar fontes de dados e ligações que estão disponíveis e permitidas no seu ambiente. As políticas de dados e outros controlos do administrador determinam quais as fontes e ligações disponíveis.

As aplicações do Copilot Studio podem ter acesso a um subconjunto do catálogo mais amplo de conectores. Saiba como os administradores classificam e controlam conectores nas políticas de dados.

Uma fonte de dados ou ligação pode não estar disponível por uma destas razões:

• Uma política bloqueia-o.
• O catálogo de conectores do ambiente não o inclui.
• A ligação necessária não existe.
• A tua conta não tem permissão para o usar.
• A licença necessária não está disponível.

Contacte o seu administrador se esperar que uma fonte de dados esteja disponível mas não a possa selecionar ou usar.

Trabalhar com ficheiros Excel e CSV

Pode usar ficheiros de várias formas, dependendo se pretende fornecer contexto, ligar dados em tempo real ou permitir que os utilizadores da aplicação carreguem um ficheiro.

Anexe um ficheiro enquanto cria uma aplicação

Selecione + no Chat para anexar um ficheiro que dê mais contexto ao agente. Por exemplo, um livro de exercícios pode ajudar o agente a compreender os campos e informações que a aplicação deve mostrar. Anexar um ficheiro como contexto não cria uma ligação duradoura a esse ficheiro.

Ligar uma tabela do Excel

Quando o conector Excel está disponível, o Copilot Studio pode ligar uma aplicação a uma tabela num livro de exercícios Excel. Esta ligação utiliza dados em tempo real em vez de um ficheiro anexo único. O livro deve conter uma tabela do Excel definida, e a disponibilidade e as permissões dos conectores continuam a ser aplicáveis.

Adicionar carregamento de ficheiro a uma aplicação

O Copilot Studio também pode gerar uma experiência de aplicação em que o utilizador seleciona um ficheiro Excel ou CSV para a aplicação processar no navegador. Neste cenário, o ficheiro é introduzido na aplicação em execução. Não se torna automaticamente uma fonte de dados partilhada centralmente ou continuamente sincronizada.

Compreender a identidade e as permissões

As aplicações acedem aos dados associados em nome do utilizador com sessão iniciada.

Esta condição significa:

• A aplicação não dá automaticamente a alguém acesso a dados que não poderia usar de outra forma.
• Diferentes utilizadores podem ver dados diferentes com base nas suas permissões.
• Um utilizador pode precisar de criar ou consentir uma ligação na primeira utilização da aplicação.
• Uma operação de dados ligados pode falhar se o utilizador não tiver permissão para a realizar.

Antes de publicar, teste a aplicação com uma conta que tenha permissões semelhantes às dos utilizadores pretendidos.

Preparar os dados da aplicação para publicação

Um fluxo de trabalho comum é:

1. Descreva a aplicação e reveja a pré-visualização da aplicação.
2. Aperfeiçoe os campos, ecrãs e ações utilizando dados de exemplo ou dados locais do navegador.
3. Ligue uma fonte de dados organizacional, esteja ela configurada para a aplicação ou já exista.
4. Revise os Dados e Ligações da aplicação.
5. Teste com contas que representem os utilizadores pretendidos.
6. Publique o aplicativo.
7. Partilhe a aplicação e confirme separadamente que os seus utilizadores podem aceder aos dados subjacentes.

Também pode começar diretamente a partir de dados organizacionais existentes quando já sabe qual a fonte que a aplicação deve usar.

Gerir ligações na sua aplicação

Quando uma aplicação funciona com uma fonte organizacional ou um serviço externo, faz-no através de um conector — um link pré-construído para um serviço como Outlook, SharePoint ou Dataverse. Uma ligação é a ligação autorizada entre a sua aplicação e um desses conectores. Os conectores estão disponíveis para uma vasta gama de serviços da Microsoft e de terceiros; para os explorar, consulte a referência do conector.

Não se criam ligações manualmente. Descreva o que quer que a aplicação faça, e o Copilot Studio adiciona o conector que a aplicação precisa. Por exemplo, pedir à aplicação para enviar uma mensagem quando um registo é adicionado é o que adiciona uma ligação a um conector de correio. Para remover, basta pedir no chat para remover a ligação estabelecida.

As conexões afetam os utilizadores da sua aplicação das seguintes formas.

Se um conector que espera não estiver disponível, uma política de administrador é a razão mais comum. Contacte o seu administrador para saber quais os conectores permitidos no seu ambiente.

Verifique as ligações na sua aplicação

Para ver que ligações a sua aplicação utiliza, selecione o nome da aplicação na barra de comandos e depois selecione Ligações. Cada ligação apresenta o ícone do conector, o nome e uma breve descrição do que faz. Pode pesquisar na lista por nome ou descrição.

Resolução de problemas de dados e ligações na sua aplicação

• As alterações desaparecem quando a aplicação recarrega. A aplicação pode estar a usar dados de amostra ou outra fonte de dados temporária. Reveja os seus Dados e Ligações e peça ao agente que ligue uma fonte de dados organizacional.
• Os dados permanecem após a atualização, mas outros utilizadores não os conseguem ver. A aplicação pode estar a usar armazenamento local no navegador. A informação local do navegador não é partilhada automaticamente entre utilizadores, navegadores ou dispositivos.
• Não existe fonte de dados ou ligação disponível. A fonte de dados pode estar indisponível ou bloqueada no ambiente. Confirma que a ligação existe e que a política do administrador, permissões e licenças a permitem.
• Um utilizador pode abrir a aplicação, mas não consegue ver os seus dados. Abrir a aplicação não dá acesso aos dados subjacentes da aplicação. Confirme que o utilizador tem acesso à lista do SharePoint, à tabela do Dataverse, ao livro ou a outra origem e que deu o seu consentimento para qualquer ligação necessária.
• Alterações a um ficheiro anexado não aparecem na aplicação. Um ficheiro anexado fornece contexto para a criação da aplicação, mas não é automaticamente uma ligação ativa. Ligue a tabela do Excel através de um conector disponível, se a aplicação precisar de ler os dados atuais do livro.
• Uma fonte ligada mudou, mas a aplicação continua a usar uma estrutura mais antiga. A ligação gerada pode precisar de ser atualizada ou recriada para que a aplicação possa usar o esquema atualizado. Revise a fonte e a ligação antes de alterar manualmente o código da aplicação gerado.

Informações relacionadas

• Crie uma aplicação no Microsoft Copilot Studio
• Publique e partilhe uma aplicação no Microsoft Copilot Studio