Compartilhar via

Use adaptadores orientados a dados (DDAs)

  • Artigo

 

Publicado: novembro de 2016

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

Os adaptadores orientados a dados geralmente são aproveitados pelo Kit de ferramentas do aplicativo hospedado (HAT). Estes adaptadores são assemblies genéricos que tratam somente da interação com a interface do usuário e não contêm processos empresariais. O SDK de Unified Service Desk é enviado com um DDA que fornece um conjunto de funções comuns que permite que você hospede e acesse uma ampla variedade de aplicativos. Porém, você pode exigir a funcionalidade adicional, dependendo do tipo de aplicativo. Há várias maneiras de estender a funcionalidade existente, como a criação de um novo DDA (e usar um deles em um DDA composto com DDAs externo) e estender DDA existente.

Nesta seção

Tipos de adaptadores orientados a dados

Criando um DDA

Ampliando um DDA existente

Associações

Usando DDAs em adaptadores de aplicativo personalizado

Tipos de adaptadores orientados a dados

Há quatro tipos de DDAs:

Criando um DDA

Você pode criar um novo DDA herdando apenas a classe DataDrivenAdapterBase.

A classe tem o construtor que pode ser sobrecarregado.

Ampliando um DDA existente

Na seção anterior vimos como criar um DDA. Entretanto, se a sua personalização for nominal, você pode usar o DDA existente e ampliá-lo conforme requisitos.

Use as seguintes classes para ampliar os DDAs de UII existentes:

Todas as classes anteriores são originadas da classe DataDrivenAdapterBase.

Associações

Um adaptador orientado a dados usa dados, conhecidos como associações, para definir a maneira que ele identifica um componente de interface do usuário de um aplicativo hospedado. Por exemplo, as associações podem consistir em caminhos de Modelo de objeto de documento (DOM) para descrever os elementos em uma página da Web. O exemplo a seguir mostra uma cadeia de caracteres de inicialização de aplicativos com uma subárvore de associação de DDA. Este é um exemplo geral, mas indica o padrão usado para a implementação de controles de Acc nas associações do Windows.

Dica

Nenhum dos parâmetros de configuração foi removido para maior clareza.

<initstring>
    <interopAssembly>
      <URL>path to executable</URL>
      <Arguments>test argument</Arguments>
      <WorkingDirectory>c:\</WorkingDirectory>
      <hostInside/>
    </interopAssembly>
<!—- notice there is no custom application adapter specified here-->
    <displayGroup>None</displayGroup>
    <optimumSize x="800" y="600"/>
    <minimumSize x="640" y="480"/>
    <DataDrivenAdapterBindings>
      <Type>typeName, assemblyName</Type>
      <Controls>
        <AccControl name="combobox1">
          <Path>
            <FindWindow>
              <ControlID>1003</ControlID>
            </FindWindow>
          </Path>
        </AccControl>
</Controls>
    </DataDrivenAdapterBindings>
</initstring>

Se estiver usando as operações de software HAT, ele criará a InitString. O aplicativo pode ser implantado no servidor usando operações de software.

Se estiver adicionando diretamente um aplicativo hospedado usando a interface do usuário, não é necessário criar InitStringcompleta. Você só precisa especificar a <DataDrivenAdapterBindings> e acrescentá-la à guia Automation Xml.

Usando DDAs em adaptadores de aplicativo personalizado

Embora os DDAs tenham sido criados inicialmente para oferecer suporte a automações dentro do Kit de ferramentas do aplicativo hospedado (HAT), eles também podem ser usados por adaptadores personalizados para obter resultados úteis. A amostra de código a seguir retirada de um adaptador personalizado, ilustra como os adaptadores personalizados podem usar DDAs e mostra as vantagens gerais dos DDAs. Como o exemplo mostra, o uso de DDAs permite uma separação de código e informações de configuração.

DataDrivenAdapter Dda;
public overrIDe bool Initialize()
{
   Dda=DataDrivenAdapter.CreateInstance(ApplicationInitString,ApplicationObject);
   return (Dda != null);
}
public overrIDe bool DoAction(Action action, ref string data)
{
if (action.Name == "AddToHistory")
   {
   Dda.ExecuteControlAction("combobox1");
   Dda.SetControlValue("textbox1", data);
   Dda.ExecuteControlAction("button1");
   }
}

A configuração de DDA que está incorporada na InitString do aplicativo, é XML, conforme exemplo a seguir.

<DataDrivenAdapterBindings>
<Type> Microsoft.UII.HostedApplicationToolkit.DataDrivenAdapter.WinDataDrivenAdapter, Microsoft.UII.HostedApplicationToolkit.DataDrivenAdapter</Type>
  <Controls>
    <AccControl name="combobox1">
      <Path>
        <FindWindow>
          <ControlID>1003</ControlID>
        </FindWindow>
      </Path>
    </AccControl>
    <AccControl name="textbox1">
      <Path>
        <FindWindow>
          <ControlID>1001</ControlID>
        </FindWindow>
      </Path>
    </AccControl>
    <AccControl name="button1">
      <Path>
        <FindWindow>
          <ControlID>1002</ControlID>
        </FindWindow>
      </Path>
    </AccControl>
  </Controls>
</DataDrivenAdapterBindings>

O elemento <Type/> direciona o UII para instanciar dinamicamente o tipo especificado no tipo, formato de assembly, permitindo que DDAs personalizados sejam carregados e usados. O elemento <Controls/> contém a lista de controles configurados, especificados da maneira exigida pelo DDA carregado.

Confira Também

Trabalhar com as operações de software de HAT

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais