Académique Documents
Professionnel Documents
Culture Documents
MANUAL DE USUARIO
SIGNATURE SERVER
Manual De Usuario
DOCUMENTOS ENVIADOS
.................................................................................................................................................... 6
................................................................................................................................................... 15
.................................................................................................................................................. 33
DEFINICIN DE REPORTES
.............................................................................................................................................. 34
GENERACIN DE REPORTES
.............................................................................................................................................. 35
OTRAS OPCIONES ..................................................................................................................................................................... 36
ACTUALIZAR LOS DATOS DE LA PANTALLA
............................................................................................................................ 36
REGENERAR REPORTES
.................................................................................................................................................... 36
ELIMINAR REPORTES
....................................................................................................................................................... 37
CONFIGURACIN .................................................................................................................................................................... 38
DATOS EMPRESA
DIVISIONES
............................................................................................................................................................. 39
..................................................................................................................................................................... 39
BSQUEDA DE DIVISIONES
................................................................................................................................................. 40
NUEVA DIVISIN
............................................................................................................................................................ 41
ASOCIACIN DE USUARIOS ............................................................................................................................................. 42
2
Manual De Usuario
ELIMINACIN DE DIVISIONES
USUARIOS
......................................................................................................................................... 43
.................................................................................................................................................................... 43
BSQUEDA DE USUARIOS
.................................................................................................................................................. 44
GENERACIN DE UN NUEVO USUARIO
.................................................................................................................................... 45
CAMBIAR CLAVE
............................................................................................................................................................ 46
ADMINISTRACIN .................................................................................................................................................................... 47
FOLIOS
........................................................................................................................................................................... 48
BSQUEDA DE FOLIOS
IMPORTACIN DE FOLIOS
CLIENTES
...................................................................................................................................................... 48
.................................................................................................................................................... 49
..................................................................................................................................................................... 49
................................................................................................................................................................. 53
.................................................................................................................................................................. 55
............................................................................................................................................................... 56
.................................................................................................................................................................... 57
.................................................................................................................................................................. 62
................................................................................................................................................... 73
3
Manual De Usuario
LOGS
............................................................................................................................................................................... 74
ANEXO I .................................................................................................................................................................................... 76
TUTORIAL XPATH ................................................................................................................................................................... 76
Manual De Usuario
CAPITULO I
Documentos Enviados
Manual De Usuario
Documentos Enviados
Mediante el acceso a este men es posible realizar toda la gestin relacionada con los documentos
enviados ya sea desde Signature Server como desde Signature xDoc.
Bsicamente el men permite buscar los documentos enviados mediante diferentes combinaciones de
datos de forma de facilitar la gestin de los mismos.
Bsqueda de Documentos
Para realizar una bsqueda de documentos se debe realizar los siguientes pasos:
-
Manual De Usuario
Seleccionar el estado particular del documento a consultar. En caso de no saber el estado del
documento a buscar seleccionar la opcin por defecto Todos
El resto de los criterios de bsqueda podrn utilizarse solos combinados dependiendo de las
necesidades que tenga el usuario que realiza la accin. Los campos posibles de utilizar son:
Manual De Usuario
Cant. Doctos.: Este campo se utiliza para indicar la cantidad mxima de documentos que debern
incluirse en la bsqueda.
En caso que la cantidad de documentos resultado de la bsqueda sea mayor a la soportada por el
tamao de la pgina mostrada, se indicar la cantidad de pginas que conforman la bsqueda en
el extremo inferior derecho de la pgina.
En este ejemplo se ha realizado una bsqueda para un tipo de documento Factura Electrnica,
cuyo estado es Archivado, cuyo receptor tiene el RUT 97.030.000-7, con fecha de emisin que se
encuentran entre el 01-01-2005 en adelante y cuyos folios van desde el 20 al 80
Manual De Usuario
La creacin de nuevos documentos desde Signature Server slo es posible si se han cargado
previamente en la aplicacin los Cdigos de Autorizacin de Folios (CAF) correspondientes.
Para crear un nuevo documento se debe presionar el cono Nuevo
superior del men.
ubicado en la parte
Manual De Usuario
El nuevo DTE cuenta con un rea para ingresar la informacin de las lneas de Detalle y los Totales.
Adicionalmente, el documento tiene un rea para establecer los Documentos de Referencia.
Los detalles corresponden a los productos o servicios que se estn facturando. Para ello es necesario
incorporar por lo menos los datos que se encuentran en rojo ya que los mismos son de carcter
obligatorio.
Una vez cargado el producto o servicio en la lnea de detalle se debe presionar el cono Guardar,
para dejar registrada la lnea (imagen contenida en el crculo rojo).
Para agregar ms lneas de detalle al documento deber presionar el cono Nuevo (imagen
contenida en el crculo rojo)
En caso que est generando una nota de crdito, ser necesario adems incorporar los datos del
documento a que hace referencia la misma. Para ello deber completar los datos contenidos en la
zona de Documentos Referenciados.
La forma de operacin es idntica a la carga de lneas de detalle. De la misma manera, una vez
finalizada la carga se deber presionar el cono Guardar para dejar registrados los cambios (imagen
contenida en el crculo azul).
10
Manual De Usuario
Para incorporar otros datos en el documento, se deber hacer click en el botn Avanzado.
Finalmente, cuando el documento se encuentre listo para ser generado se deber presionara el cono
Guardar que se encuentra en la parte superior izquierda de la pgina de carga del documento.
Una vez que el documento sea generado el mismo quedar en estado Por Confirmar. Eso significa
que el mismo tiene asignado un nro de folio vlido pero an no ha sido enviado al SII. Para liberar el
documento seleccione el documento en cuestin, bralo presionando el primer cono que se
11
Manual De Usuario
encuentra a la derecha del documento y luego presione el cono Confirmar que se encuentra en la
parte superior de la pantalla.
Regeneracin de PDF
En caso que el PDF no se pueda visualizar, usted tiene la opcin de regenerarlo. Para ello seleccione
el documento mediante la casilla de verificacin que se encuentra en el extremo izquierdo del
mismo y presione el cono Generar PDF que se encuentra en la parte superior de la pantalla.
Distribucin de Documentos
Esta opcin permite la redistribucin del documento por mail en el caso que el mismo se encuentre
asociado a una regla de distribucin previamente asignada. Para ello seleccione el o los documentos
que desee redistribuir mediante la casilla de verificacin que se encuentra en el extremo izquierdo
del mismo, y presione el cono Distribuir que se encuentra en la parte superior de la pantalla.
Anulacin de Folios
Esta opcin slo es utilizable en caso que el documento generado haya sido rechazado por el SII. En
ese caso, el estado del mismo aparecer como Rechazado SII en la columna correspondiente.
Si ese fuera el caso, usted podr anular el folio seleccionando el documento mediante la casilla de
verificacin que se encuentra en el extremo izquierdo del mismo, y presione el cono Anular Folio
que se encuentra en la parte superior de la pantalla.
Importar Documentos
Esta opcin permite importar DTEs que hayan sido generados desde otra herramienta de facturacin
electrnica.
Para ello presione el cono Importar que se encuentra en la parte superior de la pantalla.
12
Manual De Usuario
A continuacin aparecer una pantalla la cual le permitir seleccionar el documento que desea
importar.
Presione el botn Examinar para buscar el documento a importar, y luego presione el cono
Importar que se encuentra en la parte superior de la pantalla.
Otras Opciones
Todos los documentos generados por el sistema de facturacin quedarn almacenados en Signature
Server en formato XML tal como lo exige el SII. Para poder visualizarlos en ese formato presione el
cono indicado el cual se encuentra en el extremo derecho de cada documento generado.
13
Manual De Usuario
Esta opcin le permitir visualizar el ciclo de vida del documento. En otros trminos, esta opcin
permite hacer un seguimiento de todos los eventos que se produjeron durante toda la vida del
documento desde su generacin hasta su almacenamiento final.
Para revisar el ciclo de vida del documento presione el cono indicado el cual se encuentra en el
extremo derecho del mismo.
La siguiente pantalla muestra el ciclo de vida de un documento ejemplo.
Manual De Usuario
Libros Electrnicos
Como un elemento obligatorio dentro del modelo de facturacin electrnica, el SII exige la
generacin y envo peridico de los libros de compras y ventas realizadas por los contribuyentes
electrnicos.
Signature Server provee la funcionalidad de generacin, consolidacin y firmado de libros tributarios
electrnicos a partir de las operaciones almacenadas en la herramienta, como as tambin la
importacin de libros en formato de texto generados desde otras aplicaciones.
15
Manual De Usuario
16
Manual De Usuario
Para generar un nuevo libro a partir de las operaciones almacenadas en Signature Server, presione el
cono Nuevo.
17
Manual De Usuario
Archivo Fuente: Esta opcin permite la importacin de libros generados desde otras aplicaciones. El
formato del archivo a importar debe ser TEXTO y la estructura de los registros del mismo debe estar
de acuerdo a las especificaciones indicadas a continuacin.
Libro de Ventas
Libro de Compras
Una vez cargados todos los campos indicados presione el cono Guardar para confirmar la
generacin del libro.
Como el proceso de generacin de libros demanda mucho uso de CPU en el equipo, el mismo se
programa para correr en background. Por ese motivo en la pantalla principal del mdulo, el libro
aparecer con estado Solicitado durante el lapso que se est generando.
Una vez finalizado el proceso, el estado cambiar a Generado No Generado (en caso de existir
algn error).
18
Manual De Usuario
Otras Opciones
Bsqueda de Libros
Este mdulo provee la funcionalidad de bsqueda de libros generados. Para ello debe seleccionar las
opciones presentadas en la imagen siguiente y luego presionar el cono Buscar
Consolidacin de libros
Esta funcionalidad permita la fusin de dos o ms libros generados para un mismo perodo y tipo. En
la prctica esta opcin permite por ejemplo la consolidacin de libros generados entre diferentes
reas generados desde sistemas de gestin diferentes
Para ejecutarla se deben seleccionar todos los libros que se desean consolidar presionando la casilla
de verificacin que poseen los mismos a la izquierda de cada uno de ellos.
19
Manual De Usuario
Una vez seleccionados los libros a fusionar se deber presionar el cono Consolidar. Como resultado
de ello se generar un nico libro conteniendo los libros parciales seleccionados el cual aparecer en
la pantalla de operacin de la herramienta.
Firmado de Libros
Una vez obtenidos y verificados, los libros tributarios debern ser enviados al SII. Para ello es
necesario previamente firmarlos digitalmente.
Para poder firmar los libros se debern seleccionar mediante la casilla de verificacin que cada uno
de ellos posee en el extremo izquierdo de la pantalla y luego presionar el cono Firmar. Una vez
firmados los mismos sern despachados automticamente al SII.
Eliminacin de Libros
En caso de necesitar borrar de la herramienta alguno de los libros generados se deber presionar el
cono Eliminar. Es importante destacar que slo es posible eliminar aquellos libros que no hayan
sido firmados digitalmente y enviados al SII.
20
Manual De Usuario
CAPITULO II
Documentos Recibidos
21
Manual De Usuario
Documentos Recibidos
Mediante el acceso a este men es posible realizar toda la gestin relacionada con los documentos
recibidos Signature Server.
Bsicamente el men permite buscar los documentos recibidos mediante diferentes combinaciones
de datos de forma de facilitar la gestin de los mismos.
Bsqueda de Documentos
Para realizar una bsqueda de documentos se debe realizar los siguientes pasos:
-
Manual De Usuario
Seleccionar el estado particular del documento a consultar. En caso de no saber el estado del
documento a buscar seleccionar la opcin por defecto Todos
El resto de los criterios de bsqueda podrn utilizarse en solos combinados dependiendo de las
necesidades que tenga el usuario que realiza la accin. Los campos posibles de utilizar son:
Manual De Usuario
Cant. Doctos.: Este campo se utiliza para indicar la cantidad mxima de documentos que debern
incluirse en la bsqueda.
En caso que la cantidad de documentos resultado de la bsqueda sea mayor a la soportada por el
tamao de la pgina mostrada, se indicar la cantidad de pginas que conforman la bsqueda en
el extremo inferior derecho de la pgina.
EJEMPLO
24
Manual De Usuario
Consulta SII
Esta opcin permite realizar una consulta al SII en lnea del estado de un documento recibido. Es
importante destacar que la misma solamente puede aplicarse en caso que el documento recibido se
encuentre en estado No recibido SII. Como resultado de la consulta el documento seleccionado
podr cambiar de estado si es que ha sido recibido por el SII. Este cambio de estado podr
visualizarse en la columna Estado ubicada en la pantalla principal del mdulo.
Para realizar la consulta seleccione el los documentos a travs de las casillas de verificacin que se
encuentran en el extremo izquierdo de cada uno de ellos, y presione el cono Consultar SII.
Regeneracin de PDF
En caso que el PDF no se pueda visualizar, usted tiene la opcin de regenerarlo. Para ello seleccione
el documento mediante la casilla de verificacin que se encuentra en el extremo izquierdo del
mismo y presione el cono Generar PDF que se encuentra en la parte superior de la pantalla.
Distribucin de Documentos
Esta opcin permite la redistribucin del documento por mail en el caso que el mismo se encuentre
asociado a una regla de distribucin previamente asignada. Para ello seleccione el o los documentos
que desee redistribuir mediante la casilla de verificacin que se encuentra en el extremo izquierdo
del mismo, y presione el cono Distribuir que se encuentra en la parte superior de la pantalla.
25
Manual De Usuario
Descarga de Documentos
Otras Opciones
Todos los documentos recibidos por Signature Server quedarn almacenados en formato XML tal como
lo exige el SII. Para poder visualizarlos en ese formato presione el cono indicado el cual se encuentra
en el extremo derecho de cada documento generado.
26
Manual De Usuario
Esta opcin le permitir visualizar el ciclo de vida del documento. En otros trminos, esta opcin
permite hacer un seguimiento de todos los eventos que se produjeron durante toda la vida del
documento desde su generacin hasta su almacenamiento final.
Para revisar el ciclo de vida del documento presione el cono indicado el cual se encuentra en el
extremo derecho del mismo.
La siguiente pantalla muestra el ciclo de vida de un documento ejemplo.
27
Manual De Usuario
28
Manual De Usuario
Folio Interno (optativo): Nro correlativo interno utilizado por algunos sistemas de facturacin para la
realizacin de seguimientos internos de la empresa
ID Documento: Identificador interno colocado por Signature Server.
Usuario Creador: ID del usuario que gener el documento consultado
Actualizacin: Fecha y hora de la ltima actualizacin que se realiz sobre el documento
Fecha Descarga: Fecha en la que se realiz la descarga del documento para procesamiento interno de
la empresa emisora.
Tracking del documento: en este sector de la pantalla se muestra el ciclo de vida del documento. En
l se puede distinguir los diferentes cambios de estado que sufri el documento desde su recepcin a
Signature.
29
Manual De Usuario
En la misma se muestra todo el ciclo de vida del documento. En caso de desear Aprobar o Rechazar
el documento deber presionar el cono Aprobar que se encuentra en la parte superior de la
pantalla.
Al presionarlo aparecer la siguiente pantalla:
30
Manual De Usuario
Manual De Usuario
CAPITULO III
Reportes
32
Manual De Usuario
Gestin de Reportes
Para facilitar las actividades de gestin de la informacin de facturacin tanto emitida como
recibida, Signature Server provee la funcionalidad de generacin de reportes. Mediante la misma, los
usuarios pueden generar diferentes tipos de reportes los cuales quedarn disponibles en formato CVS
para ser procesados desde Excel.
33
Manual De Usuario
Definicin de Reportes
Signature Server proporciona una cantidad de reportes preconfigurados que permiten realizar las
consultas de facturacin ms frecuentes. Independientemente de esto, existe la posibilidad de
definir reportes personalizados en caso de ser necesario.
Es importante destacar que la definicin de estos reportes debe ser realizada por personal
capacitado ya que es necesario contar con un conocimiento acabado de la estructura de datos de
Signature Server.
Para generar un nuevo tipo de reporte presione el cono Nuevo
Manual De Usuario
Una vez completados todos los campos descritos, presione el cono Guardar para finalizar la
operacin.
Generacin de Reportes
Divisin: Seleccione la divisin para la cual desea generar el reporte. En caso de querer generar un
reporte de operaciones totales seleccione Todas
Fecha desde/hasta: Seleccione el rango de fechas a considerarse dentro del reporte.
Emisor: En caso de generar un reporte de compras, el usuario tiene la opcin de seleccionar el nro de
RUT de un proveedor determinado.
Utilizar documentos archivados: Signature Server permite la operacin en lnea de documentos
pertenecientes a los ltimos XX meses (configurable durante la instalacin). Todos los documentos
que excedan la fecha lmite pasan a quedar almacenados en un archivo histrico. En caso de desear
35
Manual De Usuario
generar un reporte con documentos ms all de la fecha de pasaje a histrico, seleccione la casilla
de verificacin correspondiente.
Una vez completados todos los datos del reporte presione el cono Guardar que se encuentra en la
parte superior de la pantalla para almacenar los cambios. En caso que desee volver al men anterior
sin confirmar la operacin, presione el cono Cancelar.
Una vez generado el reporte, el mismo aparecer en la pantalla principal del mdulo con estado
Pendiente. Eso significa que Signature Server se encuentra procesando la informacin solicitada.
Cuando Signature Server finalice la generacin del reporte el mismo pasar al estado Generado
Con el reporte generado el usuario tendr la posibilidad de visualizarlo para su anlisis. Para ello
debe seleccionar el cono Ver que se encuentra en el extremo derecho del reporte a consultar.
Otras Opciones
Presionando este cono se actualizar el estado de todos los reportes que se encuentren pendientes
en ese momento.
Regenerar reportes
Esta opcin permite regenerar el reporte solicitado de acuerdo a las condiciones originalmente
configuradas. Para ello seleccione el reporte a regenerar mediante la casilla de verificacin que se
encuentra en el extremo izquierdo del mismo y presione el cono indicado.
36
Manual De Usuario
Eliminar reportes
Esta opcin permite borrar los reportes generados. Para ello seleccione el reporte a eliminar
mediante la casilla de verificacin que se encuentra en el extremo izquierdo del mismo y presione el
cono indicado.
37
Manual De Usuario
CAPITULO IV
Configuracin
38
Manual De Usuario
Datos Empresa
Esta opcin permite la configuracin de todos los datos relacionados con la empresa usuaria de la
herramienta.
NOTA: El campo Email Contacto representa la casilla de correo declarada en el SII para el
intercambio de notificaciones con esta entidad.
Divisiones
Esta opcin permite la configuracin de todas las reas divisiones por las cuales se deseen perfilar
tanto los documentos enviados y/ recibidos como los usuarios de la empresa.
39
Manual De Usuario
Bsqueda de Divisiones
Esta opcin permite realizar la bsqueda de una divisin particular dentro de todas aquellas que
hayan sido configuradas dentro de Signature Server.
Los criterios que podrn utilizarse para la realizacin de la bsqueda son el nombre de la divisin y/
el cdigo que se le haya configurado en el momento de la carga.
Una vez cargados el los criterios de bsqueda, deber presionar el cono Buscar para ejecutar la
misma.
El cono Nueva Bsqueda limpia todos los criterios cargados en la bsqueda anterior.
40
Manual De Usuario
Nueva Divisin
Para la generacin de una nueva divisin dentro de la empresa emisora se deber completar los
campos que se describen a continuacin:
Cdigo: Indicar un mnemotcnico que permita identificar la divisin que se est creando
Nombre: Indicar el nombre completo de la divisin que se est creando.
Direccin: Para el caso de divisiones que se encuentran distribuidas en diferentes locaciones se
puede incorporar la direccin de la misma.
Email: Incorporar la casilla de correo de alguna persona que pueda servir de contacto dentro de la
divisin que se est creando.
Asociar documentos enviados/recibidos que cumplan: Signature Server permite la asociacin de los
documentos enviados/recibidos a las divisiones generadas basndose en comandos Xpath. Este
lenguaje permite realizar bsquedas dentro de archivos XML. En el Anexo 1 encontrar un completo
tutorial que describe el uso y aplicaciones de Xpath para la bsqueda de informacin en entornos
XML.
41
Manual De Usuario
Una vez que haya configurado todos los datos relacionados con la divisin a generar, presione el
cono Guardar.
Asociacin de usuarios
Esta opcin permite la asignacin de los usuarios generados desde el mdulo de Usuarios a las
divisiones creadas.
Asimismo, es posible configurar la matriz de acceso que cada uno de ellos tendr dentro de las
divisiones en las que se encuentre asignado.
Eso significa que un usuario podr asignado a una divisin y podr tener acceso a funcionalidades de
otras divisiones.
Los grupos de funcionalidades que pueden ser configuradas dentro de la matriz de acceso son las
siguientes:
Documentos Enviados
Documentos Recibidos
Emisin de Documentos Enviados
Emisin de Documentos Recibidos
42
Manual De Usuario
Una vez configurada la matriz de acceso para los usuarios configurados, presione el cono Guardar
para almacenar los cambios.
Eliminacin de divisiones
Para eliminar una divisin creada, seleccinela pinchando su nombre en la pantalla principal del
mdulo, y cuando se abra la ventana conteniendo los datos de configuracin de la misma presione el
cono Eliminar.
NOTA: Si la divisin tiene usuarios asociados, primero debe desasignarlos de la misma antes de
eliminarla.
Usuarios
Esta funcionalidad permite la administracin de todos los usuarios asociados a la empresa
configurada en Signature Server.
43
Manual De Usuario
Bsqueda de Usuarios
Este mdulo provee la funcionalidad de bsqueda de usuarios generados. Para ello debe seleccionar
las opciones presentadas en la imagen siguiente y luego presionar el cono Buscar
44
Manual De Usuario
Para generar un nuevo usuario dentro de la plataforma Signature Server presione el cono Nuevo.
Una vez dentro de la pantalla de carga de datos se debern completar los siguientes campos:
Usuario: Indique el nombre de usuario que se utilizar para identificarse en la plataforma.
Nombre: Indique el nombre completo del usuario.
Descripcin: Indique algn texto aclaratorio referente al usuario configurado.
Divisin: Seleccione la divisin a la cual va a estar asignado el usuario. Es importante destacar que
las divisiones deben haberse generado previamente a la carga de los usuarios.
Email: Indique la casilla de correo asociada al usuario configurado
45
Manual De Usuario
Activo: Seleccione esta casilla de verificacin para indicar si el usuario configurado se encuentra
activo al momento de generar la cuenta. Esta opcin es til por ejemplo en la situacin que el
usuario se vaya de vacaciones. En ese caso no es necesario eliminar el usuario para evitar el posible
acceso desautorizado a la plataforma.
Matriz de accesos otorgados al usuario: Indique todos los roles que desea asignarle al usuario que se
est configurando.
Una vez cargados todos los datos, presione el cono Guardar para almacenar los cambios.
NOTA: La contrasea predeterminada que genera Signature Server al momento de crear el usuario es
igual al nombre de usuario creado. En nuestro ejemplo:
Usuario: czapata
Contrasea: czapata
Para resetear la contrasea de un usuario determinado y volver a la contrasea predeterminada
presione el cono Contrasea ubicado en la parte superior de la pantalla del mdulo.
Cambiar Clave
Esta opcin permite la asignacin de una nueva clave de acceso a la plataforma. Para realizar el
cambio debe ingresar la nueva contrasea en el campo Nueva Contrasea, y confirmarla
nuevamente en el campo Confirmacin.
Para activar el cambio debe presionar el cono Contrasea.
46
Manual De Usuario
CAPITULO V
Administracin
47
Manual De Usuario
Folios
La administracin de folios es una funcionalidad aplicable a todas aquellas empresas que utilizan el
mdulo de facturacin manual provisto por Signature Server.
En ese caso, y dependiendo de los tipos de documentos tributarios electrnicos que deseen utilizar,
ser necesario previamente descargar los CAFs correspondientes desde el sitio del www.sii.cl
Bsqueda de Folios
Este mdulo provee la funcionalidad de bsqueda de folios instalados. Para ello debe seleccionar las
opciones presentadas en la imagen siguiente y luego presionar el cono Buscar
48
Manual De Usuario
Tipo de Documento: Seleccione desde esta caja de texto el tipo de documento tributario que desea
buscar.
Estado: Seleccione desde esta caja de texto el estado del CAF que desea buscar. Signature Server
administra dos estados posibles para los CAFs instalados, Vigentes y Archivados. El cambio de estado
lo realiza Signature Server en forma automtica en la medida que los folios se vayan consumiendo. Es
decir, una vez que los CAFs han sido consumidos pasan automticamente de estado Vigente a estado
Archivado.
Importacin de Folios
Para instalar los CAFs descargados desde el sitio del SII debe importarlos a Signature Server de la
siguiente manera:
Archivo a Importar: Presione el botn Examinar y seleccionar el CAF que desee instalar desde el
directorio en donde los haya descargado.
Una vez seleccionado el CAF presione el cono Importar.
Clientes
Con el objeto de facilitar la distribucin de los documentos tributarios electrnicos Signature Server
provee un mdulo de administracin de cartera de clientes/proveedores.
49
Manual De Usuario
Bsqueda de Clientes/Proveedores
Este mdulo provee la funcionalidad de bsqueda de clientes generados. Para ello debe seleccionar
las opciones presentadas en la imagen siguiente y luego presionar el cono Buscar
50
Manual De Usuario
Nuevo Cliente/Proveedor
51
Manual De Usuario
52
Manual De Usuario
Cdigo interno: Indique el cdigo que identifica al cliente dentro del sistema de gestin de la
empresa.
Importar Cliente/Proveedor
Productos
Al igual que con la administracin de la cartera de clientes/proveedores Signature Server permite la
gestin de un maestro de productos, con el objeto de facilitar la facturacin que se realice desde la
plataforma.
53
Manual De Usuario
Bsqueda de Productos
Este mdulo provee la funcionalidad de bsqueda de productos dentro del maestro de Signature
Server. Para ello debe seleccionar las opciones presentadas en la imagen siguiente y luego presionar
el cono Buscar.
54
Manual De Usuario
Nuevo Producto
Para ingresar un nuevo producto al maestro de productos de Signature Server, complete los datos
indicados en la imagen siguiente y luego presione el cono Guardar.
Plantillas
Este mdulo permite la administracin de todos los tipos de plantillas utilizados por Signature Server
para la conformacin de los documentos tributarios electrnicos almacenados y de los correos
electrnicos enviados a los clientes y proveedores.
A travs de la pantalla principal del mdulo usted puede seleccionar cualquiera de las plantillas
instaladas pinchando el nombre de la misma, descargar la plantilla pinchando la columna
Descargar ubicada en el extremo derecho de cada una de ellas.
55
Manual De Usuario
Nueva Plantilla
Para instalar una nueva plantilla dentro de Signature Server presione el cono Nueva.
56
Manual De Usuario
CR para generar y guardar PDF: Reporte Crystal Report utilizado para la generacin de
los PDFs almacenados para almacenamiento y envo por correo electrnico.
XSLT para visualizacin en lnea: Al igual que el formato anterior, esta plantilla .XSLT
se utiliza slo para la visualizacin del documento tributario y se elimina una vez
cerrada la ventana.
xDoc mapping template: Plantilla XML propietaria de Signature xDoc que se utiliza
para generar las transformaciones entre los archivos .spf entregados por el sistema de
facturacin de la empresa y los XML exigidos por el SII.
Cuerpo email para distribucin electrnica: Plantilla .eml que se utiliza para definir el
cuerpo de los correos electrnicos que van a ser enviados tanto a los clientes como a
los proveedores.
Distribucin
57
Manual De Usuario
Este mdulo provee la funcionalidad de bsqueda de las reglas de distribucin que han sido definidas
dentro de Signature Server. Para ello debe seleccionar las opciones presentadas en la imagen
siguiente y luego presionar el cono Buscar.
58
Manual De Usuario
Los criterios que pueden utilizarse para la bsqueda de reglas de distribucin son los siguientes:
Clase: Indique si la regla se corresponde con un documento tributario (Documento), con un
documento anexo (Adjunto).
Grupo: Indique si la regla se corresponde con un documento del grupo Enviados, del grupo
Recibidos.
Tipo de Documento: Seleccione Todos.
Descripcin: Indique una breve descripcin de la regla que desea consultar.
Tipo de Distribucin: Seleccione el tipo de distribucin que utilizar Signature Server para distribuir
los documentos electrnicos. Los tipos de distribucin utilizados por Signature Server son los
siguientes:
59
Manual De Usuario
Manual De Usuario
Obtener desde el documento XML: Especifique la cadena Xpath que indique la posicin
en el XML en donde se encuentra la casilla de correo destino.
Credenciales: Este campo indica el par usuario/clave que se utilizar en caso de enviar la
informacin por FTP http en lugar de correo electrnico. Las posibles opciones son:
Las siguientes: Indique el usuario y contrasea que utilizar Signature Server para
comunicarse con su contraparte.
Obtener desde el documento XML: Especifique la cadena Xpath que indique la posicin
en el XML en donde se encuentra la casilla de correo destino.
Signature Server permite la importacin masiva de reglas de distribucin. Las mismas deben ser
generadas sobre un archivo .csv previamente a la carga en Signature Server.
Para importar una lista de reglas de distribucin seleccione el archivo .csv presionando el botn
Examinar y luego presione el cono Importar.
Para borrar una regla de distribucin creada, seleccinela mediante la casilla de verificacin que se
encuentra en el extremo izquierdo de la misma y presione el cono Eliminar.
61
Manual De Usuario
Documentos
Este mdulo tiene el objetivo de brindar al usuario administrador una cantidad de herramientas de
gestin que le permita tener un control absoluto sobre todos los documentos que se encuentran en
Signature Server.
Bsqueda de Documentos
62
Manual De Usuario
SET Rechazado SII: SET (Paquete de DTE) rechazado en el SII (revisar Log del
Documento para ver tipo de rechazo).
Aprobado SII
Rechazado SII
No Enviado SII:
Estado final una vez cumplido los procesos del DTE (Gestin SII, Distribucin)
No Distribuido Elect.
Folio Anulado
Eliminado
Reenviar SII: Presenta los DTEs que han sido seleccionado manualmente para reenviar
al SII para su validacin (requiere que este en estado No Enviado SII).
63
Manual De Usuario
Redistribuir Elect.
Error. Dist. Elect.: Ha ocurrido un error en la distribucin del DTE (revisar Log del
Documento y Log de Eventos para los detalles).
Espera acuse de recibo: El documento fue enviado al receptor electrnico pero ste
todava no ha confirmado la recepcin del mismo
Recibido receptor
No recibido receptor
Aprobado receptor
Rechazado receptor
Actual: Seleccione esta casilla si desea buscar los documentos por el estado actual deseleccinela
si desea buscar los documentos por algn estado intermedio que hayan atravesado a lo largo de su
ciclo de vida.
Nmero entre: Indique el rango de nmeros que desea consultar
ID, Folio, Interno: Indique si la bsqueda por nmero ser por el ID colocado por Signature Server,
por el folio legal del documento por el folio interno asignado por el sistema de facturacin.
Fecha Entre: Indique el rango de fechas que desea consultar
TimeStamp: Seleccione esta casilla si desea que Signature Server realice la bsqueda en funcin del
time stamp colocado en el documento.
Emisor: Aplica slo a documentos recibidos. Indique el rut del emisor del documento
Receptor: Aplica slo a documentos enviados. Indique el rut del receptor del documento.
Track ID: Indique el Track ID entregado por el SII para el documento consultado.
Estado Descarga: Aplica slo a instalaciones en donde se configuren descargas automticas de
documentos. Seleccione el estado de la descarga del documento a consultar. Los posibles estados
contemplados son:
0 No Descargado
1- Descargado
2- Descarga confirmada
Estado PDF: Seleccione el estado del PDF del documento a consultar. Los posibles estados
contemplados son:
0 No Generado
64
Manual De Usuario
1 Generado
2 Plantilla no definida (Se pretende generar un PDF sin la plantilla asociada)
3 XML no existe (Se pretende generar un PDF de un XML inexistente)
4 Error Generando (Consulte Log de Eventos)
Reenviar SII
Esta funcionalidad aplica slo a documentos enviados cuyo estado sea No enviado SII. En ese caso
Signature Server reenva el documento seleccionado al SII.
Para ejecutar esta funcionalidad seleccione el documento a reenviar al SII mediante la casilla de
verificacin que se encuentra en el extremo izquierdo del mismo y presione el cono Reenviar SII.
Estado SII
Esta funcionalidad aplica slo a documentos recibidos cuyo estado sea No enviado SII. En ese caso
Signature Server realiza la consulta al SII del estado del documento seleccionado.
Para ejecutar esta funcionalidad seleccione el documento a consultar mediante la casilla de
verificacin que se encuentra en el extremo izquierdo del mismo y presione el cono Estado SII.
Generar PDF
En caso que el PDF no se pueda visualizar, usted tiene la opcin de regenerarlo. Para ello seleccione
el documento mediante la casilla de verificacin que se encuentra en el extremo izquierdo del
mismo y presione el cono Generar PDF que se encuentra en la parte superior de la pantalla.
Distribuir
65
Manual De Usuario
Esta opcin permite la redistribucin del documento por mail en el caso que el mismo se encuentre
asociado a una regla de distribucin previamente asignada. Para ello seleccione el o los documentos
que desee redistribuir mediante la casilla de verificacin que se encuentra en el extremo izquierdo
del mismo, y presione el cono Distribuir que se encuentra en la parte superior de la pantalla.
Anular Folio
Esta funcionalidad aplica slo a documentos enviados cuyos estados sean No enviado SII
Rechazado SII. En esos casos Signature Server anula el folio legal de los documentos seleccionados
y los deja en estado Anulado.
Para ello seleccione el o los documentos que desee anular mediante la casilla de verificacin que se
encuentra en el extremo izquierdo del mismo, y presione el cono Anular Folio que se encuentra en
la parte superior de la pantalla.
Descargar
Eliminar
Esta funcionalidad aplica slo a documentos enviados cuyos estados sean No enviado SII
Rechazado SII. En esos casos Signature Server elimina lgicamente los documentos seleccionados y
los deja en estado Eliminado.
66
Manual De Usuario
Para ello seleccione el o los documentos que desee eliminar mediante la casilla de verificacin que
se encuentra en el extremo izquierdo del mismo, y presione el cono Eliminar que se encuentra en
la parte superior de la pantalla.
Otras Opciones
Todos los documentos generados y recibidos quedarn almacenados en Signature Server en formato
XML tal como lo exige el SII. Para poder visualizarlos en ese formato presione el cono indicado el
cual se encuentra en el extremo derecho de cada documento generado.
Esta opcin le permitir visualizar el ciclo de vida del documento. En otros trminos, esta opcin
permite hacer un seguimiento de todos los eventos que se produjeron durante toda la vida del
documento desde su generacin hasta su almacenamiento final.
Para revisar el ciclo de vida del documento presione el cono indicado el cual se encuentra en el
extremo derecho del mismo.
La siguiente pantalla muestra el ciclo de vida de un documento enviado ejemplo.
67
Manual De Usuario
Manual De Usuario
Fecha Descarga: Fecha en la que se realiz la descarga del documento para procesamiento interno de
la empresa emisora.
Tracking del documento: en este sector de la pantalla se muestra el ciclo de vida del documento. En
l se puede distinguir los diferentes cambios de estado que sufri el documento desde su recepcin a
Signature.
69
Manual De Usuario
En la misma se muestra todo el ciclo de vida del documento. En caso de desear Aprobar o Rechazar
el documento deber presionar el cono Aprobar que se encuentra en la parte superior de la
pantalla.
Al presionarlo aparecer la siguiente pantalla:
70
Manual De Usuario
Manual De Usuario
CAPITULO VI
Operacin
72
Manual De Usuario
Reporte de Estados
Esta funcionalidad permite tener una visin global de los estados de todos los documentos emitidos o
recibidos dentro de un perodo determinado. El objeto de la misma es brindarle al usuario la
posibilidad de evaluar si todos los documentos considerados se encuentran cuadrados respecto a los
estados que conforman su ciclo de vida.
Reporte de Procesos
73
Manual De Usuario
Esta opcin permite visualizar la carga de trabaja que poseen los procesos activos en Signature
Server.
Logs
Esta opcin permite visualizar todos los eventos que se suceden dentro de Signature Server.
74
Manual De Usuario
75
Manual De Usuario
ANEXO I
Tutorial XPath
76
Manual De Usuario
Introduccin
Qu es y para qu sirve
Todo el procesamiento realizado con un fichero XML est basado en la posibilidad de direccionar o
acceder a cada una de las partes que lo componen, de modo que podamos tratar cada uno de los
elementos de forma diferenciada.
El tratamiento del fichero XML comienza por la localizacin del mismo a lo largo del conjunto de
documentos existentes en el mundo. Para llevar a cabo esta localizacin de forma unvoca, se
utilizan los URI (Unifom Resource Identifiers), de los cuales los URL (Unifom Resource
Locators) son sin duda los ms conocidos.
Una vez localizado el documento XML, la forma de seleccionar informacin dentro de l es mediante
el uso de XPath, que es la abreviacin de lo que se conoce como XML Path Language. Con XPath
podremos seleccionar y hacer referencia a texto, elementos, atributos y cualquier otra informacin
contenida dentro de un fichero XML.
XPath en s es un lenguaje sofisticado y complejo, pero distinto de los lenguajes procedurales que
solemos usar (C, C++, Basic, Java...). Adems, como casi todo en el mundo de XML, an est en
estado de desarrollo, por lo que no es fcil encontrar herramientas que incorporen todas sus
funcionalidades.
XPath es a su vez la base sobre la que se han especificado nuevas herramientas que aprovechar para
el tratamiento de documentos XML. Herramientas tales como XPointer, XLink y XQL (el lenguaje que
maneja los documentos XML como si de una base de datos se tratase), que tambin estn en estado
de desarrollo, pero que sin duda cambiarn el modo en que actualmente concebimos la navegacin
por la Web. As, XPath sirve para decir cmo debe procesar una hoja de estilo el contenido de una
pgina XML, pero tambin para poder poner enlaces o cargar en un navegador zonas determinadas de
una pgina XML, en vez de toda la pgina.
77
Manual De Usuario
Un caso especial de nodo son los nodos atributo. Un nodo puede tener tantos atributos como desee, y
para cada uno se le crear un nodo atributo. No obstante, dichos nodos atributo NO se consideran
como hijos suyos, sino ms bien como etiquetas aadidas al nodo elemento.
A continuacin se muestra un ejemplo de cmo se convierte en rbol un documento XML. Este mismo
ejemplo ser usado a lo largo de todo el tutorial. En primer lugar se muestra el documento XML y a
continuacin el rbol que genera.
XML
Pgina
:
<libro>
<titulo>Dos por tres calles</titulo>
<autor>Josefa Santos</autor>
<capitulo num="1">
La primera calle
<parrafo>
Era una sombra noche del mes de agosto...
</parrafo>
<parrafo destacar="si">
Ella, inocente cual
<enlace href="http://www.enlace.es">mariposa</enlace>
que surca el cielo en busca de libaciones...
</parrafo>
</capitulo>
<capitulo num="2" public="si">
La segunda calle
78
Manual De Usuario
rbol
generado
:
/
79
Manual De Usuario
|
+---libro
|
+---titulo
|
|
+---autor
|
+---(texto)Josefa Santos
|
+---capitulo [num=1]
|
+---parrafo
+---parrafo
|
+---capitulo [num=2]
|
+---(texto)La segunda calle
|
+---parrafo
|
+---parrafo
|
80
Manual De Usuario
81
Manual De Usuario
Aquellos atributos que tienen por valor el valor por defecto asignado en el DTD se tratarn como si el
valor se le hubiese al escribir el documento XML. Al contrario, no se crea nodo para atributos no
especificados en el documento XML, y con la propiedad #IMPLIED definida en su DTD. Tampoco se
crean nodos atributo para las definiciones de los espacios de nombre. Todo esto es normal si tenemos
en cuenta que no es necesario tener un DTD para procesar un documento XML.
Nodos comentario y de instrucciones de proceso
Aparte de los nodos indicados, en el rbol tambin se generan nodos para cada nodo con comentarios
y con instrucciones de proceso. Al contenido de estos nodos se puede acceder con la propiedad
string-value.
Manual De Usuario
Hay que tener en cuenta que una expresin en XPath no devuelve los elementos que cumplen con el
patrn que representa dicha expresin, sino que devuelve una referencia a dichos elementos; es
decir, una expresin XPath nos devuelve una lista de apuntadores a los elementos que encajan en el
patrn. Dicha lista puede estar vaca o contener uno o ms nodos.
Nodo contexto
Un location path siempre tiene un punto de partida llamado nodo contexto. Para entendernos es
como el directorio actual si nos referimos a un sistema de ficheros. As, si estando en Unix, damos
una orden ls obtendremos los ficheros que existen en el directorio actual, mientras que si decimos ls
/usr/bin obtendremos el listado de los ficheros existentes en el directorio /usr/bin con
independencia del directorio en que estemos colocados al dar la orden.
En los location path ocurre lo mismo. A menos que se indique un camino explcito, se entender que
el location path parte del nodo que en cada momento se est procesando.
El concepto de "nodo contexto" es imprescindible para comprender cmo se lleva a cabo la eleccin
de los nodos que ajustan con el patrn indicado en el location path. Para explicar esto, veamos
cmo actuara un motor de evaluacin de expresiones XPath al leer la siguiente expresin aplicada al
documento XML que manejamos desde el principio del tutorial:
/libro/capitulo/parrafo
(Aviso: lo que viene a continuacin requiere de pausada lectura, descansito para ir al frigorfico a por
algo de beber y pequeo masaje en los ojos... como mnimo)
En primer lugar comienza por leer /, lo cual le dice que debe seleccionar el nodo raz,
independientemente del nodo contexto que en ese momento exista. En el momento en que el
evaluador de XPath localiza el nodo raz, ste pasa a ser el nodo contexto de dicha expresin.
Siguiendo con nuestro ejemplo, el analizador leera ahora libro, lo cual le dice que seleccione TODOS
los elementos que cuelgan del nodo contexto (que atendiendo al prrafo anterior es el nodo raz) que
se llamen libro. Bueno... en este caso solo hay uno... porque (otra vez) solo puede haber un
elemento raz.
Sigamos avanzando con nuestro ejemplo. A continuacin el analizador leera capitulo, lo cual le dice
que seleccione TODOS los elementos que cuelgan del nodo contexto (que atendiendo al prrafo
anterior es el nodo libro).
En un disco sera imposible que hubiera dos directorios con el mismo nombre colgando de un mismo
directorio padre. Sin embargo, en nuestro documento XML podemos ver como hay dos elementos
capitulo colgando del elemento raz libro. Por tanto, en estos momentos hay dos elementos que
encajan con el patrn /libro/capitulo.
Y ahora viene lo mejor! El analizador contina leyendo la expresin XPath que le hemos dado y llega
a parrafo. Con ello le estamos diciendo que seleccione TODOS los elementos parrafo que cuelgan
del nodo contexto...pero NO hay un nodo contexto, sino DOS!! Bueno, no pasa nada, cada uno de
los nodos de ese conjunto de nodos va a tener su momento de gloria, de forma que el evaluador de
expresiones lo va a recorrer uno por uno haciendo que, mientras evala un determinado nodo, se
sea el nodo contexto de ese momento.
83
Manual De Usuario
En otras palabras, para localizar todos los elementos parrafo tal y como deseamos, se procesa el
primer elemento capitulo y de l se extraen todos los parrafo que contenga. A continuacin se pasa
al prximo elemento capitulo del cual se vuelven a extraer todos los de tipo parrafo que tenga... y
as sucesivamente. El resultado final es un nuevo conjunto de nodos (o para ser ms precisos,
conjunto de punteros a nodo) que encajan con el patrn buscado.
Predicados
Por lo poco que llevamos visto, podemos pensar que XPath es un gran mecanismo para seleccionar
muchos nodos a la vez, lo cual es muy til. Pero qu pasa si solo queremos seleccionar un nodo que
cumple ciertas caractersticas? o ms de un nodo que cumple con un patrn pero no todos los que lo
cumplen, sino solo aquellos con un atributo que les hemos aadido para saber que los puede ver todo
el mundo? Bueno, pues para todo esto se utilizan los predicados.
Los predicados se incluyen dentro de un location path utilizando los corchetes, como por ejemplo:
/libro/capitulo[@num="1"]/parrafo
Mediante el anterior location path estamos indicando que se escojan todos los elementos parrafo
de todos los elementos capitulo que tengan un atributo llamado num al cual se le haya asignado el
valor "1" (recordemos que en XML todos los atributos tienen valores de tipo cadena).
Atendiendo a nuestro ejemplo, solo hay un capitulo que cumpla dichas condiciones, por lo que solo
los elementos parrado que l contiene sern seleccionados.
Posteriormente, veremos qu tipo de cosas se pueden poner en un predicado.
Axes
Digamos que un Axe incluida en un location path realiza una seleccin de nodos dentro del rbol (o
mejor dicho, dentro del subrbol que cuelga del nodo o conjunto de nodos contexto) de acuerdo con
algn patrn.Bingo!!, cada vez que hemos usado la barra / (salvo para denominar el nodo raz)
estbamos usando un Axe.
Veamos las distintas Axes que podemos usar para recorrer el arbolito.
Ejemplos
Antes de empezar, ser bueno decir cmo vamos a ver el resultado de los ejemplos que se citan a
continuacin. En primer lugar podramos usar alguna herramienta de visualizacin de expresiones
XPath. Dichas herramientas permiten especificarles un fichero XML, generan el rbol asociado al
mismo y posteriormente nos dejan introducir expresiones XPath y las evalan dando el resultado.
Una de ellas es la realizada (en Java) por Khun Yee Fung, denominada XPath VisualTool. El sitio
original para bajrsela es http://www.wireoptional.com/XML/xslt.html
Por ello, el mtodo que voy a usar es utilizar las Extensible Stylesheet Language Transformations (o
XSLT), cuya explicacin escapa al mbito de ste tutorial, pero de las que se puede hallar ms
informacin en http://geneura.ugr.es/~jmerelo/XSLT.
84
Manual De Usuario
Para poder usarlas, en primer lugar, necesitamos un analizador de XSLT como Xalan o XP y por
supuesto uno de XML, como Xerces o XT. Si tenemos instalado Cocoon, entonces ya tenemos tanto
Xalan como Xerces.
Lo siguiente es llamar a Xalan indicndole qu fichero .xml debe tomar, qu fichero .xsl debe aplicar
y qu fichero .html (en nuestro caso) debe generar. Yo me he creado un ficherito bash que lo he
llamado xsl para reducir el proceso. Tiene la siguiente pinta:
#! /bin/bash /usr/local/jdk1.2.2/bin/java -cp /usr/local/xalan-j_1_2_2/xalan.jar:/usr/local/xalanj_1_2_2/xerces.jar \ org.apache.xalan.xslt.Process -in $1 -xsl $2 -out $3
Hay que tener en cuenta que posiblemente el ejecutable java est en otro directorio, e igual
ocurrir con Xerces y Xalan. Esto me permite hacer llamadas como la siguiente:
xsl ejemplo.xml ejemplo.xsl ejemplo.html
El fichero .xml que vamos a usar es el anteriormente indicado (el de los libros, captulos, etc), al
cual vamos a llamar ejemplo.xml. El fichero .xsl tiene el siguiente formato:
<?xml version="1.0" encoding="ISO-8859-1"?>
<!-==========================================================================
| File..........: ejemplos.xsl
| Author........: Victor Manuel Rivas Santos, vrivas@ujaen.es
|
(C) GeNeura Team, 2000
|
http://www.geneura.org, todos@geneura.ugr.es
| Date..........: 26-Dec-2000
| Description...: XSL for tutorials
==========================================================================
-->
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="libro">
<HTML>
<HEAD>
<TITLE>Ejemplos en XPath</TITLE>
</HEAD>
<BODY>
<H1>Resultados:</H1>
<PRE>
<xsl:apply-templates select="/libro/capitulo/text()"/>
</PRE>
</BODY>
85
Manual De Usuario
</HTML>
</xsl:template>
</xsl:stylesheet>
Lo que vamos a hacer cada vez que veamos un ejemplo es sustituir la parte en rojo por el ejemplo
(dejndole el /text() final para que muestre el contenido de los elementos seleccionados). Una vez
substituido, lo grabamos como ejemplo.xsl, y llamamos al ficherillo xsl dndole los ficheros segn:
xsl ejemplo.xml ejemplo.xsl ejemplo.html
Y a continuacin visualizamos en cualquier navegador la pgina ejemplo.html. Fcil, no?
En la seccin 4. Ejercicios, puedes acceder a una pgina web que te permitir hacer ejercicios de
XPath mucho ms fcilmente.
Child
Es el Axe utilizada por defecto. Se corresponde con la barra, / (aunque tiene una forma ms larga
que es: /child::).
Seleccionar todos los titulo de un libro:
/libro/titulo
Attribute
Se corresponde con el signo de la arroba, @ (o en su forma larga que es: attribute::).
Mediante este operador podemos seleccionar aquellos nodos atributos que deseemos, especialmente
indicando el nombre. Ntese, que para seleccionar los nodos elemento que muestran dichos
atributos, lo que se ha de usar es un predicado (como se ha indicado ya anteriormente)
Para seleccionar el atributo num que posean los elementos capitulo
/libro/capitulo/@num
Para seleccionar todos los elementos hijo de los capitulo que posean el atributo public
/libro/capitulo[@public]/*
Para seleccionar todos los elementos hijo de parrafo cuyo atributo destacar sea igual a "si".
/libro/titulo/parrafo[@destacar="si"]
Descendant
Se especifica poniendo una doble barra: // (en su forma larga: descendant::).
86
Manual De Usuario
Sirve para seleccionar TODOS los nodos que descendiendan del conjunto de nodos contexto. Es decir,
no solo los hijos de los nodos contexto, sino tambin los hijos de los hijos, y los hijos de estos, etc.
Para seleccionar todos los parrafo de un libro:
/libro//parrafo
Para seleccionar todos los descendientes de parrafo que tienen un atributo href.
//parrafo//*[@href]
Para ver el valor del atributo href del caso anterior:.
//parrafo//*[@href]/@href
Para seleccionar todos los elementos descendientes de capitulo
/libro/titulo//*
Self
Se especifica mediante el ..
Es muy til pues sirve para seleccionar el nodo contexto. Por ejemplo, supongamos que deseamos
seleccionar todos los parrafo descendientes del nodo contexto. No podemos escribir //parrafo, dado
que seleccionara todos los descendientes del nodo raz. Por ello, la forma correcta es: .//parrafo
Parent
Al igual que en los sistemas de ficheros, se utilizan los dos puntos para identificarlo: ..
El comportamiento de este Axe es un poco extrao al principio dado que realiza un paso hacia atrs
en el rbol de nodos
Seleccionar todos los nodos que tienen algn hijo de tipo parrafo:
//parrafo/..
Seleccionar todos los nodos capitulo que tienen algn hijo de tipo parrafo:
//parrafo/../../capitulo
O bien:
//capitulo/parrafo/..
Ancestor
De todas las Axes que podemos usar, esta es la nica que no tiene ninguna forma de abreviacin, sino
que hay que ponerla como ancestor::
87
Manual De Usuario
Ancestor es a parent lo que descendant es a child. Es decir, devuelve todos los elementos de los
cuales el nodo contexto es descendiente.
Seleccionar todos los elementos que tienen entre sus descendientes algn parrafo
//ancestor::parrafo/ancestor::*
Seleccionar todos los captulos que tienen entre sus descendientes alguno con el atributo href
//*[@href]/ancestor::capitulo
Nodos Test
Los nodos test son algo as como funciones que nos van a ayudar a restringir un poquito lo que nos
devuelve una expresin XPath. Ya hemos visto algunos de estos nodos test en los ejemplos
anteriores. Pero ahora vamos a verlos con ms detenimiento.
En primer lugar hemos de distinguir entre las Axes de contenido (content axis) de las que no lo son.
Las Axes de contenido son bsicamente todas las vistas excepto attibute y namespace (es como
attribute pero para obtener el "espacio de nombres" asociado al elemento).
Nodos test aplicables a TODAS las Axes
*
El nodo test * devuelve todos los nodos de tipo principal (es decir, elemento, atributo o espacio de
nombres), pero no nodos de texto, comentarios, y de instrucciones de proceso.
Seleccionar todos los nodos principales descendientes de los parrafo:
//parrafo/*
node()
El nodo test nod() devuelve todos los nodos de todos los tipos.
Seleccionar todos los nodos descendientes de los parrafo:
//parrafo/node()
Nodos Test aplicables SOLO a la Axes de contenido
text()
Cualquier nodo de tipo texto.
88
Manual De Usuario
89
Manual De Usuario
Aunque tambin se puede hacer uso del operador and encerrando entre parntesis los distintos
predicados lgicos.
Ejemplo similar al anterior
//capitulo[ (parrafo/*[@href]) and (@public='si')]
Tambin se puede hacer uso de la operacin or.
Existe otro tipo de operacin or que utiliza la barra vertical: | separando no dos predicados, sino dos
expresiones XPath.
Seleccionar todos los capitulo que tengan un parrafo que tenga algn elemento con atributo href
o todos los apendice:
//capitulo[parrafo/*[@href]]|//apendice
Por ltimo, tambin podemos especificar con not la negacin de alguna de las negaciones del
predicado.
Seleccionar todos los capitulo que no tengan el atributo public
//capitulo[not(@public)]
Predicados con funciones de cardinalidad
Existen, por ltimo, ciertas funciones que nos van a servir para restringir el conjunto de nodos
devueltos en una expresin XPath basndose en la posicin del elemento devuelto. Tales funciones
son: position(), last() e id().
position()
Seleccionar el segundo capitulo:
//capitulo[position()=2]
Esta funcin se puede simular poniendo simplemente el nmero entre corchetes.
Mismo ejemplo anterior: seleccionar el segundo capitulo:
//capitulo[2]
last()
Seleccionar el ltimo capitulo:
//capitulo[last()]
90
Manual De Usuario
//capitulo[not(position()=last())]
Estas funciones se pueden usar con expresiones matemticas, como en el siguiente ejemplo.
Seleccionar el penltimo capitulo:
T
//capitulo[last()-1]
id()
T
91