03 peoplesoft peopletools procesos
TRANSCRIPT
Procesos PeopleSoftQualsys Consulting S.C.Arianna Valencia Erika Santamara Jos Enrquez Francisco HernndezOctubre, 2008
Procesos PeopleSoftndiceProcesos 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 sistema2| Qualsys Consulting S.C
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
Procesos PeopleSoftMetastring 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 Records3| Qualsys Consulting S.C
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
Procesos PeopleSoftTipos 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 definicin4| Qualsys Consulting S.C
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
Procesos PeopleSoftEmpezando 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.5| Qualsys Consulting S.C
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
Procesos PeopleSoftFunciones 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
6|
Qualsys
Consulting
S.C
Procesos PeopleSoft
Procesos PeopleSoftPeopleSoft PeopleCodePeopleCode 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 PeopleCodeEsta 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 PeopleCodeEsta 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 datosLos 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.
Tipos de datos convencionalesPeopleCode incluye estos tipos de datos convencionales:7| Qualsys Consulting S.C
Procesos PeopleSoftAny Boolean Date DateTime Float Integer Number Object String Time
Consideraciones para los tipos Float, Integer y NumberEl 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 datosPara 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 Rowset PeopleCode incluye estos tipos de datos para la pantalla: AnalyticGrid8| Qualsys Consulting S.C
Procesos PeopleSoftChar 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 PostReport ProcessRequest RowsetCahce SoapDoc
9|
Qualsys
Consulting
S.C
Procesos PeopleSoftSQL SyncServer TransformData XmlDoc XmlNode
Tipos API ObjectUtilice 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
ComentariosUtilice 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 final El siguiente cdigo muestra los formatos para hacer comentarios:
10 |
Qualsys
Consulting
S.C
Procesos PeopleSoftEjemplo:
SentenciasUna 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
11 |
Qualsys
Consulting
S.C
Procesos PeopleSoftSeparadoresLas 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 asignacinLas 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 valorEn 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 referenciaCuando 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.
12 |
Qualsys
Consulting
S.C
Procesos PeopleSoftSintaxis: Local array of number &AN, &AN2; Local number # &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 lenguajeLa 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 subrutinasPeopleCode, 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 subrutina es lo mismo que llamar una funcin que no regresa valores. Sintaxis: function_name(param_list);
13 |
Qualsys
Consulting
S.C
Procesos PeopleSoftSentencias de controlLas sentencias de control controlan el flujo del programa basndose en evaluar expresiones condicionales.
Sentencias If, Then y ElseSintaxis: 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 EvaluateUtilice 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 [Lista de sentencias] When-other [Lista de sentencias]
14 |
Qualsys
Consulting
S.C
Procesos PeopleSoftEnd-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 ForLa sentencia For repite una secuencia de sentencias un especfico nmero de veces. Sintaxis: For count = expresion1 to expresion2 [Step i]; [Lista de sentencias] End-for;15 | Qualsys Consulting S.C
Procesos PeopleSoftLa 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 condicionalesLos 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 RepeatSintaxis: 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 WhileSintaxis: While expresin_logica [Lista de sentencias] End-while;; La sentencia While evala la expresin lgica antes de ejecutar la lista de sentencias. Continua repitiendo la lista de sentencias hasta que la expresin lgica resulte falsa.
FuncionesFunciones soportadasPeopleCode soporta los siguientes tipos de funciones:16 | Qualsys Consulting S.C
Procesos PeopleSoftBuilt-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 funcionesLas 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 funcionesSi 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: Declare Funtion UpdatePSLOCK PeopleCode FUNCLIB_NODES.MSGNODENAME FieldFormula
Llamado de funciones:
17 |
Qualsys
Consulting
S.C
Procesos PeopleSoftSintaxis: 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 funcionesLas 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 ejemplo, la siguiente llamada para DeleteRow ignora el valor de regreso y corra la fila. Ejemplo: DeleteRow (RECORD.BUS_EXPENSE_PER,&L1_ROW,RECOD:BUS_EXPENSE_DTL,&L2_ROW);
18 |
Qualsys
Consulting
S.C
Procesos PeopleSoftEl 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 funcionesSi 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)
ExpresionesExpresiones fundamentalesEvala 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 simple expresin puede modificarse por operadores (como un signo negativo o la 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.
19 |
Qualsys
Consulting
S.C
Procesos PeopleSoftMetastrings (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.
ConstantesPeopleCode 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 numricasConstantes numricas pueden ser cualquier nmero. Como por ejemplo: 7 0.8725 -172.324
Constantes stringLas 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 booleanasLas constantes booleanas representan un valor verdadero. Solo hay dos posibilidades True y False.
20 |
Qualsys
Consulting
S.C
Procesos PeopleSoftConstantes nulasLas 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 usuarioEl 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 expresionesPuede 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 sistemaLas variables del sistema estn precedidas del smbolo de porcentaje (%). Utilice estas variables para obtener la fecha actual u obtener informacin del usuario, el lenguaje actual, el registro actual, pgina, componente o ms.
MetastringLos metastring son expresiones especiales de SQL. Los metastring, tambin llamados meta-SQL, estn precedidos del smbolo porcentaje (%) y pueden incluirse
21 |
Qualsys
Consulting
S.C
Procesos PeopleSoftdirectamente 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 registroUtilice 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 registroPara 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 (^).
22 |
Qualsys
Consulting
S.C
Procesos PeopleSoftVariablesTipos de variables soportadasPeopleCode 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 usuarioLas 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 utilizar las variables locales sin declararlas.
23 |
Qualsys
Consulting
S.C
Procesos PeopleSoftEjemplo: 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 variablesDeclare 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.
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
24 |
Qualsys
Consulting
S.C
Procesos PeopleSoftaccidentalmente escribe &EDN_DATE, la nueva variable aparece en la pestaas cuando guarde el programa.
Inicializacin de variables definidas por el usuarioPara 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.
OperadoresLas expresiones en PeopleCode piden modificarse y combinarse utilizando operadores matemticos, de caracter, comparacin y booleanos.
Operadores matemticosLos operadores estndar utilizado son:
25 |
Qualsys
Consulting
S.C
Procesos PeopleSoftSmbolo + * / ** Mas Menos Multiplicacin Divisin Potencia Accin
Operadores de fecha y horaPuede 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 cadenasLas 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; &RETORT = I cant do that, | &OPER_NICKNAME | .;
26 |
Qualsys
Consulting
S.C
Procesos PeopleSoftEl 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 comparacinLos operadores de comparacin, comparan dos expresiones del mismo tipo de datos. El resultado de la comparacin es un valor booleano. La siguiente tabla resume estos operadores. Operador = Igual Significado
27 |
Qualsys
Consulting
S.C
Procesos PeopleSoftOperador != < >= 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 booleanosLos 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
El operador NOT niega la expresin bolean, cambiando el valor de True a Falso y de False a True. El siguiente ejemplo de sentencias contiene expresiones booleanas.
28 |
Qualsys
Consulting
S.C
Procesos PeopleSoftEjemplo: &FLAG = (Not (&FLAG)); If ((&HAS_FLEAS or &HAS_TICKS) and SOAP_QTY %BIND (RECNAME) OR (RECNAME = %BINF (RECNAME) AND FIELDNAME > %BIND (FIELD NAME)) 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.
72 |
Qualsys
Consulting
S.C
Procesos PeopleSoftLos 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 anormalesUn 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 EngineHay dos formas de restaurar un programa del Application Engine Desde la lnea de comandos. Desde la pgina Process Request.
Restaurando desde la lnea de comandoNormalmente 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. Para restaurar la aplicacin del comando de lnea 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 de73 | Qualsys Consulting S.C
Procesos PeopleSoftproceso. 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 RequestSe 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 principioCuando 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 en un lugar desconocido. 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. Para restaurar un programa Application Engine desde el principio:74 | Qualsys Consulting S.C
Procesos PeopleSoft1. 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 restauracinPara 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.
75 |
Qualsys
Consulting
S.C
Procesos PeopleSoft PeopleSoft Component InterfaceUn 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 InterfaceUn 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 InterfaceEn 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 InterfaceUn 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 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
76 |
Qualsys
Consulting
S.C
Procesos PeopleSoftcomponente son mapeados a las llaves y propiedades del Component Interface. Los mtodos son utilizados para encontrar, crear, modificar y borrar datos.
Arquitectura del Component InterfaceLa 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 InterfaceNombre 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). 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.
77 |
Qualsys
Consulting
S.C
Procesos PeopleSoftPropiedades 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 InterfaceSe puede crear, modificar y revisar la definicin del Component Interface utilizando Application Designer. Cuando trabaja con una definicin del Component Interface en Application Designer, se puede observar que la vista del componente se encuentra del lado izquierdo, y la vista del Component Interface se encuentra del lado derecho. La siguiente pantalla muestra las vistas del componente y del Component Interface en Application Designer.
78 |
Qualsys
Consulting
S.C
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 Interfacecono Component Interface. Grupo de llaves. Propiedad que es un campo llave desde el registro. Llave de bsqueda alterna. Grupo de Propiedades o Mtodos. Descripcin
79 |
Qualsys
Consulting
S.C
Procesos PeopleSoftcono 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 InterfaceNombre 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 Property para las llaves, colecciones o propiedades.
Record
Field
Read Only
Comment
Nota. En la vista del Component Interface, las propiedades aparecen en el mismo orden como aparecen en el componente y no estn ordenadas alfabticamente
Desarrando un Component InterfaceEste captulo expondr como:80 | Qualsys Consulting S.C
Procesos PeopleSoftCrear 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 InterfaceComo 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
1. Selecciona del men de Application Designer FileNew. 2. Selecciona Component Interface. 3. Selecciona el componente en el cual este Component Interface estar basado.
81 |
Qualsys
Consulting
S.C
Procesos PeopleSoftDespus 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
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.82 | Qualsys Consulting S.C
Procesos PeopleSoftDeterminando cuales campos exponerLa 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 llavesLa 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. Cada campo llave de bsqueda alterna produce un Find key.
Agregando y borrando llavesPara agregar una llave
83 |
Qualsys
Consulting
S.C
Procesos PeopleSoft1. 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 configuracinEsta seccin expone como: Crear propiedades definidas por el usuario Borrar propiedades Renombrar propiedades Nombrar propiedades del Component Interface.
Propiedades estndarLas 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 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.84 | Qualsys Consulting S.C
GetKeyInfoCollection
FindKeyInfoCollection
GetHistoryItems
Procesos PeopleSoftNombre 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 propiedad es de solo lectura. Regresa la configuracin de mercado del componente utilizado para construir el Component Interface. Esta propiedad es de solo lectura. Cuando un nuevo scroll es insertado en una pgina, este
ComponentName
Description
Market
GetDummyRows
85 |
Qualsys
Consulting
S.C
Procesos PeopleSoftNombre 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 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
Type
OAType
86 |
Qualsys
Consulting
S.C
Procesos PeopleSoftNombre 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 lectura.
Key
Required
Xlat
Yesno
Prompt
Length
DecimalPosition
IsReadOnly
Altkey
Listboxitem
Creando propiedades definidas por el usuarioLas propiedades son aquellas propiedades en el componente que estn expuestas a travs del Component Interface. Las propiedades definidas por el usuario son derivadas
87 |
Qualsys
Consulting
S.C
Procesos PeopleSoftdel 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 propiedadesPara 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 usuarioLos 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: 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. 2. Introduzca el nuevo nombre de la propiedad. 3. Agregue comentarios que puedan ser tiles.
88 |
Qualsys
Consulting
S.C
Procesos PeopleSoft4. 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 referenciaCada 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 Related Component Interface Descripcin Describe el nombre de la referencia que se est creando. Designa el Component Interface referenciado desde el actual Component Interface.
89 |
Qualsys
Consulting
S.C
Procesos PeopleSoftNombre 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 lecturaSe 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 coleccionesUna 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. 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.
90 |
Qualsys
Consulting
S.C
Procesos PeopleSoftCuando se arrastra un scroll hijo a la vista del Component Interface, las colecciones padres son creadas automticamente.
Trabajando con mtodosEsta 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 InterfaceNombre Connect getCompIntfc Descripcin Lo conecta al servidor de la aplicacin. Regresa una referencia a un Component Interface.
Mtodos estndarUn 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 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. Crea una nueva instancia de un Component Interface.
Create
91 |
Qualsys
Consulting
S.C
Procesos PeopleSoftNombre 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).
92 |
Qualsys
Consulting
S.C
Procesos PeopleSoftHabilitar 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 usuarioEsta seccin expone como crear mtodos definidos por el usuario.
93 |
Qualsys
Consulting
S.C
Procesos PeopleSoftPara 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 InterfaceLa 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 en sus lugares adecuados. Tambin quizs necesite renombrar la propiedad o la coleccin. Para validar un Component Interface: 1. Abra el Component Interface en Application Designer
94 |
Qualsys
Consulting
S.C
Procesos PeopleSoftLa 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 seguridadDespus 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. 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. 7. Haga clic en OK cuando haga hecho todo lo anterior.
95 |
Qualsys
Consulting
S.C
Procesos PeopleSoft8. Guarde la pgina.
Probando el Component InterfaceDespus 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 InterfacePara 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. 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
96 |
Qualsys
Consulting
S.C
Procesos PeopleSoftInterface. 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. Es equivalente a crear una nueva lnea en el modo Add.
Edit History Items
Get Dummy Rows
Get Existing
Create New
Obtencin de registros existentes utilizando llaves parcialesSi se quiere recuperar una llave parcial, haga clic en el botn Find. El cuadro de dilogo Find Results aparece:
97 |
Qualsys
Consulting
S.C
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 InterfaceDesde 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). Si hay errores se mostrarn en el rea Error Message Log.98 | Qualsys Consulting S.C
Procesos PeopleSoftPrueba de los mtodos de Component InterfacePruebe 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 coleccinLa 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 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.
Reglas del mtodo de coleccinLa siguiente tabla contiene las reglas del mtodo de coleccin:
99 |
Qualsys
Consulting
S.C
Procesos PeopleSoftNombre 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 ItemByKeysUsted puede obtener la firma del mtodo ItemByKeys (o cualquier otro mtodo) cuando este probando un Component Interface. Esto es til para el mtodo ItemByKeys, porque la firma es diferente para cada Component Interface.
100 |
Qualsys
Consulting
S.C
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 sincronizacinLa 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.
101 |
Qualsys
Consulting
S.C
Procesos PeopleSoftConsideraciones del tiempo de ejecucinEn 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 generalesConsideracin 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 mbitoConflicto 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 en uno padre e hijo.
Instancias mltiples de un Component Interface
Programacin de un Component Interface en PeopleCodeExisten algunas funciones de PeopleCode que son ignoradas al llamar un Component Interface. Estas son:102 | Qualsys Consulting S.C
Procesos PeopleSoftFuncin 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. Esta diseada primordialmente para utilizarse con llamadas remotas.
CheckMenuItem
DisableMenuItem EnableMenuItem HideMenuItem UncheckMenuItem
SetCursorPos
TransferPanel
TransferPage
DoModalPanelGroup IsModalPanelGroup DoModalComponent
IsModalComponent
GetSelectedTreeNode
GetTreeNodeParent RefreshTree DoSave DoSaveNow
103 |
Qualsys
Consulting
S.C
Procesos PeopleSoftFuncin Gray Ungray Descripcin Deshabilita los campos de una pgina. Habilita los campos de una pgina.
Generando una plantilla de PeopleCodePara 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 PeopleCodeEl 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.
104 |
Qualsys
Consulting
S.C
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). 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.105 | Qualsys Consulting S.C
Procesos PeopleSoftObtenga 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.
106 |
Qualsys
Consulting
S.C
Procesos PeopleSoft GlosarioAPI: 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.
107 |
Qualsys
Consulting
S.C
Procesos PeopleSoft BibliografaEnterprise 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
108 |
Qualsys
Consulting
S.C