AttributeMatchPath

 

Publicado: novembro de 2016

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

O elemento <AttributeMatchPath> pode ser utilizado por uma configuração de controle da Web para localizar o documento desejado no documento HTML carregado atualmente usando os atributos de controle. O "caminho de correspondência" é uma lista de pares de chave/valores que são aplicados, por meio da iteração de cada elemento no HTMLDocument Object Model (DOM), correspondendo atributos junto com os nós do caminho de correspondência. Cada chave representa o nome do atributo para correspondência e o valor é correspondido com o valor do atributo atribuído no documento HTML. Após uma chave/valor ser correspondida, o próximo par de chave/valor na sequência é usado para comparar cada elemento no DOM. Observe que keyn+1 = keyncorrespondente ao novo par de chaves/valor começa com o seguinte nó no elemento, DOM, não no nó atual.

Neste tópico

<AttributeMatchPath> syntax

Elementos <AttributeMatchPath>

<AttributeMatchPath> syntax

O elemento <AttributeMatchPath> pode ser definido em quadros específicos em um aplicativo HTML.

<AttributeMatchPath [framename=""|framesrc=""] [framematch="n"] [matchtype="equals|startswith|endswith|contains"]>

<attributeName1 [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatch1
</attributeName1>

<attributeName2 [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatch2
</attributeName2>

…
<attributeNamen [matchtype= "equals|startswith|endswith|contains"]>
attributeValueToMatchn
</attributeNamen>

</AttributeMatchPath>

Elementos <AttributeMatchPath>

A tabela a seguir descreve os elementos de <AttributeMatchPath>.

Elemento	Descrição
Framename	Corresponde o nome do quadro de IFrame.
Framesrc	Corresponde a origem de IFrame.
Framematch	Corresponde nth do quadro especificado; o padrão é 1.
Matchtype	Especifica como a legenda deve ser correspondida. Os valores possíveis são equals, startswith, endswith, ou contains; qualquer outro valor gerará uma exceção.

Por exemplo, se um aplicativo Web tiver mais de um quadro com um nome, é possível especificar para procurar pelo segundo ou terceiro quadro com esse nome. O atributo framematch não é obrigatório, no entanto é assumido como 1, a menos que especificado. Se framematch for especificado, framename ou framesrc devem ser especificados; caso contrário, será gerada uma exceção "Quadro não encontrado".

Dica

Se nenhum dos atributos AttributeMatchPath forem fornecidos, a operação, ocorrerá na janela de nível superior como se fosse um quadro. Se framename e framesrc forem especificados, framesrc terá prioridade.

No exemplo a seguir, o matchtype é usado no attributeValueToMatch.

<AttributeMatchPath>
<key1>val1</key1>
<key2>val2</key2>
<key3[matchtype="equals|startswith|endswith|contains"]>attributeValueToMatch</key3>
  .
<keyn>valn</keyn>
</AttributeMatchPath>

O exemplo a seguir mostra o caminho correspondente do atributo para uma marca Test.

Page code:  
<Test FirstName='John' LastName='Smith'/>

Match path used in control description:  
<AttributeMatchPath>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
</AttributeMatchPath>

Dica

É altamente recomendável usar somente a ID e/ou o nome como os atributos de pesquisa. Os outros atributos terão impacto negativo em um desempenho.

Confira Também

WebDDA
Use adaptadores orientados a dados (DDAs)

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais