Utilizzo dei template

I template consentono di memorizzare le configurazioni di applicazioni o dimensioni in un file offline al fine di utilizzarle in altri ambienti Oracle Enterprise Data Management Cloud. Utilizzare i template per trasferire applicazioni o dimensioni, con i relativi oggetti metadati, tra ambienti diversi (ad esempio, da un ambiente di test a un ambiente di produzione) o per avviare rapidamente nuove implementazioni.

Per utilizzare un template, esportare innanzitutto un'applicazione e tutti i relativi oggetti metadati dell'ambiente di origine in un file .json, quindi importare il template nell'ambiente target.

I template contengono solo metadati e non includono dati, richieste o cronologia transazioni.

Procedura consigliata

Se in un ambiente di test si sta creando un'applicazione che si prevede di trasferire a un ambiente di produzione, la procedura consigliata prevede dapprima l'aggiornamento dell'ambiente di test con uno snapshot corrente dell'ambiente di produzione, quindi la creazione dell'applicazione da trasferire. In questo modo gli oggetti globali, quali ad esempio le proprietà e le viste, avranno gli stessi ID in entrambi gli ambienti.

Caution:

I template sono progettati per eseguire la migrazione di modifiche da un ambiente a un altro. Per questo motivo, è importante designare un sistema di origine in cui vengono eseguite tutte le modifiche e un sistema target verso cui viene eseguita la migrazione delle modifiche. Non apportare modifiche in entrambi gli ambienti. È possibile utilizzare gli snapshot di migrazione anche per risincronizzare gli ambienti, se necessario. Fare riferimento al paragrafo Procedure consigliate nella sezione Esempi di scenari di migrazione.

Considerazioni

Per importare ed esportare applicazioni e dimensioni nei template, è necessario essere un amministratore servizi o disporre del ruolo applicazione Migrazioni - Amministra (fare riferimento alla sezione Introduzione a ruoli e autorizzazioni delle applicazioni).
Quando un'applicazione viene trasferita in un ambiente target, si verifica quanto segue.
- Se il proprietario dell'applicazione nell'ambiente di origine esiste anche nell'ambiente target, verrà mantenuto come proprietario dell'applicazione nell'ambiente target.
- Se invece il proprietario dell'applicazione nell'ambiente di origine non esiste anche nell'ambiente target, un amministratore servizi deve assegnare un proprietario all'applicazione nell'ambiente target.
È possibile trasferire nuove applicazioni o dimensioni dall'ambiente di origine a quello target oppure trasferire applicazioni o dimensioni già esistenti nell'ambiente target. Il processo di importazione dei template aggiorna le applicazioni o le dimensioni esistenti nell'ambiente target mediante la creazione di oggetti che non esistono e mediante la modifica degli oggetti esistenti per l'applicazione o la dimensione target. Fare riferimento alla sezione Aggiornamento di un'applicazione o una dimensione esistente mediante un template.
È possibile trasferire solo le applicazioni attive.
È possibile escludere dalle importazioni nei template gli oggetti catena dati archiviati se gli oggetti archiviati dell'ambiente di origine non esistono già nell'ambiente target.

Note:
Vengono esclusi dall'archiviazione nei template anche gli oggetti dipendenti da un oggetto archiviato qualora non esistano nell'ambiente target. Se un oggetto dipendente venisse escluso parzialmente, verrebbe visualizzato nell'anteprima del template o nell'importazione con un messaggio di avviso che indica che è stato impossibile importarlo.
Se ad esempio durante l'importazione si esclude una dimensione archiviata e tale dimensione non esiste già nell'ambiente target, vengono esclusi dall'importazione nel template anche oggetti quali associazioni di dimensioni, tipi di nodi, criteri ed estrazioni qualora non esistano già nell'ambiente target.
È possibile trasferire più applicazioni in un unico file template. Se il trasferimento viene eseguito a livello di dimensione, non è possibile trasferire più dimensioni in un unico file template.
Durante il trasferimento delle dimensioni, l'applicazione contenente la dimensione interessata deve esistere nell'ambiente target.
Per trasferire un'applicazione o una dimensione tra ambienti diversi, entrambi gli ambienti devono essere della stessa versione di rilascio.
Quando si importa un template, se un utente o un gruppo esiste sia nell'ambiente di origine che nell'ambiente target, vengono importati i riferimenti utente o gruppo seguenti per gli oggetti associati:
- Autorizzazioni
- Utenti e gruppi di criteri
- Assegnatari di sottoscrizioni
- Filtri vista per utenti e gruppi
Se un utente o un gruppo dell'ambiente di origine non esiste nell'ambiente target, il riferimento utente o gruppo associato non verrà trasferito. Verrà visualizzato un messaggio con l'indicazione degli utenti e dei gruppi mancanti nell'ambiente target e degli oggetti associati non importati.
Per importare i convertitori di tipi di nodo e le sottoscrizioni è necessario che le applicazioni o le dimensioni di origine e target esistano nell'ambiente target. Trasferire le applicazioni sia di origine che target nello stesso file template oppure assicurarsi di importare dapprima l'applicazione o la dimensione di origine per i convertitori e le sottoscrizioni, in modo che al momento dell'importazione dell'applicazione o della dimensione target i convertitori e le sottoscrizioni siano già creati.
Quando si trasferisce una dimensione con proprietà che utilizzano un tipo di dati Nodo per fare riferimento ad altre dimensioni, le dimensioni di origine interessate devono già esistere nel sistema target. In caso contrario, trasferire dapprima le dimensioni di origine oppure utilizzare un template applicazione per trasferire tutte le dimensioni nello stesso file template file.
Quando si importano gli oggetti globali seguenti, se l'oggetto esiste già nell'ambiente target con lo stesso nome ma con ID diverso, l'oggetto di origine verrà rinominato nell'ambiente target in modo da risultare univoco:
- Proprietà
- Viste
- Set di ricerca
- Connessioni globali
Dopo aver esportato un'applicazione in un template, è possibile esaminare il contenuto del file template in un visualizzatore .json.

Caution:
La modifica manuale del file template non è supportata.

Per esportare le applicazioni o una dimensione in un template, eseguire le operazioni riportate di seguito.

Dalla casella Strumenti selezionare Template.

Note:
La casella Strumenti è visibile solo per gli amministratori servizi o gli utenti che dispongono del ruolo applicazione Migrazioni - Amministra.
Nella scheda Esporta, effettuare una delle seguenti operazioni.
- Per esportare le applicazioni, selezionare un'applicazione nel pannello a sinistra. Utilizzare Ctrl/Cmd+clic per selezionare più applicazioni. Le applicazioni selezionate vengono elencate nella sezione Artifact selezionati.
- Per esportare una dimensione, espandere l'applicazione nel pannello a sinistra, quindi selezionare la dimensione da esportare. Non è possibile selezionare più dimensioni in un unico file template.
  
  Note:
  Per esportare una dimensione attributo, selezionare la dimensione di base per la dimensione attributo.
In File template immettere un nome file con estensione .json, quindi fare clic su Esporta.
Il template viene creato e scaricato nel file system locale. Viene visualizzato lo stato dell'esportazione.

Per importare un'applicazione o una dimensione da un template, eseguire le operazioni riportate di seguito.

Dalla casella Strumenti selezionare Template.

Note:
Le caselle Strumenti e Template sono visibili solo per gli amministratori servizi o gli utenti che dispongono del ruolo applicazione Migrazioni - Amministra.
Fare clic su Scegli file nella scheda Importa.
Nel file system locale selezionare un file con estensione.json, quindi fare clic su Apri.
Facoltativo: scegliere una o più opzioni di importazione tra quelle descritte di seguito.
- Sostituisci autorizzazioni: consente di sostituire le autorizzazioni esistenti nell'ambiente target con le autorizzazioni del template di origine.
- Sostituisci gruppi di criteri: consente di sostituire i gruppi di criteri esistenti nell'ambiente target con i gruppi di criteri del template di origine.
- Escludi oggetti archiviati: consente di escludere gli oggetti archiviati di un template di un ambiente di origine dall'importazione nell'ambiente target qualora gli oggetti di origine non esistano nell'ambiente target.
  
  Note:
  Gli oggetti archiviati di un template di origine che esistono già nell'ambiente target non possono essere esclusi dall'anteprima del template o dall'importazione.
Fare riferimento alla sezione Oggetti e impostazioni di template.
Fare clic su Anteprima per individuare gli oggetti nel file template e visualizzare il relativo stato. Fare riferimento alla sezione Anteprima delle importazioni dei template e revisione dei risultati dell'importazione.
Fare clic su Importa, quindi fare clic su Sì nel messaggio di conferma.
Il template viene importato e lo stato di ciascun oggetto nel template viene visualizzato. Fare riferimento a Anteprima delle importazioni dei template e revisione dei risultati dell'importazione.