Visão geral dos conectores de aplicativo de tela no Power AppsOverview of canvas-app connectors for Power Apps

Os dados estão no núcleo da maioria dos aplicativos, incluindo aqueles que você compila no Power Apps.Data is at the core of most apps, including those you build in Power Apps. Os dados são armazenados em uma fonte de dados, e você coloca esses dados em seu aplicativo ao criar uma conexão.Data is stored in a data source, and you bring that data into your app by creating a connection. A conexão usa um determinado conector para se comunicar com a fonte de dados.The connection uses a specific connector to talk to the data source. O Power Apps tem conectores para muitos serviços populares e fontes de dados locais, incluindo SharePoint, SQL Server, Office 365, Salesforce e Twitter.Power Apps 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 um aplicativo de tela, confira Adicionar uma conexão de dados ao Power Apps.To get started adding data to a canvas app, see Add a data connection in Power Apps.

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

TabelasTables

Se o conector fornecer tabelas, você poderá adicionar sua fonte de dados e, em seguida, selecionar a tabela da fonte de dados que deseja gerenciar.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 Power Apps recupera dados da tabela em seu aplicativo e atualiza os dados na fonte de dados para você.Power Apps both retrieves table data into your app and updates data in your data source for you. Por exemplo, você pode adicionar uma fonte de dados que contém uma tabela chamada Lessons e, em seguida, definir a propriedade Items de um controle, como uma galeria ou um formulário, como esse 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 Items de uma fonte de dados simples

Você pode especificar os dados que seu aplicativo recupera personalizando a propriedade Items do controle que mostra os dados.You can specify the data that your app retrieves by customizing the Items property of the control that shows your data. Dando continuidade ao exemplo anterior, você pode classificar ou filtrar os dados na tabela Lessons usando esse 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 Items está definida especifica que os dados são classificados e filtrados com base no texto em 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 Items da fonte de dados expandida

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

Entender fontes de dados no Power AppsUnderstand data sources in Power Apps
Gerar um aplicativo de dados do ExcelGenerate an app from Excel data
Criar um aplicativo do zeroCreate an app from scratch
Entender tabelas e registros no Power AppsUnderstand tables and records in Power Apps

Observação

Para se conectar a dados em uma pasta de trabalho do Excel, ela precisa estar hospedada em um serviço de armazenamento na nuvem, 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, consulte Conectar-se ao armazenamento em nuvem a partir do Power Apps.For more information, see Connect to cloud-storage from Power Apps.

AçõesActions

Se seu conector fornece ações, você ainda precisa selecionar sua fonte de dados como fez 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 a próxima etapa, você conecta manualmente um controle a uma ação editando a propriedade Items do controle que mostrará 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 você define a propriedade Items especifica a ação que recupera dados.The formula to which you set the Items property specifies the action that retrieves data. Por exemplo, o aplicativo não recuperará dados se você se conectar ao Yammer e, em seguida, definir a propriedade Items como o nome da fonte 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 controle com os dados, especifique uma ação, como GetMessagesInGroup(5033622).messages.To populate a control with data, specify an action such as GetMessagesInGroup(5033622).messages.

Propriedade Items de uma fonte de dados de ação

Se precisar lidar com atualizações de dados personalizados para 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 você associará a ela.In the formula, identify the action and the fields that you'll bind to the action.

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

PatchPatch
CollectCollect
UpdateUpdate

Observação

O Power Apps não funciona com esquema dinâmico.Power Apps doesn't work with dynamic schema. O esquema dinâmico da frase refere-se à possibilidade de que a mesma ação possa retornar uma tabela diferente 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 sejam diferentes incluem os parâmetros de entrada da ação, o usuário ou função que está executando a ação e o grupo em que o usuário está trabalhando, 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, os procedimentos armazenados do SQL Server podem retornar colunas diferentes se executados com entradas diferentes.For example, SQL Server stored procedures may return different columns if run with different inputs. Para ações com 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 valor de devolução.as the return value. Por outro lado, o Power Automate funciona com esquema dinâmico e pode fornecer uma solução alternativa para o seu cenário.In contrast, Power Automate works with dynamic schema and might provide a work-around for your scenario.

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

         
Common Data Service Common Data ServiceCommon Data Service   Armazenamento em nuvem Armazenamento em nuvem **Cloud storage **
Dynamics 365 Dynamics 365Dynamics 365   Dynamics AX Dynamics AXDynamics AX
Excel ExcelExcel   Microsoft Translator Microsoft TranslatorMicrosoft Translator
Office 365 Outlook Office 365 OutlookOffice 365 Outlook   Office 365 Users Usuários do Office 365Office 365 Users
Oracle OracleOracle   Power BI Power BIPower BI
SharePoint SharePointSharePoint   SQL Server SQL ServerSQL Server
Twitter TwitterTwitter

** Aplica-se ao Azure Blob, Box, Dropbox, Google Drive, OneDrive e OneDrive for Business** Applies to Azure Blob, Box, Dropbox, Google Drive, OneDrive and OneDrive for Business

Conectores padrão e personalizadosStandard and custom connectors

O Power Apps fornece conectores padrão para muitas fontes de dados comumente usadas.Power Apps provides standard connectors for many commonly used data sources. Se o Power Apps tiver um conector padrão para o tipo de fonte de dados que você deseja usar, use esse conector.If Power Apps has a standard connector for the type of data source that you want to use, you should use that connector. Caso queira se conectar a outros tipos de fontes de dados, como um serviço que criou, confira Registrar e usar 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

Conectores padrão não requerem licenciamento especial.Standard connectors do not require special licensing. Para obter mais informações, consulte Planos do Power Apps.For more information, see Power Apps Plans.

Você pode fazer perguntas sobre um conector específico nos fóruns do Power Apps e pode sugerir conectores a serem adicionados ou outras melhorias a serem feitas em Ideias para o Power Apps.You can ask questions about a specific connector in the Power Apps forums, and you can suggest connectors to add or other improvements to make in Power Apps Ideas.

Segurança e tipos de autenticaçãoSecurity and types of authentication

Ao criar seu aplicativo e uma conexão com uma fonte de dados, você poderá ver que sua opção de conector permite usar maneiras diferentes de autenticação.As you author your app and create a connection to a data source, you may see that your choice of connector allows you to use different ways to authenticate. Por exemplo, o conector do SQL Server permite usar Azure AD Integrated, Autenticação do SQL Server e Autenticação do Windows.For instance, the SQL Server connector allows you to use Azure AD Integrated, SQL Server Authentication, and Windows Authentication. Cada tipo de autenticação possui diferentes níveis de segurança associados.Each type of authentication has different levels of security associated with it. É importante entender quais informações e direitos você compartilha com os usuários que usam seu aplicativo.It's important to understand what information and rights you share with users who use your application. O exemplo principal neste artigo é o SQL Server. No entanto, os princípios se aplicam a todos os tipos de conexões.The primary example in this article is SQL Server, however the principles apply to all types of connections.

Azure AD IntegratedAzure AD Integrated

Esse é um tipo de conexão segura.This is a secure type of connection. Por exemplo, o SharePoint usa esse tipo de autenticação.For example, SharePoint uses this type of authentication. O SQL Server também permite esse tipo de autenticação.SQL Server also allows for this type of authentication. Quando você se conecta, o serviço do Azure AD identifica você separadamente para fazer SharePoint em seu nome.When you connect, the Azure AD service identifies you separately to SharePoint on your behalf. Você não precisa fornecer um nome de usuário ou senha.You do not have to supply a username or password. Como autor, você pode criar e trabalhar com a fonte de dados com suas credenciais.As an author you can create and work with the data source with your credentials. Quando você publica seu aplicativo e o usuário do aplicativo efetua login, ele o faz com sua própria credencial.When you publish your application and your application user logs in, they do so with their credentials. Se os dados estiverem adequadamente protegidos em um back-end, seus usuários poderão ver apenas o que estão autorizados a ver com base em suas credenciais.If the data is appropriately secured on a back-end your users can only see what they are authorized to see based on their credentials. Esse tipo de segurança permite alterar os direitos de usuários específicos do aplicativo na fonte de dados de back-end após a publicação do aplicativo.This type of security allows you to change rights for specific application users on the back-end data source after the application has been published. Por exemplo, você pode conceder acesso, negar acesso ou refinar o que um usuário ou conjunto de usuários pode ver, tudo na fonte de dados de back-end.For instance you can grant access, deny access, or refine what a user or set of users can see all on the back-end data source.

