Criar e Editar Objetos de Negócios no Oracle Visual Builder

É possível criar um objeto de negócio no Oracle Visual Builder, como uma NFF, uma ordem de compra ou uma auditoria. Pense em um objeto de negócios como um recurso semelhante a uma tabela de banco de dados; ele tem campos que contêm os dados da sua aplicação. Como uma tabela de banco de dados, um objeto de negócios fornece a estrutura de dados. Os objetos de negócios são armazenados em um banco de dados. Os aplicativos em seu aplicativo visual e outros clientes acessam os objetos de negócios usando seus pontos finais REST.

Criar um Objeto de Negócios

Você usa objetos de negócio personalizados para armazenar dados que não são fornecidos por um serviço externo. Os dados em seus objetos de negócios personalizados são armazenados no banco de dados provisionado para sua instância de serviço.

Ao criar objetos de negócios personalizados, você especifica cada um dos campos de que sua aplicação precisa. Ao desenvolver sua aplicação, você pode modificar seus objetos de negócios para adicionar e modificar campos conforme necessário. Seu objeto de negócios personalizado é exposto como um conjunto de pontos finais que fornecem APIs REST para operações que você pode chamar dos componentes da página.

Para criar um objeto de negócios:

  1. Clique na guia Objetos de Negócios.
  2. Clique em Criar Objeto de Negócios.
  3. Informe o label para o objeto de negócios e clique em Criar.
    O valor do ID é preenchido automaticamente com base no Rótulo.

Quando você clica em Criar, uma janela de artefato para o novo objeto de negócios é aberta na janela principal e exibe a guia Visão Geral. A janela contém guias adicionais para exibir e editar os vários atributos do objeto de negócios: Campos, Segurança, Regras de Negócios, Pontos Finais e Dados.

Você pode ver os pontos finais para o objeto de negócios que é criado por padrão na guia Pontos Finais.

Você também pode criar objetos de negócios usando o Diagramador.

Exibir, Criar e Editar Relacionamentos do Objeto de Negócio

A área Relacionamentos da guia Visão Geral de um objeto de negócios exibe os relacionamentos entre esse objeto de negócios e outros objetos de negócios da sua aplicação.

Quando você cria uma referência a outro objeto de negócios, a relação entre o objeto de negócios atual e o que está sendo referenciado é, por padrão, muitos para um. Por exemplo, quando você cria uma referência de um objeto de negócio Funcionário para um objeto de negócio Departamento, o funcionário pode pertencer a apenas um departamento, mas geralmente um departamento tem muitos funcionários.

O objeto de negócio referenciado, Departamento, também aparece na guia Pontos Finais do objeto de negócio Funcionário.

Você pode excluir um relacionamento, mas somente se os objetos de negócio associados não forem usados em nenhum lugar do aplicativo.

Para criar uma nova relação:

  1. Na guia Objetos de Negócios, selecione o objeto de negócios que você deseja exibir.
    O conteúdo da guia Visão Geral é exibido.
  2. Clique no ícone Nova Relação ao lado de Relação.
  3. Na caixa de diálogo, selecione o objeto de negócios com o qual você deseja criar um relacionamento.
  4. Selecione a cardinalidade para cada objeto (Muitos ou Um).
    É possível clicar no botão Reverter Relação para alternar entre um para muitos e um para um. É possível especificar cardinalidades de um para um e muitos para muitos entre objetos de negócios, além de muitos para um e um para muitos. Se você especificar muitos para muitos, um objeto de negócio de interseção com dois campos de referência será criado automaticamente. Seu nome é uma concatenação dos dois objetos de negócios. Em um objeto de negócios de interseção, você não pode desmarcar a caixa de seleção Obrigatório em um dos campos de referência e a regra de exclusão padrão é Em Cascata.
  5. Edite as propriedades do campo Relacionamento (o ID, o Rótulo de Exibição, o Campo de Exibição Padrão, a caixa de seleção Obrigatório, a Regra de Exclusão). Para Excluir Regra, as opções disponíveis são Em Cascata, Restringir e Definir como Nulo. Se você pode editar uma propriedade e quais valores estão disponíveis dependem do tipo de relacionamento e dos objetos.
  6. Clique em Criar.
  7. Clique em Salvar para salvar o novo relacionamento.
O novo relacionamento é exibido na lista Relacionamentos. Se você especificou muitos para muitos como a cardinalidade, o novo objeto de negócios de interseção também será exibido.

Para editar uma relação, clique no ícone Editar ao lado do nome da relação e faça as alterações desejadas. Alguns campos não podem ser editados e desativados. Você pode especificar o Rótulo e selecionar o Campo de Exibição Padrão. Você pode marcar a caixa de seleção Obrigatório para o campo e especificar uma regra de exclusão. A regra de exclusão padrão é Restringir, mas você pode selecionar Em Cascata ou Definir como Nulo.

Adicionar Campos a Objetos de Negócios

Você pode usar a guia Campos da janela de artefato para criar campos para seus objetos de negócios.

Você pode criar novos campos para seu objeto de negócios enquanto ele está no status Desenvolvimento.

Para adicionar um novo campo:

  1. Clique na guia Campos do objeto de negócios que você deseja editar.
  2. Clique no botão + Novo Campo.
  3. No campo Label, informe o nome do campo.
    O valor do Id é preenchido automaticamente com base no label do campo.
  4. Selecione o Tipo do campo.
    Os tipos disponíveis são String , Número , Booliano , Data/Hora , Data , Hora , Referência , E-mail , Percentual , Telefone e Uri . Para um tipo Reference, será necessário especificar o Objeto de Negócios de Referência e o Campo de Exibição Padrão.
  5. Clique em Criar.

Editar os Campos de Objetos de Negócios

Você pode usar a guia Campos da janela de artefato para modificar os campos de seus objetos de negócios personalizados.

Você pode editar os campos de objetos de negócios quando sua aplicação estiver no status Desenvolvimento. Você pode editar campos para especificar restrições.

Para editar as propriedades de um campo:

  1. Clique na guia Campos do objeto de negócios que você deseja editar.
    A guia Campos exibe uma tabela que lista todos os campos definidos no esquema para o objeto de negócios.
  2. Selecione a linha do campo que você deseja editar.

    Quando você seleciona uma linha na tabela, o editor exibe as propriedades que podem ser editadas.

  3. Edite as propriedades do campo.
    As propriedades disponíveis dependerão do tipo de dados do campo. Por exemplo, você pode especificar um valor inicial para o campo usando um valor estático, uma expressão ou uma fórmula. Você também pode especificar restrições de campo.
  4. Clique em Editar novamente para fechar a caixa de diálogo e clique em Salvar.