Gestor Global (Controlo Alojado)

O tipo de controlo alojado Gestor global é a base de Unified Service Desk, e um exemplo deste controlo alojado é requerido pelo Unified Service Desk. Este controlo alojado carrega e lê todos os dados de configuração do Unified Service Desk a partir do Microsoft Dynamics CRM durante o arranque aplicação, interpreta as regras de navegação nas janelas, fornece dados a componentes da barra de ferramentas e scripts de agente e gere os dados da sessão. Apenas uma única instância do tipo de controlo alojado Gestor global pode ser carregada.

Importante

As quatro aplicações de exemplo para o Unified Service Desk estão pré-configuradas com uma instância do tipo de controlo alojado Gestor Global. Para informações sobre as aplicações de exemplo, consulte TechNet: Aplicações de Exemplo do Unified Service Desk.

Além do fornecimento de interpretação para a maioria das funções de Unified Service Desk, o tipo de controlo alojado Gestor global também fornece funcionalidades multilíngues no sistema para poder cadeias localizar cadeias e mensagem da IU na sua aplicação em vários idiomas. Para mais informações, consulte Adicionar suporte multilingue às aplicações de agente. Também fornece o fornecedor de pesquisa, que foi concebido para ser genérico e adaptável por configuração.

Neste Tópico

Criar um controlo alojado Gestor Global

Ações predefinidas do UII

Eventos predefinidos

Criar um controlo alojado Gestor Global

Para criar um novo controlo alojado, os campos no ecrã Novo Controlo Alojado variam consoante o tipo de controlo alojado que pretende criar. Esta secção fornece informações sobre os campos específicos que são exclusivos para o tipo de controlo alojado Gestor Global. Para obter informações detalhadas sobre a criação de um controlo alojado, consulte Criar ou editar um controlo alojado.

No ecrã Novo Controlo Alojado, na área Unified Service Desk, selecione Gestor global ne lista pendente de Tipo de componente do USD. Além disso, certifique-se de que define o valor de Sequência de Ordenação deste controlo alojado como 2 para garantir que é carregado pela aplicação do agente imediatamente após a ligação com o CRM ser estabelecida usando o controlo alojado Gestor de Ligação. Para informações sobre outros campos Geral, consulte Criar ou editar um controlo alojado.

Depois de guardar o registo, a área Serviços de Idioma fica disponível quando adicionar recursos para adicionar cadeias localizadas à IU da aplicação de agente. Para obter informações sobre como adicionar recursos de idioma, consulte Adicionar suporte multilingue às aplicações de agente.

Ações predefinidas do UII

O gestor global fornece um conjunto de ações predefinidas que lhe permitem manipular dados de registo do CRM através de serviços Web. Estes podem ser utilizados durante a configuração para executar funções avançadas no CRM.

As seguintes ações do UII predefinidas disponíveis para o tipo de controlo alojado Gestor global:

CopyToClipboard

Copia ou acrescenta o URL do artigo à Área de Transferência.

Parâmetro	Descrição
dados	Dados que pretende copiar. Pode também utilizar parâmetros de substituição. Por exemplo: data=[[$context.title]]
append	Indica os dados são ou não acrescentados à Área de Transferência. Defina true ou false. Por exemplo: append=false.

New_CRM_Page

Cria uma página para criar um novo registo do CRM da entidade especificada e trata a página como se fosse um pop-up do controlo alojado especificado. As regras de navegação da janela são avaliadas para determinar a localização onde a página para criar o registo de entidade é apresentada.

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

Nota

O resto dos parâmetros deve ser composto por pares nome=valor. Estes são os valores pré-povoados adicionais no formulário para criar um novo registo da entidade especificada. Para mais informações sobre como utilizar esta ação, consulte o passo 4 em Procedimento 7: Configurar scripting de agente na aplicação de agente.

Open_CRM_Page

Abre uma instância existente da entidade especificada e identificada pelo ID e trata a página como se fosse um pop-up do controlo alojado especificado. As regras de navegação da janela são avaliadas para determinar a localização onde o pop-up deve ser apresentado.

Parâmetro	Descrição
LogicalName	O nome lógico da entidade a abrir.
id	O ID do registo de entidade a abrir.

Pop-up

Apresenta um pop-up o URL do controlo alojado e executa regras de navegação de janela sobre este para encaminhar o pop-up para a localização adequada.

Parâmetro	Descrição
URL	Encaminha um pop-up do controlo alojado utilizando este URL como se este fosse um pop-up pedido pelo controlo apresentado.
frame	A Frame em que este pop-up teve origem.

Fechar

Fecha o controlo alojado. Ao contrário da ação CloseActive, se este separador está a apresentar mais de uma página, irá fechar todas as páginas apresentadas no separador na aplicação de agente.

FireEvent

Aciona um evento definido pelo utilizador a partir deste controlo alojado.

Parâmetro	Descrição
Nome	Nome do evento definido pelo utilizador.

Todos os pares nome=valor subsequentes transformam-se em parâmetros para o evento. Para mais informações sobre como criar um evento definido pelo utilizador, consulte Criar um evento definido pelo utilizador.

MoveToPanel

Move controlos alojados entre painéis em tempo de execução.

Parâmetro	Descrição
Aplicação	Nome do controlo alojado a ser movido.
painel	Painel de destino para o controlo alojado.

SetSize

Define explicitamente a altura e largura de controlo alojado. Isto é particularmente útil para utilizar “auto” nos esquemas de painéis.

Parâmetro	Descrição
width	A largura do controlo alojado.
height	A altura do controlo alojado.

SaveAll

Guarda todos os formulários no controlo alojado que permite que várias páginas sejam apresentadas (Allow Multiple Pages = Yes). Se o controlo alojado permite que apenas uma única página seja apresentada (Allow Multiple Pages = No), é equivalente à ação de Guardar.

DisplayMessage

Apresenta uma caixa de mensagens ao utilizador.

Parâmetro	Descrição
texto	É o texto apresentado na caixa de mensagem. Se este parâmetro não for especificado, todo o texto restante (parâmetro restante) ou uma cadeia vazia serão utilizados.
legenda	É a legenda apresentada na caixa de mensagem. Se não for especificada uma legenda, Mensagem do CRM será utilizado.

ClearEntityList

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

Parâmetro	Descrição
global	True se pretender limpar os resultados da pesquisa associados à sessão global. Deverá ter cuidado ao armazenar resolutados da pesquisa na sessão global porque estes não são limpos automaticamente pelo sistema. Neste caso, deverá chamar a ação de ClearEntityList antes de chamar a ação de DoSearch.

DoSearch

Chama os serviços Web do CRM utilizando FetchXML é definido como uma pesquisa de entidade no Unified Service Desk e o nome da entidade de pesquisa é transmitido como parâmetros para esta chamada de ação. Para mais informações sobre pesquisas de entidade, consulte Procurar dados utilizando pesquisas de entidade no Unified Service Desk.

Parâmetro	Descrição
name	O nome da entidade de pesquisa a utilizar para procurar o registo.
global	True se pretender limpar os resultados da pesquisa associados à sessão global. Deverá ter cuidado ao armazenar resolutados da pesquisa na sessão global porque estes não são limpos automaticamente pelo sistema. Neste caso, deverá chamar a ação de ClearEntityList antes de chamar esta ação.
maxcount	O número máximo de registos para armazenar nos resultados de EntityList da chamada.

Nota

Quando chamar esta ação, o parâmetro de substituição $Return apresenta o número de registos existentes e armazenados em EntityList como resultado desta pesquisa. Para mais informações, consulte $Return.

ShowTab

Define o foco num separador (controlo alojado) na aplicação de agente.

Parâmetro	Descrição
	A primeira linha na chamada de ação tem de conter o nome do controlo alojado a apresentar em primeiro plano. Não utilize o nome a apresentar de controlo alojado. Para mais informações sobre como utilizar esta chamada de ação, consulte o passo 4 em Procedimento 2: Apresentar uma página Web externa na aplicação de agente.

CloseActive

Fecha o controlo alojado ativo do painel especificado.

Parâmetro	Descrição
	A primeira linha na chamada de ação tem de conter o nome do paonel para localizar a aplicação ativa. Se nenhum parâmetro for especificado, é assumido MainPanel.

CallDoAction

Chama uma ação noutro controlo alojado.

Parâmetro	Descrição
painel	Este é o painel para localizar a aplicação ativa, se não for especificada nenhuma aplicação.
ação	A ação a chamar no controlo alojado.
dados	Este é o parâmetro de dados a passar para a ação.
aplicação	Este é o nome do controlo alojado para o qual pretende executar uma chamada de ação. Se for especificado, o parâmetro panel é ignorado.

SetTheme

Aplica um tema para modificar o esquema e e/ou o aspeto e funcionamento dos componentes da interface do utilizador. Para mais informações, consulte Utilizar temas para personalizar o aspeto da aplicação.

Parâmetro	Descrição
clear	True se pretende limpar completamente o tema atual antes de aplicar o tema especificado. Se este parâmetro for falso ou não for especificado, as informações do tema novo serão intercaladas com o tema atual.
	O parâmetro restante (que está à esquerda após os outros parâmetros serem removidos), tem de conter o nome do tema para utilizar. Tem de ser o nome do recurso Web do ficheiro de XAML (mudado o nome para XML e carregado como um recurso Web), um URL de um servidor de acesso anónimo, ou XAML não processado que representa o tema.

SaveSetting

Armazena uma definição específica do utilizador.

Parâmetro	Descrição
Nome	O nome da definição. Irá aparecer na definição $Settings dos parâmetros de substituição.
valor	O valor da definição a guardar.

ReadSettings

Lê as definições anteriormente guardadas na secção $Settings.

Parâmetro	Descrição
readfromcache	True se pretende ler a versão em cache destas definições. False ou em falta.

DoRoute

Pode ser utilizada para testar as regras de navegação na janela simulando uma janela de pop-up de um controlo alojado específico. Pode ser utilizada em produção para acionar manualmente as regras de navegação da janela como pretendido.

Parâmetro	Descrição
Nome	O ID da entidade de destino de queueItem
entidade	O Nome Lógico da entidade que é aberta numa janela de pop-up.
id	O ID da entidade que será aberta numa janela de pop-up.
frame	O frame no qual o pop-up vai ocorrer.

RouteToQueue

Encaminha uma entidade para uma fila no CRM.

Parâmetro	Descrição
destino	O ID da fila de destino. Isto é mutuamente exclusivo com o parâmetro destinationqueuename
destinationqueuename	Este é o nome da fila para encaminhar a entidade.
entitytype	Este é o nome lógico da entidade a encaminhar
entityid	Este é o GUID/Id de entidade a ser colocada na fila.

LookupQueueItem

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

Parâmetro	Descrição
ID	O ID da entidade de destino de queueItem
EntityType	Escreva ou o nome lógico da entidade referida no campo ID.

Os detalhes resultantes de queueitem serão colocados temporariamente no parâmetro de substituição queueitem e podem ser referenciados mais tarde.

WorkOn

Esta ação é equivalente a seleccionar um item de uma fila e a clicar no botão WorkOn no friso. Marca o item de fila como a ser trabalhado por um agente específico.

Parâmetro	Descrição
ID	Este é o ID de queueitem. Consulte LookupQueueItem para obter informações sobre como obter o ID de uma entidade de destino.
Ação	Parâmetro opcional permitindo que o administrador especifique que pretende remover o atributo WorkOn para regressar à fila. Valores válidos: Remove – Remover o atributo WorkOn e devolve o item à fila para ser trabalhado por outros.

Pausa

Coloca em pausa a execução da ação sem bloquear o processamento da mensagem. Esta ação é diferente de suspender o tópico atual durante o período de tempo especificado) (Thread.Sleep) porque a ação permite que o processamento continue. Esta ação é útil quando estiver a aguardar a conclusão de operações Web.

Parâmetro	Descrição
milissegundos	O número de milissegundos a colocar em pausa.

CopyToContext

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

CopyLogicalEntityToContext

Copia os valores de uma secção completa dos parâmetros de dados para o contexto.

Parâmetro	Descrição
LogicalName	O tipo ou secção dos parâmetros de dados a partir dos quais os valores são copiados.

InvokeCTI

Simula eventos CTI

Parâmetro	Descrição
tipo	Este é o tipo de evento de CTI, tal como chamada telefónica e chat.
appname	O nome do gestor de ambiente de trabalho a utilizar para esta simulação de pop-up
ani	A identificação numérica automática ID (ANI) ou o número de telefone do chamador.
dnis	O DNIS ou o número marcado.
	Todos os parâmetros restantes serão transmitidos como parâmetros para o processador de eventos de CTI.

RedoScreenPop

Apresenta novamente o último ecrã. Isto pode ser útil em casos em que o limite de sessão e foi alcançado e o pop-up não teve êxito, ou se tiver fechado a sessão de trabalho mas é necessário mais trabalho. Esta ação não necessita dos parâmetros.

ShellExecute

Esta ação destina-se a iniciar um URL ou uma linha de comandos. NOTA: O utilizador tem de ter direitos da aplicação.

Parâmetro	Descrição
	O parâmetro é a única linha de comandos ou URL da aplicação a executar.

Auditoria

Adiciona uma ação de auditoria aos registos de auditoria do Unified Service Desk. Para mais informações, consulte Technet: Configurar auditorias no Unified Service Desk.

Parâmetro	Descrição
Nome	O nome de entrada de auditoria. Tem de adicionar uma opção na área Opções (Definições > Unified Service Desk > Opções (Como é que chego lá?)) com o valor definido como 1.
Ação	Cadeia que representa a ação que está a ser auditada.
TargetApplication	Cadeia que representa a aplicação de destino para auditoria.
CustomerId	Cadeia que representa o ID de cliente.
ContextId	Cadeia que representa o ID de contexto.
ApplicationId	GUID do controlo alojado para auditoria.
AgentState	Cadeia representando o estado do agente
ActionData	Dados para escrever para a entrada de auditoria. Se este parâmetro não é fornecido explicitamente, irá utilizar todas as linhas restantes no campo Dados da definição da chamada de ação.

CreateEntity

Cria um novo registo no CRM.

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

Cada linha subsequente na lista de parâmetros contém um conjunto de pares Nome=Valor que definirão os outros campos para povoar ao criar.

As referências de entidade podem ser descritas do seguinte modo:

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

OptionSetValue podem ser especificados do seguinte modo:

Param=OptionSetValue(value)

Booleans podem ser descritas do seguinte modo:

Param=Boolean(value)

PartyList (utilizado com correio eletrónico) pode ser descrito do seguinte modo:

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

Pode utilizar qualquer número de correio eletrónico e entradas para representar endereços de correio eletrónico e referências de entidade respetivamente.

Outros valores como valores de cadeia podem ser especificados do seguinte modo:

Param=value

Após o registo ser criado, o valor de $Return será povoado com o GUID do registo acabado de criar.

UpdateEntity

Actualiza um registo no CRM.

Parâmetro	Descrição
ID	O ID de valor para a atualização. Tem de ser o GUID do registo a atualizar.
LogicalName	O nome lógico da entidade a atualizar

Cada linha subsequente na lista de parâmetros contém um conjunto de pares Nome=Valor que definirão os outros campos para povoar ao atualizar.

As referências de entidade podem ser descritas do seguinte modo:

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

OptionSetValue podem ser especificados do seguinte modo:

Param=OptionSetValue(value)

Booleans podem ser descritas do seguinte modo:

Param=Boolean(value)

PartyList (utilizado com correio eletrónico) pode ser descrito do seguinte modo:

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

Pode utilizar qualquer número de correio eletrónico e entradas para representar endereços de correio eletrónico e referências de entidade respetivamente.

Outros valores como valores de cadeia podem ser especificados do seguinte modo:

Param=value

CloseActivity

Fecha um registo de atividade no CRM.

Parâmetro	Descrição
ID	O GUID do registo de atividade a fechar.
LogicalName	O nome lógico da atividade a fechar.
StatusCode	O nome a apresentar de código de estado final após a atividade ser fechada.
StateCode	O nome a apresentar de código de estado final após a atividade ser fechada.

Por exemplo, para fechar uma atividade de chamada telefónica, tem de especificar o seguinte:

Id=<GUID of the phone activity record>

LogicalName=phonecall

statuscode=Received

statecode=Completed

Quando o registo de atividade for fechado, o valor do paramento de substituição do sistema $Return será povoado com um valor Booleano que indica se a solução foi concluída com êxito ou não.

DeleteEntity

Elimina um registo no CRM.

Parâmetro	Descrição
ID	O ID de valor para a eliminação. Tem de ser o GUID do registo a eliminar.
LogicalName	O nome lógico da entidade a eliminar.

CreateSession

Cria uma sessão.

ExecuteScriptlet

Executa o scriptlet especificado.

Parâmetro	Descrição
	Especifique o nome do scriplet a executar no campo de Dados.

ResetLocalCache

Repõe a cache de configuração no Unified Service Desk. Da próxima vez que o Unified Service Desk é iniciado, irá transferir a configuração do servidor. O utilizador tem de ter acesso de escrita à entidade msdyusd_usersettings para esta ação funcionar.

GetTemplate

Obtém o conteúdo de um modelo de correio electrónico intercalado.

Parâmetro	Descrição
Nome	Nome do modelo a obter.
id	O ID da entidade a associar a este modelo da operação de intercalação.

MoveApplicationToPanel

Move um controlo alojado para o painel especificado na aplicação cliente.

Parâmetro	Descrição
Aplicação	Nome do controlo alojado a mover.
painel	Nome do painel de destino.

SetWindowProperty

Define o estado da janela para apresentação da janela principal da aplicação cliente.

Parâmetro	Descrição
WindowState	Um dos seguintes valores: maximized, minimized ou normal.

SetAppBar

Ancora um controlo alojado à extremidade especificada da janela principal da aplicação cliente.

Parâmetro	Descrição
ApplicationName	O nome do controlo alojado a ancorar. Se este parâmetro for especificado, a janela principal que contém este controlo alojado será ancorada.
width	A largura da janela ancorada em pixéis. Se não for especificada, a largura atual da janela é utilizada.
height	A altura da janela ancorada em pixéis. Se não for especificada, a altura atual da janela é utilizada.
Edge	A extremidade onde a ancoragem deve ocorrer. Se não for especificado nada, é assumido Top. Especifique um dos seguintes valores: Top, Bottom, Left ou Right.

ClearAppBar

Liberta o controlo alojado especificado na aplicação cliente.

Parâmetro	Descrição
ApplicationName	Nome do controlo alojado a ser libertado. Se este parâmetro não for fornecido, a janela principal da aplicação cliente é libertada.

SetEventTimer

Define um temporizador de evento para iniciar.

Parâmetro	Descrição
Nome	Nome de temporizador de evento.

StopEventTimer

Para um temporizador de evento.

Parâmetro	Descrição
Nome	Nome de temporizador de evento a parar.

Translate

Permite-lhe efectuar a tradução de idioma utilizando o Microsoft Translator.

Parâmetro	Descrição
valor	Este é o texto a traduzir. Este valor pode utilizar códigos para suportar várias linhas. Alguns exemplos válidos: value=$Escaped("my string<br>new line\\\"my text\\\"") value=[[myapp.myparam]^] value=$Escaped([[myapp.myparam]$]) Para mais informações sobre estas chaves de substituição, consulte Utilizar parâmetros de substituição para configurar o Unified Service Desk.
fromlanguage	Nome do idioma de origem da tradução. Se este estiver vazio, o sistema tentará detetar o idioma do valor especificado a traduzir antes da tradução. Para obter uma lista de valores de idioma válidos, consulte Códigos de idioma do Translator.
tolanguage	Nome do idioma de destino da tradução. Para obter uma lista de valores de idioma válidos, consulte Códigos de idioma do Translator.
clientId	Um ID de cliente obtido a partir do Microsoft Azure para serviços de tradução. Para obter informações sobre como registar o Azure, consulte https://datamarket.azure.com.
clientsecret	Um segredo do cliente obtido a partir do Microsoft Azure para serviços de tradução. Para obter informações sobre como registar o Azure, consulte https://datamarket.azure.com.

O valor traduzido é apresentado no parâmetro de substituição de $Return.

ShowAbout

Apresenta a caixa de diálogo Acerca de padrão do Unified Service Desk que contém informações, como o nome do utilizador atual, o servidor de CRM e a organização à qual o utilizador está ligado, o número de versão da aplicação cliente de Unified Service Desk e o URL do suporte.

Eventos predefinidos

Seguem-se os eventos predefinidos associados a este controlo alojado.

DesktopReady

Ocorre no arranque quando toda a inicialização do ambiente de trabalho foi concluída e as ligações foram estabelecidas ao CRM. Este evento só será acionado uma vez e é comum utilizar este evento para definir temas e efetuar outras ações de arranque.

SessionActivated

Ocorre sempre que a sessão é ativada.

Parâmetro	Descrição
SessionId	ID de sessão ativa actualmente.
IsGlobal	Indica se este evento se aplica à sessão global. Devolve True ou False.
Ativar	Definido como True.

SessionClosed

Ocorre quando uma sessão é fechada.

Parâmetro	Descrição
SessionId	Este é o ID da sessão que foi fechada.
IsGlobal	Indica se este evento se aplica à sessão global. Devolve True ou False.

SessionDeactivated

Ocorre quando uma sessão é desativada.

Parâmetro	Descrição
SessionId	ID da sessão inativa.
IsGlobal	Indica se este evento se aplica à sessão global. Devolve True ou False.
Ativar	Definido como False.

SessionNew

Ocorre quando é criada uma nova sessão.

Parâmetro	Descrição
SessionId	ID da sessão recém-criada.
IsGlobal	Devolve True se a nova sessão for uma sessão global. Caso contrário, devolve False.

Consulte Também

Conceitos

Ações do UII
Eventos
Ver ações e eventos predefinidos para um controlo alojado
Ver ajuda incorporada para ações e eventos

Outros Recursos

Procedimentos de configuração do Unified Service Desk
Tipos de controlos alojados e referência de ações e eventos
TechNet: Guia de Administração do Unified Service Desk para Microsoft Dynamics CRM

Unified Service Desk
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.