Snippets de código personalizado

Alguns scripts exigem maior complexidade do que as ações do Studio podem fornecer. O Studio permite que você adicione código personalizado aos seus scripts. Isto permite que você personalize os seus scripts para atender às necessidades da sua organização.

Códigos personalizados exigem certo conhecimento de programação ou criação de scripts. Studio utiliza uma linguagem de programação personalizada chamada Snippet, desenvolvida para uso em Studio. Um guia de referência técnica completo está disponível na ajuda online para que você possa aprender como usar esta linguagem.

Fatos importantes sobre Snippets

• Criar códigos de snippets pode ajudar a melhorar a organização e eficiência dos seus scripts. Eles aumentam o seu controle sobre os processos executados, bem como quando e como serão executados. Você pode criar as suas próprias variáveis e objetos e adicionar lógica de programação, usando expressões como IF, FOR, FOREACH e outras.
• Alguns produtos e recursos exigem snippets, mas você pode usá-los em seus scripts mesmo quando eles não são exigidos.
• Quando um produto ou recurso exige códigos de snippets, a ajuda online fornece informações detalhadas sobre os snippets que você precisa incluir. Exemplos de scripts são fornecidos para mostrar como usar os códigos de snippets nos scripts. Scripts adicionais podem ser exigidos para implementar produtos ou recursos.
• A linguagem de script Snippet é criada na estrutura de trabalho .NET. Ela é executada no servidor e compilada no MSIL (Microsoft Intermediate Language), assim como o C# e o Visual Basic .NET.

Ação de snippet

Para adicionar códigos personalizados aos seus scripts, você precisa de uma ação Snippet. Você pode clicar duas vezes nessa ação para abrir uma janela de editor onde você pode adicionar o seu código personalizado. Você também pode depurar o código na janela de editor. Você pode precisar de mais de uma ação Snippet no seu script. Caso use várias ações, atualize o campo Adicionar Caption de cada uma com uma frase que ajude a identificar sua finalidade.

A posição de uma ação Snippet é importante. Se uma Snippet atribui um valor a uma variável, ela deve ser colocada antes da ação que precisa do valor. Por outro lado, se uma Snippet contém códigos de decisão que agem com base em um valor passado a ela, a Snippet deve ser colocada após a ação que fornece o valor.

Snippets comparados a ações

Algumas das tarefas que você pode fazer nos snippets também podem ser feitas usando ações do Studio. Por exemplo, há ações para instruções IF e FOR. Também há a ação ASSIGN, que você pode usar para criar uma variável personalizada e atribuir a ela um valor. Usar essas ações é uma forma aceitável de adicionar essas funcionalidades ao seu script. No entanto, usar snippets é mais eficiente.

Ao inserir código em snippets, o seu script fica mais limpo, organizado e fácil de navegar. Isto torna o seu trabalho como criador de scripts mais fácil e eficiente. Se você tornar um hábito sempre declarar variáveis em snippets, no futuro será mais fácil encontrar uma declaração particular já que você terá menos locais nos quais procurar.

Adicione código personalizado a um script

A Snippetação permite adicionar código personalizado aos seus scripts.

1. No CXone Mpower, clique no seletor de aplicativos e selecioneStudio.
2. Na página Scripts, localize e abra seu script.
3. Adicione a ação Snippet ao seu script e clique em Abrir Editor no painel de propriedades.
4. Digite seu código na janela do editor. Você pode digitar o seu código ou copiá-lo e colá-lo de outra fonte, como desta página de ajuda ou de outro script.
5. Clique em Apply para salvar suas alterações. O editor de snippet é fechado. Abra-o novamente para continuar editando seu código.