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

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 janelas. Para obter mais informações: Parâmetros de substituição

Este artigo fornece informações sobre as chaves de substituição que pode usar nos seus parâmetros de substituição para indicar uma manipulação especial e como pode usar esses parâmetros no Unified Service Desk em algumas condições especiais.

Chaves de substituição

A tabela a seguir fornece informações sobre as chaves de substituição que você pode usar em seus parâmetros de substituição.

Tecla de substituição	Descrição
+	Essa chave, quando presente, substitui uma chave nula ou inexistente por uma cadeia de caracteres vazia. Por exemplo: No cenário em que account.name é indefinido, a chamada [[account.name]] resultaria em um erro "Nem todos os parâmetros na chamada <de ação ActionName> estão disponíveis, anulando a chamada de ação". Isso interrompe o processamento da regra ou do item de linha que está sendo executado. No entanto, [[account.name]+] devolve um espaço em branco e não gera o erro da tecla de substituição.
$	Esta tecla permite escapar às aspas e quebras de linha. Ele é usado como um operador ao invocar um scriptlet ou retornar uma cadeia de caracteres de várias linhas. Por exemplo: [[script.MyMultiLineString]$]
^	Esta tecla impede o escape de aspas e quebras de linha e é utilizada para aplanar o conjunto de resultados com várias linhas. Por exemplo: MyMultiline=[[myvalue]^]
u	Esta tecla é usada para codificar URL (também designado codificação percentual) do parâmetro de substituição. Por exemplo, considere o parâmetro de substituição no seguinte URL: https://mysite?something=[[opportunity.name]u]. A seguinte cadeia de caracteres é retornada: https://mysite?something=My%20Opportunity.
x	Essa chave é usada para codificar XML o parâmetro de substituição. Permite que os caracteres XAML, como <, tenham caracteres de escape e sejam apresentados corretamente no resultado. Por exemplo, [[myvalue]x].
g	Essa chave é usada para retornar o valor da sessão global. Se a chave não puder ser encontrada na sessão global, isso resultará em um erro de chave não encontrada.
a	Esta tecla é usada para devolver valor da sessão atualmente ativa que está em foco. Se a chave não puder ser encontrada na sessão ativa, isso resultará em um erro de chave não encontrada.
v	Esta tecla é usada para substituir teclas dentro de uma tecla de substituição. Por exemplo, considere os dois valores a seguir: - account.name = "Minha Conta" - mytemplate.value = "Meu modelo é [[account.name]+]" Quando você invoca o [[mytemplate.value]], a seguinte cadeia de caracteres é retornada: "Meu modelo é [[account.name]+]". No entanto, quando você invoca [[mytemplate.value]v], a seguinte cadeia de caracteres é retornada: "Meu modelo é Minha Conta".

Operadores especializados

Muitas vezes, há a necessidade de fazer algo simples, como uma construção do tipo if/then/else que não justifica a criação de um scriptlet. Essas situações exigem a utilização de um scriptlet dentro de uma chamada de ação. Existem dois processadores especializados para ajudar na criação de scriptlets inline em chamadas de ação: $Expression e $Multiline.

$Expression

Considere uma situação em que você precisa alternar o nome de exibição com base no código de tipo de entidade (etc) da entidade atual. Você está criando uma URL que precisa dessas informações. Nessa situação, só pode haver uma conta ou contacto carregado.

Nesse cenário, estamos chamando a ação Navegar em um controle hospedado de aplicativo Web padrão usando o seguinte valor no campo Dados :

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

Para isso, usaremos $Expression o seguinte:

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

Isso efetivamente cria e executa um scriptlet à medida que a ação é processada.

$Multiline

Na secção $Expression, falámos sobre realizar um scriptlet inline numa ação. Na situação em que há a necessidade de fazer um scriptlet mais complexo, e você ainda não deseja usar um objeto scriptlet para armazenar o scriptlet, o comando $Multiline pode ser usado para armazenar scriptlets mais complexos.

Por exemplo, usando o exemplo que usamos anteriormente na seção $Expression, ele pode ser dividido da seguinte forma:

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

Ver também

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