Concurrents Hello World !!!!!

Hace algún tiempo cuando comenzaba a desarrollar para la EBS me pidieron crear un concurrente ("Con que?" fue mi pregunta). por lo que hoy decidí hacer un pequeño manual con el "hola mundo" en los concurrentes.

Así que primero un poco de teoría:

Concurrente: Es el medio que tienen los usuarios para ejecutar procesos en el servidor, sin tener acceso al usuario APPS ( Pon ningun motivo un usuario debe tener acceso a esta cuenta, incluso ni siquiera los desarrolladores deberiamos tener acceso a este usuario). La mayoría de las ejecuciones de concurrente se realizan por medio del menu:
ver->solicitudes->ejecutar nueva solicitud->solicitud unica

Si seleccionan en el recuadro amarillo, nos mostrara la lista de programas a los que tenemos acceso.

Ahora que ya se como ejecutarlo como rayos se crean estas cosas.

5 Pasos:

1.- Se genera un ejecutable, esto quiere decir cualquier cosa que se va a procesar en el servidor , la EBS soporta ejecutables pro C, java, perl, pl/sql,reports, etc. (el ejemplo que les daré esta en pl/sql).
ejemplo:
CREATE OR REPLACE PROCEDURE APPS.XXX_TST (errbuf OUT VARCHAR2
 /*Mensaje que le regresa el procedimiento al adminstrador de concurrente, este mensaje se muestra en el administrador de concurrente*/ , retcode OUT NUMBER/*Codigo de error que el concurrente regresa al administrador de concurrente sobre el estatus de del concurrente: retcode :=0; El concurrente finaliza normal sin color retcode :=1; El concurrente finaliza en ADVERTENCIA color Amarillo retcode :=2; El concurrente finaliza en ERROR color rojo */,oper1 varchar2 ,oper2 NUMBER )
IS BEGIN
/* apps.fnd_file.output & apps.fnd_file.log constantes que represntan sobre que archivo se realizaran las operaciones del paquete fnd_file. apps.fnd_file.put(which,buff); este comando escribe en el archivo seleccionado los datos que se coloquen en el segundo parametro de entrada. apps.fnd_file.new_line(which,lines);este comando escribe en el archivo seleccionado tantos saltos de linea como se indique en el segundo parametro apps.fnd_file.put_line(which,buff);este comando escribe en el archivo seleccionado los datos que se coloquen en el segundo parametro de entrada concatenados con un salto de linea. */
apps.fnd_file.put(apps.fnd_file.output,'Linea 1 Hola Mundo');
apps.fnd_file.new_line(apps.fnd_file.output, 2);
apps.fnd_file.put(apps.fnd_file.output,'Linea 3 Hola Mundo');
apps.fnd_file.put(apps.fnd_file.output,'-Linea 3 Hola Mundo parte 2');
apps.fnd_file.new_line(apps.fnd_file.output, 1);
apps.fnd_file.put_line(apps.fnd_file.output, 'Linea 4 Hola Mundo');
apps.fnd_file.put(apps.fnd_file.output,'Linea 5 Hola Mundo');
apps.fnd_file.put(apps.fnd_file.log,'Linea LOG 1 Hola Mundo');
apps.fnd_file.new_line(apps.fnd_file.log, 2);
apps.fnd_file.put(apps.fnd_file.log,'Linea LOG 3 Hola Mundo');
apps.fnd_file.put(apps.fnd_file.log,'-Linea LOG 3 Hola Mundo parte 2');
apps.fnd_file.new_line(apps.fnd_file.log, 1);
apps.fnd_file.put_line(apps.fnd_file.log, 'Linea LOG 4 Hola Mundo');
apps.fnd_file.put(apps.fnd_file.log,'Linea LOG 5 Hola Mundo'); errbuf:='HAY ALERTAS';
retcode :=1;
errbuf:='HAY ERRORES';
retcode :=2;
errbuf:='NO HAY ERRORES';
retcode :=0;
END;

2.- Se define el ejecutable, desde la responsabilidad Desarrollador de aplicaciones(Application Developer)/Administrador de Sistema(System Administrator) en el menu:Concurrente->Programa->Ejecutable(Concurrent->Program->Executable) se capturan los datos de tu ejecutable. se podría decir que esta pantalla es solo una definición global del ejecutable.

3.- Se define el programa desde la responsabilidad Desarrollador de aplicaciones(Application Developer)/Administrador de Sistema(System Administrator) en el menu:Concurrente->Programa>Definir->(Concurrent->Program->Define) , aquí se capturan los datos que le servirán al usuario para ejecutar su programa, como son : cual es el ejecutable que utilizara?, con que parámetros?, que parámetro es obligatorio? este programa es incompatible con otro? que tipo de salida da este programa?, etc. aqui les dejo un ejemplo de la definición de  programa.

4.- Se define quien va a ejecutar este programa,  en la ebs el primer nivel donde se define que puede hacer un usuario es la responsabilidad que este tiene, a esa responsabilidad se le agregan todas las funcionalidades que el usuario debería ser capaz de realizar, ejemplo:

 

  

5.- Como se puede observar la responsabilidad tiene asociado un grupo de solicitudes, el grupo de solicitudes es básicamente la lista de programas que el usuario que tiene esa responsabilidad puede ejecutar.

Listo !!!! una vez que ya lograron este paso, ya pueden ejecutar el programa que ustedes realizaron.

Ahora lo ejecutamos y que sucede, dependiendo de la forma en que hayan codificado los códigos de error, el proceso puede finalizar:
a) 2300206  retcode:=0;   ejemplo de proceso normal.
b) 2300210  retcode:=1;  ejemplo  de proceso con advertencias.
c) 2300206  retcode:=2;  ejemplo de proceso con error.

Queda del lado del programador el colocar el retcode que le ayude al usuario a identificar mejor la situación en la que se ejecuto el proceso.
Como detalle adicional si como programador no tocas esa variable, el proceso  se marca como finalizado
correctamente cuando termina su ejecución sin lanzar excepciones.

Un proceso de pl/sql, hereda los datos de la sesión con la que se encuentra conectado, que quiere decir esto: Que no se requiere ejecutar ni APPS.FND_GLOBAL.APPS_INITIALIZE.

Con esto queda el ejemplo de como realizar la creación y ejecución de un proceso concurrente escrito en PL/SQL.


En el próximo articulo daré un ejemplo en reports.

Updating Twitter from the database, using PL/SQL and OAuth.

Hace poco trate de hacer un ejemplo con de actualizar el estado de twitter desde la base de datos y me encontré con que el api que ocupaba antes ya no funcionaba y el único error que me mandaba es que el método de autentificación básico ya no está siendo soportado. Y yo me dije que tan difícil puede ser el nuevo método . . . Bueno pues difícil no es (Aplausos) , en realidad ahora es más talachudo, porque lo que antes se hacía con un par de llamadas a las funciones nativas de la base de datos, ahora se tiene que hacer  un conjunto de operaciones más complejas, incluso ya hay quienes desarrollaron una opción http://somecodinghero.blogspot.com/2010/09/updating-twitter-from-database-using.html

Y esta funciona, sin embargo me encontré con que no tenía permisos para una de las funciones que mencionan, adicionalmente de que esta opción requería un poco más de investigación, por lo que decidi optar por la otra cara de la moneda y la que siempre nos dice para que te cansas si yo ya lo hice:

“JAVA”

Y como Oracle ya compro java pues dije vamos a darle una oportunidad.

Paso A paso:

1.- Registrar la aplicación: Ir a la siguiente dirección https://dev.twitter.com/

2.- Una vez registrada guardar los datos de nuestra aplicación recién creada, si nos da flojera siéntanse con la libertad de utilizar los datos de la mía, solo recuerden que está diseñada para tipo cliente.

3.- Descargar la última versión estable del api de java http://twitter4j.org/en/index.html

 (Twitter4J is an opensourced software and free of charge.

You can use Twitter4J freely for any commercial and non-commercial projects.) Gratis pues!!,

En el caso de este proyecto se utilizó la versión 2.2.1, pero al ser puramente java, la base aceptara todo sin mayor problema.

Una vez que se ha descargado el api de java hay que desomprimirlo y buscar el siguiente jar:

twitter4j-core-2.2.1.jar

4.-Subir el api a la base de datos:

Este jar se sube a una ruta que pueda leer su servidor de base de datos.

Se ejecuta el siguiente comando en el servidor. “Esta es la parte que realmente es importante”

loadjava twitter4j-core-2.2.1.jar -user user/pwd –f

loadjava es el commando que se utiliza para subir al servidor los archivos de java y convertirlos en objetos de base de datos.

Disponibles para ser publicados a pl/sql o utilizados por otros proyectos de java.

Recordemos que la base de datos de Oracle es muy poderosa, pero que pasa si solo saben lo básico de sql y mucho de java el resultado es sorprendente créanme, porque el Oracle permite sqlj “Obvio” que es una forma de mesclar dentro de los programas de java sentencias de sql como si fuera pl/sql al grado que ya no sabes en que estas programando jejeje.

Hummm hummm bueno regresando al proyecto. Una vez que suban el api, los objetos de esta aparecerán todos inválidos, por lo que queda como labor de nosotros recompilarlos todos , si alguien conoce la sentencia correcta de loadjava para evitar esto por favor postéalo para poder corregir esta parte tan tediosa .

5.-Recompilar el Api, es un poco burdo, pero lo que fue más rápido para mí fue:

SELECT 'alter java class "'||ja.name||'" resolve;'

   FROM ALL_JAVA_CLASSES ja

   WHERE  NAME LIKE 'twit%'

Y el resultado de este query ejecutarlo varias veces hasta reducir el número de objetos inválidos al menor numero posible.

6.-Una vez que el api esta valida en su mayoría (Existen algunos que no pude lograr validar). Podemos comenzar a utilizarla.

El objeto que se creo basándome en los ejemplos que trae consigo el api fue el siguiente:

public final class XXX_JTWEET{
public static String update_status(String argument) 

/* update_status funciona tal cual el ejemplo es hard code, pero ayuda mucho a ver como funciona por lo que la dejo para su uso posterior*/

         public static String get_auth_url(String l_proxy ,String l_proxy_user ,String l_proxy_pass ,String l_proxy_port ,String l_AuthConsumerKey ,String l_ConsumerSecret ,String l_user  ,String l_password )



/* get_auth_url esta función reducida nos regresa la url sobre la que se debe autorizar el acceso de la aplicación a nuestra cuenta de twitter*/

String set_status(String l_proxy
,String l_proxy_user
,String l_proxy_pass
,String l_proxy_port
,String l_AuthConsumerKey
,String l_ConsumerSecret
,String l_token
,String l_token_secret
,String l_access_token
,String l_access_token_secret
,String l_pin
,String l_status
)
}
/* set_status con la información obtenida de la página da autorización publica el estatus en el twitter*/

El proyecto completo y las instrucciones de cómo usarlo se encuentran disponibles en

http://sourceforge.net/projects/ora-tweet/

Ejemplo:

/*enciendan dbms ouput para ver los resultados*/

/*esta parte del codigo unicamente es para cuando registran su programa ante twitter*/

declare

RetVal varchar2(4000);

begin

dbms_output.put_line(XXX_JTWEET_PKG.INITIALIZE (1));

dbms_output.put_line(xxx_jtweet_pkg.get_auth_url(false));

COMMIT;

END;

/



/*una vez que van a la pagina que les regreso el programa anterior deben ingresar el codigo que

       les regreso al programa, este paso se realiza una sola vez

*/

begin

xxx_jtweet_pkg.SET_PIN('2667137');

commit;

end;



/*Así es como deberían enviar los mensajes a twitter desde sus programas */



begin

/*al inicio del programa */

dbms_output.put_line(XXX_JTWEET_PKG.INITIALIZE (1));

/*Cada vez que desean mandar algo*/

dbms_output.put_line(xxx_jtweet_pkg.UPDATE_STATUS('hi from plsql v1.16'));

end;






Cualquier duda que tengan no duden en hacérmela llegar por medio del blog.

         Una vez mas los archivos del proyecto se encuentran disponibles en: http://sourceforge.net/projects/ora-tweet/

 Repasemos rápidamente antes de terminar. lo que se nesecita para poder realizar el uso del api de twitter es:

         Consumer Secret/*Los obtienes al registrar el APP*/
         AuthConsumerKey /*Los obtienes al registrar el APP*/
         Request token /¨*Lo obtienes cuando se genera el auth url*/
         Request token secret  /¨*Lo obtienes cuando se genera el auth url*/
        pin /*Se obtiene al ingresar n la tienda de musical pin a la oauth url*/
        access_token /*Se obtiene al ingresar el pin a la oauth url*/
        access_token_secret  /*Se obtiene al ingresar el pin a la oauth url*/
Ahora si felices Tweets