Procesos PeopleSoft

TM

PDF Editor

Procesos PeopleSoft
ndice
Procesos PeopleSoft PeopleSoft PeopleCode Vista general de PeopleCode Estructura del lenguaje PeopleCode Tipo de datos Tipos de datos convencionales Consideraciones para los tipos Float, Integer y Number Tipos de datos Tipos API Object Comentarios Sentencias Separadores Sentencias de asignacin Asignacin por valor Asignacin por referencia Construcciones del lenguaje Funciones como subrutinas Sentencias de control Sentencias If, Then y Else Sentencia Evaluate Sentencia For Ciclos condicionales Sentencia Repeat Sentencia While Funciones Funciones soportadas Definicin de funciones Declaracin de funciones Llamado de funciones: Valores regresados por funciones Conflictos al nombrar funciones Expresiones Expresiones fundamentales Constantes Constantes numricas Constantes string Constantes booleanas Constantes nulas Constantes definidas por el usuario Funciones como expresiones Variables del sistema 7 7 7 7 7 7 8 8 10 10 11 12 12 12 12 13 13 14 14 14 15 16 16 16 16 16 17 17 17 18 19 19 19 20 20 20 20 21 21 21 21

TM

PDF Editor
2| Qualsys Consulting

S.C

Procesos PeopleSoft
Metastring Referencias del campo de registro Sintaxis de la referencia del campo del registro Variables Tipos de variables soportadas Variables definidas por el usuario Declaracin de variables Inicializacin de variables definidas por el usuario Operadores Operadores matemticos Operadores de fecha y hora Concatenacin de cadenas Operador @ Operadores de comparacin Operadores booleanos Eventos en PeopleCode Evento Activate Evento FieldChange Evento FieldDefault Evento FieldEdit Evento FieldFormula Evento ItemSelected Evento PosBuild Evento PreBuild Evento PrePopup Evento RowDelete Evento RowInit Evento RowInsert Evento RowSelect Evento SaveEdit Evento SavePostChange Evento SavePreChange Campo ChartField PeopleSoft Application Engine Entendiendo PeopleSoft Application Engine Fundamentos de PeopleSoft Application Engine Meta-SQL Elementos del programa de Application Engine. Secciones Pasos Accin Acciones Do SQL PeopleCode Log Message Call Section State Records 21 22 22 23 23 23 24 25 25 25 26 26 27 27 28 29 29 29 29 30 30 30 30 31 31 31 31 31 31 32 32 33 33 34 34 34 35 35 35 36 36 36 36 37 37 37 37

TM

PDF Editor
3|

Procesos PeopleSoft
Tipos de programas del Application Engine Daemon Program Transform Program Creando programas de Application Engine Visualizando programas de Application Engine Utilizando vista Definition Definicin de la vista Pop-up Menu Utilizando la vista Program Flow Men pop-up del Program Flow Cambiando ntre las vistas Definition y Program Flow Cambiando dentro de la vista Program Flow Utilizando la opcin actualizar Filtrando el contenido de la vista Comportamiento de las opciones de la seccin de filtrado Creando, abriendo y renombrando los programas. Creando nuevos programas Abriendo programas existentes Renombrando programas Copiando o moviendo elementos del programa Probando programas de Application Engine Configurando las propiedades del programa Accediendo a las propiedades Configuracin las propiedades generales Configurando las propiedades del registro de estado Especificando las tablas temporales Configurando propiedades avanzadas Agregando secciones Seccin de orden de ejecucin Insertando secciones Localizando las secciones. Buscando las llamadas a las secciones de referencia Buscando secciones en el programa actual Configurando las propiedades de las seccin Agregando pasos Insertando pasos Configurando las propiedades de los pasos Especificando las acciones Entendiendo las acciones Accin orden de ejecucin Insertando acciones Configurando las propiedades de la accin Gestionando los programas de Application Engine Ejecutando programas de Application Engine Entendiendo las opciones de ejecucin de un programa Programas batch utilizando PeopleSoft Process Scheduler Programas en lnea utilizando PeopleCode Programas manuales utilizando la lnea de comando Creando las definiciones del proceso Listando los parmetros del proceso de definicin 37 38 38 38 38 38 39 41 42 42 43 43 44 44 46 46 46 46 47 47 48 48 48 49 50 51 52 53 53 53 53 54 54 55 55 56 57 57 57 58 59 59 59 59 60 60 60 60 61

TM

PDF Editor
4|

Procesos PeopleSoft
Empezando programas con la pgina Application Engine Process Request Tablas utilizadas en la pgina Process Request. Requisitos de Application Engine Utilizando el PeopleCode para invocar programas del Application Engine Utilizando la lnea de comandos para invocar programas Application Engine Opciones de la lnea de comando Depurando los programas de Application Engine Activando el depurador de PeopleSoft Application Engine Definiendo las opciones de depuracin Tips de depuracin Opciones de depuracin Restaurando los programas Application Engine Determinando cuando utilizar la restauracin Utilizando la restauracin a nivel de programa Utilizando la restauracin en el nivel de seccin Utilizando la restauracin en el nivel de pasos Controlando las terminaciones anormales Restaurando los programas del Application Engine Restaurando desde la lnea de comando Restaurando desde la pgina Process Request Empezando los programas de Application Engine desde el principio Habilitando y deshabilitando la restauracin PeopleSoft Component Interface Iniciando con PeopleSoft Component Interface Introduccin al Component Interface Comprendiendo el Component Interface Arquitectura del Component Interface Atributos del Component Interface Definiciones y vistas del Component Interface Iconos del Component Interface Columnas del Component Interface Desarrando un Component Interface Creando la definicin del Component Interface Creando un nuevo Component Interface Asociando un Component Interface con un men Determinando cuales campos exponer Utilizando llaves Agregando y borrando llaves Propiedades de configuracin Propiedades estndar Creando propiedades definidas por el usuario Eliminacin de propiedades Renombrar las propiedades definidas por el usuario Creando las propiedades de referencia Creando las propiedades de slo lectura Trabajando con colecciones Trabajando con mtodos Trabajando con funciones y mtodos de sesin. 62 62 63 64 65 66 68 68 69 69 69 70 71 71 72 72 73 73 73 74 74 75 76 76 76 76 77 77 78 79 80 80 81 81 82 83 83 83 84 84 87 88 88 89 90 90 91 91

TM

PDF Editor
5|

Procesos PeopleSoft
Funciones de sesin del Component Interface. Mtodos de sesin del Component Interface Mtodos estndar Habilitar y deshabilitar mtodos estndar Creando mtodos definidos por el usuario Validacin de un Component Interface Configurando las opciones de seguridad Probando el Component Interface Bsqueda de un Component Interface Obtencin de registros existentes utilizando llaves parciales Prueba del Component Interface Prueba de las propiedades de Component Interface Prueba de los mtodos de Component Interface Probando los mtodos de coleccin Reglas del mtodo de coleccin Determinando los parmetros ItemByKeys Entendiendo la sincronizacin Consideraciones del tiempo de ejecucin Consideraciones generales Conflictos de mbito Programacin de un Component Interface en PeopleCode Generando una plantilla de PeopleCode Entendiendo la plantilla de PeopleCode Notas de las plantillas de PeopleCode Glosario Bibliografa 91 91 91 93 93 94 95 96 96 97 98 98 99 99 99 100 101 102 102 102 102 104 104 105 107 108

TM

PDF Editor
6|

Procesos PeopleSoft

Procesos PeopleSoft
PeopleSoft PeopleCode
PeopleCode es el lenguaje utilizado por las aplicaciones de PeopleSoft. Este tema proporciona una visin general de PeopleCode y muestra como crear programas en PeopleCode. Tambin proporciona informacin que se debe considerar antes de empezar a utilizar PeopleCode.

Vista general de PeopleCode

Esta seccin proporciona la informacin conceptual disponible acerca de PeopleCode. Como son la descripcin de funciones, mtodos y propiedades entre otros. PeopleCode es similar a otros lenguajes de programacin. Sin embargo, en algunos aspectos es especial para el lenguaje y entorno de PeopleTools. PeopleCode es un lenguaje orientado a objetos.

Estructura del lenguaje PeopleCode

Esta seccin asume que esta familiarizado con los lenguajes de programacin, como C, Visual Basic o Java. En esencia, la sintaxis de PeopleCode es similar a otros lenguajes de programacin. Sin embargo algunos aspectos de PeopleCode, son especficos para el entorno de PeopleTools. Por ejemplo, la definicin de referencias, que permiten hacer referencia a las definiciones de PeopleTools, as como a registro o pginas. Otra caracterstica del lenguaje, son los tipos de datos y Metastrings que reflejan la estrecha relacin que existe entre PeopleTools y SQL. Las clases y mtodos en PeopleCode son similares a otros lenguajes orientados a objetos, como java.

Tipo de datos
TM Los tipos de datos convencionales incluyen, nmeros, fechas, caracteres. Utilizados en la programacin bsica. Tipos de Objetos de datos, instancias de objetos para las clases de PeopleTools.

PDF Editor
Tipos de datos convencionales
PeopleCode incluye estos tipos de datos convencionales:
7|

Procesos PeopleSoft
Any Boolean Date DateTime Float Integer Number Object String Time

Consideraciones para los tipos Float, Integer y Number

El tipo Integer es un nmero complementario de 32 bits con signo, por lo que el rango es de -2,147,438,648 a 2,147,438,648. El tipo Float binario es un nmero de doble precisin. No es apropiado para clculos exactos de fracciones, en particular, clculos que involucren dinero. Por ejemplo, un dcimo (1/10 o .1), no puede ser representado exactamente en un Float binario de doble precisin, la suma de flotantes binarios de doble precisin de .10 + .10, no es igual a 20.

Tipos de datos
Para la mayora de las clases en PeopleTools, se necesita un tipo de datos correspondiente a las instancias de objetos. PeopleCode incluye este tipo de datos para acceso al buffer: Field Record Row

TM

PDF Editor
Rowset PeopleCode incluye estos tipos de datos para la pantalla: AnalyticGrid
8|

Procesos PeopleSoft
Char Gray GridColumn Page PeopleCode incluye estos tipos de datos para Internet script: Cookie Request Response PeopleCode incluye estos tipos de datos extras: AESection AnalyticInstance Array Crypt Execption File Interlink BIDocs JavaObject Message MCFIMInfo OptEngine

TM
PostReport ProcessRequest RowsetCahce SoapDoc

PDF Editor
9|

Procesos PeopleSoft
SQL SyncServer TransformData XmlDoc XmlNode

Tipos API Object

Utilice este tipo de datos para cualquier ApiObject, como un Object Session, un Object Tree, un Component Interface, un Registry Portal, entre otros. Los siguientes tipos de datos ApiObject pueden declararse como Globales: Session PSMessages Collection PSMessages Todos las clases Tree Todas las clases query

Comentarios
Utilice los comentarios para explicar, preferentemente en un lenguaje comprensible para cualquiera que lea su programa sepa que hace su cdigo. Los comentarios hacen posible diferencia entre el PeopleCode que le entregan y los cambios que haga. Esto es til para la bsqueda de errores y actualizaciones. Las siguientes son algunas maneras de insertar comentarios en PeopleCode: Puede encerrar comentarios empezando con / * y finalizando con */ Tambin puede utiliza REM (remark) para establecer que es un comentario Puede encerrar el texto a comentar entre <* al inicio y *> al final El siguiente cdigo muestra los formatos para hacer comentarios:

TM

PDF Editor
10 |

Procesos PeopleSoft
Ejemplo: <* this program is no longer valid commenting out entire thing REM This is an example of commenting PeopleCode; /* ----- Logic for Compensation Change ----- */ /* Recalculate compensation change for next row. Next row is based on prior value of EFFDT. */ calc_next_compchg(&OLDDT, EFFSEQ, 0); /* Recalculate compensation change for current row and next row. Next row is based on new value of EFFDT. */ calc_comp_change(EFFDT, EFFSEQ, COMP_FREQUENCY, COMPRATE, CHANGE_AMT, CHANGE_PCT); calc_next_compchg(EFFDT, EFFSEQ, 0); *>

Sentencias
Una sentencia puede ser una declaracin, una asignacin, la construccin de programas o una llamada de subrutinas: Esta seccin habla de: Separadores Sentencias de asignaciones Construcciones del lenguaje Sentencias de control Condicionales Loop

TM

PDF Editor
11 |

Procesos PeopleSoft
Separadores
Las sentencias de PeopleCode generalmente terminan con punto y coma. PeopleCode acepta puntos y comas aun cuando no son requeridos, como despus de terminar la ltima sentencia de un If. Esto permite aadir punto y coma despus de cada sentencia. Los espacios extras son ignorados. Pueden ser eliminados por el editor de PeopleCode cuando salva el cdigo.

Sentencias de asignacin
Las sentencias de asignacin son las ms bsicas de las sentencias en PeopleCode. Consiste en igualar una variable que esta ala izquierda con una expresin a la derecha:

Sintaxis:
VariableName = expression; La expresin a la derecha es evaluada, y el resultado es introducido a al variable de la izquierda. Dependiendo del tipo de dato, la asignacin se pasa un valor o una referencia.

Asignacin por valor

En la mayora de las asignaciones, el resultado de la expresin de la derecha es asignada para la variable como una nueva creacin del valor, en nuestra variable almacenada en el rea de la memoria. Cambios a la variable no afectan a otros datos.

Asignacin por referencia

Cuando los dos lados de una sentencia de asignacin son variables, el resultado de la asignacin no crea una copia del objeto en la memoria y la asigna en la variable. En vez de eso, la variable apunta al objeto en la memoria. Por ejemplo, &AN y &AN2 son arreglos de tipo nmero. Asignando &AN2 a &AN, no copia &AN2 en &AN. Los dos arreglos apuntan al mismo lugar en la memoria.

TM

PDF Editor
12 |

Procesos PeopleSoft
Sintaxis: Local array of number &AN, &AN2; Local number &NUM; &AN = CreateArray (100, 200, 300) &AN2=&AN &NUM=&AN[1] En el cdigo de ejemplo, &AN2 y &AN apuntan al mismo objeto: un arreglo de nmeros.

Construcciones del lenguaje

La construccin de lenguaje en PeopleCode incluye: Sentencias de control: If y Evaluate Loops y condicionales Loop: For, Repeat y While Sentencias Break, Continue y Exit para controlar Loops y terminar programas La sentencia Return para regresar a funciones Sentencias de declaracin de variables y funciones: Globales, locales y variables de componentes, y declaracin de funciones par funciones Sentencias de funciones para definir funciones Sentencias para definir clases Sentencias Try, Match y Throw para capturar errores.

Funciones como subrutinas

PeopleCode, como C, no tienen subrutinas como generalmente nos referimos a ellas. Las subrutinas de PeopleCode son un subconjunto de las funciones de PeopleCode y solo estn definidas para no regresar valores o regresar valores opcionales. Llamar una TM subrutina es lo mismo que llamar una funcin que no regresa valores. Sintaxis:

PDF Editor
function_name(param_list);
13 |

Procesos PeopleSoft
Sentencias de control
Las sentencias de control controlan el flujo del programa basndose en evaluar expresiones condicionales.

Sentencias If, Then y Else

Sintaxis: If condicin Then [Lista de sentencias1] Else [Lista de sentencias2] End-If; Esta sentencia evala la expresin condicin. Si la condicin es verdadera, la sentencia If ejecuta la lista de sentencias1. Si la condicin es falsa, entonces el programa ejecuta las sentencias en la clusula Else; si no hay clusula Else, el programa contina con la siguiente sentencia.

Sentencia Evaluate
Utilice la sentencia Evaluate para evaluar varias condiciones. Sintaxis: Evaluate left_term When [relop_1] right_term_1 [Lista de sentencias] . . . When [relopn1] right_term_n

TM

PDF Editor
[Lista de sentencias] When-other [Lista de sentencias]
14 |

Procesos PeopleSoft
End-evaluate; La sentencia Evaluate toma una expresin, left_term, y lo compara con la expresin compatible right_term_1 utilizando el operador relacional (relop) en una secuencia de clausulas When. Si relop se omite, entonces se asume una igualdad de signos. Si el resultado de la comparacin es TRUE, el programa ejecuta las sentencias de la clausula When, entonces se mueve para comparar la siguiente clusula When. El programa ejecuta las sentencia en todas la clausulas When en las cuales la comparacin resulte TRUE, si ninguna de las comparaciones resulta en TRUE el programa ejecuta la sentencias de la clusula When-other, el siguiente ejemplo de Evaluate ejecuta solo las sentencias de la primera clusula When. Ejemplo: evaluate &USE_FREQUENCY when = "never" PROD_USE_FREQ = 0; when = "sometimes" PROD_USE_FREQ = 1; when = "frequently" PROD_USE_FREQ = 2; when-other Error "Unexpected value assigned to &USE_FREQUENCY." end-evaluate;

Sentencia For
La sentencia For repite una secuencia de sentencias un especfico nmero de veces. Sintaxis:

TM
For count = expresion1 to expresion2 [Step i];

PDF Editor
[Lista de sentencias] End-for;
15 |

Procesos PeopleSoft
La sentencia For inicializa el valor de count con expresion1 entonces incrementa count con cada i veces despus de ejecutar las sentencias en lista de sentencias. El programa contina el ciclo hasta que count es igual a expresion2, si la clusula Step se omite, entonces i se iguala a uno. Para contar hacia atrs desde un valor mas alto a uno ms pequeo, se utiliza un valor negativo para i. Puede salirse de un ciclo For utilizando una sentencia Break.

Ciclos condicionales
Los ciclos condicionales, Repeat y While, repiten una secuencia de sentencias, evaluando una expresin condicional cada vez que pasan el ciclo. El ciclo termina cuando la condicin a evaluar es verdadera. Puede salir de un ciclo utilizando la sentencia Brear. Si la sentencia Break esta en un ciclo dentro de otro ciclo, el Break aplica solo a al ciclo interno.

Sentencia Repeat
Sintaxis: Repeat [Lista de sentencias] Until expresin_logica; La sentencia Repeat ejecuta las sentencias una vez, entonces evala la expresin lgica. Si la expresin lgica es falsa, la secuencia de sentencias se repite hasta que la sentencia sea verdadera.

Sentencia While
Sintaxis: While expresin_logica [Lista de sentencias] End-while;; La sentencia While evala la expresin lgica antes de ejecutar la lista de sentencias. TM Continua repitiendo la lista de sentencias hasta que la expresin lgica resulte falsa.

PDF Editor
Funciones soportadas
PeopleCode soporta los siguientes tipos de funciones:
16 |

Funciones

Procesos PeopleSoft
Built-in: La funcin estndar para PeopleCode. Esta puede ser llamada sin declarar el Begin Internal: Funciones que ya estn definidas en un programa de PeopleCode en el cual son llamadas External PeopleCode: las funciones de PeopleCode definidas fuera del programa que las llama. Generalmente estn en la definicin de Registros que funcionan como libreras. External non-PeopleCode: (libreras de C) funciones almacenadas en libreras externas

Adicionalmente PeopleCode soporta mtodos. Las principales diferencias entre una funcin built-in y el mtodo son: Una funcin built-in, en su cdigo, se llama a si mismo y generalmente no depende de ningn otro. Un mtodo puede se ejecutado solo por un objeto

Definicin de funciones
Las funciones en PeopleCode pueden ser definidas en cualquier programa de PeopleCode. La definiciones deben ponerse al principio del programa, junto con cualquier variable externa y declaraciones de funciones externas. Por convencin, los programas de PeopleCode se almacenan en registros cuyos nombre empiecen con FUNCLIB_, y siempre se adjuntan a un evento FieldFormula.

Declaracin de funciones
Si llama una funcin externa desde un programa de PeopleCode, debe declarar la funcin al principio del programa. La sintaxis de la declaracin de funciones varia, dependiendo de si la funcin externa se escrita en PeopleCode o compilada en una librera dinmica. El siguiente es un ejemplo de la declaracin de una funcin en otro registro a FUNCLIB. Ejemplo:

TM

PDF Editor
Llamado de funciones:
17 |

Declare Funtion UpdatePSLOCK PeopleCode FUNCLIB_NODES.MSGNODENAME FieldFormula

Procesos PeopleSoft
Sintaxis: Function_name (lista_parametros) La lista de parmetros, es una lista de expresiones, separadas por comas, que la funcin espera le suministre. Los parmetros de la lista pueden ser opcionales o requeridos. Puede verificar los parmetros de los valores que pasa a la funcin al momento de ejecucin en la ventana Parameter del debugger de PeopleCode. Si el valor regresado es requerido, entonces la funcin debe llamarse como una expresin. Ejemplo: &RESULT = Product (&RAISE_PERCENT,.01,EMPL_SALARY); Si la funcin regresa un valor como una opcin, puede ser llamada como una subrutina. Si la funcin no regresa valores, debe se llamada como subrutina. Ejemplo: WinMessage(64,I cant do that,| &OPER_NICKNAME |.); Los parmetros siempre pasan funciones de PeopleCode por referencias internas y externas. Si la funcin cambia los datos al pasarlos, entonces debe pasar una variable. Los parmetros de la funcin Built-in pueden pasar por referencia o por valor, dependiendo de la funcin. Los parmetros de una funcin externa de C pueden pasar valores o referencias, dependiendo de la declaracin y del tipo.

Valores regresados por funciones

Las funciones pueden regresar valores de cualquier tipo de dato que soporten; algunas funciones no regresan ningn valor. La opcin de regresar valores ocurre solo en funciones Built-in. No puede definir una funcin opcionalmente regrese un valor. El regreso opcional de valores es tpico en las funciones que regresan un valor bolean indicando si la ejecucin tuvo xito. Por TM ejemplo, la siguiente llamada para DeleteRow ignora el valor de regreso y corra la fila.

PDF Editor
DeleteRow (RECORD.BUS_EXPENSE_PER,&L1_ROW,RECOD:BUS_EXPENSE_DTL,&L2_ROW);
18 |

Ejemplo:

Procesos PeopleSoft
El siguiente ejemplo verifica el valor regresado y muestra un mensaje diciendo que ha sucedido. Elemplo: If DeleteRow (RECORD.BUS_EXPENSE_PER, &L1_ROW, RECOD:BUS_EXPENSE_DTL, &L2_ROW) then WinMessage (RowDelete); Else WinMessage (Sorry---couldnt delete that row); End-if

Conflictos al nombrar funciones

Si define una funcin con el mismo nombre de una funcin built-in, la funcin que defini toma preferencia sobre la funcin Built-in. En cualquier momento que compile el PeopleCode en el editor de PeopleCode, un mensaje de advertencia aparece en la pestaa de validacin, indicando que el usuario defini una funcin con el mismo nombre de una funcin existente. Tambin, si selecciona Compile All PeopleCode, un mensaje de error es generado en el archivo log por cada funcin que el usuario defina con el mismo nombre de una funcin existente. El siguiente es un ejemplo de un mensaje de error: User defined funtion IsNumber is overrriding the builtin funtion of the same name. (2,98)

Expresiones
Expresiones fundamentales
Evala expresiones para los valores de los tipos de datos de PeopleCode. Una simple expresin de PeopleCode puede consistir en una constante, una variable temporal, una variable de sistema, una referencia a un registro o la llamada de una funcin. Una TM o la simple expresin puede modificarse por operadores (como un signo negativo expresin lgica NOT) o combinando expresiones utilizando operadores binario (como un signo plus u operador lgico AND) El verificador de nombres compara la cadena del nombre con las definiciones existentes en PeopleTools, como registros o paginas.

PDF Editor
19 |

Procesos PeopleSoft
Metastrings (tambin llamados meta-SQL) son expresiones especiales utilizadas como cadenas literales de SQL. En tiempo de ejecucin, el metastring se expande apropiadamente dentro del SQL.

Constantes
PeopleCode soporta constantes numricas, string y boolean, como constantes definidas por el usuario. Tambin soportan la constante Null, el cual indica que un objeto que no hace referencia a un objeto valido.

Constantes numricas
Constantes numricas pueden ser cualquier nmero. Como por ejemplo: 7 0.8725 -172.324

Constantes string
Las constantes string pueden delimitarse utilizando la coma simple () o al doble coma (). Si la comas forman parte de la cadena, la cadena puede encerrase dentro de otro tipo de delimitador. Como una alternativa, puede incluir dos veces el delimitador. Los siguientes son algunos ejemplos: Esta es una constante string Tambin esta Ella dijo, esta es una constante string Ella dijo, esta es una constante string Utilice el siguiente cdigo para incluir literalmente comas dentro de un string. Ejemplo: &cDblQoute =; /*coma simple comas dobles coma simple*/

Constantes booleanas
TM Las constantes booleanas representan un valor verdadero. Solo hay dos posibilidades True y False.

PDF Editor
20 |

Procesos PeopleSoft
Constantes nulas
Las constantes nulas representan un objeto que hace referencia a un objeto no valido. Esto significa que llama un mtodo o un objeto o trata de obtener o establecer propiedades que no existen. La constante nula es la palabra null.

Constantes definidas por el usuario

El usuario puede definir constantes al inicio de un programa en PeopleCode. Puede utilizar la declaracin de constantes donde desee almacenar el valor. Las constantes pueden definirse como valores number, string o boolean. El usuario al definir constates solo pueden declararse locales El siguiente es un ejemplo de la declaracin de constantes por parte del usuario. Ejemplo: Constant &Stara_New_Instance = Trae; Constant &Display_Mode = 0; Constant &AddMode = A: Local Field &Start_date; . MyFunction (&Start_New_Instance, &Display_Mode, &Add_Mode);

Funciones como expresiones

Puede utilizar cualquier funcin que regrese un valor o una expresin. La funcin puede ser utilizada del lado derecho de una sentencia, pasar como un parmetro a otra funcin o combinarse con otra expresin para formar una expresin compuesta.

Variables del sistema

Las variables del sistema estn precedidas del smbolo de porcentaje (%). Utilice estas variables para obtener la fecha actual u obtener informacin del usuario, el lenguaje TM actual, el registro actual, pgina, componente o ms.

PDF Editor
21 |

Metastring

Los metastring son expresiones especiales de SQL. Los metastring, tambin llamados meta-SQL, estn precedidos del smbolo porcentaje (%) y pueden incluirse

Procesos PeopleSoft
directamente en cadenas. Se expanden al momento de ejecutarse dentro de una subcadena para la actual base de datos. Los metastring son utilizados en: SQLExec En la construccin de vistas dinmicas en PeopleSoft Application Designer Con Objetos SQL En PeopleSoft Application Engine Con algunos mtodos de clases Con COBOL

Referencias del campo de registro

Utilice las referencias del campo del registro para recuperar valores almacenados en un campo de tabla o para asignar un valor a un campo del registro.

Sintaxis de la referencia del campo del registro

Para hacer referencia a un campo de un registro siga la siguiente forma. Sintaxis: [recordname.]fieldname Debe poner el recordname solo si el campo y su programa PeopleCode estn en diferentes registros Por ejemplo, supongamos que en la base de datos para veterinarios tiene dos registros PET_OWNER y PET. Un programa en el registro PET_OWNER debe hacer referencia a PET_BREED que esta en el registro PET, entonces la definicin del registro ser PET.PET_BREED. De cualquier manera, un programa en el registro PET puede hacer referencia a el mismo registro directamente a PET_BREED. Si el programa esta en el mismo campo del registro PET_BREED, puede hacer referencia a este mismo campo utilizando el smbolo caret (^).

TM

PDF Editor
22 |

Procesos PeopleSoft
Variables
Tipos de variables soportadas
PeopleCode Soporta este tipo de variables: Concepto Variables definidas por el usuario Caracterstica El nombre de estas variables deben estar precedidos por el smbolo &. Los nombres de las variables pueden tener de 1 a 1000 caracteres, de A-Z y a-z, nmeros de 0-9 y caracteres #,@,$ y _. Las variables del sistema proporcionan acceso a la informacin del sistema. Estas variables tienen el prefijo % en vez del &, utilice estas variables siempre que use una constante, pasndolo como parmetro a funciones o asignando su valor a campos o variables temporales

Variables del sistema

Variables definidas por el usuario

Las variables definidas por el usuario pueden mantener la informacin de un campo de registro, para programar claramente un cdigo. Por ejemplo, puede darle a una variable un nombre ms descriptivo que a un campo, basndose en el contexto del programa. Si el campo es de otro registro, puede asignarle una variable temporal en lugar de utilizar la referencia al campo. Esto hace ms fcil la programacin y ms fcil de leer. Declaracin y alcance de las variables definidas por el usuario La diferencia entre las declaraciones de variables consiste en el periodo de vida: Global: esta variable es valida para toda la sesin Component: la variable es valida mientras cualquier pgina en el componente donde la variable fue definida se mantenga activa. Local: la variable es valida durante el programa de PeopleCode o funcin en la cual la variable fue definida. Puede declarar variables utilizando sentencias Global, Local o Componente, o puede TM utilizar las variables locales sin declararlas.

PDF Editor
23 |

Procesos PeopleSoft
Ejemplo: Local Number &AGE; Global String &OPER_NICKNAME; Component Rowset &MY_ROWSET; Local Any &SOME_FIELD; Local ApiObjet &MYTREE; Local Boolean &Compare = True; La declaracin de variables se hace normalmente en la parte superior del programa en PeopleCode. La excepcin es la declaracin de variables Locales, las cuales se pueden utilizar en una funcin o en el cuerpo del programa. Si una variable es declarada cono tipo ANY o si una variable no es declarada, PeopleTools utiliza un apropiado tipo de datos basndose en el contexto Las variables globales pueden ser acezadas desde diferentes componentes y aplicaciones, incluyendo un programa Application Engine. Una variable global debe ser declarada en cada programa en que es utilizada. Utilice las variables globales lo menos posible debido a que es difcil su mantenimiento. Las variables Globales estn disponibles para un portal o aplicacin con bases de datos diferentes.

Declaracin de variables
Declare las variables antes de utilizarlas. Si no declara una variable, es declarada automticamente con el tipo de dato Any. Recibe un mensaje de advertencia en la pestaa de validacin del PeopleSoft Application Designer por cada variable que no este declarada cuando salve su programa PeopleCode.

TM

PDF Editor
24 |

Si declara todas las variables, puede utilizar estos valores para asegurar que no tiene errores ortogrficos. Por ejemplo, si declara una variable como &END_DATE, y

Procesos PeopleSoft
accidentalmente escribe &EDN_DATE, la nueva variable aparece en la pestaas cuando guarde el programa.

Inicializacin de variables definidas por el usuario

Para declarar e inicializar variables en un paso, utilice el siguiente formato. Ejemplo: Local String &MyString = New; Local Date &MyDate= %Date; Esto esta disponible solo para variables de alcance Local. Aunque puede declarar ms de una variable en una sola lnea, puede inicializar solo una variable por lnea. El siguiente cdigo crea un error de sintaxis cuando trata de salvar el programa. Ejemplo: Local Number &N1,&N2 = 5; No puede declarar una variable, despus inicializar en una segunda sentencia otra. El siguiente cdigo produce un error cuando trata de salvar el programa, por duplicar una declaracin. Ejemplo: Global Number &N1; . Local Stringr &N1 = String; Si no inicializa las variables, cuando las declara o antes de utilizarlas, las variables tipo String son inicializadas con Null, date y times con Null, y Number con cero.

Operadores
TM Las expresiones en PeopleCode piden modificarse y combinarse utilizando operadores matemticos, de caracter, comparacin y booleanos.

PDF Editor
Operadores matemticos
Los operadores estndar utilizado son:
25 |

Procesos PeopleSoft
Smbolo + * / ** Mas Menos Multiplicacin Divisin Potencia Accin

Operadores de fecha y hora

Puede agregar o restar dos fechas o dos valores de horas, lo que proporciona como resultado un nmero. En el caso de las fechas, el nmero representa la diferencia entre las dos fechas en das. Y en el caso de las horas, el nmero representa la diferencia en segundos. Puede tambin sumar y restar nmeros a una hora o una fecha, y el resultado ser otra hora u otra fecha. En el caso de los das, el nmero representa los das y en el caso de las horas representa los segundos. Operacin Hora + numero de segundos Fecha + numero de das Fecha Fecha Hora Hora Fecha + Hora Tiempo Fecha Nmero Nmero FechaHora Resultado El resultado representa Horas Fecha Diferencia en das Diferencia en segundos Fecha y Hora combinados

Concatenacin de cadenas
Las concatenacin de cadena se hace con el operador (|). Por ejemplo, asumiendo que &OPER_NICKNAME es David, y que la variable &RETORT debe decir No puedo hacer eso Davis: Ejemplo: Global Number &N1;

TM

PDF Editor
&RETORT = I cant do that, | &OPER_NICKNAME | .;
26 |

Procesos PeopleSoft
El operador de concatenacin automticamente convierte el operador a string. Esto hace ms fcil de escribir sentencias que muestren diferentes tipos de datos. Ejemplo: &DAYS_LEFT = &CHRISTMAS - %Date; WinMessage (Today is | %Date | . Only | &DAYS_LEFT | shopping days left ! );

Operador @
El operador @ convierte una cadena almacenndola en una referencia dentro de una definicin. Esto es til, por ejemplo, si desea almacenar referencias en la base de datos como cadenas y recuperarlas utilizando PeopleCode, o si desea obtener una referencia en forma de una cadena. Tomemos un ejemplo sencillo, si el campo EMPLID actualmente es 8001, la siguiente expresin evala a 8001. Ejemplo: @EMPLID El siguiente ejemplo explica el uso del operador @ para convertir una cadena almacenndola en un registro y un campo. Ejemplo: &STR1 = RECORD.BUS_EXPENSE_PER; &STR2 = BUS_EMPENSE_DTL.EMPLID; &STR3 = FerchValue(@(&STR1), CurrentRowNumber (1), @(&STR2),1); WinMessage (&STR3, 64);

Operadores de comparacin
Los operadores de comparacin, comparan dos expresiones del mismo tipo de datos. TM El resultado de la comparacin es un valor booleano. La siguiente tabla resume estos operadores.

PDF Editor
Operador = Significado Igual
27 |

Procesos PeopleSoft
Operador != <> < <= > >= Diferente Diferente Menor que Menor o igual Mayor Mayor o igual Significado

Puede agregar al inicio de cualquier operador el operador NOT, por ejemplo: Not= Not< Not>=

Operadores booleanos
Los operadores lgicos AND, OR y NOT son utilizados para combinar expresiones Booleanas. La siguiente tabla muestra el resultado de combinar dos expresiones booleanas con los operadores AND y OR. Expresin 1 FALSE FALSE TRUE FALSE FALSE TRUE Operador AND AND AND OR OR OR Expresin 2 FALSE TRUE TRUE FALSE TRUE TRUE Resultado FALSE FALSE TRUE FALSE TRUE TRUE

TM y de El operador NOT niega la expresin bolean, cambiando el valor de True a Falso False a True.

PDF Editor
El siguiente ejemplo de sentencias contiene expresiones booleanas.
28 |

Procesos PeopleSoft
Ejemplo: &FLAG = (Not (&FLAG)); If ((&HAS_FLEAS or &HAS_TICKS) and SOAP_QTY <= MIN_SOAP_QTY) then SOAP_QTY = SOAP_QTY + OrderFleaSoap (SOAP_ORDER_QTY); End-if;

Eventos en PeopleCode
Evento Activate
El evento actvate es iniciado cada vez que se activa una pgina, inclusive cuando una pgina es mostrada al usuario por primera vez, o si el usuario presiona TAB entre las diferentes paginas en un componente. Cada pgina activa su propio evento. Solo se puede activar PeopleCode asocindolo con pginas

Evento FieldChange
Utilice FieldChange PeopleCode para re-calcular los valores de los campos en la pagina, cambiar la apariencia de la pagina de control. Para validar el contenido de un campo, utilice el evento FieldEdit. El evento FieldChange se aplica al campo o fila que acaba de cambiar. FieldChange PeopleCode se acompaa de RowInit PeopleCode. En esta combinacin RowInit/FieldChange, el cdigo en RowInit evala los valores en el componente e inicializa su estado o los controles de la pgina. FIeldChange vuelve a evaluar los valores en el componente al momento de la ejecucin y resetea los valores o las pginas.

Evento FieldDefault
El evento FieldDefault PeopleCode permite programar los valores por default para los TMparte campos cuando se van a mostrar. Este evento se inicia en todos los campos como de diferentes procesos, sin embargo, los triggers de PeopleCode se disparan cuando las siguientes condiciones son verdaderas: Los campos de la pgina continan en blanco despus de aplicar cualquier valor especificado en las propiedades del registro. El campo tiene un programa PeopleCode para FieldDefault

PDF Editor
29 |

Procesos PeopleSoft
En la prctica, el PeopleCode para FieldDefault normalmente configura los campos por default cuando nuevos datos se agregan al componente, esto es, en modo de agregar y cuando una nueva fila es insertada. Si el valor de un campo es cambiado, ya sea a travs de PeopleCode o por el usuario, la propiedad IsChange para la filase pone en verdadero. La excepcin a esto en cuando un cambio esta hecho con los eventos FieldDefautl o FieldFormula. Si un valor se configura en FieldDefault o FieldFormula, la fila no se marca como cambiada. Al guardar, las nuevas inserciones y cambios a filas se escriben en la base de datos. Las nuevas inserciones

Evento FieldEdit
Use el evento FieldEdit para validar el contenido de un campo. Si el dato no pasa la validacin el programa PeopleCode debe mostrar un mensaje de error, el cual vuelve a mostrar la pgina, mostrando el mensaje de error y poniendo el campo en rojo. Para permitir al usuario editar un campo pero alertarlo de la posibilidad de un error, use una sentencia de advertencia o de error. Una sentencia de advertencia muestra una ventana de advertencia con un botn OK y explicacin. Esto permite que el contenido del campo pueda ser cambiado y continuar el proceso como normalmente sucede.

Evento FieldFormula
El evento FieldFormula normalmente no es utilizado. Porque FieldFormula PeopleCode inicia de diferentes maneras y lanza PeopleCode en cada campo o cada fila en el buffer del componente, y puede degradar el desempeo de la aplicacin. Use RowInit y FieldChange en lugar de evento FieldFormula.

Evento ItemSelected
El evento ItemSelected es iniciado donde sea que el usuario seleccione un elemento de un men. En mens emergentes, ItemSelected PeopleCode se ejecuta en el contexto de la pgina donde se encuentra el men, lo que significa que puede tener un men diferente por cada pgina. ItemSelected PeopleCode esta asociado solo con los mens emergentes.

Evento PosBuild

TM

PDF Editor
PeopleCode PostBuild esta asociado solo con los componentes
30 |

El evento PostBuild es asociado despus de construir todos los eventos del componente. Este evento normalmente utilizado para mostrar u ocultar pginas. Tambin es utilizado para configurar las variables del componente.

Procesos PeopleSoft
Evento PreBuild
El evento PreBuild es iniciado antes del resto de los eventos Built del componente. Este evento se utiliza para esconder o mostrar pginas. Tambin es utilizado para configurar las variables del componente. Tambin use el evento PreBuild para validar la entrada de datos en las pginas de bsqueda.

Evento PrePopup
El evento PrePopup es iniciado antes de mostrar un men emergente. Puede utilizar PeopleCode PrePopup para controlar la apariencia del men emergente.

Evento RowDelete
El evento RowDelete es iniciado cuando el usuario intenta borrar un afila de datos desde un pgina. Use PeopleCode RowDelete para prevenir la eliminacin de una fila o para ejecutar algn proceso despus de la eliminacin. PeopleCode RowDelete puede ser asociado con campos y registros

Evento RowInit
El evento RowInit se inicia por primera vez cuando el Component Processor encuentra una fila de datos. Se utiliza para configurar el estado inicial del control de componentes. Esto ocurre durante el proceso de construccin del componente y la insercin de una fila. Esto ocurre despus del mtodo Select o SelectAll. No use sentencias de advertencia o error en el PeopleCode RowInit; esto causa un error de ejecucin.

Evento RowInsert
Cuando el usuario agrega una fila de datos, el Component Processor genera un evento RowInsert. Debe utilizar PeopleCode RowInsert para procesos especificos para insertar nuevas filas. No ponga PeopleCode en RowInsert si existe RowInint, debido a que el evento RowInit siempre inicia antes del evento RowInsert, lo que causa que el cdigo.se TM ejecute dos veces.

PDF Editor
31 |

Evento RowSelect

El evento RowSelect se inicia en al principio del proceso de construccin del componente en cualquiera de los modos de accin (Update, Update/Display All,

Procesos PeopleSoft
Correction). RowSelect se utiliza para filtrar las filas de los datos que se estn leyendo en el buffer del componente Una funcin DiscardRow en RowSelect causa que el Component Processor salte la fila actual y contine el proceso a otra fila. La sentencia StopFetching causa que el Component Processor acepte la fila de datos y pare la lectura de las filas de datos. Si se ejecutan las dos sentencias, el programa salta la fila actual y entonces detiene la lectura de las dems filas. Rara vez se utiliza el RowSelect, debido a que es ineficiente para filtrar filas que ha seleccionado anteriormente.

Evento SaveEdit
El evento SaveEdit se indica cuando un usuario intenta guardar el componente. Puede utilizar el PeopleCode SaveEdit para validar la consistencia de datos en los campos del componente. Siempre que una validacin involucre ms de una campo en el componente, debe utilizar PeopleCode SaveEdit. Si una validacin involucra solo un campo en la pgina del componente, use PeopleCode FieldEdit. Un error en una sentencia en SaveEdit PeopleCode muestra un mensaje y muestra otra vez el componente sin guardar los datos. Una sentencia de advertencia permite al usuario dar clic en OK y guardar los datos o dar Clic en Cancel y regresar al componente sin guardar los datos. SaveEdit puede asociarse con registros y componentes

Evento SavePostChange
Despus de que el Component Processor actualiza la base de datos, inicia el evento SavePostChange. Puede utilizar SavePostChange para actualizar las tablas sin utilizar el componente sino la funcin SQLExec. Un error o advertencia en SavePostChange causa un error de ejecucin. Evite los errores y advertencias en este evento. El sistema utiliza la sentencia commit de SQL despus de completar exitosamente el evento SavePostChange. Si esta ejecutando Workflow PeopleCode, tenga en cuenta que si el WorkflowTM falla, el evento SavePostChange no sera ejecutado. Si su componente tiene ambos eventos, Workflow y SavePostChange considere cambiar el evento SavePostChange a SavePreChange.

PDF Editor
32 |

Procesos PeopleSoft
Evento SavePreChange
El evento SavePreChange es iniciado despus de que SaveEdit se complete sin errores. SavaPreChange proporciona una oportunidad final para manipular datos antes de que el sistema actualic la base de datos, para instancias puede utilizar SavePreChange poner en alto nivel las llaves. Si SavePreChange corre satisfactoriamente, un evento Workflow se genera, y el Component Processor utiliza apropiadamente las sentencias SQL Inser, Update o Delete.

Campo ChartField
Es un campo que almacena caracteres de cuentas, recursos, y otros, dependiendo de la aplicacin PeopleSoft. Los valores ChartField representan nmeros de cuentas individuales, cdigos de departamento, y as sucesivamente.

TM

PDF Editor
33 |

Procesos PeopleSoft PeopleSoft Application Engine

PeopleSoft Application Engine es una PeopleTools designada para ayudarle a desarrollar a fondo programas SQL. Esta herramienta esta destinada para ser utilizada por desarrolladores con conocimiento de SQL, SQL tools y PeopleTools. PeopleSoft Application Engine ofrece una alternativa para escribir programas en cobol o SQR para procesamiento afondo de SQL. Mientras PeopleSoft Application Engine no genera, analiza o entiende SQL, si ejecuta el SQL que usted proporcione.

Aplicacin

Seccin

Seccin

Seccin

Paso

Paso

Paso

Accin

Accin

Accin

Entendiendo PeopleSoft Application Engine

Puede utilizar PeopleSoft Application Engine para desarrollar programas batch o en lnea que realizan procesos de altos volmenes, procesando a fondo sus datos.

Fundamentos de PeopleSoft Application Engine

TM

PDF Editor
34 |

PeopleSoft Application Engine comprende dos componentes distintos, un diseador donde se define los programas batch y el entorno de ejecucin donde se corren y monitorean los programas.

Procesos PeopleSoft
En PeopleSoft Application Engine, un programa es un conjunto de sentencias SQL y de PeopleCode. Un programa se define en PeopleSoft Application Designer y realiza un proceso de negocio. PeopleSoft Application Engine no genera SQL o PeopleCode. Este ejecuta las sentencias SQL y PeopleCode que se incluye en una accin de Application Engine como parte de su programa. PeopleSoft Application Engine esta diseado para el procesamiento batch donde usted tiene los datos que deben ser procesados sin intervencin del usuario.

Meta-SQL
Puede escribir SQL dentro de PeopleSoft Application Engine o puede copiar sentencias SQL en un Application Engine de cualquier utilidad SQL con unos cuantos cambios (si los hubiera). Esto permite escribir y ajustar sentencias SQL antes de tratar de incorporarlos en un programa de Application Engine Las plataformas de las bases de datos pueden tener diferentes reglas de sintaxis especialmente en lo que respecta a la fecha, la hora, y otros clculos numricos. Generalmente puede trabajar en torno a las diferencias de sintaxis utilizando PeopleSoft meta-SQL, el cual apoya un PeopleSoft Application Engine. Meta-SQL es un conjunto de condiciones predefinidas diseado para sustituir RDBMS con una sintaxis comn

Elementos del programa de Application Engine.

Un programa de Application Engine comprende un conjunto de procesos para ejecutar una tarea dada y esta compuesta de varios elementos claves: Secciones Pasos Acciones Registros de estado.

Secciones
TM en Las secciones comprenden uno o ms pasos y son equivalentes a un prrafo COBOL o a un procedimiento en SQR. Todos los programas del Application Engine deben contener al menos una seccin Main.
Una seccin es un conjunto de pasos ordenados que se ejecutan como parte de un programa. Puede llamar a estas secciones (y otros programas) de los pasos dentro de otras secciones.

PDF Editor
35 |

Procesos PeopleSoft
Un programa debe contener al menos una seccin. La ejecucin del programa siempre comienza con la seccin definida como Main.

Pasos
Los pasos son las unidades ms pequeas de trabajo que pueden ser incluidas dentro de un programa. Aunque puede utilizar un paso para ejecutar un comando de PeopleCode o iniciar un mensaje, normalmente, un paso se utiliza para ejecutar una sentencia SQL o para llamar otras secciones. Cuando una seccin es llamada, sus pasos se ejecutan secuencialmente. Cada programa empieza por ejecutar el primer paso de la seccin requerida llamada Main y termina despus del ltimo paso en la ltima seccin completada correctamente

Accin
Hay mltiples tipos de acciones que puede especificar para incluir dentro de un paso. Es comn tener mltiples acciones asociadas con un simple paso.

Acciones Do
Las acciones Do contienen una sentencia SQL designada a regresar resultados del cual dependen acciones subsecuentes. Por ejemplo, si la sentencia Select no devuelve lneas, las acciones subsecuentes no necesitan ejecutarse. Los 4 tipos de acciones Do son: Do While Do When Do Select Do Unit

SQL
La mayora de las acciones SQL contienen una simple sentencia de SQL. Estas acciones pueden realizar los siguientes tipos de sentencias SQL: Update Delete Insert Select

TM

PDF Editor
36 |

Las acciones SQL difieren de las acciones Do, las cuales tambin contienen SQL, y en que la accin de SQL no controla el flujo del programa.

Procesos PeopleSoft
PeopleCode
PeopleSoft Application Engine PeopleCode proporciona una excelente forma de construir SQL dinmicos, realizando simples if/else, establecidos por default y otras operaciones que no requieren una consulta a la base de datos. Lo ms importante, PeopleCode proporciona acceso a las tecnologas de integracin de PeopleSoft como PeopleSoft Integration Broker, Component Interface y Business Interlinks.

Log Message
Se utiliza la accin Log Message para escribir un mensaje basado en una condicin en su programa. Esto da a su programa capacidad multilenguaje. El sistema almacena el mensaje generalmente como un mensaje conjunto, nmeros de mensaje y valores de los parmetros. Cuando el usuario ve los mensajes utilizando la pagina de Application Engine Message Log, el sistema recupera el mensaje apropiado del catalogo de mensajes basado en el idioma seleccionado por el usuario.

Call Section
Puede tambin insertar una accin que llame a otra seccin. La seccin llamada puede estar en el mismo programa, o puede ser en un programa externo. Esto le permite reutilizar el programa, en lugar de crear la accin. Si una seccin ya existe en un programa, en vez de copiarla en otro programa, slo mndela llamar.

State Records
El State Record es un registro que se debe crear y mantener por el desarrollador del Application Engine. Este registro define los campos que un programa utiliza para pasar valores de una accin a otra. Un State Record puede ser cualquier record fsico o record de trabajo, y cualquier nmero de State Records que puedan ser asociados con el programa.

Tipos de programas del Application Engine

Hay cinco tipos de programas en el Application Engine. Usted especifica elTM tipo de programa en cuadro de dialogo de las propiedades para la definicin de el programa. Los tipos son: Standard, es un punto de entrada normal del programa. Upgrade Only, es utilizada para las actualizaciones de PeopleSoft. Import Only, el cual es utilizado importar utileras de PeopleSoft.

PDF Editor
37 |

Procesos PeopleSoft
Daemon Only, un tipo de programa utilizado como un demonio proceso. Transform Only, un tipo de programa utilizado para apoyar Extensible Stylesheet Language Transformaciones (XSLT).

Daemon Program
Application Engine proporciona un Daemon Program, llamado PSDAEMON, que se ejecuta continuamente cuando el Process Scheduler esta corriendo, y es identificado por trabajos recurrentes. Un conjunto predefinido de condiciones es un evento.

Transform Program
Los tipos de programas Transform Only, permite diferentes sistemas para comunicarse uno con el otro transformando mensajes en formatos apropiados. Cuando se especifica un Application Engine program como Transform Only, se debe especificar la accin del tipo XSLT o PeopleCode. Puede utilizar Transform Program para hacer cualquiera de lo siguiente: Aplicar una transformacin a un mensaje para hacer su estructura cumplir con el objetivo de los requerimientos del sistema. Realizar una traduccin de datos en un mensaje como los datos estn representados de acuerdo a los convenios del sistema. Determinar si para pasar un mensaje a travs de su objetivo, para filtrar esto basado en su contenido.

Creando programas de Application Engine

Un Application Engine incluye un orden lgico de secciones, pasos, y acciones. Un programa ejecutable debe contener al menos una seccin llamada Main, utilizada para identificar el punto de comienzo del programa, este debe contener al menos un paso y cada paso debera contener al menos una accin.

Visualizando programas de Application Engine

Utilizando vista Definition
TM Utilice la vista Definition para crear definiciones dentro de una estructura jerrquica definida, en la cual los nodos representan las definiciones. Un nodo es una representacin visual de una seccin, un paso o una accin que puede seleccionar colapsar, modificar, etc.

PDF Editor
38 |

Procesos PeopleSoft
Las secciones que aparecen en la vista Definition no necesariamente aparecen en el orden en que estos se ejecutan. Para ver el orden real en las cuales las secciones se ejecutan, cambie a la vista Program Flow. Puede navegar en esta vista utilizando las siguientes teclas de combinaciones: Presione CTRL + HOME para desplazarse a la parte superior de la definicin del programa y seleccione el primer nodo. Presione CTRL + END para desplazarse hasta el final de la definicin del programa y seleccione el ltimo nodo visible. Presione TAB para pasar del campo seleccionado actualmente a la prximo campo actualizado Presione CTRL + DOWN ARROW para desplazarse desde el nodo seleccionado actualmente para el prximo nodo. Presione CTRL + UP ARROW para pasar de la actual nodo seleccionado a la anterior nodo. La siguiente ilustracin muestra la vista Definition.

Definicin de la vista Pop-up Menu

TM

PDF Editor
39 |

La siguiente tabla describe cada tema que ve cuando le da clic a la ventana de Definition. Algunos elementos del men se activan slo cuando una definicin en particular est seleccionada.

Procesos PeopleSoft
Comando del men View PeopleCode Descripcin Ejecuta el editor de PeopleCode con el PeopleCode apropiado. Se habilita cuando una accin PeopleCode es seleccionada. Ejecuta el editor SQL con el SQL apropiado. Se habilita cuando una accin que contiene un SQL es seleccionada. Ejecuta el editor SQL cuando el se relacionan el texto cargado y el Extensible Stylesheet Language Transformations (XSLT). Se habilita solo para un programa tipo Transform Only, cuando una accin XSLT es seleccionada. Remueve el elemento seleccionado y sus copias del portapapeles. No puede copiar o pegar dentro de ningn programa. Copia un elemento seleccionado. Pega el contenido del portapapeles de PeopleTools, (el ms reciente corte o copiado) a la ubicacin actual del cursor. Borra el nodo actualmente seleccionado de la definicin del programa. Actualiza la vista actual y reordena la definicin de objetos, segn sea necesario. Inserta una nueva seccin en el programa actual, en el lugar donde el cursor esta en posicin. Esta opcin est habilitada slo cuando tienes MAIN u otra seccin seleccionada. Inserta un nuevo paso y la accin dentro de la seccin seleccionada actualmente. Esta opcin est activada slo cuando usted tiene una seccin o un paso seleccionado. TM Inserta una nueva accin en el paso actualmente seleccionado. Esta opcin est habilitada slo cuando se tiene un paso o accin seleccionada. Cambia a el programa Program Flow view

View SQL

View XSLT

Cut

Copy Paste

Delete

Refresh View

Insert Section

Insert Step/Action

Insert Action

PDF Editor
Jump to This Program Flow
40 |

Procesos PeopleSoft
Comando del men Descripcin Con la primera aparicin de la actual seleccin definiendo en el punto de mira. Print Muestra el cuadro de dilogo Imprimir para la vista de la definicin. Se aplica a las secciones. Inserta la actual seleccin en el proyecto.

Insert Section Into Project

Utilizando la vista Program Flow

La vista Program Flow es solo de lectura, muestra las secuencias de los pasos para ser ejecutados en el programa que se esta desarrollando. La siguiente ilustracin muestra el programa:

Usted puede controlar la cantidad de detalle que aparece para cada definicin haciendo clic en ella para ampliar al siguiente nivel. Tambin puede ver el SQL o PeopleCode en la parte inferior (splitter) del rea de la ventana, haciendo clic en la parte baja de la misma. Si un nodo de primer paso (uno que no es el resultado de llamar una seccin) TM es seleccionado, el cuadro de dialogo Print Options permite la impresin, ya sea para comenzar en ese nodo de paso o la impresin de todo el programa. Sin embargo, si un nodo del segundo paso (uno que es el resultado de llamar una seccin), un nodo de la segunda accin, un nodo SQL o un nodo PeopleCode, es seleccionado en la vista Program Flow, el cuadro de dialogo Printf Options solo permite la impresin de todo el programa.

PDF Editor
41 |

Procesos PeopleSoft
Para mostrar el men pop-up para un nodo, de clic derecho al mismo nodo. No tiene que seleccionar primero el nodo. Puede tambin mostrar los comentarios asociados con las definiciones seleccionando View, Show All Comments o para un nodo en particular, haga clic derecho y seleccione Show Comment.

Men pop-up del Program Flow

La siguiente tabla contiene cada tema de men pop-up de la vista Program Flow. Comando del men View PeopleCode Descripcin Ejecuta el editor de PeopleCode con el apropiado PeopleCode cargado. Habilitado cuando una accin de PeopleCode esta seleccionada. Ejecuta el editor de SQL con el apropiado SQL cargado. Habilitado cuando una accin con SQL esta seleccionada. Actualiza la vista actual y reordena la definicin de objetos, segn sea necesario. Revela los comentarios para un simple objeto que aparece en la vista Program Flor. Cambia a la vista Definition con la primera aparicin de la definicin actual del objeto seleccionado actualmente. Ejecuta el cuadro de dilogo para imprimir para la vista del programa.

View SQL

Refresh View

Show Comment

Jump to This Definition

Print

Cambiando ntre las vistas Definition y Program Flow

Por default, la navegacin dentro de cualquier vista no afecta a la fila activa actual en otra vista. Esto permite recuperar el lugar mientras se desplaza en alguna otra. Para cambiar entre dos vistas, puede utilizar cualquiera de los siguientes mtodos: Pestaas de vistas.

PDF Editor
Men de vistas
42 |

TM Como con cualquier interfaz con pestaas, si selecciona una pestaa, la vista de la interfaz asociada se convierte en una interfaz activa. Cuando regrese la vista previa, este sigue posicionada en el actual o ultimo nodo dentro del programa cuando se encienda.

Procesos PeopleSoft
Seleccione una seccin o paso en la actual vista (note que seleccionando una accin no habilita esta funcionalidad). Seleccione View Jump to Program Flow o View Jump to Definition, dependiendo en que vista este activo actualmente. Cuando selecciona uno de estos comandos, el centro del objetivo depende de que lo tenga seleccionado en la vista previa. Men pop-up Los mismos comandos como el men View tambin estn disponibles desde el men pop-up.

Cambiando dentro de la vista Program Flow

Mientras se encuentre en la vista Program Flow, puede seleccionar estas opciones del men pop-up: Go to Next Reference Seleccione esta opcin para cambiar la siguiente referencia de una definicin de un objeto en particular. Esto le ayuda a navegar rpidamente a travs del programa. Por ejemplo, si las referencias a la seccin C, el paso 4 aparece tres veces, porque hay varias llamadas a este objeto en tiempo de ejecucin, seleccione Go to Next Reference para navegar fcil y rpidamente en cada referencia. Jump to this Definition Seleccione esta opcin para ir directamente a la definicin del nodo en la vista Definition que pertenece a la actual seleccin en la vista Program Flow.

Utilizando la opcin actualizar

Como desarrollador de un programa Application Engine, tal vez inserte, renombre y borre definiciones. En un largo programa puede ser fcil perder su lugar o desorientarse. La opcin actualizar reordena todos los nodos para la actual definicin de acuerdo a la siguiente lgica: Para las definiciones de un programa estndar, la seccin del Main siempre aparece primero. TM Las secciones restantes aparecen alfabticamente por nombre, esto hace ms fcil localizar una seccin dentro de un programa. El sistema ejecuta secciones a travs de la accin Call Sections dentro de los pasos, no por el orden que fueron definidos. Los pasos nunca se reordenan automticamente en la vista Definition, y, en tiempo de ejecucin se ejecutan en el orden en que fueron definidos.

PDF Editor
43 |

Procesos PeopleSoft
Las acciones se reordenan lgicamente siempre dentro de un paso, basado de su tipo de accin, que define su tiempo de ejecucin.

Filtrando el contenido de la vista

Las seccin de las opciones de filtrado le permiten filtrar la vista actual de manera que slo vea las secciones y las pasos basados en los criterios especificados. Para habilitar o modificar las opciones de filtrado, seleccione View Secction Filtering. Para habilitar o modificar las opciones de filtro, seleccione View Section Filtering. Puede seleccionar una de las siguientes opciones de filtrado: Comando de men No Filtering Descripcin Seleccione para ver todos los objetos en el programa independientemente de cualquier seccin de atributos, tales como mercado, tipo de base de datos, fecha efectiva y estado efectivo. Seleccione para mostrar la definicin de filtro de acuerdo con el valor por default de los criterios de filtrado. Si cambia el valor de cualquier opcin de filtrado haga clic en OK, para tener definido una filtro personalizado. Seleccione para mostrar el cuadro de dilogo de la definicin de filtro y definir las opciones del filtrado para la vista actual.

Default

Custom

Comportamiento de las opciones de la seccin de filtrado

Cuando use la seccin de opciones de filtrado considere lo siguiente: El valor por default es no filtrado, por lo tanto, todas las definiciones de la seccin se incluyen en esta vista. Si selecciona filtrado, el filtrado de las opciones por defecto se muestran mientras est en la seccin actual de PeopleSoft Application Designer Si modifica este filtro y da clic en OK, las nuevas opciones sern guardadas como opciones activas actuales y en consecuencia se actualiza la vista. TM

PDF Editor
44 |

Si selecciona los filtros por default, las opciones aparecern en el cuadro de dialogo.

Si selecciona Section Filtering, Default o Section Filtering Custom aparecer el siguiente cuadro de dilogo:

Procesos PeopleSoft

En este ejemplo, slo las definiciones que representan a los siguientes criterios aparecen en las vistas Definition y Program Flor. Atributo Market Definicin Seleccione un cdigo de mercado para ver slo las definiciones dentro de ese mercado. Para ver todos los agentes del mercado relacionados con las definiciones de un programa, puedes actualizar el perfil predeterminado, o definir un filtro personalizado, seleccionando (none) de la lista desplegable Market Drop-Down. Seleccione la plataforma de filtrado. En la ilustracin, las secciones que se definen slo para Microsoft SQL Server son mostradas. Seleccione Default para mostrar las secciones definidas para ser independientes de la base de datos de la plataforma independiente. Las plataformas especificas incluyen Oracle, DB2 UDB parar OS/390 y z/OS, DB2/UNIX, Informix, Microsoft, y Sybase. Seleccione la fecha filtrada. En la imagen de arriba,TM las secciones con secciones como una fecha igual o superior a 7 de abril de 2000. Seleccione None para mostrar todas las secciones a pesar de la fecha efectiva. Seleccione para mostrar las definiciones seccin activa

Platform

As of Date

PDF Editor
Active Status
45 |

Procesos PeopleSoft
Creando, abriendo y renombrando los programas.
Creando nuevos programas
Para crear nuevos programas: 1. Seleccione File New o presione CTRL + N. 2. En el cuadro de dialogo, seleccione App Engine Program y de clic en OK. 3. Nmbrelo y guarde el programa. Seleccione File Save As ingrese le nombre del programa en el cuadro de dialogo Save Name As y de clic en OK.

Abriendo programas existentes

Para abrir un programa existente: 1. Seleccione File Open. 2. En el cuadro de dialogo Open Definition seleccione App Engine Program de la lista desplegable 3. Ingrese su criterio de bsqueda del programa que quiera, seleccione su programa en los resultados de la bsqueda y de clic en Open.

Renombrando programas
Para renombrar un programa: 1. Seleccione File Rename. 2. En el cuadro de dialogo de renombrar, asegrese de que aparezca App Engine Program como el tipo de definicin. 3. En el men desplegado que contiene los resultados de su bsqueda seleccione el programa que quiera renombrar. 4. Seleccione Rename. 5. Site el cursor en la casilla que aparece destacado en todo el nombre del programa. TM 6. Ingrese el nuevo nombre del programa.

PDF Editor
46 |

7. Haga clic en Rename y, a continuacin, responder adecuadamente en el cuadro de de dilogo Confirm Rename.

Procesos PeopleSoft
Copiando o moviendo elementos del programa
Los siguientes procedimientos aplican a las sesiones, pasos y acciones. Tenga en cuenta que cuando estas funciones se llevan a cabo para un determinado objeto, el resultado no slo se aplica al objeto seleccionado, sino que tambin incluye las definiciones asociadas si es que existen. Para copiar una definicin: 1. Seleccione la definicin. 2. Seleccione Edit Copy. 3. Site el cursor donde usted desea poner la definicin copiada, y seleccione Edit Paste. Para mover una definicin: 1. Seleccione la definicin de objeto. 2. Seleccione Edit Cut. 3. Site el cursor en la ubicacin de destino y seleccione Edit Paste.

Probando programas de Application Engine

Despus de crear o modificar su programa, usted puede probarlos en PeopleSoft Application Designer en segundo plano. Puede utilizar Ejecutar en el cuadro de dilogo:

TM

PDF Editor
Para ejecutar un programa Application Engine en segundo plano:
47 |

1. Seleccione Edit Run Program desde la barra de herramientas de PeopleSoft Application Designer. El cuadro de dialogo Run Request aparecer.

Procesos PeopleSoft
2. Introduzca los valores adecuados. Al hacer clic en OK, estos valores se pasan como parmetros al ejecutable de PeopleSoft Aplicacin Engine. 3. Presione OK. Los datos que necesita son: Atributo Run Control ID Descripcin Introduzca el run control ID del programa que usted est probando Seleccione para que la ventana del proceso solicitado se minimizara al ejecutar el programa. Seleccionar para escribir el registro de salida a un archivo. Especifique el nombre del archivo de registro de salida (permitido slo cuando la salida del archivo de registro est seleccionada). Especifique el proceso para ejecutar esta peticin, o utilizar el valor por default de cero si el nmero de la instancia no es necesario.

Run Minimized

Output Log to File Log File Name

Process Instance

Configurando las propiedades del programa

Accediendo a las propiedades
Cuando tiene un programa Application Engine abierto en el PeopleSoft Application Designer, puede ver y modificar las propiedades asignadas a la totalidad de un programa slo como lo hara un paso o una seccin. Para ver o modificar las propiedades asociadas con un programa, haga clic en el botn propiedades y seleccione File Definition Properties, mientras que el programa est abierto. Tambin puede pulsar ALT + ENTER. El cuadro de dilogo Program Properties aparece.

Configuracin las propiedades generales

TM Acceda al Programa de cuadro de dilogo Propiedades y seleccione la pestaa General. Puede especificar los valores de identificacin para su programa Application Engine.
Atributo Descripcin

PDF Editor
Owner ID
48 |

(Opcional) Introduzca el ID del propietario para el

Procesos PeopleSoft
Atributo Descripcin programa. El propietario de identificacin es una forma de identificar que las definiciones son propiedad de las aplicaciones de PeopleSoft, como PeopleSoft General Ledger, Accounts Receivables, y as sucesivamente.

Configurando las propiedades del registro de estado

Seleccione la pestaa del registro de estado.

Atributos Qualify Search

Definicin Introduzca los caracteres o nombre de la tabla para limitar los resultados que aparecen en la lista de registro. De forma predeterminada, la casilla Record List contiene todos los nombres de records que terminan con la extensin TM AET. Esta extensin identifica el registro como un registro Application Engine. Haga clic aqu para rellenar la Record List

PDF Editor
Get List Record List
49 |

Esta casilla contiene los resultados de su bsqueda del registro de estados

Procesos PeopleSoft
Atributos Selected Definicin Seleccione un registro de estados para su uso con un programa en particular. Haga clic en Add para incluir registros seleccionados de la lista de registros. Haga clic en Remove para eliminar los registros seleccionados de la lista. Indican que el registro acta como un registro de estados por defecto para la seleccin de su casilla de verificacin.

Especificando las tablas temporales

Seleccione la pestaa de tablas temporales. Las tablas temporales almacena resultados durante un programa que se esta ejecutando.

Atributo Qualify Search

Descripcin

PDF Editor
Get List Haga clic aqu para rellenar la Record List.
50 |

TM Introduzca los caracteres o nombres de tabla completa para limitar los resultados que aparecen en la lista de registro. De forma predeterminada, el cuadro Record List slo contiene registros que son de tipo tabla temporal.

Procesos PeopleSoft
Atributo Record List Descripcin Este cuadro de texto contiene resultados de su bsqueda en tablas temporales Seleccione las tablas temporales para su uso con un programa en particular. Haga clic en Add para incluir los registros seleccionados que aparecen en la lista de registro. Haga clic en Remove para excluir los registros seleccionados que aparecen en la lista seleccionada. Introduce el nmero de tablas fsicas que se crear para cada tabla dedicada a este programa durante el procedimiento de SQL Build en PeopleSoft Application Designer. Si la definicin del programa activo de Application Engine pertenece a un proyecto, seleccionelo para incluir las tablas temporales para este programa dentro del mismo proyecto. Controla como se comporta un programa Application Engine si una instancia de sus tablas temporales especificadas no est disponible. Si usted selecciona Continue, entonces PeopleSoft Application Engine utiliza la versin baja, o la versin no dedicada, de las tablas temporales. Si usted selecciona Abort, entonces las salidas de programa tendrn un mensaje de error.

Selected

Instance Count

Insert Selected List into Project

Runtime

Configurando propiedades avanzadas

TM

PDF Editor
51 |

Procesos PeopleSoft
Atributos Disable Restart Descripcin Seleccione para desactivar de la capacidad de reiniciar un programa en particular. En algunos casos, puede que quiera un programa para contener slo una coleccin, o una biblioteca, de las rutinas comunes que no desea para ejecutarse como un programa independiente. Cuando las secciones se definen como pblico, otros pueden llamar a los programas de las secciones, o rutinas, que existen en la biblioteca en tiempo de ejecucin. Los programas Batch Only no se ejecutan a partir de la funcin CallAppEngine PeopleCode. Cualquier tabla temporal utilizada para Batch Only crea instancias en lnea. Especifique el mensaje por default, el valor establecido para este programa. El sistema utiliza este mensaje de valor para todos los mensajes de registro, acciones en las que el mensaje conjunto no se especifica. Standard: Utilizado por programas Entry-Point. Upgrade Only: Utilizado por PeopleSoft para actualizar. Import Only: Utilizado por PeopleSoft para importar utilidades. Daemon Only: Utiliza los programas Daemon Type. Transform Only: Apoyado por programas XSLT.

Application Library

Batch Only

Message Set

Program Type

Agregando secciones
Una seccin incluye pasos y es equivalente a un prrafo de COBOL o una funcin de PeopleCode. Puede crear secciones que son independientes de la plataforma o plataformas especficas, destinados a un mercado particular, y de fecha efectiva. TM Cuando usted crea un nuevo programa, al mismo tiempo crea una seccin llamada Main. La seccin Main identifica el punto de inicio del programa para que pueda ser llamado por otro programa.

PDF Editor
52 |

Procesos PeopleSoft
Seccin de orden de ejecucin
Una seccin es nica basada en el programa y los nombres de la seccin, y basada en la plataforma de la base de datos y fecha efectiva. Cuando ejecuta un programa de Application Engine, este ejecuta secciones basadas en el siguiente orden de precedencia: 1. Si una seccin por el mercado actual existe, ejectela. De otra manera, ejecute la seccin de mercado global. 2. Si una seccin por la plataforma actual o base de datos existe, ejectela. De otra manera, ejecute la seccin por default de la plataforma de la base de datos. 3. Si secciones mltiples de fecha efectiva existen, ejecute la seccin con la ms reciente fecha efectiva, basada en el dato actual.

Insertando secciones Para insertar una seccin:

1. Seleccione Insert Section o con el clic derecho seleccione Insert Section El nombre por default para una seccin que se inserta es Section N, donde N es un nmero que incrementa los intentos lo que proporciona un nombre nico para cada una de los objetos de seccin. Sino renombra las secciones, las secciones se llamaran Seccin N + 1, donde N es la ltima seccin que se insert. En consecuencia, se obtiene como nombres, Section1, Section2, Section3, y as sucesivamente.
Nota. Las secciones son siempre reordenadas alfabticamente por nombre al momento de guardar para hacer ms fcil localizar la seccin dada.

2. Introduzca los valores restantes de la propiedad de la seccin. 3. Guarde el programa

Localizando las secciones.

Hay varios mtodos para localizar las referencias de las secciones dentro toda una base TM de datos, as como dentro de un programa.

PDF Editor
53 |

Buscando las llamadas a las secciones de referencia

Puede generalizar una lista de todas las referencias para una seccin en particular. La lista aplica solo a programas de Application Engine definidas dentro de una simple base de datos.

Procesos PeopleSoft
Para localizar las secciones de referencia: 1. Abra el programa que contenga la seccin compartida o llamada. 2. Seleccione EditFind References 3. Aparece el cuadro de dialogo Definition Reference 4. En la pestaa Call Sections, seleccione la seccin apropiada de la lista de nombres de seccin o introduzca en nombre directamente 5. Clic Ok La ventana de salida enlista los programas y secciones que llama a un programa en particular. Esta lista muestra el total de llamadas de referencias realizadas a una seccin particular. Las secciones llamadas dentro del programa actual aparecen en la lista en primer lugar.

Buscando secciones en el programa actual

Mientras mas largos y complicados los programas Application Engine, tales como actualizaciones, no es comn tener mas de cien secciones. En lugar de desplazarse a travs del programa, use la funcin Go To.

Configurando las propiedades de las seccin

Los controles que especifican las propiedades de la seccin estn localizadas en las vista Definition. Por ejemplo para cada seccin que incluye en su programa, esta un nodo, como se muestra en el siguiente ejemplo, a partir de la cual usted especificara todos los atributos que se asocian con una seccin especfica.

Los valores que especificas en el nivel de la seccin generalmente aplican a todos los objetos contenidos dentro de la seccin. Atributo Section Name Descripcin Elaborar una convencin de nomenclatura y ser coherentes TM en todo su proyecto. Usted est limitado a ocho caracteres. Seleccione el mercado para el cual la seccin esta destinada. Si un mercado es irrelevante a su programa por batch (lotes), mantener el valor por defecto el valor de mercado de Global (GBL).

PDF Editor
54 |

Market

Procesos PeopleSoft
Atributo Platform Descripcin Seleccione la plataforma de la base de datos de para la definicin que esta se esta ejecutando. Deje el valor predeterminado para todas las secciones cuyas acciones definidas no son especficas para ninguna plataforma de base de datos. Para hacer una seccin particular de fecha-efectiva, ingrese la fecha. Especifique si una seccin est activa, o habilitada en tiempo de ejecucin. En el caso de una terminacin abrupta del programa, este valor se especifica al campo al reiniciar la seccin. Seleccione para especificar el nivel del commit de la seccin. Usted omitir el commit o tener un commit despus de que se complete exitosamente el Application Engine Seleccionar para habilitar la llamada a la seccin desde otro programa.

Effective Date

Effective Status

Section Type

Auto Commit

Public

Agregando pasos
Un paso representa la ms pequea unidad de trabajo que puede ser incluida en un programa. Cuando crea un programa, se tiene por default la seccin Main y un paso, inicialmente llamado step01.

Insertando pasos
1. Resaltar la seccin o el paso que necesite precede al nuevo paso. Por ejemplo, si quiere que el nuevo paso sea el primero en la seccin, seleccione el nodo. D lo contrario, seleccione le paso existente que quiera que sea el siguiente paso. 2. Seleccione Insert Step/action.

TM

PDF Editor
3. Especifica el nombre de un paso y los restantes valores.
55 |

Por default, los pasos tienen un nombre de StepN + 1 empezando con Step01. Renombre el paso para una mejor definicin del tipo de accin que contiene el paso.

Procesos PeopleSoft
Para renombrar el nombre del paso, posicione del cursor en el nombre del paso de el cuadro de dialogo e ingrese un nombre. Slo se acepta el nombre predeterminado para la creacin rpida, sencilla y programas con fines de capacitacin.

Configurando las propiedades de los pasos

Puede establecer las propiedades de paso en Definition view. Atributo Step Name Commit Definicin Ingrese un nombre (mximo ocho caracteres) Especifica el nivel del commit para el paso: Default: Seleccione para heredar cualquier nivel de COMMIT que ha especificado para la seccin en la que esta el paso. Later: Seleccione para posponer el COMMIT hasta que se produzca otro COMMIT. Aqu puede anular le nivel del Commit. After Step: Seleccione si tiene un nivel de COMMIT de NONE especificado en el nivel de seccin. De esta manera puede anular el nivel de COMMIT de la seccin y especificar un paso COMMIT dentro de una seccin con ningn otro COMMIT Frequency Habilitado slo cuando un paso contiene una de las siguientes acciones: Do While, Do Select, or Do Until. Introduzca la frecuencia numrica con la que PeopleSoft Application Engine debera hacer el COMMIT. Si ninguna, PeopleSoft Application Engine hace COMMITS cada N iteraciones y, a continuacin, de nuevo despus de la ltima iteracin. Especifica cmo la aplicacin PeopleSoft Engine debe responder a un error en el nivel de paso. En la rutina de error se comporta de la misma manera para SQL yTM acciones Peoplecode. El programa termina slo en los errores, y no en las advertencias. Abort: La aplicacin termina con error en los mensajes.

On Error

PDF Editor
56 |

Ignore: El programa contina pero registra un mensaje de

Procesos PeopleSoft
Atributo error. Suppress: El programa contina y no presenta mensajes de error. SQL: Por lo general, un programa termina si una declaracin SQL falla. Si selecciona Ignore o Suppress, los errores en la ejecucin de programas son suprimidos, pero los errores de compilacin continan hasta que el programa termine. Por lo tanto, si selecciona para reutilizar sobre la sentencia de actualizacion, el programa falla al compilar se la sentencia SQL es incorrecta, pero no falla en una duplicacin de llaves o error similar cuando se ejecuta el programa PeopleCode: Hay un error en el programa PeopleCode si el cdigo regresado satisface la sentencia If(nRet & PCM_ERROR) Status Seleccione para activar un paso. Si el paso es actualmente aplicable a su programa (y trabajo) probablemente querr que le mantenga activo. Definicin

Especificando las acciones

Esta seccin provee una especificacin de las acciones

Entendiendo las acciones

Hay ocho tipos de acciones que puedes incluir dentro de un paso, y un paso puede contener mltiples acciones. Las acciones que define para un paso dependen del resultado que el programa requiera en cada etapa de la ejecucin. Las nicas acciones mutuamente exclusivas dentro de un simple paso son llamadas secciones y sentencias SQL; no puede agregar una llamada a las acciones de la seccin que ya contenga acciones de SQL y viceversa. Puede incluir solo uno en cada tipo de accin dentro de un paso. Porque hay ocho tipos de acciones y dos TM son mutuamente excluyentes, el mximo nmero de acciones en un simple paso son siete.

PDF Editor
57 |

Accin orden de ejecucin

En tiempo de ejecucin, el sistema evala las acciones por tipo y las ejecuta dentro de una estricta jerarqua. Por ejemplo un Do When y Peoplecode existen dentro de un determinado paso. Application Engine siempre ejecuta el Do When primero

Procesos PeopleSoft
El siguiente diagrama muestra la secuencia y el nivel de ejecucin para cada tipo de accin:

A medida que se aaden acciones a un paso en Definition View las acciones son inicialmente insertadas despus de la definicin. Sin embargo, tras guardar una solicitud o un recargar una vista, el Designer reordena pedidos de todas las acciones para que coincida con la ejecucin jerrquica. Esta caracterstica le ayuda a visualizar la secuencia en la que cada paso de su programa ser ejecutado.

Insertando acciones
Para insertar una accin: 1. Resalte el paso en el que desea insertar la accin. 2. Insertar la accin. Seleccione insert Step/Action. Haga clic en el paso insertar y seleccione Step/Action. 3. Seleccione el tipo de accin desde el cuadro de lista desplegable, o cuando el tipo de accin actual est seleccionada, escriba el primer carcter, o de la accin TM deseada tipo, a continuacin, presione TAB. 4. Escriba una descripcin de la accin.

PDF Editor
5. Especificar las propiedades de la accin que ha seleccionado.
58 |

Procesos PeopleSoft
Configurando las propiedades de la accin
Para modificar las propiedades de accin, debe tener Definition view activa. Dado que puede incluir una variedad de acciones dentro de un paso, hay diferentes tipos de propiedades especficas para un tipo particular de accin. Dependiendo de la tipo de accin que seleccione, las propiedades que aparecen cambian. Por ejemplo, puede especificar el reutilizacin de caractersticas con una accin SQL. Esta caracterstica no aplica para una accin PeopleCode. La siguiente ilustracin muestra cmo se puede seleccionar las especficas para los diferentes tipos de acciones. propiedades

Gestionando los programas de Application Engine

Ejecutando programas de Application Engine
Entendiendo las opciones de ejecucin de un programa
Los programas del Application Engine se ejecutan en uno de los siguientes modos: modo batch utilizando PeopleSoft Process Scheduler, modo en lnea utilizando funciones PeopleCode y manualmente utilizando la lnea de comandos. La siguiente tabla lista algunas diferencias entre programas en lnea y programas batch: Ejecucin en lnea Empeza por la funcin CallAppEngine de PeopleCode Los programas se ejecutan rpidamente, sincrnicamente, y al azar Ejecuciones Batch Empeza a travs de PeopleSoft Process Scheduler Los programas se ejecutan a largo plazo de forma asincrnica y en tiempos previstos. TM Puede ser diseado para la ejecucin paralela Utiliza las tablas temporales de batch/dedicated.

Potencial para la ejecucin simultanea

PDF Editor
Utiliza la tabla temporal en lnea
59 |

Procesos PeopleSoft
Programas batch utilizando PeopleSoft Process Scheduler
Este es el modo tpico de ejecucin. Usted invoca programas que se ejecutan en este modo utilizando PeopleSoft Process Scheduler o la pgina de Application Engine Process Request. El modo batch tambin se conoce como ejecucin asincrnica, lo que significa que se ejecuta independientemente en el fondo. PeopleSoft Application Engine se ejecuta en cualquier sistema operativo que soporte PeopleSoft como un servidor de aplicacin. Si su sitio utiliza un sistema operativo que no es soportado por PeopleSoft Application Engine, usted debe ejecutar programas de Application Engine en el servidor de aplicaciones (La nica excepcin es OS/390 [z/OS]). Para ejecutar programas de Application Engine en el servidor batch, usted debe instalar BEA Tuxedo. Esto aplica tanto servidores batch UNIX y como Microsoft Windows NT. Si usted ejecuta su servidor batch en la misma maquina del servidor de aplicaciones entonces el servidor de aplicaciones y el servidor batch puede compartir una instalacin BEA Tuxedo. Si su servidor batch esta separado de su servidor de aplicacin, usted debe instalar BEA Tuxedo en su servidor batch. Los parmetros TOOLBINSRV en los archivos de configuracin del PeopleSoft Process Scheduler determinan donde PeopleSoft Process Scheduler invoca un programa Application Engine.

Programas en lnea utilizando PeopleCode

Los programas de Application Engine que se ejecutan en lnea son ejecutados tpicamente de una pgina con las funciones CallAppEngine de Peoplecode. Tal proceso en lnea es sncrono, lo que significa que los procesos posteriores esperan los resultados.

Programas manuales utilizando la lnea de comando

Normalmente, se utiliza esta tcnica solo durante las pruebas o si se necesita reiniciar el programa.

Creando las definiciones del proceso

Seleccione PeopleToolsProcess SchedulerProcesses para acceder a la pgina Process Process Definition.

TM

PDF Editor
60 |

Procesos PeopleSoft

Al utilizar PeopleSoft Process Scheduler para empezar programas batch en el Application Engine, debe crear una definicin de proceso para cada programa. Los programas Running Application Engine son muy parecidos a la ejecucin de cualquier programa de COBOL o SQR que usted invoca normalmente en PeopleSoft Process Scheduler. Utilice PeopleSoft Application Engine como la definicin de un tipo de proceso genrico. Cada programa de Application Engine que invoque utilizando PeopleSoft Process Scheduler requiere una nica definicin del proceso derivada de la definicin del tipo de proceso genrico.

Listando los parmetros del proceso de definicin

Acceda a la pgina Processes Process Definition Options.

TM

PDF Editor
61 |

Utilice esta pgina para la lista de parmetros. Aqu est la lista completa de parmetros:

Procesos PeopleSoft
ct MICROSFT cd %%DBNAME%% co%%OPRID%% cp %%OPRPSWD%% r %%RUNCNTLID%% i %%INSTANCE%% ai %%PRCSNAME%

Empezando programas con la pgina Application Engine Process Request

Usted puede empezar un programa Application Engine mediante el uso de la pgina Process Request. Utilizando esta pgina de solicitud permite especificar valores adicionales y parmetros que los que aparecen dentro de las definiciones de proceso de PeopleSoft Process Scheduler. La mayora de los usuarios inician los programas de Application Engine desde una pgina de solicitud de una aplicacin especfica utilizando el PeopleSoft Process Scheduler. Un experto en sistema, a veces, necesita crear procesos de solicitud estndar que requieren programas mltiples para realizar procesos en paralelo o que necesiten un conjunto especfico, iniciar valores en un State Record. Este es un ejemplo de donde podra utilizar la pgina de solicitudes de proceso del Application Engine.

Tablas utilizadas en la pgina Process Request.

El Process Request inserta valores dentro de las siguientes tablas. AEREQUESTTBL. Contiene todos los valores que aparecen en la pgina a excepcin de los parmetros en el grupo. AEREQUESTPARM. Incluye solo valores inciales en el State Record especificados del grupo de parmetros, TM si es necesario.

PDF Editor
62 |

Usted necesita para utilizar la pgina Application Engine Request, invocar un Application Engine e insertar filas en los registros requeridos del Application Engine solo si necesita realizar cualquiera de las siguientes tareas. Ingresar valores inciales en el State Record asociado con un programa en particular.

Procesos PeopleSoft
Establecer una fecha para el programa Application Engine para realizar procesamiento retroactivo. No establecer una marca por default para el programa. Configurar una imagen de tabla temporal para utilizarse si se presenta un proceso de solicitud PeopleSoft EPM que realice un proceso paralelo.

Requisitos de Application Engine

Seleccione Peopletools Application Engine Request Application Engine para acceder a la pgina Application Engine Request.

Atributo Process Origin

Descripcin Muestra donde fue invocado el programa: desde PeopleSoft Process Scheduler, desde lnea de comando , etc. Muestra el proceso asignado a la ejecucin del programa anterior Muestra el estado del ltimo programa que se ejecuto, si tiene xito, esta pendiente, etc. Especifica cuanto tiempo requiere que el proceso permanecer activo o valido:

Process Instance

Status

Process Frequency

TM

Always: Seleccione para correr el proceso como necesario.

PDF Editor
Dont: Seleccione para desactivar el proceso, para que nadie lo invoque y potencialmente corrompa los datos
63 |

Once: Seleccione si solamente requiere el proceso una vez.

Procesos PeopleSoft
Atributo As Of Date Descripcin Si requiere procesos retroactivos, especifique la fecha apropiada Introduzca el campo apropiado o la variable obligada para el cual se esta ingresando un valor Introduzca el valor inicial que desea establecer para el campo especificado

Bind Variable Name

Value

Utilizando el PeopleCode para invocar programas del Application Engine

Para llamar un programa particular del Application Engine de una pgina utilizando PeopleCode, utilice la funcin CallAppEngine en SavePreChange o SavePostChange PeopleCode. Sintaxis: CallAppEngine(applid [, Statereclist ] ); Se utiliza CallAppEngine si el programa que esta llamado es un proceso rpido. Debido a que el proceso es sincrnico, un usuario debe esperar por cualquier proceso invocado por CallAppEngine hasta que se complete, antes de hacer cualquier otra cosa. Si el programa llamado causa una demora injustificada, entonces utilice otra alternativa, como la funcion ScheduleProcess de PeopleCode Se utiliza CallAppEngine cuando tiene un negocio complejo e intenso en el que la mayora de los procesos corren en batch y en lnea, o el proceso requiere que se utilicen tablas temporales. Si este no es el caso, es mejor escribir el programa en PeopleCode. Si tiene lgica el PeopleCode para la ejecucin en lnea, y desea volver a utilizarlo en un programa batch, puede ser forzado a procesarlo fila por fila. Disee primero la lgica del batch, y entonces decida si tener una versin en lnea separada o solo rehusar el cdigo batch utilizando CallAppEngine. No utilice un CallAppEngine dentro de un paso de PeopleCode del Application Engine. Si usted necesita llamar un programa Application Engine de otro programa Application Engine, debe de utilizar la accin Call Section. TM No utilice CallAppEgine para controlar la operacin commit. Los programas llamados con CallAppEngine son incrustados dentro de una mayor unidad de trabajo definida por la pgina de activacin, tal como guardar una pagina.

PDF Editor
64 |

Procesos PeopleSoft
Utilizando la lnea de comandos para invocar programas Application Engine
Usted podra llamar programas de Application Engine a travs de la lnea de comandos en las siguientes situaciones: Reiniciando Cuando un programa truena, un administrador de sistemas podr reiniciar el programa utilizando la lnea de comandos. Si necesita, usted puede localizar todos los programas especficos y la informacin de los procesos del Process Monitor en el cuadro de dialogo del Process Request Detail. Desarrollo o prueba Muchos desarrolladores incluyen la lnea de comandos en archivos batch para lanzar los programas que estn desarrollando. De esta forma pueden fcilmente ejecutar los archivos batch como necesiten. Esto tambin permite la separacin del desarrollo de programas de aplicacin de sus pginas asociadas. Depuracin Para depurar un programa que se ejecuta en el servidor usted puede entrar al servidor y llamar al programa en la lnea de comandos. Para empezar un programa Application Engine en la lnea de comandos usted debe especificar el ejecutable Application Engine (PSAE.EXE) seguido por los parmetros requeridos, Ejemplo: psae -CT dbtype -CS server -CD database_name -CO oprid -CP oprpswd? -R run_control_id -AI program_id -I process_instance -DEBUG (Y|N)? -DR (Y|N) -TRACE tracevalue -DBFLAGS flagsvalue -TOOLSTRACESQL value? -TOOLSTRACEPC value -OT outtype -OF outformat -FP filepath

TM
O si las opciones lnea de comandos son almacenadas en el archivo de texto puede ingresar lo siguiente: Ejemplo:

PDF Editor
psae optfilename
65 |

Procesos PeopleSoft
Opciones de la lnea de comando
Atributo -CT Descripcin Especifica el tipo de base de datos al cual esta conectado (ORACLE, MICROSFT, SYBASE, INFORMIX, DB2UNIX, y DB2ODBC.) Requerido para Sybase e Informix. Para las plataformas que requieran un nombre del servidor como parte de singon, ingrese el nombre correcto. Esto afecta a Sybase, Informix, y Microsoft SQL Server. Sin embargo para Microsoft SQL Server, esta opcin es valida pero no requerida. -CD Introduzca el nombre de la base de datos para la cual el programa se conectara. Introduzca el ID del usuario que esta ejecutando el programa. Introduzca el password asociado con el ID especifico del usuario. Especifique el run control ID para este programa Especifique el programa de Application Engine para ejecutar Requerido para reiniciar. Introduzca el proceso para ejecutar el programa. El default es 0, lo que significa que PeopleSoft Application Engine utilice el siguiente proceso disponible Este parmetro controla las utilidades de depurador. Introduzca Y para indicar que usted quiere el programa a ejecutar este en modo de depuracin, o introduzca N para indicar lo contrario. TM Este parmetro controla la capacidad de reinicio. Introduzca Y para desactivar el reinicio, o introduzca N para activar el reinicio. Para permitir el rastreo desde la lnea de comando, introduzca este parmetro y un valor especfico de la seal.

-CS

-CO

-CP

-R -AI

-I

-DEBUG

-DR

PDF Editor
-TRACE
66 |

Procesos PeopleSoft
Atributo -DBFLAGS Descripcin Para deshabilitar %UpdateStats meta-SQL construct, ingrese 1. Habilita la seal de SQL. Habilita la seal de PeopleCode. (Opcional) iniciar el PeopleCode meta-variable %OutDestType (numerico). Ejemplo: &ProcessRqst.OutDestType = %OutDestType ; -OF (Opcional) Iniciar PeopleCode meta-variable %OutDestFormat (numrico). Ejemplo: Query.RunToFile(Record QryPromptRecord, %OutDestFormat); -FP (Opcional) Initialize the PeopleCode meta-variable %FilePath (cadena de caracter). Ejemplo: If All(%FilePath) Then &FILENAME = %FilePath | &FILENAME; &MYFILE = GetFile(&FILENAME, "E", %FilePath_Absolute); Else &MYFILE = GetFile(&FILENAME, "E", %FilePath_Relative); End-If;

-TOOLSTRACESQL -TOOLSTRACEPC -OT

TM

PDF Editor
optfilename
67 |

Si enva un archivo para PeopleSoft Application Engine como el primer parmetro en la lnea de comandos, Application Engine lee el contenido del archivo e interpreta

Procesos PeopleSoft
Atributo Descripcin el contenido como si fueran parmetros ingresados por la lnea de comandos .Esta opcin es destinada principalmente para ambiente de servidor Microsoft Windows NT o UNIX Process Scheduler

Depurando los programas de Application Engine

Activando el depurador de PeopleSoft Application Engine
Para ejecutar un programa en modo de depuracin: 1. Configurar la opcin de depuracin. Usted puede configurar la opcin de depuracin en las siguientes locaciones: Abra PeopleSoft Configuration Manager y seleccione la pestaa Process Scheduler. Si usted esta utilizando la opcin de lnea de comando para invocar a su programa de Application Engine, entonces puede incluir el parmetro DEBUG Y en la lnea de comendos y envelo a PSAE.EXE. Si usted tiene cdigo PeopleCode en su programa de Application Engine, habilite el depurador de PeopleCode. 2. Ejecute el programa del Application Engine para depurarlo. 3. En el prompt Application Engine Debugger ingrese un comando para habilitar la opcin de depuracin. Cada comando esta representado por una nica letra como X, L o M. Ingrese la letra que corresponde a la opcin que usted quiere ejecutar. Para ver la lista de opciones disponibles de depuracin, ingrese el smbolo ? en el prompt. Para habilitar el depurador de PeopleCode para Application Engine. 1. Acceda a las PeopleTools con el mismo usuario que utiliza cuando llama a los programas del Application Engine 2. Abra PeopleSoft Application Designer 3. Seleccione Debug PeopleCode Debugger Mode.

TM

PDF Editor
4. Seleccione Debug Break at Start
68 |

Esto causa que los programas de Application Engine truenen antes de ejecutar cualquier PeopleCode dentro del programa.

Procesos PeopleSoft
Definiendo las opciones de depuracin
Cada opcin de depuracin es representada por una letra sencilla que se especifica en el prompt. Para ejecutar la opcin que usted selecciono, presione ENTER.

Tips de depuracin
En algunos casos, como cuando se establecen interrupciones los submens ofrecen ms opciones. Despus de estar familiarizado con los comandos, puede introducir mltiples temas en la lnea de comando para combinar comandos y pasar por alto los submens. Los comandos de letras no distinguen entre maysculas o minsculas.

Opciones de depuracin
Opcin Quit Descripcin Ingrese Q. Esta opcin realiza un rollback y termina la depuracin. Esta opcin es valida solo despus de que un paso se ha completado y otro an no ha empezado. Ingrese C. para dar commit a la actual unidad de trabajo en su programa. Es valida solo despus de que un paso se ha completado y antes de que comience otro. Ingrese B, para establece un punto de interrupcin. Las opciones del Breakpoint incluyen: Set: Escriba S para establecer un punto de interrupcin para la localizacion. Unset: Introduzca U para eliminar los puntos de interrupcin establecidos anteriormente

Exit

Commit

Break

TM List: Ingrese L para enlistar los puntos de interrupcin.

Look

PDF Editor
Modify
69 |

Ingrese L. Puede especificar el nombre del campo en el State Record en el prompt Field Name. Ingrese M. Permite modificar el valor del State Record para propsitos de depuracin.

Procesos PeopleSoft
Opcin Watch Descripcin Ingrese W. Cuando especifique un campo como watch, el programa se detiene cuando el valor del campo cambia. Ingrese S. Ejecuta el paso actual hasta terminarlo y se detiene en el siguiente paso en la seccin actual Ingrese I. Use esta opcin para observar un paso o una seccin en un nivel mas granular. Ingrese O. Despus de que se ha aumentado un paso o seccin, utilice las opciones del Step Out of para ejecutar el resto del paso o la seccin y se detiene. Ingrese G. Despus de que el programa se detuvo en una locacin especfica y ha examinado su estado actual, usted puede utilizar el comando GO para resumir la ejecucin del programa. Ingrese R. Resume la ejecucin de su programa despus de que se ha detenido

Step Over

Step Into

Step Out of

Go

Run to commit

Restaurando los programas Application Engine

Una caracterstica clave de PeopleSoft Application Engine es la construccin de punto de restauracin y capacidad para restaurarse. Si hay una terminacin abrupta o un paso fallido en el programa, puede restaurar desde el ltimo punto de restauracin exitosa, o un paso antes del paso que fallo. Restaure el programa desde la pgina de solicitud de procesos. Los programas Application Engine guardan en la base de datos (ejecutando un commit) solo cuando un programa termina exitosamente. Puede establecer commits donde considere necesario. En el nivel de seccin, puede poner un commit despus de cada paso en la seccin. En el nivel de paso, puede exigir o aplazar los commits en cada paso, o puede aumentarlos en una iteracin con las acciones de ciclos dentro de un paso, como en acciones Do TM Select, o Do While.

PDF Editor
70 |

El nivel de commit que seleccione juega un papel importante cuando se restaura el programa. Cada vez que PeopleSoft Application Engine utiliza un commit permite restaurar el programa, en el registro actual. Utilizar la caracterstica de restaurar, permite que ejecute mas a menudo commits en un programa. Restaurar reduce todo el impacto en otros usuarios y procesos mientras el

Procesos PeopleSoft
programa de respaldo se ejecuta, debido a que reduce la cantidad de registros bloqueados por el programa, permitiendo que mltiples instancias del programa corran, lo que puede ser til en programas de altos volmenes de informacin. Con la restauracin, si ocurre una falla en cualquier punto del proceso, el usuario puede restaurar el programa y esperar que el programa se comporte de las siguientes maneras: Ignorar los pasos que estn completados hasta el ltimo commit. Empezar el procesamiento hasta el siguiente paso despus del ltimo commit exitoso. Cuando un programa se ejecuta, cada vez que PeopleSoft Application Engine establece un commit esto tambin guarda toda la informacin solicitada de un programa restaurado en el registro AERUNCONTROL.

Determinando cuando utilizar la restauracin

Usualmente, desea desarrollar programas para tomar ventaja de las capacidades de restauracin del PeopleSoft Application Engine. Los programas que son buenos candidatos para hacer uso de la restauracin son los que tiene que hacer muchas tareas, como tablas de unin y datos de carga en tablas de trabajo temporales. Como regla general, la restauracin es esencial para programas que principalmente hacen procesos Set-based. De cualquier manera, si su programa tiene una de las siguientes caractersticas, puede habilitar la restauracin: Procesar lnea por lnea Las cabeceras involucradas con PeopleSoft Application Engine ejecutan un checkpoint durante la ejecucin de un programa que no es deseado. El programa hace commit despus de N iteraciones en un ciclo, y la sentencia Select que maneja el ciclo esta compuesta de tal manera que termina y se inicia de nuevo, ignora procesos corrieron previamente.

Utilizando la restauracin a nivel de programa

TM El Application Engine automticamente realiza todas las actualizaciones del State Record. Cuando un programa Application Engine comienza, este inserta una fila en el State Record de una asignada instancia de proceso. Entonces el sistema actualiza el State Record siempre que el programa realice un commit para cambiar valores dentro de la base de datos.

PDF Editor
71 |

Procesos PeopleSoft
Utilizando la restauracin en el nivel de seccin
Si una seccin solo prepara datos, los selecciona, llena tablas temporales o actualiza las tablas temporales entonces configure el tipo seccin para Prepare Only. Pero, si la seccin actualiza permanentemente las tablas de aplicaciones en la base de datos, configure la opcin Critical Updates. Durante el tiempo de ejecucin, cuando el sistema llega a la primera seccin define el Critical Updates, y esta define el valor AE_CRITICAL_PHASE en el registro AERUNCONTROL como Y. una vez definido, el valor de AE_CRITICAL_PHASE sigue siendo Y hasta que el programa se complete exitosamente. Cuando el programa se completa, le fila correspondiente en AERUNCONTROL es eliminada.

Utilizando la restauracin en el nivel de pasos

En las sentencias Where del programa de una seccion Do Select, deben incluir condiciones que reduzcan la respuesta que regresa desde la sentencia Select. Ejemplo: SELECT RECNAME, FIELDNAME FROM PS_AE_RECFIELD ORDER BY RECNAME, FIELD NAME Si ejecuta este Select como parte de una accin DO Select con Restartable, como tipo Do Select, el sistema puede procesar algunas filas dos veces antes de iniciar. Por esto, si especfica Reselect, el programa puede ejecutar de manera infinita el ciclo, por que no hay nada para salir del ciclo. Sin embargo, si modifica la sentencia Select para que se parezca ms a la siguiente, puede hacerlo Restartable. Ejemplo: SELECT RECNAME, FIELDNAME FROM PS_AE_RECFIELD WHERE RECNAME > %BIND (RECNAME)

TM OR (RECNAME = %BINF (RECNAME) AND FIELDNAME > %BIND (FIELD NAME))

PDF Editor
72 |

ORDER BY RECNAME, FIELDNAME

Una accin do select que ha sido codificada para Restartable puede ser convertida a Select/Fetch, pero no de manera inversa.

Procesos PeopleSoft
Los ejemplos previos muestran el uso de una llave columna para reducir el grupo de respuestas. Esto puede ser conveniente si el record tiene solo uno o dos campos llaves. Sin embargo, si el record tiene dos o tres campos llaves, su SQL se convertir en algo complejo.

Controlando las terminaciones anormales

Un control de terminaciones anormales (a veces llamado un abend) significa que hay salidas del Application Engine por medio de una condicin de error calculado. Algunos ejemplos de abends (termino anormal) controlados son: Errores SQL mientras se define un Abourt en On Error. Un valor PeopleCode regresa, cuando en On Return se define un Abourt. Una sentencia SQL que no afecta a las filas, cuando se define un Abort en On No Rows. En estos casos el campo Run Status del Process Monitor leer Error. Una terminacin no controlada ocurre cuando se viola la memoria o un usuario termina un proceso. En este caso, el campo Run Status del Process Monitor muestra Processing.

Restaurando los programas del Application Engine

Hay dos formas de restaurar un programa del Application Engine Desde la lnea de comandos. Desde la pgina Process Request.

Restaurando desde la lnea de comando

Normalmente solo los desarrolladores utilizan la lnea de comando para restaurar programas del Application Engine. Los usuarios en la mayora de los casos no suelen ser expertos en este mtodo. Se puede utilizar la opcin de lnea de comando para restaurar un programa que se ejecuta en el servidor. El Application Engine referencia solo las instancias de los procesos en los procesos no exitosos. TM Para restaurar la aplicacin del comando de lnea

PDF Editor
73 |

1. Coleccione los valores de la lnea de comandos asociados con el programa fallido. Este valor incluye los tipos de base de datos, nombre de la base de datos, usuarios, password, run control ID, nombres del programas y las insyancias de

Procesos PeopleSoft
proceso. Usted puede encontrar estas variables en el cuadro de dilogo del Process Detalis, el correspondiente State Record o en la tabla del run control del Application Engine. Donde los valores dependen de cmo usted llama a los programas. 2. ingrese la siguiente lnea de comandos sustituyendo los valores del paso anterior. Ejemplo: PSAE.EXE CT DB_TYPE -CD RUN_CONTROL -AI PROGRAM DB_NAME -CO OPRID -CP PASSWORD -R

NAME I PROCESS_INSTANCE

Restaurando desde la pgina Process Request

Se pueden restaurar programas desde la pgina de Process Request solo para los programas que se ejecutan en el servidor. Para restaurar un programa del Application Engine desde una pagina de Process Request: 1. Abra PeopleSoft Process Scheduler, seleccione Peopletools Process Scheduler, System Process Request. 2. Localice el nmero del run control ID del programa que se restablecer. 3. Para mostrar los detalles de los procesos fallidos de clic en el hipervnculo Process Detail 4. En la pgina del Process Request Details, seleccione Restart Request y de clic en OK.

Empezando los programas de Application Engine desde el principio

Cuando un programa del Application Engine termina normalmente usted puede tiene que decidir si quiere restaurar el proceso o solo empezar desde el principio. Como su programa del Application Engine ejecuto al menos una parte puede dejar sus datos TM en un lugar desconocido.

PDF Editor
Para restaurar un programa Application Engine desde el principio:
74 |

Para empezar el programa desde el principio usted necesita utilizar SQL para eliminar los registros que correspondan al programa que fallo de la tabla del Run Control del Application Engine y su State Record.

Procesos PeopleSoft
1. Abra su editor SQL nativo y manualmente borre los records en la tabla PS_AERUNCONTROL que corresponda al programa que quiera empezar desde el principio. Utilice el siguiente SQL para lograr este paso. Ejemplo: DELETE FROM PS_AERUNCONTROL WHERE OPRID=OPRID AND RUN_CNTL_ID=Run_Control_ID 2. Elimine de su State Record los registros que correspondan al programa fallido. Utilice el siguiente SQL para lograr este paso. Ejemplo: DELETE FROM PS_MY_AET WHERE PROCESS_INSTANCE=Process_Instance

Habilitando y deshabilitando la restauracin

Para deshabilitar la restauracin utilice cualquiera de estos mtodos: Seleccione el Disable Restart en el cuadro de dialogo de Peoplesoft Application Engine. Para acceder a las propiedades del programa, seleccione File Definition Properties, y seleccione la petaa Advanced. Seleccione el Disable Restart en el perfil Configuration Manager. Para acceder al perfil, se abrir el Configuration Manager, seleccione la pestaa Propfile, y de clic en Edit. Despus seleccione la pestaa Process Scheduler. Incluya la opcin DR Y en la lnea de comando de PSAE.EXE.

TM

PDF Editor
75 |

Procesos PeopleSoft PeopleSoft Component Interface

Un Component Interface es una definicin de PeopleSoft PeopleTools que se crea en Application Designer. Este permite un acceso sncrono a un componente desde otra aplicacin.

Iniciando con PeopleSoft Component Interface

Un Component Interface es un conjunto de interfaces de aplicacin de programacin (APIs) que se pueden utilizar para acceder y modificar informacin de base de datos mediante programacin. PeopleSoft Component Interface expone un componente PeopleSoft (un conjunto de pginas agrupadas para propsitos de negocios) para un acceso sncrono desde otra aplicacin (PeopleCode, Java, C/C++ o Component Object Model [COM]). Un programa PeopleCode o un programa externo (Java, C/C++ o COM) pueden ver, entrar, manejar y acceder a datos del componente de PeopleSoft, la lgica y la funcionalidad de negocio. Adicionalmente, se puede utilizar el Component Interface Tester para revisar la validacin del Component Interface y el Excel al Component Interface Utility para manejar los datos. Los Component Interface son creados en Application Designer, as que debe asegurarse de estar familiarizado con las PeopleTools.

Introduccin al Component Interface

En este captulo se expondr: Arquitectura del Component Interface. Conceptos del Component Interface, como nombres y propiedades. Definicin del Component Interface en Application Designer.

Comprendiendo el Component Interface

Un Component Interface permite la exposicin de un componente PeopleSoft (un conjunto de pginas agrupadas para un propsito de negocio) para un acceso sncrono desde otra aplicacin (como PeopleCode, Java, C/C++, COM, o XML). Los Component Interface pueden ser utilizados para integrar una aplicacin con otra o con sistemas TM externos. Los Component Interface ejecutan la lgica de negocio construida en el componente y como resultado, proporcionan un nivel ms alto de validacin de datos que un simple SQL. Se pueden crear mltiples Component Interface para el mismo componente. Cuando se crea un Component Interface en Application Designer. Los campos del registro en el

PDF Editor
76 |

Procesos PeopleSoft
componente son mapeados a las llaves y propiedades del Component Interface. Los mtodos son utilizados para encontrar, crear, modificar y borrar datos.

Arquitectura del Component Interface

La arquitectura del Component Interface comprende tres elementos fundamentalescomponentes, Component Interface y el Component Interface API. Cada Component Interface tiene los siguientes atributos principales: Nombre Llaves (obtener, crear y encontrar llaves) Propiedades y Colecciones (fields y records) Mtodos

Atributos del Component Interface

Nombre Cada Component Interface requiere un nombre nico que es especificado cuando el Component Interface es creado. Los programas llamados utilizan el nombre del Component Interface para acceder a las propiedades y mtodos. Llaves Las llaves son propiedades especiales que contienen valores que recuperan una instancia (obtener llaves) o una lista de instancias (encontrar llaves) del Component Interface. Cuando se crea un nuevo Component Interface, obtener (get) y encontrar (find) llaves son creadas basadas en la bsqueda de la definicin del registro para el componente. Sin embargo, se pueden agregar, eliminar o cambiar las llaves en Application Designer. Propiedades Las propiedades proporcionan acceso tanto a los datos del componente como a la configuracin del Component Interface. Los Component Interface incluyen dos tipos de propiedades: estndar y definidas por el usuario (user-defined). TM Propiedades Estndar son asignadas automticamente cuando un Component Interface es creado. Las propiedades estndar pueden estar definidas como verdaderas o falsas. Estas propiedades no son mostradas en Application Designer.

PDF Editor
77 |

Procesos PeopleSoft
Propiedades Definidas por el Usuario mapean los campos del registro en el Component Interface y son mostrados en Application Designer. Una propiedad puede corresponder a un campo o a un scroll. Se tiene control sobre las propiedades definidas por el usuario las cuales son incluidas en el Component Interface. Colecciones Una coleccin del Component Interface es un tipo especfico de propiedad que corresponde a un scroll. Por default cada coleccin utiliza el nombre del registro primario para el scroll subyacente. Mtodos Un mtodo es una funcin que realiza una tarea especfica en un Component Interface en un tiempo de ejecucin. Existen dos tipos principales de mtodos: estndar y definidos por el usuario. Por ejemplo, los mtodos se pueden utilizar para guardar o crear una nueva orden de compra. El acceso al tiempo de ejecucin para cada mtodo es determinado por la seguridad que se tenga para ese mtodo especfico. Mtodos Estndar son aquellos que son disponibles para todos los Component Interface. Los mtodos de Find, Get, Save y Cancel son generados automticamente por el Application Designer cuando un nuevo Component Interface es creado. En el Component Interface, los mtodos estndar son resaltados en gris. Mtodos definidos por el usuario son creados en Application Designer para proporcionar funcionalidad aadida al Component Interface. Estos mtodos son funciones que son hechas accesibles a travs del Component Interface. Cada funcin mapea un mtodo definido por el usuario. En el Component Interface estos mtodos son resaltados en azul.

Definiciones y vistas del Component Interface

Se puede crear, modificar y revisar la definicin del Component Interface utilizando Application Designer. Cuando trabaja con una definicin del Component Interface en TM del Application Designer, se puede observar que la vista del componente se encuentra lado izquierdo, y la vista del Component Interface se encuentra del lado derecho.

PDF Editor
78 |

La siguiente pantalla muestra las vistas del componente y del Component Interface en Application Designer.

Procesos PeopleSoft

La vista del componente muestra los registros y scrolls utilizando un rbol de la representacin. Arrastre los campos y colecciones que desee exponer a la vista del Component Interface. La vista del Component Interface muestra las llaves, propiedades y mtodos, utilizando un rbol de representacin. Cuando un Component Interface es abierto, las propiedades son mostradas en el orden en el cual stas aparecen en la vista del componente. El rbol tanto en la vista del componente como en la del Component Interface tiene diferentes conos. Algunos conos son utilizados tanto en la vista del componente y en la del Component Interface con significados ligeramente diferentes. A continuacin se explica el significado de cada icono y columna en la vista del Component Interface.

