Partilhar via

Parâmetros de substituição

  • Artigo

Os parâmetros de substituição podem ser utilizados na implementação para obter dados de elemento de dados (chamados parâmetros de dados) capturados durante a execução da aplicação que aumentam e incluem o contexto de Unified Service Desk. O contexto consiste nos pares de cadeias nome/valor que alteram frequentemente à medida que são detetados dados das diversas formas quando a aplicação é utilizada. Os parâmetros de substituição são utilizados para uma variedade de tarefas tais como a especificação de cadeias de consulta do URL, geração de saídas de script em scriptlets, especificar valores de pesquisa de entidade, Computer Telephone Integration (CTI), e especificar ações a serem chamadas noutros controlos alojados. Os parâmetros de substituição são elementos chave que permitem um nível superior de configuração ou personalização no Unified Service Desk sem ter de utilizar o código.

Para obter informações sobre como utilizar parâmetros de substituição para configurar a aplicação de agente, consulte Utilizar parâmetros de substituição para configurar o Unified Service Desk.

Nota

O parâmetro de substituição é utilizado por vezes alternadamente com parâmetros de dados porque o parâmetro de substituição é essencialmente a representação de um parâmetro de dados.

Neste Tópico

Ver os Parâmetros de Substituição no Unified Service Desk

Parâmetros de substituição do sistema

Ver os Parâmetros de Substituição no Unified Service Desk

O controlo Depurador na aplicação cliente pode ser utilizado para ver uma lista de parâmetros de substituição disponíveis.

  1. Inicie o cliente de Unified Service Desk e inicie sessão no Microsoft Dynamics CRM em que instalou os pacotes de exemplo.

  2. No ecrã principal do cliente Unified Service Desk, clique na seta junto de uma engrenagem no canto superior direito e selecione Depurar. É apresentado o Depurador.

    Debug option to open Debugger

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

    Replacement parameters on Data Parameters tab

Uma vista de árvore é utilizada para representar as variáveis disponíveis. Ao especificar a variável, especifique o nome ao nível de raiz, seguido de um ponto (.) e do nome da lista. Seguem-se alguns exemplos:

  • [[$Session.IsGlobal]]

  • [[$User.fullname]]

Estes valores serão alterados à medida que o utilizador interage no cliente Unified Service Desk. As chamadas de ação utilizarão o valor atual e utilizá-lo-ão na lista de parâmetros, ou onde quer que seja utilizado. Quando as variáveis são atualizadas, um evento de NotifyContextChange é acionado nos controlos base mesmo que o contexto do Unified Service Desk não tenha mudado. Isto permite que as funcionalidades como as Linhas de sessão verifiquem os valores dos parâmetros de substituição para ver se necessita de atualizar a apresentação.

Parâmetros de substituição do sistema

Os parâmetros de substituição de sistema são os parâmetros de substituição que são povoados e definidos pelo sistema, os nomes começam com $ para os manter separados dos parâmetros de substituição definidos pelo utilizador. Por exemplo, $Global. O Unified Service Desk tem os seguintes parâmetros de substituição:

  • $Context

  • $Debug

  • $Debug

  • $Resources

  • $Return

  • $Session

  • $Settings

  • $Subject

  • $User

$Context

Esta secção contém os conteúdos de contexto de sessão do User Interface Integration (UII) e fornece uma forma de utilizar variáveis no contexto da sessão do UII na aplicação do Unified Service Desk.

Nota

O controlo alojado Gestor global fornece uma ação que permite copiar valores de outros parâmetros de substituição no contexto. Isto pode ser útil ao transferir chamadas ou ao guardar a sessão para reutilização mais tarde. O contexto pode ser guardado no servidor nestes casos utilizando mecanismos padrão do UII.

$Debug

Este é um valor de substituição utilizado apenas num Scriptlet para determinar se está a ser chamado pela janela de deupração Particularmente quando os scriptlets estejam a fazer com que as ações sejam executadas no sistema, testamos este parâmetro para determinar se saltarmos o bloco de código secundário para evitar efeitos secundários ao depurar. O seguinte scriptlet lançaria o controlo alojado Conta e indicaria o separador quando a janela de depuração é aberta.

CRMGlobalManager.GetApp(“Account”);

Isto porque os scripts são executados no contexto atual para determinar os valores de estado atual do sistema. Para evitar este efeito secundário, efetue o seguinte:

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

Isto evitará o efeito secundário e ainda vai fornecer informações úteis ao depurador.

$Global

