Descrição geral dos conectores de aplicações baseadas em telas para o PowerAppsOverview of canvas-app connectors for PowerApps

Os dados são o núcleo da maioria das aplicações, incluindo os criados no PowerApps.Data is at the core of most apps, including those you build in PowerApps. Os dados são armazenados numa origem de dados e coloca esses dados na sua aplicação através da criação de uma ligação.Data is stored in a data source, and you bring that data into your app by creating a connection. A ligação utiliza um conector específico para comunicar com a origem de dados.The connection uses a specific connector to talk to the data source. O PowerApps tem conectores para inúmeros serviços populares e origens de dados no local, incluindo o SharePoint, SQL Server, Office 365, Salesforce e Twitter.PowerApps has connectors for many popular services and on-premises data sources, including SharePoint, SQL Server, Office 365, Salesforce, and Twitter. Para começar a adicionar dados a uma aplicação baseada em telas, veja Adicionar uma ligação de dados no PowerApps.To get started adding data to a canvas app, see Add a data connection in PowerApps.

Um conector pode disponibilizar tabelas de dados ou ações.A connector may provide tables of data or actions. Alguns conectores só disponibilizam tabelas, outros só disponibilizam ações e outros disponibilizam ambos.Some connectors provide only tables, some provide only actions, and some provide both. Além disso, o seu conector pode ser um conector padrão ou personalizado.Also your connector may be either a standard or custom connector.

TabelasTables

Se o seu conector disponibilizar tabelas, adicione a sua origem de dados e, em seguida, selecione a tabela na origem de dados que quer gerir.If your connector provides tables, you add your data source and then select the table in the data source that you want to manage. O PowerApps obtém dados das tabelas na sua aplicação e também atualiza os dados na sua origem de dados.PowerApps both retrieves table data into your app and updates data in your data source for you. Por exemplo, pode adicionar uma origem de dados que contém uma tabela chamada Lições e, em seguida, defina a propriedade Itens de um controlo, como uma galeria ou um formulário, para este valor na barra de fórmulas:For example, you can add a data source that contains a table named Lessons and then set the Items property of a control, such as a gallery or a form, to this value in the formula bar:

Propriedade Itens da origem de dados simples

Pode especificar os dados que a aplicação obtém ao personalizar a propriedade Itens do controlo que mostra os seus dados.You can specify the data that your app retrieves by customing the Items property of the control that shows your data. Continuando o exemplo anterior, pode classificar ou filtrar os dados na tabela Lições através desse nome como um argumento para as funções Search e SortByColumn.Continuing the previous example, you can sort or filter the data in the Lessons table by using that name as an argument for the Search and SortByColumn functions. Neste gráfico, a fórmula para a qual a propriedade Itens está definida especifica que os dados são ordenados e filtrados com base no texto TextSearchBox1.In this graphic, the formula to which the Items property is set specifies that the data is sorted and filtered based on the text in TextSearchBox1.

Propriedade Itens da origem de dados expandida

Para obter mais informações sobre como personalizar a sua fórmula com tabelas, veja estes tópicos:For more information about how to customize your formula with tables, see these topics:

Compreender as origens de dados no PowerAppsUnderstand data sources in PowerApps
Gerar uma aplicação a partir de dados do ExcelGenerate an app from Excel data
Criar uma aplicação do zeroCreate an app from scratch
Compreender as tabelas e registos no PowerAppsUnderstand tables and records in PowerApps

Nota

Para ligar aos dados num livro do Excel, este tem de estar alojado num serviço de armazenamento na cloud, como o OneDrive.To connect to data in an Excel workbook, it must be hosted in a cloud-storage service such as OneDrive. Para obter mais informações, veja Ligar ao armazenamento na cloud a partir do PowerApps.For more information, see Connect to cloud-storage from PowerApps.

AçõesActions

Se o seu conector disponibilizar ações, ainda tem de selecionar a origem de dados como anteriormente.If your connector provides actions, you must still select your data source as you did before. No entanto, em vez de selecionar uma tabela como o passo seguinte, ligue manualmente um controlo a uma ação ao editar a propriedade Itens do controlo que irá mostrar os seus dados.Instead of selecting a table as the next step, however, you manually connect a control to an action by editing the Items property of the control that will show your data. A fórmula para a qual definir a propriedade Itens especifica a ação que obtém dados.The formula to which you set the Items property specifies the action that retrieves data. Por exemplo, a aplicação não irá recuperar quaisquer dados se se ligar ao Yammer e, em seguida, definir a propriedade Itens para o nome da origem de dados.For example, the app won't retrieve any data if you connect to Yammer and then set the Items property to the name of the data source. Para preencher um controlo com dados, especifique uma ação como GetMessagesInGroup(5033622).messages.To populate a control with data, specify an action such as GetMessagesInGroup(5033622).messages.