Autorização de padrão aberto (Oauth)Open-standard authorization (OAuth)

Esse tipo de conexão também é seguro.This type of connection is also secure. Por exemplo, o Twitter usa esse tipo de autenticação.For example Twitter uses this type of authentication. Ao se conectar, você deve fornecer seu nome de usuário e senha.When you connect you must supply your user name and password. Como autor, você pode criar e trabalhar com a fonte de dados com suas credenciais.As an author you can create and work with the data source with your credentials. Quando você publica seu aplicativo e o usuário do aplicativo efetua login, eles também precisam fornecer suas próprias credenciais.When you publish your application and your application user logs in, they must also supply their credentials. Portanto, esse tipo de conexão é seguro, pois os usuários devem usar suas próprias credenciais para acessar o serviço de fonte de dados.Therefore this type of connection is secure as your users must use their own credentials to access the data source service.

Autenticação de nome de usuário e senha de usuário do SQLSQL User name and password authentication

Esse tipo de conexão não é muito seguro porque não depende da autenticação do usuário final.This type of connection is not very secure because it does not rely on end-user authentication. O SQL Server também permite esse tipo de autenticação.SQL Server also allows for this type of authentication. No SQL Server, esse tipo de autenticação é chamado de Autenticação do SQL Server.In SQL Server this type of authentication is called SQL Server Authentication. Muitas outras fontes de dados de bancos de dados fornecem um recurso semelhante.Many other database data sources provide a similar capability. Quando você publica o aplicativo, seus usuários não precisam fornecer um nome de usuário e senha exclusivos.When you publish your application, your users do not need to supply a unique user name and password. Eles usam o nome de usuário e senha fornecidos quando você cria o aplicativo.They are using the user name and password you supply when you author the application. A autenticação de conexão com a fonte de dados é Implicitamente compartilhada com seus usuários.The connection authentication to the data source is Implicitly Shared with your users. Assim que o aplicativo é publicado, a conexão também é publicada e disponibilizada para seus usuários.Once the application is published, the connection is also published and available to your users. Os usuários finais também podem criar aplicativos usando qualquer conexão compartilhada com eles que use a autenticação do SQL Server.Your end users can also create applications using any connection using SQL Server authentication that is shared with them. Seus usuários não podem ver o nome de usuário ou a senha, mas a conexão estará disponível para eles.Your users cannot see the user name or password, but the connection will be available to them. Certamente existem cenários válidos para esse tipo de conexão.There are certainly valid scenarios for this type of connection. Por exemplo, se você tiver um banco de dados somente leitura disponível para todos na empresa, esse tipo de conexão pode ser válido.For instance if you have a read-only database that is available to everyone in the company, this type of connection may be valid.

Autenticação do WindowsWindows Authentication

Esse tipo de conexão não é muito seguro porque não depende da autenticação do usuário final.This type of connection is not very secure because it doesn't rely on end-user authentication. Use a Autenticação do Windows quando precisar se conectar a uma fonte de dados que seja local.Use Windows authentication when you need to connect to a data source that is on-premises. Um exemplo desse tipo de conexão é com um servidor local que possui um SQL Server.An example of this type of connection is to an on-premises server that has a SQL Server. A conexão deve passar por um gateway.The connection must go through a gateway. Como ela passa por um gateway, o conector tem acesso a todos os dados nessa fonte de dados.Since it goes through a gateway, the connector has access to all of the data on that data source. Como resultado, todas as informações que você pode acessar com as credenciais do Windows fornecidas estarão disponíveis para o conector.As a result, any information that you can access with the Windows credentials you supply are available to the connector. E assim que o aplicativo é publicado, a conexão também é publicada e disponibilizada para seus usuários.And once the application is published, the connection is also published and available to your users. Isso significa que seus usuários finais também podem criar aplicativos usando essa mesma conexão e acessar os dados nessa máquina.This means that your end users can also create applications using this same connection and access the data on that machine. As conexões com a fonte de dados também são Implicitamente compartilhadas com usuários com os quais o aplicativo é compartilhado.Connections to the data source are also Implicitly Shared with users that the app is shared with. Esse tipo de conexão pode ser válido quando sua fonte de dados reside apenas em um servidor local e os dados nessa fonte podem ser compartilhados livremente.This type of connection may be valid when your data source only lives on an on-premises server and the data on that source is freely shareable.