Layout de painel (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
Use o controle hospedado Layout de painel para definir a organização dos painéis no Unified Service Desk. Os painéis retêm vários controles hospedados, e um layout de painel define a organização de vários controles hospedados na tela principal do aplicativo cliente do Unified Service Desk. O Unified Service Desk vem com vários tipos de painel pré-definidos para oferecer suporte a diversas opções de layout, tais como layout tabulado, layout de plataforma e layout empilhado. Para obter mais informações, consulte Painéis, tipos de painéis e layouts de painéis no Unified Service Desk.
Se não houver um tipo de controle hospedado Layout de painel definido no aplicativo, o layout de painel padrão, Painel principal padrão será criado automaticamente. Ao criar um tipo de controle hospedado Layout de painel, você deverá configurar uma substituição para o Painel principal padrão. Qualquer layout de painel pode ser usado no lugar; entretanto, é comum definir apenas o Painel principal padrão.
Nesta seção
Crie um controle hospedado Layout de painel
Ações de UII predefinidas
Eventos predefinidos
Crie um controle hospedado Layout de painel
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 Layout de painel. Para obter informações detalhadas sobre como criar um controle hospedado, consulte Criar ou editar um controle hospedado.
.jpeg "Layout de painel do controle hospedado")
Na tela Novo controle de hospedado:
Na lista suspensa Tipo de componente da USD, selecione Layout de painel.
Na lista suspensa PanelType, selecione um tipo de layout de painel a ser criado. É possível selecionar um dos seguintes: Painel principal padrão, Painel principal de faixa de opções, Divisão vertical, Divisão horizontal, XAML e Definido pelo usuário. Os layouts de painel XAML e Definido pelo usuário são os painéis personalizados definidos por você. Para obter informações detalhadas sobre cada um dos layouts de painéis, consulte Painéis, tipos de painéis e layouts de painéis no Unified Service Desk. Os campos nesta página alteram-se com base no tipo de painel selecionado.
Selecione Sim ou Não na lista O aplicativo é dinâmico para determinar se o controle hospedado é dinâmico ou não. Um controle hospedado dinâmico pode ser global ou não global. Os controles hospedados dinâmicos globais são carregados na primeira solicitação e ocultados em seguida, e podem ser solicitados a qualquer momento, como durante uma sessão global, uma sessão normal ou o fluxo de trabalho. Os controles hospedados dinâmicos não globais somente podem ser carregados após o início de uma sessão e cada sessão usa uma instância diferente do aplicativo. Se um controle hospedado dinâmico fizer parte de um fluxo de trabalho e não for iniciado quando o fluxo de trabalho iniciar, o fluxo de trabalho iniciará o controle hospedado e o fechará quando o fluxo de trabalho for concluído.
A caixa de seleção O usuário pode fechar ficará disponível se você tiver selecionado Sim na lista O aplicativo é dinâmico. Selecione-a para especificar que o controle hospedado pode ser fechado pelo usuário.
Se você tiver selecionado Divisão vertical, Divisão horizontal, XAML ou Definido pelo usuário na lista PanelType, a caixa de seleção O aplicativo é global ficará disponível. Selecione-a para definir o controle hospedado como global. Os controles hospedados Globais podem ser exibidos fora de uma sessão do cliente. Os controles como os agentes do painel, mural ou pesquisa são usos comuns para controles hospedados globais. Os controles hospedados globais não têm um estado específico de sessão, então quando as sessões são alteradas, esses controles hospedados globais permanecem os mesmos. Se a caixa de seleção não estiver selecionada, o controle hospedado ficará com base em sessão. Os controles com base em sessão existem no contexto da sessão do cliente. As seguintes ações predefinidas de UII são disponíveis para o tipo de controle hospedado do Gerenciador global:
Se você tiver selecionado Divisão vertical, Divisão horizontal, XAML ou Definido pelo usuário na lista PanelType, o campo Exibir grupo ficará disponível. Especifique um painel no qual esse controle hospedado será exibido. Para obter informações sobre os diversos painéis disponíveis no Unified Service Desk, consulte Painéis, tipos de painéis e layouts de painéis no Unified Service Desk.
Se você tiver selecionado XAML na lista PanelType, um campo XAML ficará disponível para especificar a definição XAML do tipo de painel.
Se você tiver selecionado Definido pelo usuário na lista PanelType, os campos URI do assembly e Tipo de assembly ficarão disponíveis. No campo URI do assembly, digite o nome do assembly. No Tipo de assembly especifique o seguinte valor: <AssemblyName>.<ClassName>. Para obter informações detalhadas sobre como criar um layout de painel definido pelo usuário, consulte Criar um layout de painel personalizado.
Ações de UII predefinidas
Essas são as ações predefinidas para esse tipo de controle hospedado.
Fechar
Essa ação é usada fechar o controle hospedado.
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.
MoveToPanel
Esta ação é usada para mover controles hospedados entre os painéis no tempo de execução.
Parâmetro |
Descrição |
|---|---|
aplicativo |
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. |
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. |
SetSize
Esta ação define explicitamente 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. |
SetVisualProperty
Defina as propriedades visuais (UIElement), como por exemplo, altura, largura e visibilidade de um controle hospedado. A chamada de ação é muito útil para automação da interface do usuário, como por exemplo, exibir ou ocultar automaticamente o painel. Familiaridade com o layout XAML e Unified Service Desk é necessária para usar de forma eficaz esta ação.
Parâmetro |
Descrição |
|---|---|
elementname |
O nome do elemento da interface do usuário para o qual você deseja definir a propriedade, como por exemplo, Expander, StackPanel e Grid. Por exemplo: elementname=Expander |
propertyname |
O nome da propriedade do elemento especificado que você deseja definir, como por exemplo, Height, Width, Visibility e Color. Por exemplo: propertyname=Visibility |
valor |
Especifique o valor apropriado da propriedade especificada. Os tipos de valores suportados para este parâmetro são stringtrue enumerationou integerfalsebool. Por exemplo: value=Visible |
Para usar um exemplo desta mensagem, consulte Etapa 3: Configurar chamadas de ação para exibir e ocultar automaticamente o painel de pesquisa da base de dados de conhecimento no Passo a passo 8: Usar a base de dados de conhecimento do Parature no aplicativo do agente.
Dica
Por padrão, essa ação será exposta somente para o tipo de Layout de painel do controle hospedado. Para usar a ação SetVisualProperty com todos os outros tipos de controle hospedados de Unified Service Desk predefinidos que são originados da classe DynamicsBaseHostedControl, você deve adicionar explicitamente uma ação de UII chamada de SetVisualProperty para o respectivo controle hospedado.Para obter mais informações: Adicione uma ação de UII a um controle hospedado
Eventos predefinidos
Não há eventos predefinidos disponíveis para esse tipo de controle hospedado.
Confira Também
Painéis, tipos de painéis e layouts de painéis no Unified Service Desk
Ações da UII
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