Gerenciador global (controle hospedado)

 

Publicado: novembro de 2016

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

O tipo de controle hospedado do Gerenciador global é o centro da Unified Service Desk e uma instância desse controle hospedado é exigida pela Unified Service Desk. Este controle hospedado carrega e lê todos os dados de configuração da Unified Service Desk da Microsoft Dynamics 365 na inicialização do aplicativo, interpreta as regras de navegação da janela, fornece dados aos componentes da barra de ferramentas e aos scripts do agente, e gerencia os dados da sessão. Somente uma única instância do tipo de controle hospedado do Gerenciador global pode ser carregada.

Importante

Os três pacotes de aplicativos de exemplo do Unified Service Desk, New Environment, CRM Web Client e Interactive Service Hub, são fornecidos pré-configurados cada um com uma instância do tipo de controle hospedado Gerenciador Global. Para saber mais sobre os aplicativos de exemplo, confira TechNet: Implantar aplicativos de exemplo do Unified Service Desk no servidor do CRM usando o Package Deployer.

Além do fornecimento de interpretação para a maioria das funções na Unified Service Desk, o tipo de controle hospedado do Gerenciador global também oferece recursos multilíngues no sistema, possibilitando localizar mensagens e cadeias de caracteres da interface do usuário no aplicativo em vários idiomas. Para obter mais informações, consulte Adicionar suporte para vários idiomas aos aplicativos agentes. Ele também oferece o provedor de pesquisa, que é projetado para ser genérico e adaptável por meio da configuração.

Neste tópico

Crie um controle hospedado do Gerenciador global

Ações de UII predefinidas

Eventos predefinidos

Crie um controle hospedado do Gerenciador global

Ao criar um novo controle hospedado, os campos na tela Novo controle hospedado variam de acordo com o tipo de controle hospedado que você deseja criar. Esta seção fornece informações sobre os campos específicos que são exclusivos para o tipo de controle hospedado do Gerenciador global. Para obter informações detalhadas sobre como criar um controle hospedado, consulte Criar ou editar um controle hospedado.

Na tela Novo controle hospedado dentro da área Unified Service Desk, selecione Gerenciador global na lista suspensa Tipo de componente de USD. Além disso, verifique se o valor de Ordem de Classificação desse controle hospedado foi definido como 2 para garantir que ele seja carregado por seu aplicativo agente imediatamente após a conexão ter sido estabelecida com o Dynamics 365 usando o controle hospedado Gerenciador de Conexão. Para obter mais informações sobre outros campos Gerais, consulte Criar ou editar um controle hospedado.

Depois de salvar o registro, a área Serviços linguísticos fica disponível no local onde é possível adicionar recursos na interface do usuário do aplicativo do agente para adição de cadeias de caracteres localizadas. Para obter informações sobre como adicionar recursos de idioma, consulte Adicionar suporte para vários idiomas aos aplicativos agentes.

Ações de UII predefinidas

O Gerenciador global fornece uma série de ações predefinidas que permitem manipular dados do registro Dynamics 365 por meio dos serviços da Web. Estas podem ser usadas durante a configuração para executar funções avançadas em Dynamics 365.

As seguintes ações predefinidas de UII ficam disponíveis para o tipo de controle hospedado do Gerenciador global:

Auditar

Adiciona uma entrada de auditoria aos logs de auditoria do Unified Service Desk. Para obter mais informações, consulte Technet: Configurar auditoria no Unified Service Desk.

Parâmetro	Descrição
Name	Nome de entrada de auditoria. Você deve adicionar uma opção na área Opções (Configurações > Unified Service Desk > Opções (Como chego lá?)) com o valor definido como 1.
Ação	Cadeia de caracteres representando a ação que está sendo auditada.
AplicativoDeDestino	Cadeia de caracteres representado o aplicativo de destino para auditoria.
IDdoCliente	Cadeia de caracteres representando a ID do cliente.
IDdoContexto	Cadeia de caracteres representando a ID do contexto.
IDdoAplicativo	GUID do controle hospedado para a auditoria.
EstadodoAgente	Cadeia de caracteres representando o estado do agente
DadosDaAção	Dados para gravar na entrada de auditoria. Se este parâmetro não for fornecido explicitamente, ele usará todas as linhas restantes no campo Dados da definição de chamada de ação.

CallDoAction

Chama uma ação em outro controle hospedado.

Parâmetro	Descrição
painel	Este é o painel para localizar o aplicativo ativo, se nenhum for especificado.
ação	Esta é a ação usada para chamar o controle hospedado.
dados de	Este é o parâmetro de dados para transmitir à ação.
aplicativo	Este é o nome do controle hospedado para o qual você deseja executar uma chamada de ação. Se isso for especificado, o parâmetro painel será ignorado.

LimparBarraDoAplicativo

Desencaixa um controle hospedado especificado no aplicativo do cliente.

Parâmetro	Descrição
ApplicationName	O nome do controle hospedado a ser desencaixado. Se esse parâmetro não for fornecido, a janela principal do aplicativo do cliente será desencaixada.

LimparListaDeEntidade

Limpa a lista de resultados acumulados da pesquisa e deve sempre ser chamada antes de chamar a ação DoSearch.

Parâmetro	Descrição
global	True se desejar que os resultados da pesquisa associados à sessão global sejam desmarcados. É necessário ter cuidado ao armazenar os resultados da pesquisa na sessão global, já que eles não são limpos automaticamente pelo sistema. Nesse caso, chame a ação LimparListaDeEntidade antes de chamar a ação FazerPesquisa.

Fechar

Fecha o controle hospedado. Diferentemente da ação FecharAtivo, se esta guia estiver exibindo mais de uma página, ela fechará todas as páginas exibidas na guia do seu aplicativo do agente.

FecharAtivo

Fecha o controle hospedado ativo no painel especificado.

Parâmetro	Descrição
	A primeira linha na chamada de ação deve conter o nome do painel para localizar o aplicativo ativo. Se nenhum parâmetro for especificado, MainPanel será assumido.

CopyToClipboard

Copia ou acrescenta a URL do artigo na Área de Transferência.

Parâmetro	Descrição
Dados do	Dados que deverão ser copiado. Você também pode usar parâmetros de substituição. Por exemplo: data=[[$context.title]]
append	Indica se os dados devem ser acrescentados à Área de Transferência. Defina true ou false. Por exemplo: append=false.

CopiarParaContexto

Copia um valor ou uma série de valores para variáveis de contexto. As variáveis de contexto podem ser serializadas com a sessão. Esta ação pega uma série de nomes = pares de valor. O nome é o da variável de contexto.

CopiarEntidadeLógicaParaContexto

Copia valores de uma seção inteira de parâmetros dos dados para o contexto.

Parâmetro	Descrição
LogicalName	O tipo ou a seção de parâmetros de dados do qual copiar os valores.

FecharAtividade

Fecha um registro de atividade no Dynamics 365.

Parâmetro	Descrição
ID	O GUID do registro de atividade a ser fechado.
LogicalName	O nome lógico da atividade a ser fechada.
CódigoDeStatus	O nome de exibição do código de status final após a atividade ser fechada.
CódigoDeEstado	O nome de exibição do código de estado final após a atividade ser fechada.

Por exemplo, para fechar uma atividade de telefonema, especifique o seguinte:

Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed

Após o registro de atividade ser fechado, o parâmetro de substituição do sistema $Retorno será preenchido com um valor booliano que indica se a ação foi bem-sucedida.

CriarEntidade

Cria um novo registro no Dynamics 365.

Parâmetro	Descrição
LogicalName	O nome lógico da entidade a ser criada.

Cada linha subsequente na lista de parâmetros contém uma série de pares de Nome=Valor que definirão os outros campos a serem preenchidos na criação.

As referências de entidade podem ser descritas da seguinte maneira:

Param=EntityReference(“logicalname”, “id”)

OptionSetValues pode ser especificado da seguinte maneira:

Param=OptionSetValue(value)

As referências boolianas podem ser descritas da seguinte maneira:

Param=Boolean(value)

A ListaDeEntidade (usada por e-mail) pode ser descrita da seguinte maneira:

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

É possível usar qualquer número de email e entradas er para representar endereços de e-mail e referências de entidade respectivamente.

Outros valores, como valores da cadeia de caracteres, podem ser especificados da seguinte maneira:

Param=value

Quando o registro for criado, o valor de $Retorno será populado com o GUID do registro recém-criado.

CriarSessão

Cria uma sessão.

DeleteEntity

Exclui um registro do Dynamics 365.

Parâmetro	Descrição
ID	A ID do valor para exclusão. Isso deve ser o GUID do registro a ser excluído.
LogicalName	O nome lógico da entidade a ser excluída.

Encaminhar

Pode ser usada para testar as regras de navegação da janela simulando uma janela pop-up de um controle hospedado específico. Pode ser usada na produção para disparar manualmente as regras de navegação da janela conforme a necessidade.

Parâmetro	Descrição
nome	A ID da entidade que é o destino do queueItem
Entidade	O nome lógico da entidade que é aberta em uma janela pop-up.
id	A ID da entidade que será aberta em uma janela pop-up.
quadro	O quadro no qual o pop-up vai ocorrer.

FazerPesquisa

Chama os serviços Web do Dynamics 365 usando FetchXML definido como uma pesquisa de entidade no Unified Service Desk para obter mais informações sobre a configuração de uma pesquisa da entidade, consulte Consultar dados usando pesquisas de entidade no Unified Service Desk.

Parâmetro	Descrição
name	O nome de pesquisa de entidade a ser usado para pesquisar o registro.
global	True se desejar que os resultados da pesquisa associados à sessão global sejam desmarcados. É necessário ter cuidado ao armazenar os resultados da pesquisa na sessão global, já que eles não são limpos automaticamente pelo sistema. Nesse caso, chame a ação LimparListaDeEntidade antes de chamar esta ação.
maxcount	O número máximo de registros a serem armazenados nos resultados de EntityList dessa chamada.

Dica

Por padrão, a contagem da página (número de registros por página) para um resultado está definido como 50. Isso significa que se houver mais de 50 registros retornados, serão exibidos em páginas. Se quiser especificar um valor de contagem de página diferente para a ação DoSearch, especifique o novo valor na opção EntitySearchPageCount.Para obter mais informações:TechNet: Gerenciar as opções do Unified Service Desk

Quando você chamar a ação DoSearch, o parâmetro de substituição $Return exibirá o número de registros localizados e armazenados na EntityList como resultado desta pesquisa.Para obter mais informações:$Retorno.

ExibirMensagem

Exibe uma caixa de mensagem para o usuário.

Parâmetro	Descrição
text	Este é o texto exibido na caixa de mensagem. Se esse parâmetro não for especificado, todo o texto que restar (parâmetro restante) ou a cadeia de caracteres vazia serão usados.
legenda	Esta é a legenda exibida na caixa de mensagem. Se nenhuma legenda for especificada, a opção Dynamics 365 Mensagem será usada.

ExecuteOnDataAvailable

Atrasa a execução das subações até um conjunto especificado de parâmetros de substituição ser disponibilizado. Um valor de tempo limite pode ser especificado para limitar a quantidade de tempo de espera até que os parâmetros de substituição sejam disponibilizados. Se nenhum tempo limite for especificado, o tempo de espera será indefinido até o término da sessão.Para obter mais informações:Blog: Como usar ações especiais, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Parâmetro	Descrição
milissegundos	O tempo, em milissegundos, para indicar o tempo de espera antes que essa ação expire, e seja cancelada. Os parâmetros restantes devem conter os parâmetros de substituição que precisam existir para que as subações sejam executadas. Exemplo de Parâmetro de Dados: milissegundos=5000 [[account.Id]] [[incident.Id]]

Importante

Essa ação se aplica a todos os tipos de controle hospedado. Esta ação não é exposta por padrão quando você cria uma instância de um tipo de controle hospedado. Para usar a ação ExecuteOnDataAvailable com uma instância de um tipo de controle hospedado, você deve adicionar explicitamente uma ação de UII chamada ExecuteOnDataAvailable à respectiva instância do controle hospedado.Para obter mais informações:Adicione uma ação de UII a um controle hospedado

ExecuteOnTimeout

Atrasa a execução das subações até um tempo específico ter decorrido. Um valor de tempo limite é necessário para indicar quando as subações devem ser executadas.Para obter mais informações:Blog: Como usar ações especiais, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Parâmetro	Descrição
milissegundos	O tempo, em milissegundos, para indicar o tempo de espera até que as subações sejam executadas. Exemplo de Parâmetro de Dados: milissegundos=5000

Importante

Essa ação se aplica a todos os tipos de controle hospedado. Esta ação não é exposta por padrão quando você cria uma instância de um tipo de controle hospedado. Para usar a ação ExecuteOnTimeout com uma instância de um tipo de controle hospedado, você deve adicionar explicitamente uma ação de UII chamada ExecuteOnTimeout à respectiva instância do controle hospedado.Para obter mais informações:Adicione uma ação de UII a um controle hospedado

ExecuteOnExpressionTrue

Atrasa a execução das subações até que uma expressão JavaScript especificada retorne true. Um valor de tempo limite pode ser especificado para limitar a quantidade de tempo de espera antes de expirar. Se nenhum tempo limite for especificado, o tempo de espera será indefinido até o término da sessão.Para obter mais informações:Blog: Como usar ações especiais, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue

Parâmetro	Descrição
milissegundos	O tempo, em milissegundos, para indicar o tempo de espera antes que essa ação expire e seja cancelada. O parâmetro restante é uma expressão JavaScript a ser avaliada. Quando essa expressão for true, as subações serão executadas. Exemplo de Parâmetro de Dados: milissegundos=5000 function IsAccountLoaded() { return “[[account.Id]$+]” != “”; } IsAccountLoaded();

Importante

Essa ação se aplica a todos os tipos de controle hospedado. Esta ação não é exposta por padrão quando você cria uma instância de um tipo de controle hospedado. Para usar a ação ExecuteOnExpressionTrue com uma instância de um tipo de controle hospedado, você deve adicionar explicitamente uma ação de UII chamada ExecuteOnExpressionTrue à respectiva instância do controle hospedado.Para obter mais informações:Adicione uma ação de UII a um controle hospedado

ExecutarScriptlet

Executa o scriptlet especificado.

Parâmetro	Descrição
	Especifique o nome do scriptlet a ser executado no campo Dados.

FireEvent

Aciona um evento definido pelo usuário neste controle de hospedado.

Parâmetro	Descrição
nome	Nome do evento definido pelo usuário.

Todos os pares subsequentes de nome=valor se tornam os parâmetros do evento. Para obter mais informações sobre como criar um evento definido pelo usuário, consulte Criar um evento definido pelo usuário.

ObterModelo

Recupera o conteúdo de um modelo de e-mail mesclado.

Parâmetro	Descrição
nome	Nome do modelo a ser recuperado.
id	A ID da entidade a ser associada a esse modelo para a operação de mesclagem.

InvocarCTI

Simula eventos CTI.

Parâmetro	Descrição
type	Este é o tipo de evento CTI, como telefonema e chat.
appname	O nome do gerenciador de área de trabalho a ser usado para essa simulação de pop-up.
ani	A identificação do número automático (ANI) ou o número de telefone dos chamadores.
DNIS	O DNIS ou o número discado.
	Todos os parâmetros restantes serão transmitidos como parâmetros ao processador de evento de CTI.

LaunchURL

Inicia uma URL do lado de fora de Internet Explorer do aplicativo Unified Service Desk. Você deve especificar a URL como um parâmetro no campo Dados.

LookupQueueItem

Procura por um queueitem no sistema e obtém as informações.

Parâmetro	Descrição
ID	A ID da entidade que é o destino do queueItem
EntityType	O tipo ou nome lógico da entidade referido no campo da ID.

Os detalhes resultantes de queueitem serão colocados no parâmetro de substituição queueitem e poderão ser consultados posteriormente.

MoverAplicativoAoPainel

Move um controle hospedado para o painel especificado no aplicativo cliente.

Parâmetro	Descrição
aplicativo	Nome do controle hospedado a ser movido.
panel	Nome do painel de destino.

MoveToPanel

Move controles hospedados entre painéis em tempo de execução.

Parâmetro	Descrição
app	Nome do controle hospedado a ser movido.
painel	Painel de destino para o controle hospedado.

New_CRM_Page

Cria uma página para criar um novo registro Dynamics 365 da entidade especificada e executa a página como um pop-up do controle hospedado especificado. As regras de navegação da janela são avaliadas para determinar o local onde será apresentada a página para criar o registro da entidade.

