Persistência de dados

Quando você cria seus aplicativos de negócios, você pode ativar a persistência de dados em suas variáveis de objeto de dados. Com a persistência de dados ativada, as variáveis de objeto de dados são persistidas no servidor e não são perdidas entre as sessões.

Você pode optar por persistir dados no nível de usuário, ou no nível do aplicativo.

Nível do usuário

Os dados são persistidos para um usuário individual dentro do aplicativo. Por exemplo, você está projetando um aplicativo que abrange várias páginas com muitos campos um cliente deve ser concluído. Talvez o usuário esteja criando uma conta com vários campos. O formulário de conta teria campos que são configurados como objetos de dados individuais. Se você ativar a persistência de dados no nível de usuário para qualquer campo, as informações que o cliente insere nesses campos persistiram. Se um usuário começar a completar o formulário de conta, mas sai do aplicativo, seu progresso é salvo para quando eles retornarem para preencher o formulário.

Persistem dados no nível do usuário são diferentes do que persistem dados no nível de perfil do usuário. Persistem dados a um perfil de usuário se aplicam em todos os aplicativos e são configurados fora do designer de baixo código. Para persistência de dados de nível de usuário, os dados são persistidos por aplicativo e configurados dentro do designer de baixo código.

Nível do aplicativo

Os dados são persistidos em todos os usuários dentro do aplicativo. Por exemplo, a criação de um aplicativo que usa uma caixa de texto de comentário, em que os usuários podem enviar comentários Você pode configurar os dados para esta caixa de comentários persistir através do aplicativo. Qualquer comentário de usuário que seja submetido ao aplicativo é visualizável por todos os usuários dentro do aplicativo.

Pré-requisito

Se você deseja utilizar o armazenamento de persistência de dados padrão para o seu aplicativo, você deve ativar a opção Data persistence na sua implementação do aplicativo. Caso contrário, erros podem ocorrer quando seu aplicativo está em execução e tentando persistir dados. Depois que a opção Data persistence é ativada em sua implementação, o Content Platform Engine é implementado e pré-configurado para persistência de dados. Todos os dados que foram mantidos pelo Content Platform Engine podem ser administrados no Console Administrativo IBM® para Content Platform Engine.

Para obter mais informações sobre como configurar a opção Data persistence em sua implementação, consulte Configurando o Application Engine com persistência de dados.

Como ativar a persistência de dados em variáveis de dados

Por padrão, a persistência de dados é desativada para variáveis de dados em sua aplicação.

Ao criar seu aplicativo de negócios no designer de baixo código, alterna para a guia Variáveis para sua aplicação.
Selecione uma variável de dados da sua lista. Se a lista estiver vazia, crie uma variável de dados que você deseja persistir.
Para o valor Persist data to , configure para Usuário ou Aplicativo.

Dica: Somente persistam dados para campos que são necessários para o seu aplicativo de negócios. Isso limita chamadas de rede desnecessárias para o seu servidor. Quando seu aplicativo está em execução, toda mudança que um usuário faz para um campo de dados persistido resulta em uma chamada de rede para o servidor para salvar os dados.
Preview sua aplicação e interagir com seus dados persistidos para garantir que o aplicativo esteja se comportando como esperado.

Nota: Ao pré-visualizar seu aplicativo, ou quando a opção de persistência de dados não estiver ativada em sua implementação de tempo de execução, os dados persistidos ficam armazenados na memória do servidor e duram até que o servidor seja reiniciado.

Tipos de dados suportados

Atualmente, apenas tipos de dados que podem ser serializados fora como string são suportados para persistência de dados.

Ciclo de vida de dados

Os dados persistidos permanecem até que o administrador limpa os dados. Se o aplicativo for excluído, os dados persistidos permanecem no Content Platform Engine. Dentro do Console Administrativo da IBM para Content Platform Engine, o aplicativo State é configurado como Deleted, mas os dados são deixados intactos. Dessa forma, se o aplicativo for importado novamente, os dados persistidos não são perdidos. Isso permite que você limpe os dados com base na política de retenção de dados da sua empresa.

Exclusão de dados persistidos

Você pode remover dados persistidos do Content Platform Engine. As entradas que você remover do console não são excluídas do sistema.

Efetue login no IBM Administration Console for Content Platform Engine.
Na área de janela de navegação, acesse Armazenamentos de Objetos > AEOS Na aba AEOS que se abre, clique em Pesquisar no painel de navegação.
Configure uma pesquisa para localizar os dados que você deseja excluir.
1. Clique em Nova Pesquisa de Loja de Objeto.
2. Na lista suspensa de classe, selecione BO Persistence.
3. Insira propriedades para filtrar sua pesquisa. Se você deseja pesquisar por dados do usuário, selecione a propriedade Criador , selecione Igual a no campo de condição e digite o ID do usuário no campo de valor. Você também pode filtrar pelo ID do aplicativo ou escopo.
4. Clique em Executar para executar a pesquisa.
Selecione as entradas que você deseja excluir. Clique em uma das Ações drop-down, selecione Batch Operations, e selecione a caixa de seleção delete . Clique em OK.

Gerenciando o acesso a dados

Você pode configurar o acesso do usuário aos dados do aplicativo no Content Platform Engine.

Efetue login no IBM Administration Console for Content Platform Engine.
Na área de janela de navegação, acesse Armazenamentos de Objetos > AEOS Na guia AEOS que é aberta, acesse Design de Dados > Classes > Outras Classes > Abstract Persistable > Persistência de BO
Na visualização da classe, vá para a aba Segurança da Instância Padrão . Nesta aba você verá os usuários de segurança padrão e permissões:
- AUTHENTICATED-USERS é lido apenas.
- CREATOR-OWNER tem todas as permissões.
- cp4admin é para o administrador Content Platform Engine e tem todas as permissões.
Para atualizar permissões, selecione a entrada e clique em Editar .... Para adicionar novas permissões, clique em Adicionar Permissões ... e pesquise o Protocolo Leve de Acesso a Diretórios ( LDAP ) para adicionar um usuário ou grupo. As permissões atualizadas e novas serão aplicáveis apenas a novos objetos.
Para atualizar ou visualizar permissões em itens existentes, é possível utilizar a opção Pesquisar no painel de navegação.
1. Clique em Nova Pesquisa de Loja de Objeto e selecione BO Persistence sob o drop-down da classe.
  Configure uma pesquisa para localizar os dados que você deseja excluir.
  1. Clique em Nova Pesquisa de Loja de Objeto.
  2. Na lista suspensa de classe, selecione BO Persistence.
  3. Insira propriedades para filtrar sua pesquisa. Se você deseja pesquisar por dados do usuário, selecione a propriedade Criador , selecione Igual a no campo de condição e digite o ID do usuário no campo de valor. Você também pode filtrar pelo ID do aplicativo ou escopo.
  4. Clique em Executar para executar a pesquisa.
2. Selecione os objetos com permissões que você deseja alterar. Clique no menu suspenso Ações e selecione Batch operation.
3. Na janela Operação do Batch que se abre, selecione a guia Segurança . Usando o Add ... cair abaixo, adicionar seus usuários e grupos desejados. Em seguida, selecione suas permissões desejadas na lista abaixo.