Esta secção é adicionada automaticamente para mostrar todas as opções configuradas em Opções de CRM e os seus valores. Isto faz facilmente Opções acessíveis que podem ser utilizadas para controlar a execução ou comportamentos criados em fluxos de trabalho ou Chamadas de Ação. Todos os sinalizadores de auditoria são visíveis automaticamente esta secção.

$Resources

Esta coleção de parâmetros de substituição é povoada com identificadores de idioma do Gestor Global. Na configuração do controlo alojado Gestor Global, pode especificar vários recursos de idioma. Esses recursos tem o formato de ficheiros .resx mas são carregados em recursos Web como ficheiros XML. Ao carregar a aplicação, o Unified Service Desk lerá a definição do idioma atual do CRM e procurará este idioma na lista de idiomas do Gestor global. Se o item está listado, o recurso de identificadores de idioma será carregado na coleção de $Resources.

Se pretender fornecer texto de idioma neutro na saída, pode utilizar os parâmetros de substituição da coleção $Resources. Por exemplo, pode utilizar o seguinte para texto de botão.

[[$Resources.MyButtonName]+]

Consoante o idioma selecionado para o utilizador, será utilizado texto localizado apropriado.

Também é importante notar aqui que estes parâmetros de substituição e, consequentemente os ficheiros .resx carregados, podem conter a sintaxe dos parâmetros de substituição. Após os valores de $Resources serem substituídos, são verificados novamente para parâmetros de substituição adicionais. Desta modo, mesmo que esteja a fornecer cadeias específicas do idioma, pode substituir dados no resto da aplicação nesta cadeia também.

Para mais informações sobre como adicionar recursos localizados para configurar o Unified Service Desk, consulte Adicionar suporte multilingue às aplicações de agente.

$Return

Algumas ações devolvnum valor de cadeia. Este valor de cadeia é colocado em parâmetros de substituição de $Return utilizando o nome da chamada de ação. Seguirá este padrão:

[[$Return.ActionCallName]]

Um exemplo disto seria chamar CreateEntity no Gestor global. Isto irá criar um registo no CRM e devolverá o GUID de novo registo. Este novo GUID estará na lista de parâmetros de substituição de $Return e pode ser utilizado como entrada para a ação seguinte.

$Session

A secção $Session expõe as variáveis úteis necessárias para chamadas de ação como a contagem de sessão, se a sessão atova é global e o ID da sessão ativa atual. O valor StartTime pode ser utilizado para escrever a hora de início de uma atividade. Esta secção é povoada automaticamente.

$Settings

Esta secção fornece as definições de utilizador aplicáveis apenas ao utilizador atual. Estas definições são carregadas automaticamente ao iniciar e podem ser lidas utilizando uma chamada de ação em tempo de execução. Incluem frequentemente definições para seleção de tema do utilizador mas podem fornecer acesso quaisquer definições específicas do utilizador que o configurador queira tornar disponíveis.

Estas definições de utilizador são definidas na área Definições de utilizador (Definições > Definições de utilizador) no CRM durante a configuração do Unified Service Desk.

Estas definições podem ser utilizadas como qualquer outro parâmetros de substituição no sistema. O controlo alojado Gestor global fornece uma ação, SaveSetting, que escreve definições do utilizador no servidor, assumindo que o utilizador tem acesso de escrita. Isto pode ser utilizado para armazenar preferências específicas do utilizador como a seleção de tema e esquemas.

Nota

As definições de utilizador podem ser guardadas para o servidor do CRM assumindo que o utilizador tem acesso de escrita.

$Subject

Uma capacidade útil do Unified Service Desk é povoar automaticamente a árvore de assuntos num novo incidente que é criado em nome do utilizador. Por vezes é aconselhável povoar automaticamente o campo assunto mas precisa de saber os valores correto a utilizar, que podem mudar de sistema para sistema.

Com esta entrada, pode referenciar um assunto específico quando está a criar um incidente, utilizando o seguinte parâmetros de substituição.

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

$User

Este grupo de parâmetros de substituição é preenchido automaticamente com o conteúdo do registo do utilizador atual no CRM. Por exemplo, se o administrador expande a entidade utilizador de sistema no CRM para incluir um ID de agente, este ID de agente irá aparecer nesta lista. Isto pode ser utilizado para configurar definições especiais do utilizador.

Consulte Também

Conceitos

Utilizar parâmetros de substituição para configurar o Unified Service Desk
Executar scripts utilizando scriptlets no Unified Service Desk
Procurar dados utilizando pesquisas de entidade no Unified Service Desk
Gestor Global (Controlo Alojado)

Outros Recursos

Aprender a utilizar o Unified Service Desk

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