STUDY VLOCITY 🚀

Pacote Vlocity Core

⁃ OmniScript
⁃ VIP (Vlocity Integration Procedure) is Tool
⁃ DataRaptor
⁃ Matrixes
⁃ FlexCards

Solicitar um org com OmniStudio para estudo;

https://www.youtube.com/watch?v=oXyk5fAmHpM&t=4s

A Arquitetura OmniStudio consiste em três camadas:

https://www.youtube.com/watch?v=HcvIJkniLMA&t=5s
Digital Experience (front-end)

-> Camada de interface do usuário.

• FlexCard: Quando exportamos o flexCard ele se torna um LWC podendo assim ser
colocados em record page, community.

1. Exibe informações contextuais e ações em um formato rápido.

• OmniScript: Fluxo guiado, equivalente ao Screen flow.

1. Fornece uns scripts guiados, formulários ou telas para completar um processo de

negócios.

Service Management (back-end)

-> Serviço de dados que leem, gravam, transformam, calculam e rastreiam dados dentro
e fora do Salesforce.

• DataRaptor: serviços configuráveis para recuperar, transformar e atualizar dados

• Integration Procedures (IP) Aplicativo usados para ler e gravar dados do Salesforce e
de sistemas externos.

DataRaptors

Serviços de configuração para recuperar, transformar e atualizar dados

4 tipos de DataRaptors

• Turbo Extract – obtenha dados de um único SObject

• Extract – obter um ou mais SObjects
• Load – salva dados em um ou mais SObjects
• Transform – manipule/ transforma quaisquer dados de dentro/fora do Salesforce.

(OBS: sObject = Object Salesforce)

DataRaptor Turbo Extract: Obtém dados de um único sObject.

⁃ Extração de Query.

⁃ Tipos de dados de entrada e saída) Type Input/Output: JSON, XML ou Personalizado.

⁃ Não suporta fórmulas ou mapeamentos

Criando Turbo Extract

