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: |
append |
Indica os dados são ou não acrescentados à Área de Transferência. Defina true ou false. Por exemplo: |
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:
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.