Skip to content

Instantly share code, notes, and snippets.

@acadavid

acadavid/buscar_actividad.md

Created November 11, 2011 22:20
Show Gist options
  • Save acadavid/1359505 to your computer and use it in GitHub Desktop.
Save acadavid/1359505 to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. acadavid revised this gist Nov 11, 2011. 1 changed file with 30 additions and 0 deletions.
    30 changes: 30 additions & 0 deletions buscar_actividad.md
    View file
    Original file line number Diff line number Diff line change
    @@ -30,8 +30,38 @@
    <td>duracion</td>
    <td>Consultar actividades realizadas por un usuario cuyo nombre de usuario es usuario</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>modulo</td>
    <td>Consultar actividades realizadas al módulo cuyo nombre es modulo</td>
    </tr>
    </table>

    **Schema XML**

    <?xml version="1.0"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="filtroDeActividad">
    <xs:complexType>
    <xs:element name="id" type="xs:integer"/>
    <xs:element name="accion" type="xs:string"/>
    <xs:element name="rangoDeFechas" type="xs:date"/>
    <xs:element name="modulo" type="xs:string"/>
    <xs:element name="duracion" type="xs:positiveInteger"/>
    </xs:complexType>
    </xs:element>
    </xs:schema>

    **Ejemplo**

    <filtroDeActividad>
    <id>1</id>
    <accion>Ver</accion>
    <rangoDeFechas>11/11/2011 23:11 a 12/11/2011 23:40<rangoDeFechas>
    <modulo>Perfil</modulo>
    <duracion>1000</duracion>
    </filtroDeActividad>

    # Semántica Operativa

    Array<Actividades> consultarActividad(string usuarioActual, FiltroActividad filtroActividad) {
  2. acadavid revised this gist Nov 11, 2011. 1 changed file with 5 additions and 0 deletions.
    5 changes: 5 additions & 0 deletions buscar_actividad.md
    View file
    Original file line number Diff line number Diff line change
    @@ -53,6 +53,8 @@

    El método 'BuscarActividad' retona un arreglo de las actividades que se ajustan al filtro de actividad. Este arreglo se retornarna en formato XML para que pueda ser procesado y visualizado en el HTML.

    **Schema XML**

    <?xml version="1.0"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="actividades">
    @@ -71,6 +73,9 @@ El método 'BuscarActividad' retona un arreglo de las actividades que se ajustan
    </xs:element>
    </xs:schema>


    **Ejemplo**

    <response>
    <actividades>
    <actividad>
  3. acadavid revised this gist Nov 11, 2011. 1 changed file with 18 additions and 0 deletions.
    18 changes: 18 additions & 0 deletions buscar_actividad.md
    View file
    Original file line number Diff line number Diff line change
    @@ -53,6 +53,24 @@

    El método 'BuscarActividad' retona un arreglo de las actividades que se ajustan al filtro de actividad. Este arreglo se retornarna en formato XML para que pueda ser procesado y visualizado en el HTML.

    <?xml version="1.0"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="actividades">
    <xs:sequence minOccurs="0" maxOccurs="unbounded">
    <xs:element name="actividad">
    <xs:complexType>
    <xs:element name="id" type="xs:integer"/>
    <xs:element name="accion" type="xs:string"/>
    <xs:element name="moduloEncargado" type="xs:string"/>
    <xs:element name="fechaRealizacion" type="xs:date"/>
    <xs:element name="duracion" type="xs:positiveInteger"/>
    <xs:element name="parametrosModulo" type="xs:string"/>
    </xs:complexType>
    </xs:element>
    </xs:sequence>
    </xs:element>
    </xs:schema>

    <response>
    <actividades>
    <actividad>
  4. acadavid revised this gist Nov 11, 2011. 1 changed file with 54 additions and 54 deletions.
    108 changes: 54 additions & 54 deletions buscar_actividad.md
    View file
    Original file line number Diff line number Diff line change
    @@ -4,34 +4,33 @@

    **Filtro de Actividad**

    <table>
    <tr>
    <td>Tipo de dato</td>
    <td>Nombre</td>
    <td>Uso</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>id</td>
    <td>Consultar actividad por identificador</td>
    </tr>
    <tr>
    <td>String</td>
    <td>accion</td>
    <td>Consultar actividad por accion de la actividad</td>
    </tr>
    <tr>
    <td>Date</td>
    <td>rangoDeFechas</td>
    <td>Consultar actividades realizadas en un rango de fechas</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>duracion</td>
    <td>Consultar actividades realizadas por un usuario cuyo nombre de usuario es usuario</td>
    </tr>
    </table>

    <table>
    <tr>
    <td>Tipo de dato</td>
    <td>Nombre</td>
    <td>Uso</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>id</td>
    <td>Consultar actividad por identificador</td>
    </tr>
    <tr>
    <td>String</td>
    <td>accion</td>
    <td>Consultar actividad por accion de la actividad</td>
    </tr>
    <tr>
    <td>Date</td>
    <td>rangoDeFechas</td>
    <td>Consultar actividades realizadas en un rango de fechas</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>duracion</td>
    <td>Consultar actividades realizadas por un usuario cuyo nombre de usuario es usuario</td>
    </tr>
    </table>

    # Semántica Operativa

    @@ -95,29 +94,30 @@ El método 'BuscarActividad' retona un arreglo de las actividades que se ajustan

    # Tabla de Excepciones

    <table>
    <tr>
    <th>Nombre de la excepción</th>
    <th>Cuándo se produce</th>
    <th>Información que maneja</th>
    </tr>

    <tr>
    <td>ConsultaActividadNoAutorizadaException</td>
    <td>Cuando el módulo de Políticas indica que el usuario actual no está autorizado para realizar consulta de actividades existentes</td>
    <td>Nada</td>
    </tr>

    <tr>
    <td>Actividad</td>
    <td>Cuando el módulo encargado de ejecutar la actividad lanza una excepción (es decir, cuando ocurre una excepción fuera del módulo de Actividades).</td>
    <td>Información extra que haya sido pasada por el módulo encargado sobre el error</td>
    </tr>

    <tr>
    <td>ErrorEnBaseDeDatosException</td>
    <td>Cuando se produce un error al almacenar la actividad en la base de datos.</td>
    <td>Causa de la excepción (por ejemplo, falta de espacio en disco o servidor de base de datos caído)</td>
    </tr>

    </table>
    <table>
    <tr>
    <th>Nombre de la excepción</th>
    <th>Cuándo se produce</th>
    <th>Información que maneja</th>
    </tr>

    <tr>
    <td>ConsultaActividadNoAutorizadaException</td>
    <td>Cuando el módulo de Políticas indica que el usuario actual no está autorizado para realizar consulta de actividades existentes</td>
    <td>Nada</td>
    </tr>

    <tr>
    <td>Actividad</td>
    <td>Cuando el módulo encargado de ejecutar la actividad lanza una excepción (es decir, cuando ocurre una excepción fuera del módulo de Actividades).</td>
    <td>Información extra que haya sido pasada por el módulo encargado sobre el error</td>
    </tr>

    <tr>
    <td>ErrorEnBaseDeDatosException</td>
    <td>Cuando se produce un error al almacenar la actividad en la base de datos.</td>
    <td>Causa de la excepción (por ejemplo, falta de espacio en disco o servidor de base de datos caído)</td>
    </tr>

    </table>

  5. acadavid revised this gist Nov 11, 2011. 1 changed file with 81 additions and 77 deletions.
    158 changes: 81 additions & 77 deletions buscar_actividad.md
    View file
    Original file line number Diff line number Diff line change
    @@ -4,33 +4,34 @@

    **Filtro de Actividad**

    <table>
    <tr>
    <td>Tipo de dato</td>
    <td>Nombre</td>
    <td>Uso</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>id</td>
    <td>Consultar actividad por identificador</td>
    </tr>
    <tr>
    <td>String</td>
    <td>accion</td>
    <td>Consultar actividad por accion de la actividad</td>
    </tr>
    <tr>
    <td>Date</td>
    <td>rangoDeFechas</td>
    <td>Consultar actividades realizadas en un rango de fechas</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>duracion</td>
    <td>Consultar actividades realizadas por un usuario cuyo nombre de usuario es usuario</td>
    </tr>
    </table>
    <table>
    <tr>
    <td>Tipo de dato</td>
    <td>Nombre</td>
    <td>Uso</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>id</td>
    <td>Consultar actividad por identificador</td>
    </tr>
    <tr>
    <td>String</td>
    <td>accion</td>
    <td>Consultar actividad por accion de la actividad</td>
    </tr>
    <tr>
    <td>Date</td>
    <td>rangoDeFechas</td>
    <td>Consultar actividades realizadas en un rango de fechas</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>duracion</td>
    <td>Consultar actividades realizadas por un usuario cuyo nombre de usuario es usuario</td>
    </tr>
    </table>


    # Semántica Operativa

    @@ -52,19 +53,21 @@
    # Tipo de Retorno

    El método 'BuscarActividad' retona un arreglo de las actividades que se ajustan al filtro de actividad. Este arreglo se retornarna en formato XML para que pueda ser procesado y visualizado en el HTML.
    <actividades>
    <actividad>
    <id>34</id>
    <accion>Ver</accion>
    <moduloEncargado>Perfil</moduloEncargado>
    <fechaRealizacion>31/11/2011 23:11</fechaRealizacion>
    <duracion>1500</duracion>
    <parametrosModulo>

    <response>
    <actividades>
    <actividad>
    <id>34</id>
    <accion>Ver</accion>
    <moduloEncargado>Perfil</moduloEncargado>
    <fechaRealizacion>31/11/2011 23:11</fechaRealizacion>
    <duracion>1500</duracion>
    <parametrosModulo>
    <![CDATA[
    <perfil>
    <id>jaimito</id>
    </perfil>
    ]]>
    <perfil>
    <id>jaimito</id>
    </perfil>
    ]]>
    </parametrosModulo>
    </actividad>
    <actividad>
    @@ -74,46 +77,47 @@ El método 'BuscarActividad' retona un arreglo de las actividades que se ajustan
    <fechaRealizacion>31/11/2011 23:58</fechaRealizacion>
    <duracion>1000</duracion>
    <parametrosModulo>
    <![CDATA[
    <contenido>
    <titulo>2 minutes to midnight</titulo>
    <texto>The killer's breed or the demon's seed,
    The glamour, the fortune, the pain,
    Go to war again, blood is freedom's stain,
    But don't you pray for my soul anymore. Sing along!
    </texto>
    </contenido>
    ]]>
    </parametrosModulo>
    </actividad>
    <![CDATA[
    <contenido>
    <titulo>2 minutes to midnight</titulo>
    <texto>The killer's breed or the demon's seed,
    The glamour, the fortune, the pain,
    Go to war again, blood is freedom's stain,
    But don't you pray for my soul anymore. Sing along!
    </texto>
    </contenido>
    ]]>
    </parametrosModulo>
    </actividad>
    </actividades>
    <response>


    # Tabla de Excepciones

    <table>
    <tr>
    <th>Nombre de la excepción</th>
    <th>Cuándo se produce</th>
    <th>Información que maneja</th>
    </tr>

    <tr>
    <td>ConsultaActividadNoAutorizadaException</td>
    <td>Cuando el módulo de Políticas indica que el usuario actual no está autorizado para realizar consulta de actividades existentes</td>
    <td>Nada</td>
    </tr>

    <tr>
    <td>Actividad</td>
    <td>Cuando el módulo encargado de ejecutar la actividad lanza una excepción (es decir, cuando ocurre una excepción fuera del módulo de Actividades).</td>
    <td>Información extra que haya sido pasada por el módulo encargado sobre el error</td>
    </tr>

    <tr>
    <td>ErrorEnBaseDeDatosException</td>
    <td>Cuando se produce un error al almacenar la actividad en la base de datos.</td>
    <td>Causa de la excepción (por ejemplo, falta de espacio en disco o servidor de base de datos caído)</td>
    </tr>

    </table>
    <table>
    <tr>
    <th>Nombre de la excepción</th>
    <th>Cuándo se produce</th>
    <th>Información que maneja</th>
    </tr>

    <tr>
    <td>ConsultaActividadNoAutorizadaException</td>
    <td>Cuando el módulo de Políticas indica que el usuario actual no está autorizado para realizar consulta de actividades existentes</td>
    <td>Nada</td>
    </tr>

    <tr>
    <td>Actividad</td>
    <td>Cuando el módulo encargado de ejecutar la actividad lanza una excepción (es decir, cuando ocurre una excepción fuera del módulo de Actividades).</td>
    <td>Información extra que haya sido pasada por el módulo encargado sobre el error</td>
    </tr>

    <tr>
    <td>ErrorEnBaseDeDatosException</td>
    <td>Cuando se produce un error al almacenar la actividad en la base de datos.</td>
    <td>Causa de la excepción (por ejemplo, falta de espacio en disco o servidor de base de datos caído)</td>
    </tr>

    </table>
  6. acadavid created this gist Nov 11, 2011.
    119 changes: 119 additions & 0 deletions buscar_actividad.md
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,119 @@
    **Nombre del método:** BuscarActividad

    # Parámetros del método:

    **Filtro de Actividad**

    <table>
    <tr>
    <td>Tipo de dato</td>
    <td>Nombre</td>
    <td>Uso</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>id</td>
    <td>Consultar actividad por identificador</td>
    </tr>
    <tr>
    <td>String</td>
    <td>accion</td>
    <td>Consultar actividad por accion de la actividad</td>
    </tr>
    <tr>
    <td>Date</td>
    <td>rangoDeFechas</td>
    <td>Consultar actividades realizadas en un rango de fechas</td>
    </tr>
    <tr>
    <td>Integer</td>
    <td>duracion</td>
    <td>Consultar actividades realizadas por un usuario cuyo nombre de usuario es usuario</td>
    </tr>
    </table>

    # Semántica Operativa

    Array<Actividades> consultarActividad(string usuarioActual, FiltroActividad filtroActividad) {
    autorizado = Politicas.tienePermisos?(usuarioActual, actividad)
    if (!autorizado) {
    raise ConsultaActividadNoAutorizadaException
    }
    try {
    resultado = BaseDeDatos.buscarConAttributos(filtroActividad)
    } catch {
    raise ErrorEnBaseDeDatosException
    }
    return resultado
    }

    # Tipo de Retorno

    El método 'BuscarActividad' retona un arreglo de las actividades que se ajustan al filtro de actividad. Este arreglo se retornarna en formato XML para que pueda ser procesado y visualizado en el HTML.
    <actividades>
    <actividad>
    <id>34</id>
    <accion>Ver</accion>
    <moduloEncargado>Perfil</moduloEncargado>
    <fechaRealizacion>31/11/2011 23:11</fechaRealizacion>
    <duracion>1500</duracion>
    <parametrosModulo>
    <![CDATA[
    <perfil>
    <id>jaimito</id>
    </perfil>
    ]]>
    </parametrosModulo>
    </actividad>
    <actividad>
    <id>35</id>
    <accion>Crear</accion>
    <moduloEncargado>Contenido</moduloEncargado>
    <fechaRealizacion>31/11/2011 23:58</fechaRealizacion>
    <duracion>1000</duracion>
    <parametrosModulo>
    <![CDATA[
    <contenido>
    <titulo>2 minutes to midnight</titulo>
    <texto>The killer's breed or the demon's seed,
    The glamour, the fortune, the pain,
    Go to war again, blood is freedom's stain,
    But don't you pray for my soul anymore. Sing along!
    </texto>
    </contenido>
    ]]>
    </parametrosModulo>
    </actividad>
    </actividades>

    # Tabla de Excepciones

    <table>
    <tr>
    <th>Nombre de la excepción</th>
    <th>Cuándo se produce</th>
    <th>Información que maneja</th>
    </tr>

    <tr>
    <td>ConsultaActividadNoAutorizadaException</td>
    <td>Cuando el módulo de Políticas indica que el usuario actual no está autorizado para realizar consulta de actividades existentes</td>
    <td>Nada</td>
    </tr>

    <tr>
    <td>Actividad</td>
    <td>Cuando el módulo encargado de ejecutar la actividad lanza una excepción (es decir, cuando ocurre una excepción fuera del módulo de Actividades).</td>
    <td>Información extra que haya sido pasada por el módulo encargado sobre el error</td>
    </tr>

    <tr>
    <td>ErrorEnBaseDeDatosException</td>
    <td>Cuando se produce un error al almacenar la actividad en la base de datos.</td>
    <td>Causa de la excepción (por ejemplo, falta de espacio en disco o servidor de base de datos caído)</td>
    </tr>

    </table>