Options de migration de l'annuaire natif Shared Services

Options d'import des migrations

La liste suivante décrit les options d'import d'Oracle Hyperion Shared Services :

  • Opération d'import : sélectionnez une option :

    • Créer : crée des utilisateurs, des groupes et des rôles s'ils n'existent pas dans la cible. S'ils existent dans la cible, l'opération de création échoue. Augmente les relations de groupes, de rôles et de provisionnement.

    • Mettre à jour : met à jour les utilisateurs, les groupes et les rôles. Remplace les relations de groupes, de rôles et de provisionnement.

    • Créer/Mettre à jour : tente une opération de création sur chaque entité dans le fichier. En cas d'échec de l'opération, une opération de mise à jour est tentée.

    • Supprimer : supprime les utilisateurs, les groupes et les rôles en cours d'import. Supprime les relations de groupes, de rôles et de provisionnement.

      Remarque :

      Pour supprimer un utilisateur désactivé, l'utilisateur doit d'abord être activé avant de pouvoir être supprimé.

      Remarque :

      • Lorsque les données Shared Services sont migrées de la source vers la destination, assurez-vous que les applications sont enregistrées sous le même groupe d'applications que la source.

      • Lorsque vous choisissez l'option Créer ou Modifier pour effectuer une migration de la source vers la destination, les données sont créées ou mises à jour mais ne sont pas supprimées.

      Pour plus de détails, reportez-vous à la section Utilisation des applications et des groupes d'applications.
  • Nombre max. d'erreurs avant arrêt de l'import : spécifiez le nombre d'erreurs autorisé avant l'arrêt de l'import.

Fichiers CSV

Les fichiers source d'import sont des fichiers CSV.

Le format de fichier CSV est un format de données tabulaire qui contient des champs séparés par des virgules et encadrés de guillemets doubles. La gestion du cycle de vie Oracle Hyperion Enterprise Performance Management System prend en charge uniquement les fichiers CSV compatibles avec Excel. Les fichiers CSV produits par Excel sont différents des CSV standard :

  • L'espace de début et de fin est conservé

  • Les barres obliques inverses ne sont pas des caractères spéciaux et n'appartiennent à aucune séquence d'échappement.

  • Les guillemets à l'intérieur des chaînes entre guillemets sont précédés de guillemets doubles plutôt que de barres obliques inverses.

Excel convertit les données avant de les afficher au format CSV.

Conversions effectuées par Excel sur les fichiers CSV :

  • Les tabulations sont converties en espaces simples.

  • Les nouvelles lignes sont toujours représentées comme "\n".

  • Les nombres à plus de 12 chiffres sont représentés sous forme de notation scientifique tronquée.

Un fichier CSV distinct est disponible pour les entités suivantes :

  • Users

  • Groups

  • Roles

  • Informations sur le provisionnement

  • Listes déléguées

Chaque section d'un fichier CSV est identifiée par deux lignes obligatoires : entité et en-tête. La ligne d'entité est identifiée par un nom d'entité prédéfini précédé du caractère #. La ligne d'en-tête suit la ligne d'entité. Elle correspond à une liste séparée par des virgules d'attributs définis pour l'entité.

L'ordre des attributs dans la ligne d'en-tête est sans importance. En revanche, les lignes de données, qui suivent la ligne d'en-tête, doivent présenter les données dans l'ordre selon lequel la ligne d'en-tête affiche les attributs. Si les données ne sont pas à spécifier ; utilisez une virgule pour indiquer qu'une valeur n'a pas besoin d'être indiquée. La ligne d'entité, la ligne d'en-tête et les lignes de données fournissent les informations nécessaires au traitement.

Limites appliquées pour créer, mettre à jour et supprimer des données dans les fichiers CSV :

  • les utilisateurs, groupes et rôles sont traités sur une ligne de données à la fois ;

  • les membres de groupe sont traités sur plusieurs lignes de données sous un en-tête et un groupe parent ;

  • les membres de rôle sont traités sur plusieurs lignes sous un en-tête et un rôle parent ;

  • le provisionnement des utilisateurs est traité avec plusieurs lignes de données sous un en-tête et un groupe ou utilisateur.

Le traitement des erreurs se base sur les limites de traitement. Une erreur est comptabilisée pour chaque échec dans une limite de traitement.

Pour consulter des exemples de fichiers CSV et obtenir des informations sur les attributs, reportez-vous aux sections ci-dessous :

Fichier CSV pour utilisateurs

Exemple de fichier CSV pour utilisateurs
#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

Dans cet exemple, le fichier CSV utilisateur sert à créer l'utilisateur admin dans l'annuaire natif avec les valeurs suivantes : nom de connexion admin, prénom administrator, nom user, description hss admin user, ID de courriel admin@hyperion.com, ID interne "native://DN=cn=911,ou=People,dc=css,dc=hyperion,dc=com?USER", mot de passe crypté {SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g= et activité true :

Remarque :

Les mots de passe en texte brut spécifiés dans le fichier CSV sont cryptés.

Tableau J-3 Attributs d'entité utilisateur

Attribut Description et exemple
id
ID de l'utilisateur

Exemple : admin

provider
Facultatif : nom de l'annuaire des utilisateurs source

Exemple :

login_name
Nom de connexion de l'utilisateur

Exemple : admin

first_name
Facultatif : prénom de l'utilisateur

Exemple : administrator

last_name
Facultatif : nom de l'utilisateur

Exemple : user

description
Facultatif : description de l'utilisateur

Exemple : hss admin user

email
Facultatif : adresse électronique de l'utilisateur

Exemple : admin@example.com

internal_id
Identité interne générée automatiquement de l'utilisateur

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

password
Mot de passe de l'utilisateur

Exemple : {SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g=

active
Indique si l'utilisateur est actif (true) ou inactif (false)

Exemple : true

Fichier CSV pour groupes

Exemple de fichier CSV pour groupe

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

Dans cet exemple, le fichier CSV de groupe est utilisé pour créer le groupe WORLD dans un annuaire natif avec l'ID de groupe WORLD, la description Contains all users, et l'ID interne 611.

Tableau J-4 Attributs d'entité de groupe

Attribut Description et exemple
id
Identifiant de groupe

Exemple : WORLD

provider
Facultatif : annuaire des utilisateurs source du groupe

Exemple :

name
Nom du groupe

Exemple : WORLD

description
Facultatif : description du groupe

Exemple :Contains all users

internal_id
Identité interne générée automatiquement du groupe

Exemple : 611

Remarque : ne modifiez pas les données de colonne d'ID interne dans le contenu exporté.

Fichier CSV pour rôles

Exemple de fichier CSV pour rôle

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

Dans cet exemple, le fichier CSV de rôle est utilisé pour créer un rôle agrégé avec l'ID de rôle Viewer pour le produit HP–11.1.1 (Oracle Hyperion Planning, version 11.1.1), le nom de rôle Viewer et la description Viewer. Le type de produit indique le produit auquel appartient le rôle agrégé.

Tableau J-5 Attributs d'entité de rôle

Attribut Description et exemple
id
Identifiant de rôle

Exemple : Designer_rep

product_type
Type de produit (spécifié sous la forme code produit-version de produit) auquel appartient le rôle

Exemple : HP–11.1.1

name
Nom du rôle

Exemple : Viewer

description
Facultatif : description du rôle

Exemple : Viewer

Fichier CSV pour provisionnement

Exemple de fichier CSV pour provisionnement

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

Dans cet exemple, le fichier CSV de provisionnement permet de créer l'affectation d'un rôle pour le nom d'application Planning. L'ID de rôle est Provisioning Manager, qui appartient au type de produit HP–11.1.1. L'utilisateur pturner et le groupe testgroup se voient attribuer ce rôle.

Tableau J-6 Attributs d'entité de provisionnement

Attribut Description et exemple
app_id
Application à laquelle appartient le rôle

Exemple : Planning

product_type
Type de produit (spécifié sous la forme code produit-version de produit) auquel appartient le rôle

Exemple : hp–11.1.1

role_id
Identifiant de rôle unique

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

user_id
Identifiant unique d'un utilisateur affecté à ce rôle

Exemple : pturner

group_id
Identifiant unique d'un groupe affecté à ce rôle

Exemple : testgroup

Fichier CSV pour listes déléguées

Exemple de fichier CSV pour liste déléguée

#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
Dans cet exemple précédent, le fichier CSV de liste déléguée sert à créer une liste déléguée avec l'ID de liste et le nom testlist, ainsi que la description my_list. L'utilisateur admin défini dans l'annuaire natif est l'administrateur délégué de cette liste, ce qui lui permet de gérer le groupe testGroup défini dans l'annuaire natif.

Tableau J-7 Attributs d'entité liste déléguée

Attribut Description et exemple
id
Identifiant de liste, généralement identique au nom de liste

Exemple : testlist

name
Nom de liste déléguée

Exemple : testlist

description
Description de liste déléguée

Exemple : my_list

manager_id
Identifiant unique d'un utilisateur ou d'un groupe qui gère la liste. Chaque gestionnaire doit être identifié dans une définition séparée.

Exemple : admin

manager_provider
Annuaire des utilisateurs qui stocke le compte du gestionnaire

Exemple : Native Directory

user_id
Identifiant unique d'un membre utilisateur de la liste. Chaque membre doit être identifié dans une définition séparée.

Exemple : admin

user_provider
Annuaire des utilisateurs qui stocke le compte du membre utilisateur

Exemple : Native Directory

group_id
Identifiant unique d'un groupe membre de la liste. Chaque membre doit être identifié dans une définition séparée.

Exemple : myGroup

group_provider
Annuaire des utilisateurs qui stocke le compte du groupe

Exemple : Native Directory