Compartilhar via

Parâmetros de substituição

  • Artigo

 

Publicado: novembro de 2016

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

Os parâmetros de substituição podem ser usados em todo o aplicativo para receber dados de elementos de dados (chamados parâmetros de dados) capturados durante a execução do aplicativo que aumentam e incluem o contexto da Unified Service Desk. O contexto consiste em pares da cadeia de caracteres de nome/valor que mudam sempre que os dados forem descobertos de várias maneiras enquanto o aplicativo for usado. Os parâmetros de substituição são usados para uma variedade de tarefas, tais como especificação de cadeias de caracteres da consulta da URL, geração da saída de script em scriptlets, especificação de valores de pesquisa para pesquisas da entidade, integração do telefone com o computador (CTI) e especificação de entrada para ações que estiverem sendo chamadas em outros controles hospedados. Os parâmetros de substituição são elementos-chave que habilitam o alto nível de configuração ou personalização na Unified Service Desk sem usar o código.

Para obter informações sobre como usar os parâmetros de substituição para configurar seu aplicativo do agente, consulte Usar parâmetros de substituição para configurar o Unified Service Desk.

Dica

Às vezes, o parâmetro de substituição é usado de forma intercambiável com o parâmetro de dados porque o parâmetro de substituição é essencialmente a representação de um parâmetro de dados.

Neste tópico

Visualizar os parâmetros de substituição no Unified Service Desk

Parâmetros de substituição do sistema

Visualizar os parâmetros de substituição no Unified Service Desk

O controle depurador no aplicativo cliente pode ser usado a qualquer momento para visualizar a lista de parâmetros de substituição disponíveis.

  1. Inicie o cliente da Unified Service Desk e faça o login no Microsoft Dynamics 365 onde você tiver instalado os pacotes de exemplo.

  2. Na tela principal do cliente Unified Service Desk, clique na seta para baixo ao lado da engrenagem no canto superior direito e selecione Depurar. A página Depurar é exibida.

    Opção de depuração para abrir o depurador

  3. No Depurador, clique em Parâmetros de dados para visualizar os parâmetros de substituição.

    Parâmetros de substituição na guia Parâmetros de dados

Uma exibição de árvore é usada para representar as variáveis disponíveis. Ao especificar a variável, especifique o nome no nível raiz acompanhado por um ponto (.) e, em seguida, o nome na lista. Veja alguns exemplos:

  • [[$Session.IsGlobal]]

  • [[$User.fullname]]

Esses valores mudarão conforme o usuário interagir com o cliente na Unified Service Desk. As chamadas de ação pegarão o valor atual e o usarão na lista de parâmetros ou onde mais puder ser usado. A qualquer momento em que as variáveis forem atualizadas, um evento NotificarAlteraçãoDeContexto será acionado nos controles de base mesmo se o contexto da Unified Service Desk não for alterado. Isso permite que os recursos como linhas de sessão verifiquem novamente os valores dos parâmetros de substituição para verificar se é necessário atualizar sua exibição.

Parâmetros de substituição do sistema

Os parâmetros de substituição do sistema são os parâmetros de substituição definidos e preenchidos pelo sistema, e os nomes iniciam com $ para mantê-los separados dos parâmetros de substituição definidos pelo usuário. Por exemplo, $Global. O Unified Service Desk tem os seguintes parâmetros de substituição:

  • $Contexto

  • $Depurar

  • $Global

  • $Painel

  • $Recursos

  • $Retorno

  • $Sessão

  • $Configurações

  • $Assunto

  • $SystemParameters

  • $Usuário

$Contexto

Esta seção tem o conteúdo do contexto da sessão User Interface Integration (UII) e fornece uma forma prática de usar as variáveis do contexto da sessão UII em todo o aplicativo Unified Service Desk.

Dica

O controle hospedado do Gerenciador Global fornece uma ação que permite copiar os valores de outros parâmetros de substituição no contexto. Isso pode ser útil para transferir chamadas ou salvar a sessão para reidratação posteriormente. O contexto pode ser salvo no servidor nesses casos usando mecanismos de UII padrão.

$Depurar

Este é um valor de substituição especial usado somente em um Scriptlet para determinar se está sendo chamado pela janela de depuração. Especialmente quando os scriptlets estiverem fazendo com que as ações sejam executadas no sistema, testamos esse parâmetro para determinar se devemos ignorar o bloqueio do código para evitar efeitos colaterais na depuração. O seguinte scriptlet iniciará o controle hospedado da conta e exibirá a guia quando a janela de depuração for aberta.

CRMGlobalManager.GetApp(“Account”);

Isso porque cada um dos scripts é executado no contexto atual para determinar os valores no estado atual do sistema. Para impedir que esse efeito colateral ocorra, execute os seguintes procedimentos.

If ([[$Debug]]!= true) CRMGlobalManager.GetApp(“Account”);

Isso evitará o efeito colateral e ainda fornecerá informações úteis para o depurador.

$Global

Esta seção é adicionada automaticamente para mostrar todas as opções configuradas nas opções do Dynamics 365 e seus valores. Isso facilita a acessibilidade de Opções porque podem ser usadas para controlar a execução ou os comportamentos criados em fluxos de trabalho ou em chamadas de ação. Todos os sinalizadores de auditoria ficam visíveis automaticamente nesta seção.

$Painel

O parâmetro de substituição $Panel contém todos os controles hospedados e seus nomes de painel atuais como pares de valores/chave que se moveram para outro painel após a última vez que você iniciou o cliente Unified Service Desk. O parâmetro de substituição é disponibilizado somente se pelo menos um controle hospedado tiver modificado os painéis após a última vez que você iniciou o cliente Unified Service Desk. Todos os outros controles hospedados e seus painéis existentes atualmente carregados na área de trabalho do agente não estão disponíveis neste parâmetro de substituição.

$Recursos

Este conjunto de parâmetros de substituição é preenchido pelo Gerenciador global com identificadores de idioma. Na configuração do controle hospedado do Gerenciador Global, é possível especificar vários recursos de idioma. Esses recursos pegam o formulário de arquivos .resx, mas são carregados em recursos da Web como arquivos XML. Mediante o carregamento do aplicativo, a Unified Service Desk lerá a configuração atual do idioma do Dynamics 365 e, em seguida, irá procurar esse idioma na lista de idiomas do Gerenciador global. Se o item estiver listado, o recurso de identificadores de idioma será carregado nesse conjunto de $Recursos.

Mesmo se você tiver a intenção de fornecer o texto neutro do idioma na saída, é possível usar os parâmetros de substituição desse conjunto de $Resources. Por exemplo, é possível usar o seguinte procedimento para o texto do botão.

[[$Resources.MyButtonName]+]

Dependendo do idioma selecionado para o usuário, o texto localizado apropriado será usado.

Também é importante observar aqui que esses parâmetros de substituição, ou seja, os arquivos .resx podem conter uma sintaxe própria de parâmetro de substituição. Depois que os valores de $Resources forem substituídos, serão verificados novamente para parâmetros adicionais de substituição. Dessa forma, mesmo que você esteja fornecendo cadeias de caracteres específicas de idiomas, é possível substituir dados do restante do aplicativo nesta cadeia de caracteres também.

Para obter mais informações sobre como adicionar recursos localizados para configurar a Unified Service Desk, consulte Adicionar suporte para vários idiomas aos aplicativos agentes.

$Retorno

Algumas ações retornam um valor da cadeia de caracteres. Esse valor da cadeia de caracteres é colocado no parâmetro de substituição de $Retorno usando o nome da chamada de ação. Ele seguirá esse modelo:

[[$Return.ActionCallName]]

Um exemplo seria fazer uma chamada para CriarEntitade no Gerenciador global. Isso criará um registro no Dynamics 365 e retornará o GUID do novo registro. Esse novo GUID aparecerá na lista de parâmetro de substituição de $Return e poderá ser usado como uma entrada para a ação seguinte.

$Sessão

A seção $Session expõe as variáveis úteis necessárias por chamadas de ação, como a contagem de sessão e, se a seção ativa for global, a ID da seção atualmente ativa. O valor de StartTime pode ser usado para redigir a hora de início de uma atividade. Esta seção é preenchida automaticamente.

$Configurações

Esta seção apresenta as configurações de usuário que se aplicam apenas ao usuário atual. Estas configurações serão carregadas automaticamente na inicialização e podem ser lidas com uma chamada de ação no tempo de execução. Elas geralmente incluem configurações para a seleção do tema do usuário, mas podem fornecer acesso a qualquer configuração específica do usuário que o configurador desejar disponibilizar.

Essas configurações de usuário são definidas na área Configurações do usuário (Configurações > Configurações do usuário) no Dynamics 365 ao configurar o Unified Service Desk.

Essas configurações podem ser usadas como qualquer outro parâmetro de substituição no sistema. O controle hospedado do gerenciador global fornece uma ação, SalvarConfiguração, que escreverá as configurações do usuário para o servidor, presumindo que o usuário tenha acesso de gravação. Isso pode ser usado para armazenar preferências específicas do usuário como a seleção de temas e layouts.

Dica

As configurações do usuário podem ser salvas no servidor do Dynamics 365 presumindo que o usuário tenha acesso de gravação.

$Assunto

Um recurso útil na Unified Service Desk é preencher automaticamente a árvore de assuntos com uma nova ocorrência criada em nome do usuário. Às vezes, você pode desejar preencher automaticamente o campo de assunto, mas é necessário conhecer os valores corretos a serem usados, que podem ser alterados de sistema em sistema.

Com essa entrada, é possível consultar um assunto específico quando você estiver criando a ocorrência, usando o seguinte parâmetro de substituição.

[[$Subject.Default Subject.Id]][[$Subject.Default Subject.LogicalName]]

$SystemParameters

Esta seção contém uma variável chamada HighContrast que mostra se o modo de alto contraste no Windows está ativado ou não (verdadeiro/falso). Use esta variável para decidir se habilita cores personalizadas normais ou cores do sistema (compatíveis com configuração de contraste alto) ao personalizar seu tema no cliente.Para obter mais informações:Customize themes for High Contrast settings

$Usuário

Esse grupo de parâmetro de substituição é preenchido automaticamente com os conteúdos do registro do usuário atual no Dynamics 365. Por exemplo, se o administrador estender a entidade do usuário do sistema no Dynamics 365 para incluir uma ID do agente, essa ID do agente aparecerá nessa lista. Isso pode ser usado para definir configurações especiais de usuário.

Confira Também

Usar parâmetros de substituição para configurar o Unified Service Desk
Executar scripts usando scriptlets no Unified Service Desk
Consultar dados usando pesquisas de entidade no Unified Service Desk
Aprenda a usar o Unified Service Desk
Gerenciador global (controle hospedado)

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais