Création et modification de business objects dans Oracle Visual Builder

Vous pouvez créer un objet fonctionnel dans Oracle Visual Builder, tel qu'une facture, une commande d'achat ou un audit. Considérez un objet fonctionnel comme une ressource semblable à une table de base de données ; il contient des champs contenant les données de votre application. A l'instar d'une table de base de données, un objet métier fournit la structure des données. Les business objects sont stockés dans une base de données. Les applications de votre application visuelle et d'autres clients accèdent aux objets fonctionnels à l'aide de leurs adresses REST.

Créer un business object

Vous utilisez des objets fonctionnels personnalisés pour stocker des données qui ne sont pas fournies par un service externe. Les données de vos business objects personnalisés sont stockées dans la base de données dont les infos de paramétrage ont été fournies pour votre instance de service.

Lorsque vous créez des business objects personnalisés, vous spécifiez chacun des champs requis par votre application. Lorsque vous développez votre application, vous pouvez modifier vos business objects afin d'ajouter et de modifier des champs selon vos besoins. Votre business object personnalisé est affiché sous la forme d'un ensemble d'adresses qui fournissent des API REST pour les opérations que vous pouvez appeler à partir de composants de page.

Pour créer un business object, procédez comme suit :

1. Cliquez sur l'onglet Business objects.
2. Cliquez sur Créer un business object.
3. Saisissez le libellé du business object et cliquez sur Créer.
   La valeur ID est renseignée automatiquement en fonction du libellé.

Lorsque vous cliquez sur Créer, une fenêtre d'artefact pour le nouveau business object s'ouvre dans la fenêtre principale et affiche l'onglet Aperçu. Cette fenêtre contient des onglets supplémentaires permettant d'afficher et de modifier les différents attributs du business object : Champs, Sécurité, Règles de gestion, Adresses et Données.

Vous pouvez visualiser les adresses du business object créé par défaut dans l'onglet Adresses.

Vous pouvez également créer des business objects à l'aide de l'outil de diagramme.

Afficher, créer et modifier les relations entre objets fonctionnels

La zone Relations de l'onglet Aperçu d'un objet fonctionnel affiche les relations entre cet objet fonctionnel et les autres objets fonctionnels de l'application.

Lorsque vous créez une référence à un autre objet fonctionnel, la relation entre l'objet fonctionnel actuel et celui référencé est, par défaut, de n à un. Par exemple, lorsque vous créez une référence d'un objet fonctionnel Employé à un objet fonctionnel Service, l'employé ne peut appartenir qu'à un seul service ; un service comprend généralement de nombreux employés.

L'objet fonctionnel référencé, Department, apparaît également dans l'onglet Adresses de l'objet fonctionnel Salarié.

Vous pouvez supprimer une relation, mais uniquement si elle est associée à des objets fonctionnels n'importe où dans votre application.

Pour créer une relation :

1. Dans l'onglet Business objects, sélectionnez le business object à visualiser.
   Le contenu de l'onglet Aperçu est affiché.
2. Cliquez sur l'icône Nouvelle relation en regard de Relations.
3. Dans la boîte de dialogue, sélectionnez le business object avec lequel créer une relation.
4. Sélectionnez la cardinalité pour chaque objet (Plusieurs ou Un).
   Vous pouvez cliquer sur le bouton Reverse Relationship pour basculer entre une source et une cible. Vous pouvez spécifier des cardinalités comprises entre un à un et plusieurs objets fonctionnels, en plus de plusieurs à plusieurs. Si vous sélectionnez n à n, un objet fonctionnel d'intersection avec deux champs de référence est créé automatiquement. Son nom est une concaténation des deux business objects. Pour un objet fonctionnel d'intersection, vous ne pouvez pas désélectionner la case Obligatoire dans l'un des champs de référence et la règle de suppression par défaut est Cascade.
5. Modifiez les propriétés du champ Relation (ID, libellé d'affichage, champ d'affichage par défaut, case à cocher Obligatoire, règle de suppression). Pour Règle de suppression, les choix disponibles sont Cascade, Restreindre et Affecter la valeur NULL. Que vous puissiez modifier une propriété et quelles valeurs sont disponibles dépendent du type de relation et des objets.
6. Cliquez sur Créer.
7. Cliquez sur Enregistrer pour enregistrer la nouvelle relation.

La nouvelle relation s'affiche dans la liste Relations. Si vous avez indiqué n à n comme cardinalité, le nouveau business object d'intersection est également affiché.

Pour modifier une relation, cliquez sur l'icône Modifier en regard du nom de la relation et apportez les modifications voulues. Certains champs ne peuvent pas être modifiés et sont désactivés. Vous pouvez indiquer le libellé et sélectionner le champ d'affichage par défaut. Vous pouvez cocher la case Obligatoire du champ et indiquer une règle de suppression. La règle de suppression par défaut est Restreindre, mais vous pouvez sélectionner Cascade ou Affecter la valeur NULL.

Ajouter des champs aux objets fonctionnels

Vous pouvez utiliser l'onglet Champs de la fenêtre de l'artefact pour créer des champs pour vos business objects.

Vous pouvez créer des champs pour votre business object lorsqu'il a le statut Développement.

Pour ajouter un nouveau champ :

1. Cliquez sur l'onglet Champs du business object à modifier.
2. Cliquez sur le bouton + Nouveau champ.
3. Dans le champ Libellé, entrez le nom du champ.
   La valeur ID est renseignée automatiquement en fonction du libellé de champ.
4. Sélectionnez le type du champ.
   Les types disponibles sont les suivants: Chaîne , Nombre , Booléen , Date/heure , Date , Heure , Référence , Courriel , Pourcentage , Téléphone et URI . Pour un type Reference, vous devrez indiquer le business object de référence et le champ d'affichage par défaut.
5. Cliquez sur Créer.

Modifier les champs des business objects

Vous pouvez utiliser l'onglet Champs de la fenêtre de l'artefact pour modifier les champs de vos business objects personnalisés.

Vous pouvez modifier les champs des business objects lorsque votre application a le statut Développement. Vous pouvez modifier les champs pour indiquer des contraintes.

Pour modifier les propriétés d'un champ :

1. Cliquez sur l'onglet Champs du business object à modifier.
   L'onglet Champs comporte une table répertoriant tous les champs définis dans le schéma pour le business object.
2. Sélectionnez la ligne du champ à modifier.

   Lorsque vous sélectionnez une ligne dans la table, l'éditeur affiche les propriétés que vous pouvez modifier.

3. Modifiez les propriétés du champ.
   Les propriétés disponibles dépendent du type de données du champ. Par exemple, vous pouvez spécifier une valeur initiale pour le champ à l'aide d'une valeur statique, d'une expression ou d'une formule. Vous pouvez également indiquer des contraintes de champ.
4. Cliquez de nouveau sur Modifier pour fermer la boîte de dialogue, puis cliquez sur Enregistrer.