ColumnNamesFuncións Column

Aplícase a: Aplicacións de lenzo Copilot Studio Aplicacións baseadas en modelos Funcións de Power Platform CLI Dataverse

Recupera os nomes e valores das columnas dun valor dinámico.

Descripción

A ColumnNames función devolve os nomes de todas as columnas dun rexistro dinámico, devolvendo unha táboa con todos os nomes dese rexistro.

A Column función devolve o valor dunha propiedade dun rexistro dinámico co nome da columna dada. O valor devértese como un valor dinámico.

As ColumnNames funcións and Column devolven erros se o valor dinámico non representa un rexistro (é dicir, se representa unha táboa ou un valor escalar ou primitivo).

Sintaxe

ColumnNames( Rexistro dinámico )

  • Rexistro dinámico - Obrigatorio. Valor dinámico que representa un rexistro.

Column( DynamicRecord, ColumnName )

  • Rexistro dinámico - Obrigatorio. Valor dinámico que representa un rexistro.
  • ColumnName : é obrigatorio. O nome da columna que se vai recuperar do rexistro indicado.

Exemplos

Acceso a valores de campo

Dada a seguinte cadea JSON nunha variable chamada JsonString

{ "name": "Seattle", "population": 737000 }

  1. A seguinte fórmula devolve unha táboa dunha soa columna cunha Value columna que contén os seguintes valores: "nome", "poboación":

    ColumnNames( ParseJSON( JsonString ) )

  2. A seguinte fórmula devolve o número 737000:

    Value( Column( ParseJSON( JsonString ), "population" ) )
    • Nótese que esta fórmula é similar ao . operador para rexistros dinámicos, pero o nome da columna non ten que ser coñecido previamente.

  3. A seguinte fórmula devolve o valor de texto "name: Seattle, population: 737000":

    With(
    { untyped: ParseJSON( JsonString ) },
    Concat(
        ColumnNames( untyped ),
        $"{Value}: {Column( untyped, Value )}",
        ", "))

En branco

Dada a seguinte cadea JSON nunha variable chamada JsonString

{ "text": "text value" , "number": 567, "empty": null }
  1. Ao tentar acceder a campos inexistentes mostra Blank(). A fórmula seguinte devolve true: 
    IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
  2. Os valores JSON null considéranse Blank(). A fórmula seguinte devolve true: 
    IsBlank( Column( ParseJSON( JsonString ), "empty" ) )

Non rexistros

Chamar ás funcións Column ou ColumnNames con valores dinámicos que non representan rexistros devolve un erro. Todas as expresións da seguinte lista son erróneas:

Fórmula Motivo do erro
ColumnNames( ParseJSON ( "[1, 2, 3]" ) ) O valor dinámico representa unha matriz
Column( ParseJSON ( "23.45" ), "Valor") O valor dinámico representa un número
ColumnNames( ParseJSON ( """ola""") ) O valor dinámico representa un texto
Column( ParseJSON ( "{""a"":false}" ).a, "a" ) O valor dinámico representa un valor booleano
  • Last updated on