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.
Expressão	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.
Associação	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.

Observações

• Em modelos de relatório, 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 Dados do Filtro ou a área de parâmetro, defina 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 os usuários como listas classificadas. No entanto, quando uma condição de filtro solicitada é criada, a lista de valores de 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 a 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.

Consulte também

Conceitos

Trabalhando com o Designer de Modelo