Usar parâmetros de substituição para configurar o Unified Service Desk

 

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 para personalizar interações durante um processo de negócios específico por meio de ações e regras de navegação de janela.Para obter mais informações:Parâmetros de substituição

Este tópico apresenta informações sobre as chaves de substituição que podem ser usadas nos parâmetros de substituição para indicar a manipulação especial em que os parâmetros de substituição podem ser usados no Unified Service Desk, em determinadas condições especiais.

Neste tópico

Chaves de substituição

Manipuladores especializados

Chaves de substituição

A tabela a seguir apresenta informações sobre as chaves de substituição que podem ser usadas nos parâmetros de substituição.

Chave de substituição	Descrição
+	Esta chave, quando estiver presente, substituirá uma chave nula ou inexistente por uma cadeia de caracteres vazia. Por exemplo: no cenário onde account.name é indefinido, chamar [[account.name]]resultaria em uma "Nem todos os parâmetros na ação de chamada <ActionName> estão disponíveis, abortar chamada de ação." erro. Isso causará parada no processamento da regra ou item de linha sendo executado. Entretanto, [[account.name]+] retornará em branco e não gerará o erro de chave de substituição.
$	Esta chave permite o uso de caractere de escape para aspas e quebras de linha. Normalmente ela é usada como um operador ao chamar um scriptlet ou ao retornar uma cadeia de caracteres multilinha. Por exemplo: [[script.MyMultiLineString]$]
^	Esta chave evita o uso de caractere de escape para aspas e quebras de linha e é usada para simplificar o conjunto de resultados multilinha. Por exemplo: MyMultiline=[[myvalue]^]
u	Esta chave é usada para a Codificação URL (também chamada de Codificação de porcentagem) do parâmetro de substituição. Por exemplo, considere o parâmetro de substituição na seguinte URL: http://mysite?something=[[opportunity.name]u. A cadeia de caracteres a seguir é retornada: http://mysite?something=My%20Opportunity.
x	Esta chave é usada para a Codificação XML do parâmetro de substituição. Permite que sejam usados caracteres de escape nos caracteres XAML, como <, para que eles sejam exibidos corretamente na saída. Por exemplo, [[myvalue]x].
g	Esta chave é usada para retornar o valor da sessão global. Se a chave não puder ser encontrada na sessão global, será gerado um erro de chave não encontrada.
t	Esta chave é usada para retornar o valor da sessão atualmente ativa em foco. Se a chave não puder ser encontrada na sessão ativa, será gerado um erro de chave não encontrada.
v	Esta chave é usada para substituir as chaves em uma chave de substituição. Por exemplo, considere os dois valores a seguir: account.name = "Minha conta" mytemplate.value = "Meu modelo é [[account.name]+]" Ao chamar o [[mytemplate.value]], a cadeia de caracteres a seguir será retornada: "Meu modelo é [[account.name]+]". No entanto, ao chamar [[mytemplate.value]v], a cadeia de caracteres a seguir será retornada: “Meu modelo é minha conta”.

Manipuladores especializados

Muitas vezes, há necessidade de fazer algo simples, como um tipo de construção if/then/else, que não justifique a criação de um scriptlet. Essas situações requerem o uso de scriptlet em uma chamada de ação. Há dois manipuladores especializados para ajudar na criação de scriptlets embutidos em chamadas de ação: $Expression e $Multiline.

$Expression

Considere uma situação em que é necessário alterar o nome de exibição com base no código (etc.) de tipo de entidade da entidade atual. Você está criando uma URL que precisa dessas informações. Nesta situação, somente é possível haver uma conta ou um contato carregado.

Neste cenário, estamos ligando para a ação Navegar em um controle hospedado aplicativo Web padrão usando o valor a seguir no campo Dados:

url= http://mysite/showmessage.aspx?displayname={either the account or contact display name}

Para isso, usaremos o $Expression da seguinte forma:

url= http://mysite/showmessage.aspx?displayname=$Expression("[[$Context.etc]]" == "1" ? "[[account.name]u+]" : "[[contact.fullname]u+]")

Isso realmente criará e executará um scriptlet durante o processamento da ação.

$Multiline

Na seção $Expression, falamos sobre como executar um scriptlet embutido em uma ação. Em uma situação em que haja necessidade de executar um scriptlet mais complexo e que você também não deseje usar um objeto de scriptlet para armazenar o scriptlet, o comando $Multiline poderá ser usado para armazenar scriptlets mais complexos.

Por exemplo, usando o exemplo usado na seção $Expression anterior, é possível detalhá-lo como:

url= http://mysite/showmessage.aspx?displayname=$Multiline( $Expression(
function doWork()
{
      If ("[[$Context.etc]]" == "1")
          return "[[account.name]u+]" 
      else 
          return "[[contact.fullname]u+]"
}
doSomeWork(); 
))

Confira Também

Parâmetros de substituição
Executar scripts usando scriptlets no Unified Service Desk
Passo a passo da configuração do Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais