CRM – Toolbars e Buttons (USD) – Power Platform by Tiago Michelini Cardoso

Pessoal,

Seguindo a série de posts sobre o USD, irei escrever neste post sobre as Toolbars e Toolbars Buttons!

Para ver os posts anteriores, acesse os links (estão por ordem de publicação do mais recente para o mais antigo):

CRM Utilidades do USD (Unified Service Desk)

As Toolbars e Toolbars Buttons são os componentes que utilizamos para adicionarmos botões em nossa aplicação USD. Podemos acionar diversos tipos de controles como páginas Webs, aplicações externas, validações, entre outros.

Apesar das Toolbars nos possibilitarem uma grande quantidade de customização, temos uma limitação aos locais onde podemos adicionar as toolbars:

ToolbarPanel – é a toolbar principal, pode ser comparada com o Command Bar do CRM, nela podemos inserir os principais recursos do USD
AboutPanel – como o próprio nome diz, podemos adicionar botões que representam cofigurações ou ajuda
Search Tab – não realidade não é propriamente uma toolbar, podemos são botões que inserimos na Search Tab, mas visualmente claramente podemos concluir que é uma toolbar!

Vamos a alguns exemplos!

1 – Toolbar para Abrir Página Web

Este exemplo, consiste na criação de um Hosted Control do tipo “Standard Web Application”, duas UII Actions para possibilitar ao hosted control as ações de “Navigate” e “MoveToPanel”, um botão “Tiago’s Blog” no Toolbar “Main” e duas Action Calls para fazer a abertura e consulta da Página Web.

Vamos ao hosted control:

Poucas informações são necessárias:

Name – O nome de seu hosted control
USD Component Type – Standard Web Application
Application is Global – Marcar a caixa de seleção (neste caso, queremos que o hosted control seja inicializado junto com o USD)
Display Group – “hiddenpanel”, apesar do controle ser “global” não queremos que ele seja visível por padrão

Para criar as duas UII Actions, basta acessar os relacionamentos do hosted control e clicar em UII Actions:

Depois crie as UII Actions, informando apenas o nome “Navigate” e “MoveToPanel”:

Agora vamos criar o botão, navegue em Configurações > Unified Service Desk > Toolbars > Abra a “Main” > Clique em Adicionar um “Novo Botão”:

Para criarmos nosso botão precisamos:

Name – O nome de seu button
Button Text – O nome de visualização do button
Tooltip – O tooltip que aparecerá ao mouseover do mouse
Order – A posição que será apresentado o controle

Agora as duas Actions Calls! Uma será para fazer a navegação na URL desejada e outra será para mover o hosted control para o MainPanel:

Name – O nome de sua action call
Hosted Control – “Tiago Cardoso Blog”, o nome do hosted control com a Página Web
Action – Navigate, queremos navegar na URL informada no campo “Data”
Data – “url=http://www.tiagomcardoso.com”, a URL de nossa Aplicação Web

Name – O nome de sua action call
Hosted Control – “Tiago Cardoso Blog”, o nome do hosted control com a Página Web
Action – MoveToPanel, queremos mover o hosted control do painel “hiddenpainel” para o “MainPanel”
Data – “MainPanel”, painel que queremos mover

Com isso terminamos este exemplo! Abra seu USD e visualize o resultado!

2 – Toolbar Oportunidades Relacionadas à Conta (Search Tab)

Precisaremos criar um Hosted Control do tipo “CRM Page”, uma UII Action para possibilitar ao hosted control a ação de “Navigate”, um botão “Related Opportunities” no Toolbar “Account Navigation ToolBar” e uma Action Call para fazer a consulta das oportunidades relacionadas ao clientes que está sendo atendido.

Vamos ao hosted control:

Poucas informações são necessárias:

Name – O nome de seu hosted control
USD Component Type – CRM Page
Display Group – “MainPanel”, não é global é só será aberto quando alguma ação for disparada, quando ocorrer, será apresentado no MainPanel

Para criar a UII Action, basta acessar os relacionamentos do hosted control e clicar em UII Actions:

Depois crie a UII Action, informando apenas o nome “Navigate”:

Agora vamos criar o botão, navegue em Configurações > Unified Service Desk > Toolbars > Abra a “Account Navigation ToolBar” > Clique em Adicionar um “Novo Botão”:

Para criarmos nosso botão precisamos:

Name – O nome de seu button
Button Text – O nome de visualização do button
Tooltip – O tooltip que aparecerá ao mouseover do mouse
Order – A posição que será apresentado o controle

Agora a Action Call! Para fazer a navegação na URL do CRM:

Name – O nome de sua action call
Hosted Control – “Related Opportunities”, o nome do hosted control
Action – Navigate, queremos navegar na URL informada no campo “Data”
Data – “url=userdefined/areas.aspx?formid=8448b78f-8f42-454e-8e2a-f8196b0419af&inlineEdit=1&navItemName=Opportunities&oId=[[account.Id]u]&oType=1&pagemode=iframe&rof=true&security=852023&tabSet=areaOpps&theme=Outlook15White”, a URL da visualização das Oportunidades relacionadas ao Cliente atual
- Para recuperar o “formid”, dê um F12 em seu navegador e procure por “formid”: