How to?

Como adicionar atributos do tipo money a uma entidade?

Para proceder à adição de atributos money numa entidade é necessário:

Modelo de Entidades

Aberto o modelo de entidades basta selecionar a entidade à qual pretendemos adicionar um atributo do tipo Money e adicionar o respetivo atributo, definindo, nas suas propriedades o tipo Money.

A definição de um atributo deste tipo implica a que seja necessário efetuar associações para outra entidade designada "Currency" e que seja implementada uma das seguintes interfaces: "IMonetaryData ou IMonetaryTransaction", dependendo do que se pretende para o respetivo atributo.

Se a entidade Currency já existir no modelo apenas é necessário efetuar a respetiva associação da entidade que contem o atributo do tipo money a essa entidade, se não é necessário importar a entidade.

Para importar a entidade basta aceder ao Module Reference "CorePatterns", botão direito do rato e selecionar a opção Modules -> Import Entities... e selecionar a opção Currency. Isto irá adicionar a entidade externa Currency e a respetiva interface. Após isto apenas é necessário efetuar a associação entre as ambas a entidades.

Fica a faltar a implementação da interface necessária. Para isto basta selecionar a entidade que está a usar os atributos do tipo Money, clicar no botão direito do rato, e selecionar a opção Interfaces -> Add Interfaces... Aqui bastará, então, selecionar uma das interfaces solicitadas, IMonetaryData ou IMonetaryTransaction.

Nota: Para saber a diferença entre estas interfaces poderá consultar o documento Money

Implementar interface IMonetaryData

Se a interface selecionada for a IMonetaryData, de seguida é necessário associar a respetiva interface à entidade. Assim, é necessário selecionar a entidade, clicar no botão direito do rato e selecionar a opção Entities -> Select Entity Interfaces..., e selecionar a interface IMonetaryData. Após isto, a associação entre a entidade e a interface é efetuada.

Após isto, ao proceder à validação do modelo é possível verificar que existe ainda a necessidade de definir o atributo Currency como um atributo de interface. Paral tal é necessário selecionar novamente a entidade, selecionar a opção Entities -> Implement Interfaces... e selecionar a opção IMonetaryData.

Implementar interface IMonetaryTransaction

Se a interface selecionada for a IMonetaryTransaction é igualmente necessário associar a respetiva interface à entidade, selecionando a entidade e, através do botão direito do rato, selecionar a opção Entities -> Select Entity Interfaces..., e selecionar a interface IMonetaryTransaction. Após isto, a associação entre a entidade e a interface é efetuada.

Ao proceder à validação do modelo, verifica-se a necessidade de a entidade implementar implicitamente a interface IMonetaryTransaction, já que se encontram em falta os atributos ExchangeRate, ExchangeRateDate e Currency. Assim, é necessário selecionar novamente a entidade, selecionar a opção Entities -> Implement Interfaces... e selecionar a opção IMonetaryTransaction.

Automaticamente os atributos em falta serão adicionados à entidade, os dois primeiros como atributos normais da entidade e o atributo Currency como atributo de interface.