Opzioni di migrazione per la Directory nativa di Shared Services

Opzioni di importazione delle migrazioni

Nell'elenco riportato di seguito vengono descritte le opzioni di importazione di Oracle Hyperion Shared Services.

  • Operazione di importazione - Selezionare una della opzioni seguenti.

    • Crea - Crea utenti, gruppi e ruoli se non esistono nel target. Se esistono nel target, l'operazione di creazione non riesce. Aumenta le relazioni di gruppi, ruoli e assegnazioni di ruoli.

    • Aggiorna - Aggiorna utenti, gruppi e ruoli. Sostituisce le relazioni di gruppi, ruoli e assegnazioni di ruoli.

    • Crea/Aggiorna - Tenta di eseguire un'operazione di creazione per ogni entità del file. Se l'operazione non riesce, tenta di eseguire un'operazione di aggiornamento.

    • Elimina - Elimina gli utenti, i gruppi e i ruoli in corso di importazione. Elimina le relazioni di gruppi, ruoli e assegnazioni di ruoli.

      Nota:

      Per eliminare un utente disattivato, è necessario prima attivarlo.

      Nota:

      • Quando si esegue la migrazione dei dati Shared Services dall'origine alla destinazione, verificare che le applicazioni siano registrate nel medesimo gruppo dell'origine.

      • Quando si sceglie l'opzione Crea o Aggiorna per eseguire la migrazione dall'origine alla destinazione, i dati vengono creati o aggiornati, non eliminati.

      fare riferimento alla sezione Utilizzo dei gruppi di applicazioni e delle applicazioni.
  • N. massimo di errori prima dell'arresto dell'importazione: specificare il numero di errori consentito prima che il processo di importazione venga arrestato.

File CSV

I file di origine di importazione sono file CSV.

Il formato di file CSV è un formato dati tabulare contenente campi separati da virgola e racchiusi tra virgolette. Oracle Hyperion Enterprise Performance Management System Lifecycle Management supporta solo file CSV compatibili con Excel. I file CSV generati da Excel sono diversi dai file CSV standard:

  • Lo spazio bianco all'inizio o alla fine è significativo.

  • Le barre rovesciate non sono caratteri speciali e non vengono utilizzate come caratteri di escape.

  • Come carattere di escape che precede le virgolette all'interno di stringhe racchiuse tra virgolette vengono utilizzate virgolette doppie anziché barre rovesciate.

Prima della trasformazione in formato CSV, i dati vengono convertiti da Excel.

Conversioni eseguite da Excel sui file CSV:

  • Le tabulazioni vengono trasformate in spazi singoli.

  • Le nuove righe sono sempre rappresentate come "\n".

  • I numeri che contengono più di 12 cifre vengono rappresentati in una forma di annotazione scientifica troncata.

È disponibile un file CSV distinto per le entità riportate di seguito.

  • Utenti

  • Gruppi

  • Ruoli

  • Informazioni sull'assegnazione ruoli

  • Elenchi delegati

Ciascuna sezione in un file CSV è identificata da due righe obbligatorie: entità e intestazione. La riga entità è identificata da un nome entità predefinito preceduto dal carattere #. La riga intestazione segue la riga entità ed è costituita da un elenco, separato da virgole, degli attributi predefiniti per l'entità.

L'ordine degli attributi nella riga intestazione è irrilevante. Tuttavia, le righe dati che seguono la riga intestazione devono presentare i dati nell'ordine con cui sono presentati gli attributi nella riga intestazione. Se è necessario specificare dati, utilizzare una virgola per indicare che il valore non deve essere impostato. La riga entità, la riga intestazione e le righe dati forniscono le informazioni necessarie per l'elaborazione.

Limiti applicati alle operazioni di creazione, aggiornamento ed eliminazione sui file CSV:

  • Gli utenti, i gruppi e i ruoli vengono elaborati una riga dati alla volta.

  • I membri gruppo vengono elaborati con righe dati multiple sotto un'unica intestazione e un unico gruppo padre.

  • I membri ruolo vengono elaborati con righe dati multiple sotto un'unica intestazione e un unico ruolo padre.

  • L'assegnazione ruoli agli utenti viene elaborata con righe dati multiple sotto un'unica intestazione e un unico gruppo o utente.

La gestione degli errori si basa sui limiti di processo. Viene conteggiato un errore per ciascuna anomalia verificatasi in un limite di processo.

Per esempi di file CSV e informazioni sugli attributi, vedere le sezioni seguenti:

File CSV per gli utenti

File CSV di esempio per l'utente
#user
id,provider,login_name,first_name,last_name,description,email,internal_id,password,active
admin,Native Directory,admin,administrator,user,hss admin user,admin@hyperion.com,"native://DN=cn=911,ou=People,dc=css,dc=hyperion,dc=com?USER",{SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g=,true

In questo campione, il file CSV dell'utente viene utilizzato per creare l'utente admin in una directory nativa con nome di accesso admin, nome administrator, cognome user, descrizione hss admin user, ID e-mail admin@hyperion.com, ID interno "native://DN=cn=911,ou=People,dc=css,dc=hyperion,dc=com?USER", password cifrata {SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g= e stato attivo true:

Nota:

Le password di testo non codificato specificate nel file CSV vengono crittografate.

Tabella J-3 Attributi entità utente

Attributo Descrizione ed esempio
id
ID utente

Esempio: admin

provider
Facoltativo: nome della directory utente origine.

Esempio:

login_name
Nome di accesso dell'utente

Esempio: admin

first_name
Facoltativo: nome dell'utente.

Esempio: administrator

last_name
Facoltativo: cognome dell'utente.

Esempio: user

description
Facoltativo: descrizione dell'utente

Esempio: hss admin user

email
Facoltativo: indirizzo e-mail dell'utente.

Esempio: admin@example.com

internal_id
Identità interna dell'utente generata automaticamente

Esempio: "native://DN=cn=911,ou=People,dc=css,dc=hyperion,dc=com?USER"

password
Password dell'utente

Esempio: {SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g=

active
Indica se l'utente è attivo (true) o non attivo (false)

Esempio: true

File CSV per i gruppi

File CSV di esempio per il gruppo

#group
id,provider,name,description, internal_id
WORLD,Native Directory,WORLD,Contains all users,611

In questo campione, il file CSV del gruppo viene utilizzato per creare il gruppo WORLD in una directory nativa con ID gruppo WORLD, descrizione Contains all users e ID interno 611.

Tabella J-4 Attributi entità gruppo

Attributo Descrizione ed esempio
id
Identificativo del gruppo

Esempio: WORLD

provider
Facoltativo: directory utente di origine del gruppo.

Esempio:

name
Nome del gruppo

Esempio: WORLD

description
Facoltativo: descrizione del gruppo

Esempio: Contains all users

internal_id
Identità interna del gruppo generata automaticamente

Esempio: 611

Nota: non modificare i dati della colonna ID interno nel contenuto esportato.

File CSV per i ruoli

File CSV di esempio per il ruolo

#role
id,product_type,name,description
Viewer,hp–11.1.1,Viewer,Viewer

In questo campione, il file CSV del ruolo viene utilizzato per creare un ruolo aggregato con ID ruolo Viewer per il prodotto HP-11.1.1 (Oracle Hyperion Planning, versione 11.1.1), nome ruolo Viewer e descrizione Viewer. Il tipo di prodotto indica il prodotto a cui appartiene il ruolo aggregato.

Tabella J-5 Attributi entità ruolo

Attributo Descrizione ed esempio
id
Identificativo del ruolo

Esempio: Designer_rep

product_type
Tipo prodotto a cui appartiene il ruolo, specificato come codice prodotto-versione prodotto.

Esempio: HP-11.1.1

name
Nome del ruolo

Esempio: Viewer

description
Facoltativo: descrizione del ruolo

Esempio: Viewer

File CSV per l'assegnazione di ruoli

File CSV di esempio per l'assegnazione di ruoli

#provisioning
app_id,product_type,role_id,user_id,group_id
Planning,hp–11.1.1,Provisioning Manager,pturner,testgroup

In questo campione, il file CSV per l'assegnazione ruoli viene utilizzato per creare un'assegnazione di ruolo per l'applicazione con nome Planning. L'ID ruolo è Provisioning Manager, che appartiene al tipo di prodotto HP-11.1.1. Questo ruolo viene assegnato all'utente pturner e al gruppo testgroup.

Tabella J-6 Attributi entità assegnazione ruoli

Attributo Descrizione ed esempio
app_id
Applicazione a cui appartiene il ruolo.

Esempio: Planning

product_type
Tipo di prodotto (specificato come codice prodotto-versione prodotto) a cui appartiene il ruolo.

Esempio: hp-11.1.1

role_id
Identificativo univoco del ruolo

Esempio: native://DN=cn=HUB:2,ou=HUB,ou=Roles,dc=css,dc=hyperion,dc=com?ROLE

user_id
Identificativo univoco di un utente a cui è stato assegnato il ruolo.

Esempio: pturner

group_id
Identificativo univoco di un gruppo a cui è stato assegnato il ruolo.

Esempio: testgroup

File CSV per gli elenchi delegati

File CSV di esempio per l'elenco delegati

#delegated list
id,name,description,manager_id,manager_provider,user_id,user_provider,group_id,group_provider
testlist,testlist,my_list,admin,Native Directory,,testGroup,NativeDirectory
Nell'esempio precedente il file CSV dell'elenco delegati può essere usato per creare un elenco delegati con ID e nome testlist e descrizione my_list. L'utente admin definito nella directory nativa è l'amministratore delegato di questo elenco, che consente all'amministratore admin di gestire il gruppo testGroup definito nella directory nativa.

Tabella J-7 Attributi entità elenco delegati

Attributo Descrizione ed esempio
id
Identificativo dell'elenco, in genere corrispondente al nome elenco.

Esempio: testlist

name
Nome dell'elenco delegati

Esempio: testlist

description
Descrizione dell'elenco delegati

Esempio: my_list

manager_id
Identificatore univoco di un utente o di un gruppo che gestisce l'elenco. Ciascun gestore deve essere identificato in una definizione separata.

Esempio: admin

manager_provider
Directory utente in cui è memorizzato l'account del gestore.

Esempio: Native Directory

user_id
Identificativo univoco di un membro utente di un elenco. Ciascun membro deve essere identificato in una definizione separata.

Esempio: admin

user_provider
Directory utente in cui è memorizzato l'account del membro utente.

Esempio: Native Directory

group_id
Identificativo univoco di un gruppo che è membro dell'elenco. Ciascun membro deve essere identificato in una definizione separata.

Esempio: myGroup

group_provider
Directory utente in cui è memorizzato l'account del gruppo.

Esempio: Native Directory