Manual de Criação e Adição de Menus

este documento tem como finalidade servir como um guia prático e objetivo para a criação, configuração e adição de menus esta funcionalidade está disponível apenas para o papel de desenvolvedor geralmente, a url do citsmart instalada no oci está localizada no repositório gitlab da equipe entretanto, em algumas situações, pode não estar disponível por isso, antes de cadastrar os menus, certifique se de ter as seguintes informações 1 url do citsmart 2 perfil de administrador 3 valor da senha da engine caso não possua algum desses itens obrigatórios , solicite à equipe de infraestrutura este manual está dividido em seções para facilitar a localização das informações as seções são 🔹 antes de criar menus, você precisa cadastrar e configurar uma aplicação se ainda não tem uma, este é o seu primeiro passo /#criar menus 🔹 se você já configurou sua aplicação, aqui é ensinado como criar os menus /#importar e exportar pacotes 🔹 aprenda como exportar e importar pacotes para otimizar a configuração da sua aplicação e agilizar o processo de replicação de menus e dados entre ambientes /#menu antigo 🔹 em alguns ambientes, o front manager pode estar com versões antigas essa seção mostra como proceder nesses casos específicos criar uma aplicação no menu lateral, acesse administração da hyper platform > aplicações menu aplicações na aba, selecione a opção criar criar nova aplicações preencha o formulário nome @hyper/\<nome da sua aplicação> descrição \<descrição da sua aplicação> situação ativa renderizar legado iframe tipo gerenciada pela plataforma ícone ícone no formato png ou svg criar aplicações novamente no menu lateral, acesse administração da hyper platform > versão (das aplicações) versões da nova aplicação na página, localize sua aplicação pelo nome e, em seguida, na coluna ações , clique no ícone de edição versões da nova aplicação clique em adicionar versões da nova aplicação preencha o formulário o modelo a seguir apresenta um exemplo de aplicação criada com base na estrutura padrão utilizada pela equipe citsmart aura para personalizações adicionais, entre em contato com um supervisor ou consulte a documentação oficial da plataforma modelo base os campos maior , menor , correção e revisão compõem, em conjunto, a versão por exemplo ao inserir os valores 1, 2, 4 e 6, a versão resultante será 1 2 4 6 o campo nome da base corresponde ao segmento que aparece após a url padrão do citsmart assim, em uma url fictícia, seria representado como http //url exemplo citsmart/\<nome da base> após concluir o preenchimento clique em "gravar" , tanto no formulário quanto na tela de versão (das aplicações) versões da nova aplicaçãoversões da nova aplicação segunda confirmação mais uma vez no menu lateral, acesse administração da hyper platform > licenças de aplicações/versões licenças da nova aplicação clique em criar licenças da nova aplicação preencha o formulário de licença seguindo o modelo abaixo o modelo a seguir apresenta um exemplo de aplicação criada com base na estrutura padrão utilizada pela equipe citsmart aura para personalizações adicionais, entre em contato com um supervisor ou consulte a documentação oficial da plataforma após concluir o preenchimento clique em "gravar" licenças da nova aplicação criar menus no menu lateral, acesse administração da hyper platform > menu manutenção de itens caso esteja utilizando uma versão antiga do front manager, siga esta manual de criação e adição de menus /#menu antigo manutenção de itens clique em criar manutenção de itens preencha o formulário os exemplos a seguir abrangem a criação de todos os menus utilizados pela equipe citsmart aura caso sejam necessárias alterações, utilize o modelo como referência, ajustando apenas os campos que deseja personalizar a imagem a seguir apresenta o formulário que deve ser preenchido para adicionar o menu, utilizando parâmetros de exemplo substitua esses parâmetros pelos exemplos indicados logo após a imagem ao final de cada modelo, clique no botão gravar e, em seguida, em criar para adicionar o próximo item manutenção de itens base | comportamentos | atendimento humano | máquina de estados | widgets | atendimentos | filas | atalhos de texto | atalhos globais | atalhos privados | questionários e ações | ajuda | sobre no menu lateral, acesse administração da hyper platform > menu (associar roles) associar roles de app na coluna ações , clique no ícone para editar no cliente desejado associar roles de app preencha o formulário usando o modelo abaixo todos os itens de menu do role devem ser selecionados e associados para isso, selecione o item desejado e, em seguida, clique em associar associar roles de appassociar roles de appassociar roles de appassociar roles de appassociar roles de app após associar todos os itens, clique em gravar por fim, no menu lateral, acesse administração da hyper platform > menu (associar versão de app) associar versão de app dentro da página, pesquise por aura e na coluna ações , clique no ícone para editar associar versão de app marque a versão e o item de menu desejado e clique em “associar” caso seja necessário associar outros itens, repita o procedimento associar versão de app após concluir, clique no botão “gravar” para salvar as alterações importar e exportar pacotes manual de criação e adição de menus /#exportar | manual de criação e adição de menus /#importar exportar em um ambiente citsmart já configurado, acesse o menu lateral lowcode > pacote menu de pacotes localize o pacote que deseja exportar (geralmente o mais recente ou uma versão estável) e clique no botão “exportar” exportar pacote um pacote compactado ( zip ) será baixado e poderá ser utilizado em importações futuras importar no ambiente citsmart em que deseja realizar a importação, acesse o menu lateral lowcode > pacote menu de pacotes clique no botão “importar” botão importar selecione o arquivo json e clique em importar para obter o arquivo json de uma exportação, é necessário extrair o conteúdo do arquivo zip em sistemas windows, clique com o botão direito sobre o arquivo compactado e selecione a opção “extrair tudo ” após a extração, localize o arquivo json dentro da pasta descompactada este arquivo é o que deve ser utilizado no processo de importação importar json após selecionar o arquivo, confirme a importação acessando menu lateral > menu da sua aplicação atenção verifique se todos os menus estão funcionando corretamente e se apontam para os locais desejados verificar menu menu antigo em alguns clientes, o front manager pode estar com versões desatualizadas esta seção abrange esses casos no menu lateral, acesse low code>gerenciamento>formulário menu de itens na barra de pesquisa, procure pelo item desejado e clique no ícone de editar normalmente, os itens de versões antigas começam com o prefixo "hyper" pesquisa por hyper dentro da página, selecione testar página e escolha a versão que deseja testar sempre que possível, utilize a opção de formulário padrão caso ela não esteja disponível, teste com a página de crud testar pagina link rápido /#criar menus