Iconos del Component Interface

cono Component Interface. Grupo de llaves. Descripcin

TM
Propiedad que es un campo llave desde el registro.

PDF Editor
Llave de bsqueda alterna. Grupo de Propiedades o Mtodos.
79 |

Procesos PeopleSoft
cono Coleccin. Propiedad o mtodo definido por el usuario. Mtodo Estndar. Propiedad que indica que es un campo requerido para el registro. Elemento en un Component Interface que no est en sincrona con el Componente. Descripcin

Columnas del Component Interface

Nombre Name Descripcin Nombre de un elemento especfico en un Component Interface (como el nombre de una propiedad o un mtodo). El nombre por default para las propiedades de los campos es el nombre del campo. El nombre por default para las colecciones es el nombre primario del record. Nombra el record en el cual un elemento especfico es basado. Si el nombre del record cambia el Component Interface continua con registro apropiado Nombre del campo al cual la propiedad del Component Interface hace referencia. Como con el nombre del registro, el campo tambin puede cambiar y el Component Interface contina con el campo apropiado. Y en esta columna indica que una propiedad especfica ha sido marcada de slo lectura. Identifica comentarios que existen en el cuadro de Edit TM Property para las llaves, colecciones o propiedades.

Record

Field

Read Only

Comment

PDF Editor
Desarrando un Component Interface
Este captulo expondr como:
80 |

Nota. En la vista del Component Interface, las propiedades aparecen en el mismo orden como aparecen en el componente y no estn ordenadas alfabticamente

Procesos PeopleSoft
Crear un Component Interface. Utilizar llaves, propiedades, colecciones y mtodos del Component Interface. Validar el Component Interface. Configurar la seguridad del Component Interface. Probar el Component Interface. Comprender consideraciones de tiempo de ejecucin.

Creando la definicin del Component Interface

Como cada Component Interface se refiere a un componente, se debe conocer la estructura del componente por el cual se est construyendo un Component Interface. Se puede utilizar un componente existente o bien crear uno nuevo. Muchas partes del Component Interface, tales como las llaves, son creadas en base a la configuracin en el componente de referencia.

Creando un nuevo Component Interface

TM
1. Selecciona del men de Application Designer FileNew. 2. Selecciona Component Interface. 3. Selecciona el componente en el cual este Component Interface estar basado.

PDF Editor
81 |

Procesos PeopleSoft
Despus de seleccionar el componente apropiado, aparece un mensaje en el cual pregunta si se desea que los campos expuestos en el componente seleccionado tengan las propiedades por default del Component Interface. 4. Haga clic en Yes para confirmar las definiciones de propiedades por default o No si no se quiere ninguna propiedad creada inicialmente. Si se elije tener las definiciones de propiedades automticamente por default por el sistema, todas las propiedades que aparecen en las pginas del componente son aadidas al Component Interface. Incluso aunque el sistema agrega las propiedades por default, quizs se necesita mover otras propiedades a la vista del componente para que este funcione. 5. Guarde el Component Interface.

Asociando un Component Interface con un men

TM
1. Seleccione FileOpen desde Application Designer para abrir un Component Interface existente. 2. Seleccione FileDefinition Properties desde el men de Application Designer. 3. Seleccione el nombre del men apropiado para este Component Interface.

PDF Editor
82 |

Procesos PeopleSoft
Determinando cuales campos exponer
La primera vez que se arrastra un scroll del componente a la vista del Component Interface, el sistema utiliza las siguientes reglas para determinar que propiedades exponer: Las llaves son expuestas solo en el nivel mas alto de la coleccin en la cual stas aparecen Asegrese de no borrar las propiedades dentro de la coleccin ya que esto traera como resultado una coleccin vaca. Si existen colecciones vacas, elimnelas; de lo contrario, aparecern con X en la vista del Component Interface. No exponga campos que no son visibles en la vista del componente.

Utilizando llaves
La siguiente tabla muestra los tres tipos de llaves del Component Interface: Tipo de llave Get keys Caractersticas de llave Estas llaves automticamente mapean la bsqueda de encontrar llaves (field keys) en el componente. Se puede cambiar Get keys solo si se modifican las llaves del componente despus de crear un Component Interface. Estas mapean tanto los campo llave como los campos llave de bsqueda alterna. Se puede eliminar cualquier Find Keys basado en campos llave de bsqueda alterna que no se quieran hacer disponibles para bsqueda. Si el componente permite la accin Add, Create Keys son generadas por el Component Interface automticamente.

Find keys

Create keys

Cada bsqueda de campo llave produce un Get key y un Find key. Cada bsqueda de campo llave tambin produce un Create key si el componente permite el modo Add. TM Cada campo llave de bsqueda alterna produce un Find key.

PDF Editor
Agregando y borrando llaves
Para agregar una llave
83 |

Procesos PeopleSoft
1. Expandir la coleccin de la llave de bsqueda (la primera coleccin) en la vista del componente. 2. Arrastrar la llave a la vista del Component Interface. Para borrar una llave 1. Seleccionar la llave en la vista del Component Interface. 2. Presionar DEL Key.

Propiedades de configuracin
Esta seccin expone como: Crear propiedades definidas por el usuario Borrar propiedades Renombrar propiedades Nombrar propiedades del Component Interface.

Propiedades estndar
Las propiedades estndar no aparecen en la vista del Component Interface en el Application Designer. La siguiente tabla nombra y define las propiedades estndar del Component Interface: Nombre CreateKeyInfoCollection Descripcin Regresa una coleccin de elementos que describen las llaves Create. Esta propiedad es slo de lectura. Regresa una coleccin de elementos que describen las llaves Get. Esta propiedad es de slo lectura. Regresa una coleccin de elementos que describen las llaves Find. Esta propiedad es de slo lectura. Controla si el componente se ejecuta en modo TM Update/Display o modo Correction cuando el componente es de fecha efectiva. Si GetHistory es definido como verdadero, los datos pueden ser recuperados pero no modificados. El valor por default es Falso. Esta propiedad es de slo lectura.

GetKeyInfoCollection

FindKeyInfoCollection

GetHistoryItems

PDF Editor
84 |

Procesos PeopleSoft
Nombre EditHistoryItems Descripcin Controla si el Component Interface se ejecuta en modo Update/Display All , Update /Display o Correction cuando el componente es de fecha efectiva. Si los elementos EditHistory son definidos como verdaderos, entonces los datos pueden ser modificados, los elementos EditHistory trabajan en conjunto con los elementos GetHistory. El valor por default es Falso. Esta propiedad es slo de lectura. InteractiveMode Controla si los valores se aplican y las reglas de negocio se ejecutan inmediatamente, o si los elementos estn en espera y las reglas de negocio se ejecutan despus en un paso individual. El valor por default es falso. Esta propiedad es de solo lectura. StopOnFirstError Cuando esta propiedad es definida como verdadera, el primer error generado por el Component Interface detiene el programa. El valor por default es falso. Esta propiedad es de solo lectura CompIntfcName Regresa el nombre de la clase de Component Interface como es nombrado en el Application Designer. Esta propiedad es de solo lectura. Regresa el nombre de la clase de Component Interface como es nombrado en el Application Designer. Esta propiedad es de solo lectura. (Acta igual que CompIntfcName) Regresa la descripcin de la clase de Component Interface como esta definida en el Application Designer. Esta TM propiedad es de solo lectura. Regresa la configuracin de mercado del componente utilizado para construir el Component Interface. Esta propiedad es de solo lectura.

ComponentName

Description

Market

PDF Editor
GetDummyRows
85 |

Cuando un nuevo scroll es insertado en una pgina, este

Procesos PeopleSoft
Nombre Descripcin scroll es mostrado aunque no tenga dato. Cualquier scroll que este vaco tiene una fila dummy con solo la definicin por default. Si esta propiedad es verdadera y se muestra la fila dummy, si es fals no se muestra la fila dummy. El valor por default es verdadero y es de lectura y escritura. Regresa una coleccin de elementos que describen una propiedad especfica. Esta propiedad es de solo lectura.

PropertyInfoCollection

Los objetos CompIntfPropInfoCollection soportan las siguientes propiedades: Nombre Name Descripcin Esta propiedad regresa el nombre del objeto como una cadena si se ejecuta la propiedad. Esta propiedad es de solo lectura. Esta propiedad regresa el Record Name asociado con el objeto, ejecutando la propiedad. Esta propiedad es de solo lectura. Esta propiedad regresa el Field Name asociado con el objeto, ejecutando la propiedad. Esta propiedad es de solo lectura. Esta propiedad regresa el valor del campo del registro LongName como una cadena. Si hay un componente anulado para este valor, este no ser incluido. Esta propiedad es de solo lectura. Esta propiedad regresa el valor del campo del registro ShortName como una cadena. Si hay un componente anulado para este valor, este no ser incluido. Esta propiedad es de solo lectura. Esta propiedad regresa verdadera si el objeto es una coleccin de datos, ejecutando la propiedad, y falso en TM caso contrario. Esta propiedad es de solo lectura. Regresa el tipo del campo como un nmero del objeto. Esta propiedad es de solo lectura. Regresa el tipo del campo como un nmero del objeto. Esta propiedad es de solo lectura. (Igual que Type).

RecordName

FieldName

LabelLong

LabelShort

IsCollection

PDF Editor
OAType
86 | Qualsys Consulting

Type

S.C

Procesos PeopleSoft
Nombre Format Descripcin Regresa el formato del campo del objeto en un nmero, ejecutando la propiedad. Esta propiedad es de solo lectura. Regresa verdadera si el objeto, ejecutando la propiedad, es una llave. Esta propiedad es de solo lectura. Regresa verdadera si el objeto, ejecutando la propiedad, es una propiedad requerida. Esta propiedad es de solo lectura. Regresa verdadera si el objeto, ejecutando la propiedad, es asociado con una tabla XLAT. Esta propiedad es de solo lectura. Regresa verdadera si el objeto, ejecutando la propiedad, es asociado con la tabla Yes/No. Esta propiedad es de solo lectura. Regresa verdadera si el objeto, ejecutando la propiedad, es asociado con una tabla prompt. Esta propiedad es de solo lectura. Regresa la longitud del objeto, ejecutando la propiedad. Esta propiedad es de solo lectura. Regresa la posicin decimal del objeto, ejecutando la propiedad. Esta propiedad es de solo lectura. Regresa verdadera si la propiedad es marcada como solo lectura en la definicin del Component Interface. Esta propiedad es de solo lectura. Regresa verdadera si el objeto, ejecutando la propiedad es una llave alterna. Esta propiedad es de solo lectura. Regresa verdadera si el objeto, ejecutando la propiedad es asociado con una List Box. Esta propiedad es de solo TM lectura.

Key

Required

Xlat

Yesno

Prompt

Length

DecimalPosition

IsReadOnly

Altkey

Listboxitem

PDF Editor
87 |

Creando propiedades definidas por el usuario

Las propiedades son aquellas propiedades en el componente que estn expuestas a travs del Component Interface. Las propiedades definidas por el usuario son derivadas

Procesos PeopleSoft
del componente al cual el Component Interface esta asociado y debe ser aadido manualmente. Para crear una propiedad definida por el usuario, arrastre un registro, campo o scroll desde la vista del componente a la vista del Component Interface. En la vista del Component Interface, no importa donde los inserte, porque cuando el Component Interface es abierto, el sistema convierte automticamente el campo o registro en la propiedad del Component Interface y lo coloca en el lugar adecuado dentro de la lista de las propiedades. Cuando se arrastra una definicin de la vista del componente a la del Component Interface, todas las definiciones se colocan en el Component Interface automticamente. Cuando estas propiedades son agregadas al Component Interface, se puede eliminar cada propiedad individualmente, si se desea.

Eliminacin de propiedades
Para eliminar una propiedad: 1. Seleccione la propiedad que desee eliminar 2. Presione la tecla DEL o haga clic derecho y seleccione Delete.

Renombrar las propiedades definidas por el usuario

Los nombres de las propiedades son generados automticamente en funcin a los campos correspondientes del componente. Cambiar el nombre de una propiedad no cambia el campo al que las propiedades hacen referencia.

Para renombrar una propiedad:

TM 1. Haga doble clic en el nombre de la propiedad o clic derecho en el nombre de la propiedad y seleccione Edit Name desde el men emergente.

PDF Editor
2. Introduzca el nuevo nombre de la propiedad. 3. Agregue comentarios que puedan ser tiles.
88 |

Procesos PeopleSoft
4. Seleccione la casilla de Read-Only para hacer esta propiedad de slo lectura.
Nota. Application Designer genera un error si detecta que un Component Interface tiene propiedades con el mismo nombre cuando se crea, guarda o abre el Component Interface.

Creando las propiedades de referencia

Cada Component Interface es aislado e inconsciente de otros Component Interface en el sistema. Para acceder y actualizar informacin desde otros Component Interface, las referencias establecen relaciones entre los Component Interface. Cree una propiedad de referencia en un Component Interface para acceder datos expuestos en otro Component Interface. Para acceder al cuadro de texto Create Reference haga clic derecho en la propiedad y seleccione Create Reference.

El cuadro de texto Create Reference tiene los siguientes campos: Nombre Name Descripcin

TM

PDF Editor
Related Component Interface Designa el Component Interface referenciado desde el actual Component Interface.
89 |

Describe el nombre de la referencia que se est creando.

Procesos PeopleSoft
Nombre Comments Descripcin Introduce cualquier comentario para mantener la referencia. Mapea la propiedad desde el Component Interface a la propiedad seleccionada de ste. Apoya objetos que pueden ser seleccionados como valores de propiedades de referencia definidas.

Related Key Mapping

Valid Reference Path

Creando las propiedades de slo lectura

Se puede hacer cualquier propiedad de slo lectura. En el tiempo de ejecucin, el valor de una propiedad de slo lectura podr ser ledo pero no actualizado. Para hacer una propiedad de slo lectura: 1. Seleccione la propiedad 2. Seleccione EditToggle Read Only Access desde el menu de Application Designer

Trabajando con colecciones

Una coleccin es una propiedad que apunta a un scroll en el componente. Las colecciones se crean de la misma manera que se crean las propiedades (arrastre el scroll desde la vista del componente a la vista del Component Interface). Considere los siguientes puntos cuando cree colecciones: Cuando arrastre un scroll a la vista del Component Interface, todos los scrolls asociados vienen con ste. Este es el mismo comportamiento que se esperara cuando se crea una propiedad. Las propiedades asociadas son siempre aadidas automticamente cuando se arrastra un campo desde la vista del componente la vista del Component Interface. Despus de que la propiedad o coleccin ha sido creada, t puedes borrar propiedades individuales asociadas o colecciones manualmente si es necesario. TM Cuando se arrastra un scroll a la vista del Component Interface, todos los campos del registro contenidos en ese scroll vienen con l. Los campos en ese nivel de scroll estn expuestos como parte de la misma coleccin.

PDF Editor
90 |

Procesos PeopleSoft
Cuando se arrastra un scroll hijo a la vista del Component Interface, las colecciones padres son creadas automticamente.

Trabajando con mtodos

Esta seccin explicar como: Habilitar y Deshabilitar mtodos estndar. Crear mtodos definidos por el usuario.

Trabajando con funciones y mtodos de sesin.

Las funciones y mtodos de sesin conectan a una sesin en un servidor de aplicacin. Esta conexin debe ser realizada antes de poder utilizar los mtodos del Component Interface.

Funciones de sesin del Component Interface.

Nombre CreateSession Descripcin Regresa un objeto de sesin.

Mtodos de sesin del Component Interface

Nombre Connect getCompIntfc Descripcin Lo conecta al servidor de la aplicacin. Regresa una referencia a un Component Interface.

Mtodos estndar
Un mtodo es una definicin que realiza una funcin especfica en un Component Interface al momento de ejecucin. Cada mtodo estndar es aadido por default cuando el Component Interface es creado y esta disponible en PeopleCode u otros lenguajes de programacin. Como las propiedades, los mtodos son guardados como parte de un Component Interface. Existen dos tipos de mtodos: los mtodos estndar y los definidos por el usuario. Nombre Cancel Descripcin

TM

PDF Editor
Create Crea una nueva instancia de un Component Interface.
91 |

Regresa al Component Interface actual, cancelando los cambios hechos desde la ltima vez que fue guardado. Regresa verdadero si fue exitoso, y falso en caso contrario.

Procesos PeopleSoft
Nombre Descripcin Regresa verdadero si fue exitoso y falso en caso contrario. Realiza una bsqueda de llave parcial de una instancia particular de un Component Interface, utilizando las llaves de bsqueda del nivel 0. Recupera una instancia particular de un Component Interface. Regresa verdadero si fue exitoso y falso en caso contrario. Guarda una instancia de un Component Interface. Regresa verdadero si fue exitoso y falso en caso contrario. Regresa el valor de una propiedad que es especificada por el nombre. Esta funcin es utilizada normalmente solo en aplicaciones que no pueden obtener el nombre del Component Interface. Define el valor de una propiedad que especificada por el nombre. Esta funcin es utilizada normalmente solo en aplicaciones que no pueden definir los nombres de las propiedades del Component Interface, hasta el tiempo de ejecucin. Regresa informacin especfica, como longitud, sobre la definicin de una propiedad que es especificada por el nombre. Esta funcin es utilizada normalmente solo en aplicaciones que no pueden obtener los nombres de las propiedades del Component Interface, hasta el tiempo de ejecucin.

Find

Get

Save

GetPropertyByName

SetPropertyByName

GetPropertyInfoByName

Por default cada Component Interface es creado con 4 mtodos estndar (Cancel, Find, Get y Save).

TM

PDF Editor
92 |

Procesos PeopleSoft
Habilitar y deshabilitar mtodos estndar

Para habilitar o deshabilitar mtodos Standard: 1. Seleccione FileDefinition Properties desde el men de Application Designer. 2. Seleccione la pestaa de Standard Methods

Creando mtodos definidos por el usuario

Esta seccin expone como crear mtodos definidos por el usuario.

TM

PDF Editor
93 |

Procesos PeopleSoft
Para crear un mtodo definido por el usuario: 1. Haga clic derecho en cualquier parte de la vista del Component Interface. 2. Seleccione View PeopleCode desde el men emergente. Aparece el editor del PeopleCode. Si est utilizando un nuevo Component Interface, el PeopleCode no aparecer en el editor porque los mtodos definidos por el usuario no han sido creados. 3. Escriba las funciones requeridas del PeopleCode. Las funciones del PeopleCode que usted escribe son almacenadas en un programa PeopleCode que es adjunto al Component Interface y asociado con el evento Methods.
Nota. Un nuevo mtodo definido por el usuario no aparece en la lista de mtodos hasta que guarde el Component Interface. Haga doble clic en el icono de cualquier mtodo definido por el usuario para regresar a ste programa PeopleCode.

4. Defina los permisos para los mtodos que cre. Se deben definir permisos para cada mtodo definido por el usuario. Si se definen los permisos a Full Access, al ejecutarse esa funcin esta expuesta a sistemas externos como un mtodo en el objeto del Component Interface.

Validacin de un Component Interface

La validacin asegura que la estructura del Component Interface an sea vlida. La estructura de un Component Interface puede convertirse en invlida debido a los cambios estructurales del componente y a sus modificaciones. Por ejemplo, puede suceder siempre y cuando un componente elimina o agrega un registro o un campo. Esto puede pasar si las llaves en el componente son aadidas o eliminadas.
Nota. EL proceso de validacin slo determina si el componente de un Component Interface ha cambiado, no valida el PeopleCode que es asociado con el Component Interface. Para validar el PeopleCode, abra el componente y seleccione ToolsValidate del men del Application Designer.

Para corregir un componente invlido, se tienen que borrar las propiedades por las cuales no hay campos o registros. Si la estructura del componente de origen ha cambiado, tendr que borrar las propiedades viejas y agregar las nuevas propiedades TM en sus lugares adecuados. Tambin quizs necesite renombrar la propiedad o la coleccin.

PDF Editor
Para validar un Component Interface: 1. Abra el Component Interface en Application Designer
94 |

Procesos PeopleSoft
La validacin ocurre automticamente siempre que se abra un Component Interface en Application Designer. 2. Seleccione ToolsValidate from Consistency desde el men de Application Designer.

Configurando las opciones de seguridad

Despus de crear un Component Interface, se debe configurar la seguridad para ste. La seguridad para el Component Interface es proporcionada a travs de las pginas de PeopleSoft Internet Architecture. Los permisos del Component Interface se establecen en la lista de permisos de la seguridad de PeopleSoft.

Para establecer la seguridad del Component Interface 1. Acceder a PeopleSoft Pure Internet Arquitecture a travs del navegador y seleccionar PeopleToolsSecurityPermissions & RolesPermission Lists. 2. Seleccionar la lista de permisos para el cual se desee establecer la seguridad 3. Acceder a la pgina de Component Interface. 4. Seleccionar el Component Interface para el cual se desee establecer seguridad. Si desea agregar otro Component Interface a la lista, haga clic en el botn Add. 5. haga clic en Edit. 6. Establece el permiso de acceso para cada mtodo.

TM

PDF Editor
7. Haga clic en OK cuando haga hecho todo lo anterior.
95 |

Seleccione Full Access o No Access. Debe conceder Full Access a por lo menos un mtodo para hacer el componente disponible para pruebas y otros usos en lnea.

Procesos PeopleSoft
8. Guarde la pgina.

Probando el Component Interface

Despus de establecer la seguridad para el Component Interface, se procede a probar los contenidos y el comportamiento utilizando el Component Interface de pruebas. Se debe probar el Component Interface antes de utilizarlo en el sistema externo. Esta herramienta ayuda a descubrir problemas en el componente o en el Component Interface. Cuando se est probando un Component Interface datos reales de la base de datos son utilizados. Por tanto, si se guarda la informacin que se cambi llamando el mtodo de Save, la informacin es cambiada en la base de datos.

Bsqueda de un Component Interface

Para probar el Component Interface, primero se realiza la bsqueda del Component Interface a probar, y despus se prueba. Acceder al Component Interface Tester

Buscar el Component Interface para probarlo: 1. Abrir el Component Interface en Application Designer.

TM

PDF Editor
96 |

2. Seleccionar ToolsTest Component Interface desde el men de Application Designer. El Component Interface Tester muestra en pantalla las llaves (en la columna del lado izquierdo) para obtener, crear o encontrar una instancia del Component

Procesos PeopleSoft
Interface. La columna del lado derecho proporciona un espacio para introducir los valores de las llaves a probar. 3. Introducir los valores de las llaves. Los datos que son utilizados para la prueba corresponden a los valores de las llaves que se introducirn aqu. Nombre Interactive Mode Descripcin En el modo interactivo cualquier accin requerida ocurre inmediatamente. Cada propiedad siendo configurada causa un envo inmediato al servidor de aplicacin. Esto difiere un modo no interactivo en el cual las acciones a menudo son ocultas y enviadas ms tarde en batches. Por ejemplo, en el modo no interactivo si se configura una propiedad, sta no es validada hasta realizar el momento de guardar. Sin embargo, en el modo interactivo la propiedad es validada inmediatamente. En el modo no interactivo, los errores y propiedades no son actualizados hasta que el mtodo es ejecutado. Get History Items Esta opcin recupera datos, aplica en los campos de fecha efectiva y es equivalente a ejecutar el modo Update/Display o Update/Display All Habilita la opcin de borrar y guardar datos. Aplica para campos de fecha efectiva y es equivalente a ejecutar en el modo Update/Display o Correction Esta opcin es seleccionada por default. El procesador del componente proporciona lneas dummy para permitir la entrada de datos rpida cuando al nivel al que se accediendo no tiene ningn dato. Es equivalente a abrir un registro en modo Update/Display o Correction. Este recupera una instancia de la base de datos. TM Es equivalente a crear una nueva lnea en el modo Add.

Edit History Items

Get Dummy Rows

Get Existing

Create New

PDF Editor
Obtencin de registros existentes utilizando llaves parciales
97 |

Si se quiere recuperar una llave parcial, haga clic en el botn Find. El cuadro de dilogo Find Results aparece:

Procesos PeopleSoft

Se puede elegir la instancia especfica seleccionando el botn Get Selected. Si no introduce una llave parcial antes de dar clic en Find, todos los valores de las llaves en la base de datos son regresados. Esto es lo mismo que llamar el mtodo Find a travs del Component Interface API; continuando por seleccionar un valor del Find Results, configurando el Get Key y llamando el mtodo Get. Despus de hacer clic en el botn Get Selected, el cuadro de dilogo del Component Interface Tester aparece.

Prueba del Component Interface

Prueba de las propiedades de Component Interface

TM

PDF Editor
Si hay errores se mostrarn en el rea Error Message Log.
98 |

Desde el cuadro de dilogo del Component Interface, cambie el valor de una propiedad, haga doble clic en un valor e introduzca un nuevo valor. Esta validacin incluye los eventos FieldChange y Field Edit de PeopleCode. La validacin debe ser hecha cuando el mtodo Save es llamado (SaveEdit, SavePreChange, Workflow, y SavePostChange).

Procesos PeopleSoft
Prueba de los mtodos de Component Interface
Pruebe los mtodos del Component Interface haciendo clic derecho en el nombre del componente. Un men emergente aparece mostrando los mtodos estndar Save y Cancel y mtodos definidos por el usuario que existen para el Component Interface. Los mtodos estndar Find, Create y Get no son vlidos para una instancia del componente y por lo tanto no son mostrados. Si un mtodo de Component Interface requiere uno o ms parmetros, un cuadro de dilogo aparece para introducirlos. Despus de que el mtodo es ejecutado, el mismo cuadro de dilogo aparece, mostrando los cambios a los parmetros que fueron causados por el mtodo. Si un Component Interface no requiere parmetros.

Probando los mtodos de coleccin

La prueba de los mtodos de coleccin se realiza dando clic derecho en el nombre de la coleccin. Para que aparezca un men pop-up se deben mostrar los mtodos de coleccin estndar. Seleccione el mtodo de coleccin que desee para probar este Component Interface. Ingrese un nmero de objeto para el mtodo de coleccin que esta utilizando. Este valor que esta utilizando puede regresar, insertar o borrar un objeto, de acuerdo a las siguientes reglas. Despus de ingresare l nmero, el resultado aparecer en el cuadro de dialogo. Si se TM regresa un valor, este se mostrara en el titulo de la barra. En caso contrario se mostrara un NO. De clic en OK o Cancel para cerrar el cuadro de dialogo.

PDF Editor
Reglas del mtodo de coleccin
La siguiente tabla contiene las reglas del mtodo de coleccin:
99 |

Procesos PeopleSoft
Nombre del mtodo Item (index) Descripcin Regresa la lnea del ndice indicado. Solo el xito o fracaso de esta rutina es interesante en el interior de la prueba del componente. Inserta una nueva lnea antes del ndice especificado si la coleccin es de fecha efectiva, o despus del ndice si no es de fecha efectiva. Elimina las lneas designadas por el nmero de ndice especificado en el cuadro de dialogo en el parmetro Enter. Regresa la fila correspondiente a las llaves especificadas. Solo el xito o el fracaso de esta rutina es de inters en el interior de la prueba del componente. Este mtodo regresa la lnea efectiva en un registro de fecha efectiva. Solo el xito o el fracaso de esta rutina es de inters en el interior de la prueba del componente. Regresa el DataRow que es efectivo para la fecha y numero de secuencia especficos. Este es un caso ms general de la funcin GetCurrentItem, la cual regresa la definicin que es efectiva en ese momento. Este mtodo solo trabaja con registros de fecha efectiva. Regresa el nmero del objeto que se encuentra dentro de la coleccin del DataRow que es efectivo para la fecha y numero de secuencia especficos. Este es un caso ms general de la funcin GetCurrentItemNum, la cual regresa el nmero de la definicin que es efectiva en ese momento. Este mtodo solo trabaja con registros de fecha efectiva.

InsertItem (index)

DeleteItem (index)

ItemByKeys (key1, key2, )

CurrentItem

GetEffectiveItem (DateString, SeqNum)

GetEffectiveItemNum (DateString, SeqNum)

Nota. Las clases de Component Interface contienen informacin sobre los mtodos de coleccin.

Determinando los parmetros ItemByKeys

Usted puede obtener la firma del mtodo ItemByKeys (o cualquier otro mtodo)TM cuando este probando un Component Interface. Esto es til para el mtodo ItemByKeys, porque la firma es diferente para cada Component Interface.

PDF Editor
100 |

Procesos PeopleSoft

Para determinar los parmetros ItemByKeys: 1. 2. 3. 4. 5. Abra la definicin. Seleccione Tools Test Component Interface. Encuentre u obtenga un apropiado Component Interface poblado. Navegue por la coleccin apropiada. De clic derecho y seleccione ItemByKeys del men pop-up. Aparecer un cuadro de dialogo que muestra el parmetro y tipos especficos, y el orden en el cual sern llamdos por el ItemByKeys.

Entendiendo la sincronizacin
La pestaa Component Interface Properties Synchronization es utilizada con PeopleSoft Mobile Agent. Este ltimo extiende la funcionalidad de PeopleSoft Pure Internet Architecture para desconectar los dispositivos mviles, permitiendo a los usuarios continuar trabajando con sus aplicaciones PeopleSoft en una laptop o en un asistente digital personal (PDA) mientras se encuentra desconectado de internet o la red local.

TM

PDF Editor
101 |

Procesos PeopleSoft
Consideraciones del tiempo de ejecucin
En varias formas, acceder a un Component Interface es funcionalmente equivalente a trabajar con un componente en lnea. Sin embargo, hay algunas diferencias importantes entre Componente Interface y componentes. En este tema hablaremos de cmo estas diferencias afectan la operacin interactiva, funcionalidad diseada para interfaces graficas, operacin cliente contra servidor, y situaciones diversas.

Consideraciones generales
Consideracin WinMessage no disponible Email de un Component Interface Descripcin Puede utilizar un WinMessage en un componente que se podr utilizar para construir un Component Interface. Para enviar un email de un Component Interface, utilice un evento TriggerBusinessEvent de PeopleCode, no un evento SendMail. Este campo no esta disponible para utilizarse en un Component Interface. Si se encuentra deshabilitado el RowInsert en una pgina, se debe tener cuidado cuando se llama un Component Interface correspondiente para ser insertado.

Related Display

Row Insert

Conflictos de mbito
Conflicto Procesamiento de bucles infinitos Descripcin Un Component Interface no debe llamar el mismo a ningn PeopleCode incluido dentro de su definicin de componente, porque tal vez resulte un bucle infinito del Component Interface. Porque los conflictos de memoria potencial, no deben crear instancias mltiples o simultaneas de un mismo Component Interface, ya sea en un procedimiento simple o TM en uno padre e hijo.

Instancias mltiples de un Component Interface

PDF Editor
102 |

Programacin de un Component Interface en PeopleCode

Existen algunas funciones de PeopleCode que son ignoradas al llamar un Component Interface. Estas son:

Procesos PeopleSoft
Funcin WinMessage Descripcin Muestra un mensaje en un cuadro de mensajes. Solo muestra informacin simple. Cambia el estado el men colocando una marca de verificacin al elemento del men. Esta funcin es obsoleta. Deshabilita el elemento del men especificado. Habilita el elemento del men especificado. Esconde el elemento del men especificado. Remueve una marcada de verificacin de un elemento del men especificado. Posiciona el cursor en un campo especfico en cualquier lugar del componente actual. Controla la transferencia del panel indicado dentro de PANEL.panel_name. Controla la transferencia de la pgina indicada dentro de PAGE.page_name. Ejecuta un componente modal. Prueba si un componente modal es ejecutado actualmente. Ejecuta un componente modal. (Igual que DoModalPanelGroup) Prueba si un componente modal es ejecutado actualmente. (Igual que IsModalPanelGroup) Determina que nodo de usuario tiene seleccionado un control de rbol dinmico. Ingresa datos de un control de rbol dinmico. Actualiza el rbol dinmico. Salva la pgina actual.

CheckMenuItem

DisableMenuItem EnableMenuItem HideMenuItem UncheckMenuItem

SetCursorPos

TransferPanel

TransferPage

DoModalPanelGroup IsModalPanelGroup DoModalComponent

IsModalComponent

GetSelectedTreeNode

GetTreeNodeParent RefreshTree DoSave

TM

PDF Editor
DoSaveNow
103 |

Esta diseada primordialmente para utilizarse con llamadas remotas.

Procesos PeopleSoft
Funcin Gray Ungray Descripcin Deshabilita los campos de una pgina. Habilita los campos de una pgina.

Generando una plantilla de PeopleCode

Para acceder a un Component Interface utilizando un PeopleCodee, el Application Designer genera una plantilla en forma de lenguaje PeopleCode que puede ser adaptado para un propsito. Para generar una plantilla de PeopleCode siga los siguientes pasos: 1. Abra la definicn del Component Interface deseado en el Application Designer. 2. Inserte el Component Interface dentro del proyecto. a. Seleccione Insert Current Object into Project. b. Guarde el proyecto. 3. Abra el editor del PeopleCode. Puede asociar el Component Interface de PeopleCode con un record, un componente un operador manual de servicio o un programa Application Engine. 4. Seleccione el Component Interface del rea de trabajo del proyecto. Arrastre y suelte el objeto dentro del proyecto en el editor de PeopleCode. 5. Haga los cambios necesarios en el PeopleCode.

Entendiendo la plantilla de PeopleCode

El cdigo mostrado en esta seccin es una plantilla de PeopleCode generada dinmicamente que puede ser utilizada como un punto de partida. Reemplace todos los valores por default o notaciones <*> por valores o referencias especficos para validar las variables del PeopleCode.

TM

PDF Editor
104 |

Procesos PeopleSoft

Establezca la sesin de PeopleCode en modo de mensaje de error. Esta propiedad es utilizada para determinar cuantos mensajes han salido. Tambin toma un valor numrico o una constante. El valor por default es 1. Esta propiedad determina el valor de la sesin. Aqu se muestra la lista de los modos que se pueden utilizar: Valor del modo 0 1 No regresan mensajes. Valor por default. Mensajes tipo Log dentro de la coleccin PSMessage. Emerge un cuadro de dialogo de mensajes. La unin del 1 y 2. Efecto

2 3

Notas de las plantillas de PeopleCode Tome una referencia para el Component Interface proporcionndole un nombre (Ocurrir un error en tiempo real si el Component Interface no existe).

PDF Editor
105 |

TM Obtenga las llaves para el Component Interface. En este ejemplo la llave Get es SDK_EMPLID. El mtodo get() regresa un dato de la base de datos asociado con los valores de la llave. Obtenga e imprima las propiedades del nivel 0. Un cdigo similar es generado para las propiedades SDK_BIRTHDATE y SDK_DEPTID.

Procesos PeopleSoft
Obtenga la coleccin de nivel 1 (SDK_BUS_EXP_PER). Obtenga e imprima las propiedades del nivel 1. Un cdigo similar es generado para las propiedades SDK_EMPLID y SDK_BUS_EXP_SUM en la coleccin SDK_BUS_EXP_PER. Obtenga la coleccin de nivel 2 (SDK_BUS_EXP_DTL). Sintaxis: &oSdkBusExpDtlCollection = &oSdkBusExpPer.SDK_BUS_EXP_DTL; Obtenga e imprima las propiedades del nivel 2. Un cdigo similar es generado para las propiedades SDK_EMPLID, SDK_EXP_PER_DT, SDK_EXPENSE_CD, SDK_EXPENSE_AMT, SDK_CURRENCY_CD, SDK_BUS_PURPOSE Y SDK_DEPTID.

TM

PDF Editor
106 |

Procesos PeopleSoft Glosario

API: Application Programming Interface (Interfaz de aplicacin). COM: Component Object Model Component Interface Tester: Uso del Component Interface que sirve para validar el Component Interface Metastring: Son sentencias especiales incluidas en cadenas SQL. Un metastring tiene el prefijo (%) Script: Un guin o conjunto de instrucciones. Permiten la automatizacin de tareas creando pequeas utilidades Triggers: Un trigger o un disparador en una base de datos es un evento que se ejecuta cuando se cumple una condicin establecida al realizar una operacin de insercin (INSERT), actualizacin (UPDATE) o borrado (DELETE). XSLT: Es un estndar que presenta una forma de transformar documentos XML en otros e incluso a formatos que no son XML. Las hojas de estilo XSLT realizan la transformacin del documento utilizando una o varias reglas de plantilla. Estas reglas de plantilla unidas al documento fuente a transformar y alimentan un procesador de XSLT, el que realiza las transformaciones deseadas poniendo el resultado en un archivo de salida, o, como en el caso de una pgina web, las hace directamente en un dispositivo de presentacin tal como el monitor del usuario.

TM

PDF Editor
107 |

Procesos PeopleSoft Bibliografa

Enterprise PeopleTools 8.49 PeopleBook: PeopleCode Developers Guide Enterprise PeopleTools 8.49 PeopleBook: Application Engine Enterprise PeopleTools 8.49 PeopleBook: Component Interface Enterprise PeopleTools 8.49 PeopleBook: Application Designer Enterprise PeopleTools 8.49 PeopleBook: Security Administration

TM

PDF Editor
108 |