A função DataSourceInfo no Power Apps

Fornece informações sobre a origem de dados.

Descrição Geral

As origens de dados podem fornecer uma variedade de informações para otimizar a experiência de utilizador.

Pode utilizar informações da coluna para validar a entrada do utilizador e fornecer comentários imediatos ao utilizador antes de utilizar a função Patch. A função Validate utiliza essas mesmas informações.

Pode utilizar informações ao nível da origem de dados, por exemplo, para desativar ou ocultar os botões Editar e Novo para os utilizadores que não tem permissão para editar e criar registos.

As origens de dados variam na quantidade de informações que fornecem, incluindo o não fornecimento de qualquer informação. As Coleções não fornecem nenhuma informação. Se não for fornecido um elemento de informação, é utilizado um elemento predefinido ou é devolvido um elemento blank.

Descrição

Informações da coluna

Pode utilizar DataSourceInfo para obter informações sobre uma coluna específica de uma origem de dados:

Argumento de informações Tipo de Resultado Descrição
DataSourceInfo.DisplayName String Nome a apresentar para a coluna. Se não for definido nenhum nome a apresentar, será devolvido o nome da coluna.
DataSourceInfo.MaxLength Número Número máximo de carateres que a coluna pode conter. Aplica-se apenas às colunas com cadeias. Se não estiver configurado um número máximo, será devolvido um valor blank.
DataSourceInfo.MaxValue Número Valor numérico máximo que uma coluna pode conter. Aplica-se apenas às colunas com números. Se não estiver configurado um número máximo, será devolvido um valor blank.
DataSourceInfo.MinValue Número Valor numérico mínimo que uma coluna pode conter. Aplica-se apenas às colunas com números. Se não estiver configurado um número mínimo, será devolvido um valor blank.
DataSourceInfo.Required Booleano É um valor necessário para esta coluna? Se não tiver sido definido pela origem de dados, será devolvido um valor false.

O terceiro argumento é o nome de uma coluna como uma cadeia. Por exemplo, a coluna Telefone na coleção Pessoas foi transferida para "Telefone", incluindo as aspas.

Informações da origem de dados

Também pode utilizar DataSourceInfo para obter informações sobre uma origem de dados como um todo:

Argumento de informações Tipo de Resultado Descrição
DataSourceInfo.AllowedValues Booleano Que tipos de permissões podem ser concedidos aos utilizadores para esta origem de dados? Se não tiver sido definido pela origem de dados, será devolvido um valor blank.
DataSourceInfo.CreatePermission Booleano O utilizador atual tem permissão para criar registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true.
DataSourceInfo.DeletePermission Booleano O utilizador atual tem permissão para eliminar registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true.
DataSourceInfo.EditPermission Booleano O utilizador atual tem permissão para editar registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true.
DataSourceInfo.ReadPermission Booleano O utilizador atual tem permissão para ler registos nesta origem de dados? Se não tiver sido definida pela origem de dados, será devolvido um valor true.

Sintaxe

DataSourceInfo( DataSource, Informações, ColumnName )

  • DataSource – Obrigatório. A origem de dados a utilizar.

  • Informações – Necessário. O tipo de informações que pretende obter.

  • ColumnName – Opcional. Para obter informações ao nível da coluna, o nome da coluna como uma cadeia. A coluna Telefone foi transferida para "Telefone", incluindo as aspas. Para obter informações ao nível da origem de dados, o argumento ColumnName não pode ser utilizado.

    Nota

    Para origens de dados do SharePoint e do Excel que contêm nomes de coluna com espaços, especifique cada espaço como "_x0020_". Por exemplo, especifique "Nome da Coluna" como "Column_x0020_Name".

Exemplos

Os exemplos desta secção utilizam esta origem de dados, denominada Gelado:

Gelado

A origem de dados também forneceu estas informações:

  • O nome a apresentar para Quantidade é "Quantidade na mão".
  • O comprimento máximo de Sabor é de 30 carateres.
  • A coluna Sabor tem de conter um valor. A coluna Quantidade não é necessária.
  • A Quantidade mínima é 0.
  • A Quantidade máxima é 100.
  • O utilizador atual pode ler e editar registos da origem de dados Gelado, mas não pode criar ou eliminar registos.
Fórmula Descrição Resultado
DataSourceInfo( Gelado, DataSourceInfo.DisplayName, "Quantidade" ) Devolve o nome a apresentar para a coluna Quantidade da origem de dados Gelado. "Quantidade Em Stock"
DataSourceInfo( Gelado, DataSourceInfo.MaxLength, "Sabor" ) Devolve o comprimento máximo da cadeia para a coluna Sabor da origem de dados Gelado. 30
DataSourceInfo( Gelado, DataSourceInfo.Required, "Sabor" ) A coluna Sabor da origem de dados Gelado é necessária? true
DataSourceInfo( Gelado, DataSourceInfo.Required, "Quantidade" ) A coluna Quantidade da origem de dados Gelado é necessária? false
DataSourceInfo( Gelado, DataSourceInfo.MaxValue, "Quantidade" ) Devolve o valor numérico máximo para a coluna Quantidade da origem de dados Gelado. 100
DataSourceInfo( Gelado, DataSourceInfo.MinValue, "Quantidade" ) Devolve o valor numérico mínimo para a coluna Quantidade da origem de dados Gelado. 0
DataSourceInfo( Gelado, DataSourceInfo.ReadPermission) O utilizador atual pode ler registos na origem de dados Gelado? true
DataSourceInfo( Gelado, DataSourceInfo.EditPermission) O utilizador atual pode editar registos na origem de dados Gelado? true
DataSourceInfo( Gelado, DataSourceInfo.CreatePermission) O utilizador atual pode criar registos na origem de dados Gelado? false
DataSourceInfo( Gelado, DataSourceInfo.DeletePermission) O utilizador atual pode eliminar registos na origem de dados Gelado? false

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).