Propriedade Itens da origem de dados de ação

Se tiver de processar atualizações de dados personalizados para os conectores de ação, crie uma fórmula que inclua a função Patch.If you need to handle custom data updates for action connectors, build a formula that includes the Patch function. Na fórmula, identifique a ação e os campos que irá vincular à ação.In the formula, identify the action and the fields that you'll bind to the action.

Para obter mais informações sobre como personalizar a sua fórmula para atualizações personalizadas, veja estes tópicos:For more information about how to customize your formula for custom updates, see these topics:

PatchPatch
CollectCollect
UpdateUpdate

Nota

PowerApps não funciona com o esquema dinâmico.PowerApps doesn't work with dynamic schema. O esquema dinâmico frase refere-se para a possibilidade de que a mesma ação pode devolver uma tabela com colunas diferentes.The phrase dynamic schema refers to the possibility that the same action may return a different table with different columns. As condições que podem fazer com que as colunas nas tabelas para diferem incluem os parâmetros de entrada de ação, o utilizador ou função que está a executar a ação e o grupo no qual o utilizador está a funcionar, entre outros.Conditions that may cause the columns in the tables to differ include the action input parameters, the user or role that's executing the action, and the group in which the user is working, among others. Por exemplo, procedimentos armazenados do SQL Server podem devolver colunas diferentes, se executar com entradas diferentes.For example, SQL Server stored procedures may return different columns if run with different inputs. Para ações com o esquema dinâmico, a documentação do conector mostra as saídas desta operação são dinâmicas.For actions with dynamic schema, the connector documentation shows The outputs of this operation are dynamic. como o valor de retorno.as the return value. Por outro lado, o Microsoft Flow funciona com o esquema dinâmico e pode fornecer uma solução alternativa para o seu cenário.In contrast, Microsoft Flow works with dynamic schema and might provide a work-around for your scenario.

Esta tabela tem ligações para obter mais informações sobre os nossos conectores mais populares.This table has links to more information about our most popular connectors. Para obter uma lista completa de conectores, veja Todos os conectores.For a complete list of connectors, see All connectors.

         
Common Data Service Common Data ServiceCommon Data Service   Office 365 Outlook Office 365 OutlookOffice 365 Outlook
SharePoint SharePointSharePoint   Excel ExcelExcel
SQL Server SQL ServerSQL Server   OneDrive para Empresas OneDrive para EmpresasOneDrive for Business
Dynamics 365 Dynamics 365Dynamics 365   OneDrive OneDriveOneDrive
Utilizadores do Office 365 Utilizadores do Office 365Office 365 Users   Dropbox DropboxDropbox

Conectores padrão e personalizadosStandard and custom connectors

O PowerApps proporciona conectores Padrão para muitas origens de dados frequentemente utilizadas, como as listadas acima.PowerApps provides standard connectors for many commonly used data sources, such as those listed above. Se o PowerApps tem um conector padrão para este tipo de origem de dados que quer utilizar, deve utilizar esse conector.If PowerApps has a standard connector for the type of data source that you want to use, you should use that connector. Se quiser ligar a outros tipos de origens de dados, como um serviço que criou, veja Registar e utilizar conectores personalizados.If you want to connect to other types of data sources, such as a service that you've built, see Register and use custom connectors.

Todos os conectores padrãoAll standard connectors

Veja a Referência de Conectores da Microsoft para obter uma lista de todos os conectores padrão.See the Microsoft Connector Reference for a list of all the standard connectors. Os conectores Premium requerem o PowerApps Plano 1 ou Plano 2.Premium connectors require PowerApps Plan 1 or Plan 2. Para obter mais informações, veja Planos do PowerApps.For more information, see PowerApps Plans.

Pode fazer perguntas sobre um conector específico nos Fóruns do PowerApps e pode sugerir conectores para adicionar ou outras melhorias no PowerApps Ideas.You can ask questions about a specific connector in the PowerApps forums, and you can suggest connectors to add or other improvements to make in PowerApps Ideas.