Crea e modifica i business object in Oracle Visual Builder

È possibile creare un business object in Oracle Visual Builder, ad esempio una fattura, un ordine di acquisto o un audit. Si ritiene che un business object sia una risorsa simile a una tabella di database e contenga campi contenenti i dati per l'applicazione. Come una tabella di database, un business object fornisce la struttura dei dati. I business object vengono memorizzati in un database. Le applicazioni dell'applicazione visiva e di altri client accedono ai business object mediante i relativi endpoint REST.

Crea un business object

I business object personalizzati vengono utilizzati per memorizzare dati non forniti da un servizio esterno. I dati nei business object personalizzati vengono memorizzati nel database di cui è stato eseguito il provisioning per l'istanza del servizio.

Quando si creano business object personalizzati, è necessario specificare ogni campo richiesto dall'applicazione. Durante lo sviluppo dell'applicazione, è possibile modificare i business object per aggiungere e modificare i campi in base alle esigenze. Il business object personalizzato è esposto come set di endpoint che forniscono interfacce API REST per le operazioni che è possibile richiamare dai componenti della pagina.

Per creare un business object, effettuare le operazioni riportate di seguito.

1. Fare clic sulla scheda Business object.
2. Fare clic su Crea business object.
3. Immettere l'etichetta per il business object e fare clic su Crea.
   Il valore ID viene immesso automaticamente in base all'etichetta.

Quando si fa clic su Crea, nella finestra principale viene visualizzata una finestra artifact per il nuovo business object e viene visualizzata la scheda Panoramica. La finestra contiene schede aggiuntive per la visualizzazione e la modifica dei vari attributi del business object: Campi, Sicurezza, Regole business, Endpoint e Dati.

È possibile visualizzare gli endpoint per il business object creato per impostazione predefinita nella scheda Endpoint.

È inoltre possibile creare business object utilizzando il diagrammer.

Visualizza, crea e modifica relazioni business object

Nell'area Relazioni della scheda Panoramica di un business object sono visualizzate le relazioni tra tale business object e altri business object nell'applicazione.

Quando si crea un riferimento a un altro business object, la relazione tra il business object corrente e quello a cui viene fatto riferimento, per impostazione predefinita, molti-a-uno. Ad esempio, quando si crea un riferimento da un business object Dipendente a un business object Reparto, il dipendente può appartenere a un solo reparto, ma il reparto in genere ha molti dipendenti.

Il business object di riferimento, Reparto, viene visualizzato anche nella scheda Endpoint per il business object Dipendente.

È possibile eliminare una relazione, ma solo se i business object associati non sono utilizzati in alcuna posizione dell'applicazione.

Per creare una nuova relazione:

1. Nella scheda Business object, selezionare il business object che si desidera visualizzare.
   Viene visualizzato il contenuto della scheda Panoramica.
2. Fare clic sull'icona Nuova relazione accanto a Relazioni.
3. Nella finestra di dialogo selezionare il business object con cui si desidera creare una relazione.
4. Selezionare la cardinalità per ogni oggetto (molti o uno).
   È possibile fare clic sul pulsante Inverti relazione per passare da uno a molti a uno a uno e viceversa. È possibile specificare cardinalità di uno a uno e molti a molti tra i business object, oltre a molti a molti e uno a molti. Se si specifica molti-a-molti, viene creato automaticamente un business object di intersezione con due campi di riferimento. Il nome è una concatenazione dei due business object. Per un business object intersezione, non è possibile deselezionare la casella di controllo Obbligatorio in uno dei campi di riferimento e la regola di eliminazione predefinita è A catena.
5. Modificare le proprietà del campo Relazione (ID, Etichetta visualizzata, Campo di visualizzazione predefinito, la casella di controllo Obbligatorio, Elimina regola ). Per Elimina regola le scelte disponibili sono Sovrapponi, Limita e Imposta su null. La possibilità di modificare una proprietà e i valori disponibili dipendono dal tipo di relazione e dagli oggetti.
6. Fare clic su Crea.
7. Fare clic su Salva per salvare la nuova relazione.

La nuova relazione viene visualizzata nell'elenco Relazioni. Se è stata specificata la cardinalità come cardinalità, viene visualizzato anche il nuovo business object di intersezione.

Per modificare una relazione, fare clic sull'icona Modifica accanto al nome della relazione e apportare le modifiche desiderate. Alcuni campi non possono essere modificati e sono disabilitati. È possibile specificare un valore per Etichetta e selezionare il campo Visualizzazione predefinita. È possibile selezionare la casella di controllo Obbligatorio per il campo e specificare una regola di eliminazione. La regola di eliminazione predefinita è Limita, ma è possibile selezionare Sovrapponi o Imposta su NULL.

Aggiungi campi a business object

È possibile utilizzare la scheda Campi della finestra artifact per creare campi per i business object.

È possibile creare nuovi campi per il business object mentre il relativo stato è Sviluppo.

Per aggiungere un nuovo campo, effettuare le operazioni riportate di seguito.

1. Fare clic sulla scheda Campi del business object che si desidera modificare.
2. Fare clic sul pulsante + Nuovo campo.
3. Nel campo Etichetta immettere il nome del campo.
   Il valore ID viene inserito automaticamente in base all'etichetta del campo.
4. Selezionare il tipo del campo.
   I tipi disponibili sono Stringa , Numero , Booleano , Data/ora, Data , Ora , Riferimento , E-mail , Percentuale , Telefono e URI . Per un tipo Reference, è necessario specificare il business object di riferimento e il campo di visualizzazione predefinito.
5. Fare clic su Crea.

Modifica i campi dei business object

È possibile utilizzare la scheda Campi della finestra artifact per modificare i campi dei business object personalizzati.

È possibile modificare i campi dei business object quando l'applicazione è in stato Sviluppo. È possibile modificare i campi per specificare i vincoli.

Per modificare le proprietà di un campo, effettuare le operazioni riportate di seguito.

1. Fare clic sulla scheda Campi del business object che si desidera modificare.
   La scheda Campi visualizza una tabella in cui sono elencati tutti i campi definiti nello schema per il business object.
2. Selezionare la riga del campo che si desidera modificare.

   Quando si seleziona una riga nella tabella, l'editor visualizza le proprietà che è possibile modificare.

3. Modificare le proprietà del campo.
   Le proprietà disponibili dipendono dal tipo di dati del campo. Ad esempio, è possibile specificare un valore iniziale per il campo utilizzando un valore statico, un'espressione o una formula. È inoltre possibile specificare vincoli di campo.
4. Fare di nuovo clic su Modifica per chiudere la finestra di dialogo e fare clic su Salva.