(https://www.youtube.com/watch?v=fjWiWCSBglk) time 1:09

DataRaptor Extract: Obtenha dados de um ou mais sObjetos.

⁃ (Tipos de dados de entrada e saída) Type Input/Output: JSON, XML ou Personalizado.

⁃ Usa fórmulas e funções para transformar dados.

⁃ Você pode filtrar os dados e selecionar os campos a serem retornados.

DataRaptor Load: Salva dados em um ou mais sObjects.

(https://www.youtube.com/watch?v=Iy8h1cX8wls) part 01
(https://www.youtube.com/watch?v=YubTrt4xL40) part 02

⁃ Podemos inserir novos registros no Salesforce e atualizar o mais antigo (Realizar inserts,
updates e upserts em registros no Salesforce.)

⁃ Usa fórmulas e funções para transformar dados.

⁃ (Tipos de dados de entrada e saída) Type Input/Output: JSON, XML ou Personalizado.

DataRaptor Transform: Permite realizar transformações de dados sem ler ou gravar no

Salesforce.

⁃ Usa fórmulas e funções para transformar dados.

⁃ (Tipos de dados de entrada e saída) Type Input/Output: JSON, XML ou Personalizado.

Exemplo:
⁃ Converter entrada JSON em saída XML e vice-versa
⁃ Reestruturar dados de entrada e renomear campos
⁃ Substituir valores em campos (todos os DataRaptors podem substituir valores)
⁃ Converter dados em formato PDF, DocuSign ou modelo de documento

Integration Procedures

Integration Procedures (é o core do vlocity)

⁃ Configuração declarativa para processos do lado do servidor que executam várias

ações em uma única chamada de servidor.

⁃ Os procedimentos de integração podem ser usados como fonte de dados para

OmniScript, FlexCard, API ou Apex.
⁃ Mescla a saída para várias APIs

Os Procedimentos de Integração são uma maneira de recuperar, salvar e manipular dados

nos bastidores.

Um procedimento de integração não é compatível com as seguintes fontes de dados:

• Linguagem de pesquisa de objetos do Salesforce (SOSL)

• API de transmissão
• Fora da plataforma

Developer Experience

-> Entra em cena assim que terminamos o desenvolvimento e focamos na implantação.

• IDX build Tool: Ferramenta de automação que empacota e migra Datapack (pacote de
dados) ominstudio em formato amigável.

• IDX Workbench: App desktop que permite desenv. Migra Datapack e metadados do
SF de uma org p/ outra ou de uma org para o Git.

⁃ Run Test Procedures/ Executar procedimentos de teste:

Um procedimento de integração que realiza teste de unidade de quase tudo que um

procedimento de integração pode invocar

• dataRaptor
• matriz de cálculo
• classe apex
• ou outro procedimento de integração
FlexCards

São usados para criar componentes e aplicativos de interface do usuário

FlexCard Designer.

⁃ Local para criar e projetar FlexCards.

⁃ Criados com o modelo de programação do Lightning Web Components.

• Os FlexCards podem ser incorporados em outros FlexCards.

• Os FlexCards podem ser incorporados em um LWC OmniScript.
• Os FlexCards podem exibir dados de várias fontes de dados.
• Os FlexCards são construídos rapidamente usando elementos de arrastar e soltar.
(WYSIWG)

WYSIWYG = (o que vc vê, é o que vc quer/obtém)

-> Exibe uma combinação de informações interna do Salesforce e informações externas

de um site ou sistema legado de terceiros.

O objetivo do FlexCard é fazer a criação de uma única tela, no qual exibem informações
detalhadas sob demanda e fornecem acesso rápido a tarefas comuns relevantes ao contexto.

FlexCard podem ser inseridos nos seguintes componentes;

Lightning Page
Community
OmniOut
Lightning web components

São componentes da Web executados no Salesforce.

• Implementam o padrão de componentes da Web, mas usam bibliotecas

selecionadas do Salesforce e convenções de empacotamento.

• São elementos HTML personalizados criados usando HTML e JavaScript moderno.

• Fornecem apenas o necessário para um bom desempenho em navegadores

compatíveis com o Salesforce.

Web components

• Componentes e widgets criados em padrões de componentes da Web que

funcionam em navegadores modernos e podem ser distribuídos com qualquer biblioteca
ou estrutura JavaScript.

OmniScripts

-> É uma ferramenta do OmniStudio para construir interações guiadas.

-> Com o OmniScript você permite agrupar vários elementos, como ações ( extrair
dados , enviar email), funções (fórmulas), campos de entrada e lógica de ramificação .

Exibir dados de várias fontes de dados

Um OmniScript pode exibir dados internos do Salesforce e dados externos.

⁃ As ações do OmniStudio são URLs gerados automaticamente que iniciam

OmniScripts, componentes OmniStudio FlexCards, páginas da Web ou aplicativos externos.
OmniScript Designer

Permite criar a estrutura de um OmniScript usando “cliques, não código”. Possui uma
interface de arrastar e soltar com edição do que você vê é o que você obtém

Elementos OmniScript

Os OmniScripts são criados movendo elementos na tela e definindo suas propriedades. Esses
elementos são colocados em uma sequência específica para o fluxo de trabalho.

Os elementos OmniScript são agrupados por tipo, com base no tipo de funcionalidade que
executam.

TIPO DE ELEMENTO USAR

Actions Para chamar outras ferramentas
para realizar várias ações: obter
ou salvar dados, calcular, enviar
um e-mail e assim por diante
Display Para exibir texto e imagens na
tela para melhorar a usabilidade
da interface do usuário
Functions Para realizar cálculos no
OmniScript, mostrar mensagens
condicionais e fornecer
geolocalização
Group Para agrupar elementos na
interface do usuário
Inputs Para entrada ou seleção do
sistema ou do usuário
OmniScripts OmniScripts reutilizáveis para
inserir e usar
Elementos de ações

Os elementos de ação são usados para:

• Obtenha dados de um ou mais registros do Salesforce (DataRaptor Extract Action).

• Atualize os dados em um ou mais registros do Salesforce (DataRaptor Post Action).

• Chame uma série de ações (Integration Procedure Action).

• Obtenha, salve ou exclua dados por meio de uma interface de programação de

aplicativos (API) da Web (HTTP Action).

• Preencha e envie um e-mail como parte de uma interação (Email Action).

• Envie e-mails do DocuSign para assinatura ou assine e-mails do DocuSign (DocuSign

Envelope Action and DocuSign Signature Action).

• Envie o usuário de volta para uma página anterior após a conclusão da interação
(Navigate Action).
Elementos de exibição

Para elementos Display ou Inputs, os rótulos dos elementos são o que os usuários finais veem
na tela.

• Elemento de quebra de linha/ Line Breaks element: permite criar uma quebra de linha
para controlar o espaçamento na página.

• Elemento de bloco de texto/ Text Block element: permite adicionar instruções,

imagens e hiperlinks.

Elementos de funções

• Realize cálculos de média/soma (Agregado).

• Execute funções de fórmula e cálculos algébricos (Fórmula).

• Exiba avisos, erros e outros comentários aos usuários com base nas condições
(Mensagens).

Elementos de grupos

Agrupar itens, como a visualização de etapa/página. (Ex: steps)

Type Ahead Blocks: inclui uma combinação de funcionalidade que fornece preenchimento
automático e pesquisa.

1. O usuário começa a inserir informações.

2. O sistema procura correspondências e exibe uma lista dos itens correspondentes.
3. O usuário então escolhe o item apropriado.

Outros elementos de Grupos comumente usados incluem:

• Block: Agrupa elementos na página/visualização.

• Edit block: adicione, edite ou exclua registros em tempo real.

• Radio Group: Agrupe botões de opção, como quando um usuário tem opções comuns
em um questionário.

Exemplo do elemento radio como botões de forma de pagamento (1)

Elementos de entrada

Para elemento Inputs, os rótulos dos elementos são o que os usuários finais veem na tela.

Permitem a entrada do usuário, exemplo:

• Insere informações, como forma de pagamento (1), data de pagamento (2) e valor do
pagamento (3).
• Seleciona uma ou várias opções (4).
• Seleciona uma caixa de seleção.

Elemento OmniScripts

(Child OmniScript) chama um OmniScript para reutilizá-lo em outro. Isso permite que você
crie OmniScripts “filhos” menores para funcionalidades comuns, como mostrar campos
específicos de contato ou conta.

List actions

É uma ação do VIP (Integration Procedure, tendo como objetivo manipular listas, fazer
mergens basic ou transformação).

Por se tratar de transformação de lista seu INPUT é lista obrigatoriamente.

Propriedades - List Merge

Marge List Orden

Onde damos os parâmetros de entrada, de quais listas queremos utilizar.

Estrutura básica: Quando as listas possuem o mesmo nome e os campos estão no mesmo
nível

Estrutura Avançada: Quando as listas não possuem o mesmo nome e os campos não estão
no mesmo nível

Sort List

Definir critérios de ordenação, por padrão fica ascendente.

Look Block - componente do VIP

LookBlock: como se fosse o (for it) - Para fazer um loop em uma lista de registro, tendo uma
interação entre uma matrix de objetos.

É um element, tendo dois componentes (grupo and actions).

Configuração;

Loop List - Recebe o JSON (onde receberá array) - lista de objetos

Loop Output - Saída do loop block, quando executarmos, ou não. (Key/Value)

Execution Conditional Formula - Booleano (true/false)

Loop Block x List Actions

Ambos são voltados para arrays (Listas)

Loop Block; (element type grup)

⁃ Maior controle sobre as interações e sobre os dados - Conseguimos interagir com

os itens da matriz.
⁃ Acessar atributos fora do contexto - Conseguimos acessar valores que estão sendo
trabalhados em outro componente
⁃ Permite inclusão de elementos - é possível arrastar elementos para dentro do loop.

List Actions - (Para tratamento de dados interno de uma array)

⁃ Voltado para modificações internas e merge em array - Não conseguimos acessar

atributos de fora, apenas o da array que está sendo margeado.

array_merge:

• Funde os elementos de dois ou mais arrays de forma que os elementos de um são

colocados no final do array anterior. Retorna o array resultante da fusão. Se os arrays dados
têm as mesmas chaves string, então o último valor para uma chave irá sobrescrever o valor
anterior.

• Quando entramos em uma list actions precisamos realizar um merge com a array,
realizando assim um tratamento dos dados

⁃ Tratamento de duplicidade
⁃ Ordenação
⁃ Modificação de valores

Boas práticas;

⁃ Cuidado ao utilizar o elemento Loop Output, saídas em excesso causam lentidão na

performance da nossa API.
⁃ Usar Execution Conditional sempre que possível.
Custom Functions

É uma solução para criar fórmulas personalizadas, quando trabalhamos com DataRaptor
ou IP.

⁃ A Functions é criada através de Apex.

⁃ A criação da functions tem que ser genérica, para assim ser reutilizada.

Customização do OminScript

Quando os elementos standard não atendem ao que precisamos.