Parâmetro	Descrição
LogicalName	O nome lógico da entidade para criar uma nova instância.

Dica

O restante dos parâmetros deve consistir em nome=pares de valores. Estes são os valores adicionais preenchidos previamente no formulário para criação de um novo registro da entidade especificada. Para obter mais informações sobre como usar esta ação, consulte a etapa 4 em Passo a passo 7: Configurar o script do agente no aplicativo agente.

Open_CRM_Page

Abre uma instância existente da entidade especificada e identificada pela ID e executa a página como um pop-up do controle hospedado especificado. As regras de navegação da janela são avaliadas para determinar o local onde o pop-up deve ser exibido.

Parâmetro	Descrição
LogicalName	O nome lógico da entidade a ser aberta.
id	A ID do registro da entidade a ser aberta.

Pausar

Pausa a execução da ação sem bloquear o processamento da mensagem. Esta ação é diferente de suspender o thread atual por um período especificado (Thread.Sleep), pois ela permite a continuação do processamento. Esta ação é útil quando você está aguardando a conclusão de operações da Web.

Parâmetro	Descrição
milissegundos	O número de milissegundos para pausar.

Pop-up

Faz surgir um pop-up da URL de um controle hospedado e executa as regras de navegação da janela diante dele para encaminhar o pop-up ao local adequado.

Parâmetro	Descrição
url	Encaminha um pop-up desse controle hospedado usando a URL como se fosse um pop-up solicitado do controle exibido.
quadro	O quadro do qual o pop-up foi originado.

RealignWindow

Exibe o controle hospedado no local especificado de um monitor. Você pode exibir o controle hospedado em até dois monitores. Essa ação é aplicável em instâncias de controle hospedado que foram configuradas para serem posicionadas em tipo de painel USDFloatingPanel ou USDFloatingToolPanel.

Parâmetro	Descrição
screen	Especifica a tela na qual o controle hospedado será exibido. Os valores válidos são 1 ou 2. Caso esse parâmetro não seja especificado, o valor 1 é considerado o padrão.
left	Especifica a posição, sob a forma de percentual, à esquerda da tela, no monitor de destino onde o controle hospedado deve ser exibido. Os valores válidos são 0 a 100. Caso esse parâmetro não seja especificado, o valor 0 é considerado o padrão.
top	Especifica a posição, sob a forma de percentual, acima da tela, no monitor de destino onde o controle hospedado deve ser exibido. Os valores válidos são 0 a 100. Caso esse parâmetro não seja especificado, o valor 0 é considerado o padrão.
width	Especifica a largura, sob a forma de percentual, do controle hospedado no monitor de destino. Os valores válidos são 1 a 100. Caso esse parâmetro não seja especificado, o valor 100 é considerado o padrão.
height	Especifica a altura, sob a forma de percentual, do controle hospedado no monitor de destino. Os valores válidos são 1 a 100. Caso esse parâmetro não seja especificado, o valor 100 é considerado o padrão.

ReadSettings

Esta opção lê as configurações já salvas previamente a partir do parâmetro de substituição $Configurações.

Parâmetro	Descrição
readfromcache	True se desejar ler a versão armazenada em cache local nessas configurações.False ou de outra forma.

RefazerPopDeTela

Exibe a última tela novamente. Isso pode ser útil nos casos em que talvez o limite da sessão tenha sido alcançado e, assim, o pop não tenha sido bem-sucedido, ou se a sessão de trabalho for fechada e for necessário mais trabalho. Esta ação não requer nenhum parâmetro.

RedefinirCacheLocal

Redefine o cache de configuração no Unified Service Desk. Da próxima vez que a Unified Service Desk for iniciada, ela fará o download da configuração do servidor. O usuário deve ter acesso de gravação à entidade de msdyusd_usersettings para que esta ação funcione.

EncaminharParaFila

Encaminha uma entidade para uma fila no Dynamics 365.

Parâmetro	Descrição
destino	A ID da fila de destino. Ela é mutuamente exclusiva com o parâmetro destinationqueuename.
destinationqueuename	Este é o nome da fila para encaminhar a entidade.
entitytype	Este é o nome lógico da entidade a ser encaminhada.
entityid	Este é o GUID/ID da entidade a ser colocado na fila.

SalvarTodos

Salva todos os formulários no controle hospedado que permitem que várias páginas sejam exibidas (Permitir Várias Páginas = Sim). Se o controle hospedado permitir que uma única página seja exibida (Permitir várias páginas = Não), isso será equivalente à ação Salvar.

SalvarConfiguração

Armazena uma configuração específica do usuário.

Parâmetro	Descrição
nome	O nome da configuração. Isto será exibido no parâmetro de substituição $Configurações.
valor	O valor da configuração a ser salva.

DefinirTema

Aplica um tema para alterar o layout e/ou a aparência dos componentes da interface do usuário.Para obter mais informações:Personalizar a aparência do aplicativo

Parâmetro	Descrição
limpar	True se você desejar limpar completamente o tema atual antes de aplicar o tema especificado. Se este parâmetro for falso ou não especificado, as informações do novo tema serão mescladas com o tema atual.
	O parâmetro remanescente (que for deixado após os outros parâmetros serem removidos), deve conter o nome do tema a ser usado. Este deve ser um arquivo XAML (renomeado como XML e carregado como um recurso da Web) nome do recurso da Web, um URL do servidor de acesso anônimo ou XAML bruto representando o tema.

DefinirBarraDoAplicativo

Encaixa um controle hospedado na borda especificada da janela principal do aplicativo cliente.

Parâmetro	Descrição
ApplicationName	O nome do controle hospedado a ser encaixado. Se esse parâmetro for especificado, a janela principal que estiver hospedando o controle hospedado será encaixada.
width	A largura em pixels da janela encaixada. Se isso não for especificado, a largura atual da janela será usada.
height	A altura em pixels da janela encaixada. Se isso não for especificado, a altura atual da janela será usada.
Borda	A borda para encaixar. Se nada for especificado, o valor Superior será assumido. Especifique um dos seguintes valores: Superior, Inferior, Esquerdo ou Direito.

DefinirTemporizadorDoEvento

Define um timer de evento para iniciar.

Parâmetro	Descrição
nome	Nome do temporizador do evento.

SetSize

Define a largura e a altura do controle hospedado. Isso é especialmente útil ao utilizar a opção "automática" nos layouts do painel.

Parâmetro	Descrição
width	A largura do controle hospedado.
height	A altura do controle hospedado.

ConfigurarPropriedadeDaJanela

Define o estado da janela para a janela principal do aplicativo cliente.

Parâmetro	Descrição
EstadoDaJanela	Um dos seguintes valores: maximizado, minimizado ou normal.

ShellExecute

Esta ação deve iniciar uma URL ou uma linha de comando. Observe que o usuário deve ter direitos de execução do aplicativo.

Parâmetro	Descrição
	O único parâmetro é a linha de comando ou a URL do aplicativo em execução.

MostrarSobre

Exibe a caixa de diálogo Sobre do Unified Service Desk que contém informações como o nome do usuário atual, o servidor do Dynamics 365 e a organização à qual o usuário está conectado, o número da versão do aplicativo cliente Unified Service Desk e a URL do site de suporte.

ShowTab

Define o foco em uma guia (controle hospedado) em seu aplicativo agente.

Parâmetro	Descrição
	A primeira linha na chamada de ação deve conter o nome do controle hospedado para exibição no primeiro plano. Não use o nome de exibição do controle hospedado. Para obter mais informações sobre como usar esta chamada de ação, consulte a etapa 4 em Passo a passo 2: Exibir uma página Web externa no aplicativo agente.

PararTemporizadorDoEvento

Para um timer de evento.

Parâmetro	Descrição
nome	Nome do temporizador do evento a ser interrompido.

Traduzir

Permite que você execute a tradução de idiomas usando o Microsoft Translator.

Parâmetro	Descrição
Valor de	Este é o texto a ser traduzido. Este valor pode ser salvo para suporte multilinha. Alguns exemplos válidos: value=$Escaped("my string<br>new line\\\"my text\\\"") value=[[myapp.myparam]^] value=$Escaped([[myapp.myparam]$]) Para obter mais informações sobre essas chaves de substituição, consulte Usar parâmetros de substituição para configurar o Unified Service Desk.
fromlanguage	Nome do idioma a ser traduzido. Se estiver em branco, o sistema tentará detectar o idioma do valor especificado a ser traduzido antes da tradução. Para obter uma lista de valores válidos de idiomas, consulte Códigos de idioma do tradutor.
tolanguage	Nome do idioma de destino da tradução. Para obter uma lista de valores válidos de idiomas, consulte Códigos de idioma do tradutor.
IDdoCliente	Uma ID do cliente obtida do Microsoft Azure para serviços de tradução. Para informações sobre como registrar com Azure, consulte https://datamarket.azure.com.
clientsecret	Um segredo do cliente obtido do Microsoft Azure para serviços de tradução. Para informações sobre como registrar com Azure, consulte https://datamarket.azure.com.

O valor traduzido é exibido no parâmetro de substituição $Retorno.

UpdateEntity

Atualiza um registro no Dynamics 365.

Parâmetro	Descrição
ID	A ID do valor a ser atualizado. Deve ser o GUID do registro a ser atualizado.
LogicalName	O nome lógico da entidade a ser atualizada.

Cada linha subsequente na lista de parâmetros contém uma série de pares de Nome=Valor que definirão os outros campos a serem preenchidos na atualização.

As referências de entidade podem ser descritas da seguinte maneira:

Param=EntityReference(“logicalname”, “id”)

O ValorDeDefiniçãoDaOpção pode ser especificado da seguinte maneira:

Param=OptionSetValue(value)

As referências boolianas podem ser descritas da seguinte maneira:

Param=Boolean(value)

A ListaDeEntidade (usada por e-mail) pode ser descrita da seguinte maneira:

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

É possível usar qualquer número de e-mail e entradas er para representar endereços de e-mail e referências de entidade respectivamente.

Outros valores, como valores da cadeia de caracteres, podem ser especificados da seguinte maneira:

Param=value

Trabalhar

Esta ação é equivalente a selecionar um item de uma fila e clicar no botão WorkOn na faixa de opções. Ela marca o item da fila como sendo trabalhado por um agente específico.

Parâmetro	Descrição
ID	Esta é a ID do queueitem. Consulte LookupQueueItem para verificar mais informações sobre como obter a ID de uma entidade de destino.
Ação	Parâmetros opcionais permitindo que o administrador especifique que deseja remover o atributo do WorkOn para retornar à fila. Valores válidos: Remover – Remove o atributo WorkOn e retorna o item para a fila para que outros trabalhem nele.

Eventos predefinidos

Aqui estão os eventos predefinidos associados ao controle hospedado.

ÁreaDeTrabalhoPronta

Ocorre na inicialização quando toda inicialização da área de trabalho tiver sido completada e as conexões com o Dynamics 365 tiverem sido estabelecidas. Este evento será acionado uma só vez e é comum usar este evento para definir temas e fazer outras ações de inicialização.

SessãoAtivada

Ocorre sempre que uma sessão for ativada.

Parâmetro	Descrição
SessionId	ID da sessão ativa no momento.
IsGlobal	Indica se este evento aplica-se à sessão global. Retorna Verdadeiro ou Falso.
Ativar	Isso é configurado como Verdadeiro.

SessionClosed

Ocorre quando uma sessão é fechada.

Parâmetro	Descrição
SessionId	ID da sessão que foi fechada.
IsGlobal	Indica se este evento aplica-se à sessão global. Retorna Verdadeiro ou Falso.

SessãoDesativada

Ocorre quando uma sessão é desativada.

Parâmetro	Descrição
SessionId	ID da sessão inativa.
IsGlobal	Indica se este evento aplica-se à sessão global. Retorna Verdadeiro ou Falso.
Ativar	Isso é configurado como Falso.

NovaSessão

Ocorre quando uma nova sessão é criada.

Parâmetro	Descrição
SessionId	ID da sessão recém-criada.
IsGlobal	Retorna à configuração Verdadeiro se a nova sessão for uma sessão global. Caso contrário, retorna à configuração Falso.

Confira Também

Ações da UII
Eventos
Visualizar ações e eventos predefinidos para um controle hospedado
Visualizar ajuda incorporada para ações e eventos
Passo a passo da configuração do Unified Service Desk
Tipos de controle hospedado e referência de ação/evento
TechNet: Guia de administração do Unified Service Desk for Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais