Partilhar via


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.

Global Manager hosted control

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.