Compartilhar via

  • Artigo

Objeto Attribute (Designer de Modelo)

O objeto Attribute define um item em uma entidade. Esse objeto também herda propriedades do objeto Field.

Properties

Nome

Cardinalidade

Tipo

Descrição

Name

1

String

O nome do item. Observe que esta é uma cadeia de caracteres obrigatória se o atributo não tiver uma expressão.

DataType

1

DataTypeEnum

O tipo de dados do atributo. Se uma expressão estiver presente, o valor DataType deverá corresponder ao valor DataType da expressão.

Nullable

0-1

Boolean

Indica se o atributo pode ter um valor nulo.

Expression

0-1

Object

A expressão usada para calcular o valor do atributo. Um valor escalar deve ser retornado.

SortDirection

0-1

Enum

A direção padrão na qual deve ser feita a classificação ao classificar por esse atributo. Por padrão, a ordem crescente é especificada.

Width

0-1

Integer

A largura de coluna padrão, em caracteres, para exibir o atributo. O valor deve ser maior que 0. O padrão se baseia em DataType e tem os seguintes valores: Boolean: 6, DateTime: 10, Time: 8, Integer: 8, Decimal: 8, Float: 8, String: 20, Binary: 1023, EntityKey: 128.

Alignment

0-1

Enum

O alinhamento de caractere padrão. O padrão é Geral. Outros valores possíveis são Esquerdo, Centralizado ou Direito.

MimeType

0-1

String

O tipo MIME do atributo. Para atributos não-binários, é ignorado esse valor. Você não pode especificar uma cadeia de caracteres vazia.

DataCulture

0-1

Language

Indica a cultura a ser usada para operações suscetíveis à cultura; por exemplo, formatando dados numéricos com um símbolo de moeda. Esse atributo de cultura não é usado para formatação de exibição simples, como para formatos de data ou numéricos. Se não for especificado, o valor padrão de DataCulture é o valor de cultura do modelo usado em Model.Culture.

DiscourageGrouping

0-1

Boolean

Indica se o aplicativo cliente deve desencorajar o usuário de ser agrupado neste atributo. DiscourageGrouping deve ser definido nos campos com valores exclusivos, por exemplo, números de teledone. Se o atributo for uma chave ou estiver identificando o atributo da entidade, o aplicativo cliente será agrupado nos atributos de chave da entidade.

EnableDrillthrough

0-1

Boolean

Indica se o aplicativo cliente deve fornecer um link de detalhamento deste atributo para a entidade contentora.

Format

0-1

String

Especifica a cadeia de caracteres com formato .NET Framework padrão usada para formatar o valor do atributo. Além dos formatos .NET Framework padrão, há suporte para as seguintes cadeias de caracteres de formato:

Cadeias de caracteres de formato para inteiros de data

  • ddd: dia de abreviação de semana

  • dddd: nome completo do dia da semana

  • MMM: abreviação de mês

  • MMMM: nome de mês completo

Cadeias de caracteres de formato para booleanos

  • truefalse: "Verdadeiro" e "Falso"

  • yesno: "Sim" e "Não"

Cadeias de caracteres de formato personalizadas para booleanos

As cadeias de caracteres de formato personalizadas assumem a forma "truevalue;falsevalue".

  • true: "Verdadeiro"

  • false: "Falso"

  • yes: "Sim"

  • no: "Não"

  • " and '. Os caracteres entre aspas simples ou duplas são copiados literalmente para a cadeia de caracteres de resultado e não afetam a formatação.

  • \ Caractere de escape. O caractere após o caractere de escape especificado é tratado como um caractere literal, não um especificador de formato.

ContextualName

0-1

Enum

Define como o aplicativo cliente deve gerar um nome sensível ao contexto para esse atributo quando a entidade é atingida usando uma função. O enumerador pode ser um de três valores: Attribute, Merge ou Role. O valor do enumerador assumirá como padrão Attribute, que usa o nome de atributo como o nome contextual. Especifique Merge para fazer com que o nome do atributo e da função sejam mesclados e usados como nome contextual. Se esse atributo for o único atributo identificador da entidade, a especificação de Role usará o nome da função como nome contextual. Se não for o único atributo identificador da entidade, Role será tratado como Merge.

IsAggregate

0-1

Boolean

Indica se esse atributo é um agregado que pode ser calculado no contexto não somente da entidade contentora, mas também de qualquer outra entidade para a qual há uma relação um para muitos na entidade contentora. Se isso não for definido, o atributo será tratado como um escalar. IsAggregate pode ser verdadeiro somente para atributos com expressões não ancoradas.

IsFilter

0-1

Boolean

Indica que este atributo é planejado para ser usado como um filtro nomeado. Só pode ser verdadeiro para atributos booleanos.

OmitSecurityFilters

0-1

Boolean

Indica que a expressão desse atributo deve ser calculada sem adicionar filtros de segurança. Geralmente usado para casos nos quais os dados de detalhes devem ser protegidos com base nos filtros de segurança, mas que os dados agregados são públicos. Essa propriedade é ignorada quando o atributo não tem uma expressão.

DefaultAggregateAttributeID

0-1

String

O ID de um atributo que é o agregado padrão desse atributo. Essa cadeia de caracteres deve ser a ID de uma variação desse atributo. Essa cadeia de caracteres não será permitida se IsAggregate for True. O valor será ignorado se o atributo estiver oculto.

ValueSelection

0-1

Enum

Determina o comportamento do aplicativo cliente para selecionar valores do atributo, com base no número esperado dos valores exclusivos. Três opções estão disponíveis: Nenhum, Suspenso e Lista. Por padrão, Nenhum é selecionado, o que exige que o usuário digite um valor. Quando Suspenso é especificado, os valores exclusivos são exibidos em uma lista suspensa simples. Quando Lista é especificado, os valores exclusivos são exibidos na UI como uma lista. Se IsAggregate for True, esse atributo será ignorado.

Binding

0-1

Object

O objeto do banco de dados que representa esse campo. Esse objeto será obrigatório se o atributo não tiver uma expressão. A associação deve estar vinculada a uma coluna na tabela à qual a entidade contentora está vinculada ou à coluna à qual a entidade está vinculada.

Comentários

  • No Construtor de Relatórios, um atributo é chamado de campo.

  • Para impedir que todos os valores exclusivos de um campo sejam recuperados em uma interface de seleção de valor, como a caixa de diálogo Filtrar Dados ou a área de parâmetro, certifique-se de definir a propriedade ValueSelection como None. O usuário será exigido para digitar um valor.

  • Ao usar funções que podem retornar Null, você deve definir a propriedade Nullable para o atributo como True.

  • Quando a propriedade ValueSelection está definida como Lista, todos os valores são exibidos para o usuário do Construtor de Relatórios como listas classificadas. No entanto, quando uma condição de filtro solicitada é criada, a lista valores do parâmetro talvez não seja classificada uma vez que a consulta semântica não executa classificações em consultas de valores de parâmetros. Se sua lista de valores de parâmetro não estiver classificada e você quiser que ela esteja, tente criar um índice no campo no banco de dados subjacente; isso geralmente faz com que a lista seja classificada.

  • Para criar um grupo na entidade em vez de no campo ao adicionar o campo no layout de relatórios do Construtor de Relatórios, você pode definir a propriedade DiscourageGrouping como True para o campo. Essa propriedade deve ser definida como verdadeira somente para atributos exclusivos.

Para obter mais informações sobre valores de enumeração válidos, consulte Tipos de dados do Designer de Modelo.