quarta-feira, 27 de abril de 2011

OIM 11g - Request Dataset



Todo o processo de criação e importação está na documentação do produto, no capítulo 19 – Configuring Requests:


2.  Ambiente de teste

Sobre o conector

Conector
Database Application Table
Recurso(Resource Object):
ACMEDBAPP_GTC



Sobre o sistema destino

Tipo
Tabela de banco de dados
Sistema
Oracle

Metadados:

create table ACMEDBAPP(
APP_USERID VARCHAR2(10),
APP_AUTH_MODE     VARCHAR2(30),
APP_DFLT_HOME     VARCHAR2(30),    
APP_ACCT_STATUS   VARCHAR2(30),    
APP_CREATED_BY    DATE,
APP_CREATED_ON    DATE,
APP_UPDATED_BY    DATE,
APP_UPDATED_ON    DATE
);

Observação: Esta tabela foi extraída da documentação do conector  Database Application Table, encontrada em: http://download.oracle.com/docs/cd/E11223_01/doc.910/e11194/app_sample.htm#CJFGGDBE


Sobre os arquivos

Diretório
Os arquivos de metadados do Request Dataset estão localizados em: /odrive/dummydata/reqDataSet/custom/dbapps

Arquivos
Utilizaremos o arquivo nomeado como ProvisionResourceACMEDBAPP_GTC.xml, localizado no diretório acima citado.
/odrive/dummydata/reqDataSet/custom/dbapps/ProvisionResourceACMEDBAPP_GTC.xml



Variáveis de ambiente

Para executar a importação do arquivo xml para o MDS, será necessário configurar a seguinte variável de ambiente:
OIM_ORACLE_HOME: mapeia o diretório de instalação do OIM. Ex: /odrive/oracle/oim11g_MWH/Oracle_IDM1

> export OIM_ORACLE_HOME=/odrive/oracle/oim11g_MWH/Oracle_IDM1


Sobre o arquivo xml para o Request Dataset

Este arquivo foi criado a partir da documentacao encontrada em:

Como o tipo da requisição é de provisionamento de um recurso, o arquivo xml deverá ser nomeado com o formato ProvisionResource${ENTITY-NAME}, onde ${ENTITY-NAME} deverá ser substituido pelo nome do recurso (Resource Object).



Explorando o arquivo de Request Dataset

ProvisionResourceACMEDBAPP_GTC.xml

1.  <request-data-set xmlns="http://www.oracle.com/schema/oim/request"
2.               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3.               xsi:schemaLocation="http://www.oracle.com/schema/oim/request"
4.               name="ProvisionResourceACMEDBAPP_GTC" entity="ACMEDBAPP_GTC" operation="PROVISION">
5.        <AttributeReference
6.              available-in-bulk = "false"
7.              required = "true"
8.              masked = "false"
9.              length = "10"
10.                  widget = "text"
11.            type = "String"
12.            attr-ref = "APP_USERID"
13.           name = "APP_USERID" />
14.<AttributeReference
15.        available-in-bulk = "false"
16.        required = "true"
17.        masked = "false"
18.        length = "20"
19.        widget = "date"
20.        type = "Date"
21.        attr-ref = "APP_CREATED_BY"
22.        name = "APP_CREATED_BY" />
23....
24.</request-data-set>



Linhas 1 a 4

Nestas linhas estão especificados atributos MANDATÓRIOS name, entity e operation:
name: O nome do dataset. Neste exemplo, ProvisionResourceACMEDBAPP_GTC.
entity: A entity que o dataset está associado. Neste exemplo, o recurso ACMEDBAPP_GTC
operation: A operação associada ao dataset. Neste exemplo, CREATE.

Mais detalhes sobre outros tipos de requisições, formatos de nome e operações, veja a documentação:



Linhas 5 a 13 e 14 a 22

Aqui estão definidos os atributos do recurso, neste exemplo, as colunas da tabela ACMEDBAPP.

Mais detalhes sobre as propriedades e tipos de dados dos elementos  “AttributeReference Element”, podem ser encontrados em:



Preparação para importação do arquivo xml no MDS

Vamos alterar o arquivo weblogic.properties que será usado pelo utilitário de importação. Este arquivo está localizado em $OIM_ORACLE_HOME/server/bin (ex.:/odrive/oracle/oim11g_MWH/Oracle_IDM1/server/bin).
Caso não tenha feito o export da variável OIM_ORACLE_HOME:
export OIM_ORACLE_HOME=/odrive/oracle/oim11g_MWH/Oracle_IDM1

cd $OIM_ORACLE_HOME/server/bin
vi weblogic.properties (ou edite com outro aplicativo)

A linha a ser alterada é a da propriedade metadata_from_loc, configurada para:

metadata_from_loc=/odrive/dummydata/reqDataSet/



ATENÇÃO: Repare que estamos colocando 2 pastas/diretórios acima de onde está o arquivo xml que criamos (/odrive/dummydata/reqDataSet/custom/dbapps/). Devemos manter este padrão.

As outras propriedades, wls_servername e application_name ja deverão estar configuradas, então não as mudaremos.

Importação do arquivo xml no MDS

A execução do processo de importação do dataset para o MDS é realizada através do utilitário weblogicImportMetadata.sh (ou .bat) que está no diretório $OIM_ORACLE_HOME/server/bin (ex.:/odrive/oracle/oim11g_MWH/Oracle_IDM1/server/bin).

Caso não tenha feito o export da variável OIM_ORACLE_HOME:
export OIM_ORACLE_HOME=/odrive/oracle/oim11g_MWH/Oracle_IDM1

[oracle@orclfmw ~]$ cd $OIM_ORACLE_HOME/server/bin
[oracle@orclfmw ~]$./weblogicImportMetadata.sh

Please enter your username [weblogic] :weblogic
Please enter your password [welcome1] :
Please enter your server URL [t3://localhost:7001] : t3://orclfmw.example.com:7001 (Sim! É a porta do AdminServer)

A partir deste ponto o dataset foi importado para o MDS e poderá ser verificado no OIM. Faça um teste solicitando um recurso para você ou um outro usuário através do Self-service da ferramenta.

Just in case...

É importante, caso você tenha algum problema neste processo e tenha de fazer mais modificações, expurgar dados que estão em cache. Para isso, adivinhe? Temos mais um utilitário: o PurgeCache. Ele esté no mesmo diretório do utilitário que acabamos de usar. Ok. Eu escrevo de novo:$OIM_ORACLE_HOME/server/bin

Caso AINDA não tenha feito o export da variável OIM_ORACLE_HOME:
export OIM_ORACLE_HOME=/odrive/oracle/oim11g_MWH/Oracle_IDM1

[oracle@orclfmw ~]$ cd $OIM_ORACLE_HOME/server/bin
[oracle@orclfmw ~]$./PurgeCache.sh MetaData
(repare do “D”maiúsculo)

Mais detalhes sobre  “Purging the cache” podem ser encontrados em:

Nenhum comentário:

Postar um comentário