CITSmart
Executar a Instalação
Configurações Extras do CITSmart
a partir da versão 9 1 2 24 foram inseridos novos parâmetros parâmetro authentication protocol ojetivo definir o protocolo de autenticação comportamento define se o sistema irá se autenticar com parâmetros internos ou com outro protocolo de autenticação tipo varchar valor default internal tipos válidos oauth2 para autenticação com keycloack – essa informação sobrescreve qualquer política de segurança inserida no cadastro de política de segurança caso o usuário defina que a autenticação será via keycloak, a aplicação poderá não retornar a tela de login; internal para autenticação definida no sistema; parâmetro authentication create user ojetivo definir se o usuário será criado na aplicação após login comportamento grava o usuário que fez login na aplicação; tipo boleano (true or false) valor default false valores possíveis a partir da versão 9 1 2 23 foram inseridos novos parâmetros parâmetro maximum login field size ojetivo definir o tamanho máximo aceitável no campo login comportamento apenas impede o login, emitindo uma mensagem genérica, login ou senha inválidos tipo numérico valor default 25 parâmetro allow symbols at login ojetivo definir se o sistema aceita símbolos no campo login comportamento apenas impede o login, emitindo uma mensagem genérica, login ou senha inválidos tipo boleano (true or false) valor default false a partir da versão 9 2 0 0 seguir as orientações abaixo a atualização da tabela só vai ocorrer quando o parâmetro load factservicerequestrules do application ini possuir o valor true na ausência dessa configuração no arquivo, o sistema assume o valor false para o parâmetro ou seja, o default é não atualizar a tabela; caso exista algum schedule relacionado a regra de escalação de um ticket e o parâmetro load factservicerequestrules possuir o valor false, o sistema emite no log o alerta the system cannot start processing escalation rules because the load factservicerequestrules property (configuration file) is equal to false; novos parâmetros para o citsmart cfg/ application ini para ativar o updateparameters, opção para sincronizar os valores dos parâmetros em memória, de um ambiente clusterizado; devemos adicionar no arquivo citsmart cfg a seguinte configuração updateparameters port=\<número da porta que será utilizado> exemplo updateparameters port=2002; crie um arquivo chamado application ini em /opt/wildfly/standalone/configuration/ com as informações abaixo records limit to generate report in the background = 500 start monitora incidentes=false jdbc alias reports= jdbc alias bpm= jdbc alias bpm eventos= start verifica eventos=false quantidade backuplogdados=1000 start mode rules=false start mode rules=false load factservicerequestrules=true iniciar processamentos batch=true dê permissão para o usuário do wildfly para este arquivo chown wildfly wildfly /opt/wildfly/standalone/configuration/application ini no arquivo application ini, o valor padrão é true (mesmo se não for definido), ou seja, se essa opção não existir no arquivo, o sistema utilizará o valor true para essa propriedade definido como true, ativa o thread que atualiza a tabela de fatos de solicitações de serviço na inicialização do sistema definido como false, a atualização ocorrerá somente após a inclusão ou alteração da solicitação de serviço na versão 2 1 14 o sistema não utiliza mais o parâmetro 449 para definir o tempo de sessão, ele, agora, é controlado pelo tempo de expiração do token jwt esse tempo de expiração é parametrizado no arquivo application ini, propriedade token max age definido em milissegundos caso não esteja definido, neste arquivo, o valor default é 1 dia porém, nesta versão existe um recurso para manter a sessão de usuário, ativa por tempo indeterminado, desde que ele continue usando o sistema dentro do período de um dia em outras palavras, se não completar um dia e o usuário utilizou o sistema, a sessão dele continuará ativa até que se passe mais de 24 horas este recurso foi removido na versão 3 0 0 configurações de acesso com keycloak no citsmart, o controle de autorização para acesso às telas e apis é feito através da tela de perfil de acesso esta tela define quais telas o usuário pode acessar não existe uma forma de permitir apenas o acesso às apis desta tela para o caso dos portais que precisam de determinados recursos de outras telas, isto pode gerar conflito por isso, foi permitido dar acesso a telas no perfil de acesso desta forma, será possível permitir a utilização dos portais nos recursos que serão necessários, e tendo o controle para evitar que este mesmo usuário acesse a área restrita do sistema centro de experiência a tela centro de experiência é exemplo de um portal, ou seja, uma tela de acesso inicial do sistema e que pode acessar recursos da área restrita do sistema pode se adicionar widgets que permitem acesso à lista de tickets, tickets para aprovação, registro de comentários, o registro de tickets, consulta à base de conhecimento e outros perfil de acesso a tela de perfil de acesso foi alterada para não mais retirar todas as permissões das telas e salvar automaticamente agora, ela permite que o operador restrinja o acesso de um usuário ao sistema, mas dê acesso a algum recurso interno que poderá ser utilizado nos portais smart portal e centro de experiência desta forma, o usuário não acessará as telas internas do sistema, mas poderá usar os recursos adicionados nos portais na tela de cadastro de perfil de acesso é possível marcar individualmente cada uma das permissões dentro do sistema, bem como autorizar ou não o acesso ao sistema citsmart tela inicial do sistema o parâmetro 46 tela inicial do citsmart? (opções sd = smart decisions, sp = smart portal, ec = centro de experiência) define qual será a tela inicial do sistema para todos os usuários apenas os usuários que têm permissão acessarão a área interna do sistema importante para garantir o sucesso dos testes e parametrização correta do sistema, observar que o perfil de acesso também pode ser definido na tela de grupos é importante verificar a quais grupos o usuário pertence e quais são os perfis de acesso ligados a eles é importante ressaltar que para um bom funcionamento da aplicação o parâmetro 48 também deve estar habilitado para poder realizar a edição do perfil do 'usuário sem acesso', deve se liberar o menu sistema > configurações > perfil do usuário configuração do quartz o processamento batch do citsmart utiliza o quartz para o agendamento e processamento de rotinas de sistema crie um arquivo de nome "quartz properties" no caminho /opt/wildfly/standalone/configuration/ as configurações se diferem para standalone comum, para o standalone configurado em modo cluster em qualquer um dos casos, configure o wildfly da seguinte maneira das formas a seguir configuração standalone sem cluster se você estiver rodando o wildfly em modo standalone mas sem configuração de cluster, insira as seguintes informações no arquivo quarts properties \#=============================================================== \#configure main scheduler properties \#=============================================================== org quartz scheduler instancename = citsmartmonitor org quartz scheduler instanceid = auto \#=============================================================== \#configure threadpool \#=============================================================== org quartz threadpool threadcount = 5 org quartz threadpool threadpriority = 5 org quartz threadpool class = org quartz simpl simplethreadpool \#=============================================================== \#configure jobstore \#=============================================================== org quartz jobstore class = org quartz simpl ramjobstore configuração standalone com cluster configurado caso você tenha um standalone funcionando em modo cluster, as configurações do quartz são diferentes de acordo com banco de dados utilizado abaixo seguem as configurações para cada um dos possíveis cenários qualquer que seja o banco de dados, as configurações se aplicam ao mesmo arquivo quartz properties no mesmo caminho informado anteriormente configuração para banco de dados banco de dados postgres \#============================================================================ \# configure main scheduler properties \#============================================================================ org quartz scheduler instancename = citsmartmonitor org quartz scheduler instanceid = auto \#============================================================================ \# configure threadpool \#============================================================================ org quartz threadpool class = org quartz simpl simplethreadpool org quartz threadpool threadcount = 25 org quartz threadpool threadpriority = 5 \#============================================================================ \# configure jobstore \#============================================================================ org quartz jobstore misfirethreshold = 60000 org quartz jobstore class = org quartz impl jdbcjobstore jobstoretx org quartz jobstore driverdelegateclass = org quartz impl jdbcjobstore postgresqldelegate org quartz jobstore useproperties = true org quartz jobstore datasource = citsmart org quartz jobstore tableprefix = qrtz org quartz jobstore isclustered = true org quartz jobstore clustercheckininterval = 20000 org quartz datasource citsmart jndiurl= java /jdbc/citsmart configuração para o banco de dados microsoft sql server \#============================================================================ \# configure main scheduler properties \#============================================================================ org quartz scheduler instancename = citsmartmonitor org quartz scheduler instanceid = auto \#============================================================================ \# configure threadpool \#============================================================================ org quartz threadpool class = org quartz simpl simplethreadpool org quartz threadpool threadcount = 25 org quartz threadpool threadpriority = 5 \#============================================================================ \# configure jobstore \#============================================================================ org quartz jobstore misfirethreshold = 60000 org quartz jobstore class = org quartz impl jdbcjobstore jobstoretx org quartz jobstore driverdelegateclass = org quartz impl jdbcjobstore mssqldelegate org quartz jobstore useproperties = true org quartz jobstore datasource = citsmart org quartz jobstore tableprefix = qrtz org quartz jobstore isclustered = true org quartz jobstore clustercheckininterval = 20000 org quartz datasource citsmart jndiurl= java /jdbc/citsmart configuração para o banco de dados oracle \#============================================================================ \# configure main scheduler properties \#============================================================================ org quartz scheduler instancename = citsmartmonitor org quartz scheduler instanceid = auto \#============================================================================ \# configure threadpool \#============================================================================ org quartz threadpool class = org quartz simpl simplethreadpool org quartz threadpool threadcount = 25 org quartz threadpool threadpriority = 5 \#============================================================================ \# configure jobstore \#============================================================================ org quartz jobstore misfirethreshold = 60000 org quartz jobstore class = org quartz impl jdbcjobstore jobstoretx org quartz jobstore driverdelegateclass = org quartz impl jdbcjobstore oracle oracledelegate org quartz jobstore useproperties = true org quartz jobstore datasource = citsmart org quartz jobstore tableprefix = qrtz org quartz jobstore isclustered = true org quartz jobstore clustercheckininterval = 20000 criação de diretórios para instalação crie todos os diretórios abaixo necessários para funcionamento da solução lembre se que o dono dos diretórios precisa ser o usuário wildfly mkdir p /opt/citsmart/{ged,kb,twinwords,attachkb,upload} chown r wildfly wildfly /opt/citsmart/ configurações extras do desenho de fluxo no desenho de fluxo, podemos utilizar o script abaixo numa ação do fluxo, para inserir um item de trabalho para solicitações de serviço, registradas já resolvidas flowexecution insertworkitemandattribution(flowinstance getidinstancia(), "atender solicitacao", ""); o script possui os seguintes parâmetros id da instância de execução do fluxo; nome da tarefa que será usada para encerrar a solicitação, este nome deve estar presente neste desenho de fluxo; sigla do grupo executor que irá encerrar esta atividade; o sistema irá executar as seguintes possiblidades até encontrar um id de grupo executor válido 1º o grupo da sigla informada; 2º o grupo executor da atividade no portfólio; 3º o grupo de 1º nível no portfólio; 4º o grupo do parâmetro grupo executor padrão; 5º o grupo do parâmetro grupo de primeiro nível;