Compartilhar via

Tipo de atividades para automatização de HAT

  • Artigo

 

Publicado: novembro de 2016

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

Há vários tipos de atividades de automação de Kit de ferramentas do aplicativo hospedado (HAT) que você pode usar para automatizar seus aplicativos hospedados. Para exibir e usar as atividade de automação de HAT, consulte Usar atividades para automatização de HAT.

Neste tópico

Atividades da ação da Estrutura de integração de aplicativos (AIF)

Atividades de contexto de AIF

Atividades de DDA

Atividades da ação da Estrutura de integração de aplicativos (AIF)

As atividades de ação fornecem a funcionalidade para acessar e gerenciar Ações da UII. A tabela a seguir descreve as diversas atividades de ação disponíveis.

Atividade

Descrição

DoAction

Executa uma ação no mesmo aplicativo ou em outro aplicativo hospedado. Essa ação tem as seguintes propriedades:

  • ApplicationName: o aplicativo no qual você deseja executar DoAction. Obrigatório.

  • ActionData: Dados necessários para executar a ação. Opcional.

  • ActionName Nome da ação que é registrado no aplicativo hospedado especificado na propriedade ApplicationName. Obrigatório.

GetActionData

Recupera os dados da ação que chamou o fluxo de trabalho ou a automação. O valor será retornado na propriedade ActionData.

SetActionData

Adiciona dados à ação atual.

Especifica os dados necessários para a ação no parâmetro ActionData.

RegisterActionForEvent

Registra uma ação ser iniciada sempre que um evento ocorre. Essa ação tem as seguintes propriedades:

  • ActionApplication: Nome do aplicativo com o qual ação de UII é registrada. Obrigatório.

  • ActionName: Nome da ação para o aplicativo a ser executado quando o evento for iniciado. Obrigatório.

  • ApplicationName: Nome do aplicativo que inicia o evento. Obrigatório.

  • ControlName: Nome do controle que inicia o evento. Opcional.

  • EventName: Nome do evento iniciado pelo aplicativo/controle.

UnRegisterActionForEvent

Cancela o registro de uma ação que foi registrada anteriormente usando a atividade RegisterActionForEvent. O evento com o registro cancelado não será mais executado. Essa ação tem as seguintes propriedades:

  • ActionApplicationName: Nome do aplicativo com o qual ação de UII é registrada.

  • ActionName: Nome da ação do aplicativo que foi executada quando o evento foi iniciado.

  • ApplicationName: Nome do aplicativo que inicia o evento.

  • ControlName: Nome do controle que inicia o evento.

  • EventName: Nome do evento iniciado pelo aplicativo ou controle.

CloseDynamicApp

Fecha um aplicativo dinâmico hospedado na automação. Você pode usar essa ação para fechar de forma programática aplicativo dinâmico hospedado Unified Service Desk.

Especifica o nome do aplicativo dinâmico hospedado no parâmetro ApplicationName que você deseja fechar.

Para obter mais informações sobre aplicativos dinâmicos hospedados, consulte Aplicativos hospedados dinâmicos do UII.

StartDynamicApp

Inicia um aplicativo dinâmico hospedado na automação.

Especifica o nome do aplicativo dinâmico hospedado no parâmetro ApplicationName que você deseja iniciar.

FocusApp

Define o foco de um aplicativo na automação.

Especifica o nome do aplicativo hospedado no parâmetro ApplicationName no qual você deseja definir o foco.

Atividades de contexto de AIF

As atividades de contexto permitem acessar o contexto de AIF na automação. A tabela a seguir descreve as diversas atividades de contexto disponíveis.

Atividade

Descrição

GetContext

Recupera um valor da chave especificada do contexto. O valor será retornado na propriedade ContextValue.

Especifica a chave de contexto a ser recuperada na propriedade ContextKey.

SetContext

Define o valor da chave especificada no contexto. Essa ação tem as seguintes propriedades:

  • ContextKey: Chave de contexto a ser definida.

  • ContextData: Opcionalmente, insira os dados a serem definidos no contexto ContextKeyespecificado.

GetCredential

Recupera credenciais do usuário do contexto do aplicativo especificado. Essa ação tem as seguintes propriedades:

  • ApplicationName: nome do aplicativo.

  • UserName: nome do usuário.

  • Password: Senha.

Dica

Para recuperar as credenciais de um armazenamento personalizado, o desenvolvedor precisará fornecer uma classe que implementa a interface ISsoLookupService.

HostApplication

Hospeda a interface do usuário do aplicativo. Ela usa os dados de configuração do Host do aplicativo especificados durante a configuração do controle hospedado no Unified Service Desk no servidor Microsoft Dynamics 365 para determinar o modo de hospedagem. Para obter mais informações sobre como especificar o modo de hospedagem de um aplicativo no Unified Service Desk, consulte Criar e gerenciar aplicativos hospedados UII.

Atividades de DDA

As atividades do adaptador orientado a dados (DDA) fornece acesso a controles especificados nas associações. A tabela a seguir descreve várias atividades de DDA.

Atividade

Descrição

ControlFinder

Localiza um controle no aplicativo hospedado. A ação retorna True se o controle for encontrado na propriedade ControlFound; caso contrário, retorna False. É possível definir a propriedade ExceptionsMask se você quiser usar o manipulador de exceção para executar atividades de dependência. Essa ação tem as seguintes propriedades:

  • ApplicationName: Nome do aplicativo que hospeda o controle. Obrigatório.

  • ControlName: Nome do controle no aplicativo.

  • ExceptionsMask: Indica se você deseja mostrar uma exceção se o controle não for encontrado. A configuração padrão é False.

Dica

Se um fluxo de trabalho que você configurou estiver bloqueando o thread da interface do usuário e você especificou os parâmetros SleepInterval e Timeout para a atividade ControlFinder, a ação deverá ser configurada para ser executada de forma assíncrona.

ExecuteControlAction

Executa a ação padrão de um controle. Por exemplo, se o controle for um botão, a ação padrão será clicar. Essa ação tem as seguintes propriedades:

  • ApplicationName: Nome do aplicativo que hospeda o controle.

  • ControlName: Nome do controle no aplicativo.

GetControlValue

Recupera um valor de um controle no aplicativo. O valor será retornado na propriedade ControlValue. Essa ação tem as seguintes propriedades:

  • ApplicationName: Nome do aplicativo que hospeda o controle.

  • ControlName: Nome do controle no aplicativo cujo valor deve ser recuperado.

Dica

Ao usar a atividade GetControlValue com um controle de texto de várias linhas, todos os novos caracteres de linha serão ignorados e uma cadeia de caracteres única será retornada.

SetControlValue

Define o valor de um controle no aplicativo. Essa ação tem as seguintes propriedades:

  • ApplicationName: Nome do aplicativo que hospeda o controle.

  • ControlName: Nome do controle no aplicativo cujo valor deve ser definido.

  • ControlValue: Digite o valor a ser definido.

Dica

Ao usar a atividade SetControlValue com um controle de texto de várias linhas, todos os novos caracteres de linha serão ignorados e uma cadeia de caracteres única será retornada.

Navigate

Especifica uma URL para a qual o aplicativo Web navega. Por exemplo, use a atividade Navigate para forçar um aplicativo Web para navegar em uma URL específica quando um usuário executar uma tarefa. Essa ação tem as seguintes propriedades:

  • ApplicationName: Nome do aplicativo que hospeda o controle.

  • URL: Especifique a URL junto com a cadeia de caracteres da consulta.

Dica

  • A atividade Navigate não deve ser chamada simultaneamente no navegador da Web. Se for, você receberá os seguintes erros:

    AutomationAdapter (app=Contact,action=__SetControlValue__): Exceção de ação implícita lançada: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: O navegador da Web está ocupado e não pode ser interrompido. Exceção do <GUID> WF/Automação: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DataDrivenAdapterException: DDA0301: O navegador da Web está ocupado e não pode ser interrompido.

  • Para que a atividade Navigate funcione no aplicativo de destino, configure o aplicativo hospedados no Unified Service Desk para usar Adaptador de Automação (HAT) e forneça a seguinte associação no campo XML de Automação:

    <DataDrivenAdapterBindingsCollection>    <DataDrivenAdapterBindings>       <Type>Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.WebDataDrivenAdapter, Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter</Type>       <Controls/>    </DataDrivenAdapterBindings> </DataDrivenAdapterBindingsCollection>

    Para obter mais informações sobre como configurar controles hospedados no Unified Service Desk, consulte Criar e gerenciar aplicativos hospedados UII.

Audit

Cria entradas de auditoria na automação. Essa ação tem as seguintes propriedades:

  • Audit Flag: nome do sinalizador de auditoria.

  • Log data: Valor do sinalizador de auditoria.

Para obter informações sobre vários sinalizadores de auditoria Unified Service Desk, consulte Configurar auditoria no Unified Service Desk no Guia de Administração do Unified Service Desk.

ConfigReader

Leia um valor da configuração na automação. Esta atividade será ler a configuração das definições da Opção no Unified Service Desk ou no arquivo de configuração do aplicativo. Essa ação tem as seguintes propriedades:

  • OptionKey como cadeia de caracteres: Usado para ler a configuração Opção de Unified Service Desk. Para obter mais informações sobre as várias opções, confira o TechNet: Gerenciar opções do Unified Service Desk.

  • XPath como a cadeia de caracteres: Usado para ler o arquivo de configuração do aplicativo.

  • QueryResult como a cadeia de caracteres: Resultados de pesquisa.

InitstringReader

Permite ler o conteúdo de InitString na automação. Essa ação tem as seguintes propriedades:

  • XPath como a cadeia de caracteres: Usado para ler o arquivo de configuração do aplicativo.

  • QueryResult como a cadeia de caracteres: Resultados de pesquisa.

Confira Também

Criar automatização de HAT
Estrutura de integração de aplicativos UII
Use adaptadores orientados a dados (DDAs)

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais