Propriedades promovidas: Distinguished Fields vs. Property Fields
|
segunda-feira, 5 de dezembro de 2011
|
BizTalk Server fornece dois tipos de promoções de propriedade: Distinguished Fields e Property Fields.
De forma simplificada, Distinguished Fields são propriedades que só estão acessíveis dentro das orquestrações enquanto Property Fields estão acessíveis em todas as fases do processamento de mensagens no BizTalk, seja em orquestrações, através de código personalizado, no encaminhamento de mensagens (message routing) ou nas pipelines.
Quadro comparativo entre os dois tipos de propriedades promovidas:
Notas:
· Em resumo, utilize Distinguished Fields se não tiver de aceder os elementos promovidos fora das orquestrações, como por exemplo no encaminhamento de mensagens.
· Utilize Property Fields se tiver de aceder os elementos promovidos fora das orquestrações. Certos cenários podem conter informações sigilosas para serem utilizados como uma propriedade promovida, como o número de conta bancária. Para permitir monitorizar processos e solucionar os problemas, as propriedades promovidas podem ser visualizadas em ferramentas como o HAT ou BAM. Com base em normas de privacidade, estes campos de dados devem ser ocultados destas ferramentas. Esta funcionalidade pode ser realizada definindo a propriedade “Sensitive Information property“ a true da propriedade promovida (esta configuração é aplicada no ficheiro property schema). Utilize-os com prudência por forma a não induzir problema de performance nos seus processos.
Como promover Property Fields?
Existem 2 formas de promover este tipo de propriedades:
· Quick promotion: Quick promotion é a maneira mais simples para criar uma propriedade promovida do tipo Property Fields. Para isso basta:
o Clicar no botão direito do rato sobre o elemento que quer promover e escolher a opção “Quick Promotion”.
o Ao escolher esta opção, o Visual Studio irá criar um property schema (esquema de propriedade) chamado: PropertySchema.xsd e automaticamente irá adicionar uma referência do property schema gerado no esquema da mensagem.
· Manual Promotion: Para promover manualmente uma propriedade do tipo Property Fields, deverá ser criado um property schema com todos os elementos que irão conter os valores das propriedades promovidas (podemos chamar-lhes de apontadores). Para criar um property schema, você precisa:
o Adicionar um novo item na solução BizTalk, escolhendo a opção “Schema Files –> Property Schema” como tipo do arquivo.
o Assim que todos os elementos estiverem criados no property schema, necessitamos de associá-lo com o esquema da mensagem.
o E posteriormente, selecionar os elementos da mensagem que quer promover e click no botão “Add >>” para adicionar ou “<<Remove” para remover Property Fields, após adicionar deverá associar o elemento promovido da mensagem a um elemento existente no property schema
Como promover distinguished?
Um dos principais factores que pode gerar confusão entre Distinguished Fields e Property Fields é que ambos são criados a partir do Visual Studio’s Schema Editor através da opção: “Promote –> Show Promotions”
Assim que a caixa de diálogo “Promote Properties“ estiver aberta, verifique que se encontra na tab ”Distinguished Field”, selecione o elemento da mensagem que quer promover e click no botão “Add >>” para adicionar ou “<<Remove” para remover Distinguished Fields.
Após promover os elementos como Distinguished Fields serão criados no esquema da mensagem anotações contendo a query XPath que permite apontar para o elemento promovido.
De forma simplificada, Distinguished Fields são propriedades que só estão acessíveis dentro das orquestrações enquanto Property Fields estão acessíveis em todas as fases do processamento de mensagens no BizTalk, seja em orquestrações, através de código personalizado, no encaminhamento de mensagens (message routing) ou nas pipelines.
Quadro comparativo entre os dois tipos de propriedades promovidas:
Distinguished Fields | Property Fields |
| Acessíveis apenas dentro das orquestrações. | Acessíveis em todas as fases do processamento de mensagens no BizTalk, seja em orquestrações, através de código personalizado, no encaminhamento de mensagens (portas de envio e recepção) ou nas pipelines. |
| Não participam no processo de encaminhamento de mensagens (message routing) IsPromoted = false | Usadas nos processos de encaminhamento de mensagens (message routing) através de um mecanismo de assinatura. IsPromoted = true |
| Não são usadas para o tracking | Usadas para o tracking |
| Não são persistidas na base de dados (MessageBox database). São essencialmente XPath alias, que simplesmente apontam para o elemento XML apropriado. | São persistidas na base de dados (MessageBox database). |
| Não têm limitação de tamanho. | Comprimento máximo limitado a 256 caracteres. |
| Acessível através da referência ao nome da mensagem e do nome da propriedade promovida (ou nome da estrutura e nome da propriedade), utilizando o seguinte formato: NomaMensagem.NomeEstrutura. NomePropriedadePromovida. | Acessível através da referência ao nome da mensagem, ao nome do property schema (esquema que contêm as propriedades promovidas), e ao nome da propriedade promovida, utilizando o seguinte formato: NomaMensagem(NomePropertySchema. NomePropriedadePromovida) |
| Não requerem a criação de um esquema (property schema) que contém as propriedades promovidas. | Exigir a criação de um esquema que contêm as propriedades promovidas, chamados de property schemas |
| Custam menos em termos de sobrecarga de execução | Sobrecarga adicional na execução pelo facto de serem persistidas em duas tabelas de base de dados: MessageBox e na tabela de subscrições |
| Só podem ser usadas para promover elementos únicos, ou seja, podem ser usadas para promover valores em estruturas com o tipo de conteúdo simples (ocorrência máxima de 1 vez) |
| Ambas podem ser utilizadas para promover elementos e/ou atributos |
Notas:
· Em resumo, utilize Distinguished Fields se não tiver de aceder os elementos promovidos fora das orquestrações, como por exemplo no encaminhamento de mensagens.
· Utilize Property Fields se tiver de aceder os elementos promovidos fora das orquestrações. Certos cenários podem conter informações sigilosas para serem utilizados como uma propriedade promovida, como o número de conta bancária. Para permitir monitorizar processos e solucionar os problemas, as propriedades promovidas podem ser visualizadas em ferramentas como o HAT ou BAM. Com base em normas de privacidade, estes campos de dados devem ser ocultados destas ferramentas. Esta funcionalidade pode ser realizada definindo a propriedade “Sensitive Information property“ a true da propriedade promovida (esta configuração é aplicada no ficheiro property schema). Utilize-os com prudência por forma a não induzir problema de performance nos seus processos.
Como promover Property Fields?
Existem 2 formas de promover este tipo de propriedades:
· Quick promotion: Quick promotion é a maneira mais simples para criar uma propriedade promovida do tipo Property Fields. Para isso basta:
o Clicar no botão direito do rato sobre o elemento que quer promover e escolher a opção “Quick Promotion”.
o Ao escolher esta opção, o Visual Studio irá criar um property schema (esquema de propriedade) chamado: PropertySchema.xsd e automaticamente irá adicionar uma referência do property schema gerado no esquema da mensagem.
· Manual Promotion: Para promover manualmente uma propriedade do tipo Property Fields, deverá ser criado um property schema com todos os elementos que irão conter os valores das propriedades promovidas (podemos chamar-lhes de apontadores). Para criar um property schema, você precisa:
o Adicionar um novo item na solução BizTalk, escolhendo a opção “Schema Files –> Property Schema” como tipo do arquivo.
o Assim que todos os elementos estiverem criados no property schema, necessitamos de associá-lo com o esquema da mensagem.
o E posteriormente, selecionar os elementos da mensagem que quer promover e click no botão “Add >>” para adicionar ou “<<Remove” para remover Property Fields, após adicionar deverá associar o elemento promovido da mensagem a um elemento existente no property schema
Como promover distinguished?
Um dos principais factores que pode gerar confusão entre Distinguished Fields e Property Fields é que ambos são criados a partir do Visual Studio’s Schema Editor através da opção: “Promote –> Show Promotions”
Assim que a caixa de diálogo “Promote Properties“ estiver aberta, verifique que se encontra na tab ”Distinguished Field”, selecione o elemento da mensagem que quer promover e click no botão “Add >>” para adicionar ou “<<Remove” para remover Distinguished Fields.
Após promover os elementos como Distinguished Fields serão criados no esquema da mensagem anotações contendo a query XPath que permite apontar para o elemento promovido.
Postar um comentário