====== attach ======

===== Tipo =====

  * Package



===== Descripción =====
**attach** ofrece interfaces de usuario para el uso de adjuntos en cualquier aplicación WAINE. Los adjuntos pueden estar clasificados y por defecto tienen protección de modificación y borrado, es decir, sólo puede borrar o eliminar un ajunto quien lo creó. Estas restricciones pueden ser eliminadas. Vea la sección de ejemplos.

===== Funcionalides =====

El paquete provee elementos de los modelos de presentación y dominio. En cuanto a la presentación ofrece los siguientes elementos:
  * **attach.struct.category**: Administración de categorías de adjuntos {{ waine:package:attach_fui_category.png |}}
  * **attach.struct.search**: Búsqueda de adjuntos {{ waine:package:attach_fui_search.png |}}
  * **attach.struct.nocatsearch**: Búsqueda de adjuntos sin categoría (para los casos en que no se empleen categoría) {{ waine:package:attach_fui_nocatsearch.png |}}
  * **attach.struct.listall**: Lista de todos los adjuntos del sistema {{ waine:package:attach_fui_listall.png |}}
  * **attach.form.catattach**: Formulario para la gestión de adjuntos. En la sección de ejemplos puede ver cómo emplearlo en sus aplicaciones {{ waine:package:attach_fui_catattach.png |}}
  * **attach.form.category**: Formulario para la manipulación de categorías


===== Ejemplos =====

   * Adjunto con todas sus características: categorías, protección de borrado y actualización
<code>
 <struct id="s_catattachpud" type="relation">
       <param name="form_split" value="rows=18%,*"/>
   
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="1"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   
       
       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="fields_remove" value="5:7"/>                                                   
       <param ord="2" name="source_filter_field" value="fk"/>                                                   
    </struct>   
</code>

   * Adjunto con categoría prefijada, protección de borrado y actualización
<code>
    <struct id="s_fixcatattachpud" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="2"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   

       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="fields_modify[0]" value="defvalue#2#3"/>         <!-- Asignando categoría -->                                                   
       <param ord="2" name="fields_remove" value="5:7"/>                                                   
       <param ord="2" name="fields_readonly" value="3"/>                                                   
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="source_filter_field" value="fk"/>                                                   
    </struct>
</code>

   * Adjunto sin categoría pero con protección de borrado y actualización
<code>
    <struct id="s_uncatattachpud" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="3"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   

       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="fields_remove" value="3:5:7"/>                   <!-- Se elimina también el campo categoría -->                                                   
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="source_filter_field" value="fk"/>                                                                                            
    </struct>
</code>

   * Adjunto concategorías y protección de borrado
<code>
   <struct id="s_catattachpd" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="1"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   
       
       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="fields_hidden" value="6"/>                                                   
       <param ord="2" name="fields_remove" value="5:7"/>                                                   
       <param ord="2" name="event_beforeupdate" value="0"/>                                                   
       <param ord="2" name="source_filter_field" value="fk"/>                                                   
    </struct>   
</code>

   * Adjunto con categoría prefijada y protección de borrado
<code>
    <struct id="s_fixcatattachpd" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="2"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   

       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="fields_modify[0]" value="defvalue#2#3"/>                                                   
       <param ord="2" name="fields_hidden" value="6"/>                                                   
       <param ord="2" name="fields_remove" value="5:7"/>                                                   
       <param ord="2" name="fields_readonly" value="3"/>                                                   
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="event_beforeupdate" value="0"/>                                                                                                      
       <param ord="2" name="source_filter_field" value="fk"/>                                                   
    </struct>
</code>

   * Adjunto sin categoría con protección de eliminación
<code>
    <struct id="s_uncatattachpd" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="3"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   

       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="fields_hidden" value="6"/>                                                   
       <param ord="2" name="fields_remove" value="3:5:7"/>                                                   
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="event_beforeupdate" value="0"/>                                                                                                   
       <param ord="2" name="source_filter_field" value="fk"/> 
    </struct>
</code>

  * Adjunto concategorías sin protección
<code>
    <struct id="s_catattach" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="1"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   
       
       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="fields_hidden" value="4:6"/>                                                   
       <param ord="2" name="fields_remove" value="5:7"/>                                                   
       <param ord="2" name="event_beforeupdate" value="0"/>                                                   
       <param ord="2" name="event_beforedelete" value="0"/>                                                   
       <param ord="2" name="source_filter_field" value="fk"/>                                                   
    </struct>   
</code>

   * Adjunto con categoría prefijada sin protección
<code>
    <struct id="s_fixcatattach" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="2"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   

       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="fields_modify[0]" value="defvalue#2#3"/>                                                   
       <param ord="2" name="fields_hidden" value="4:6"/>                                                   
       <param ord="2" name="fields_remove" value="5:7"/>                                                   
       <param ord="2" name="fields_readonly" value="3"/>                                                   
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="event_beforeupdate" value="0"/>                                                   
       <param ord="2" name="event_beforedelete" value="0"/>                                                   
       <param ord="2" name="source_filter_field" value="fk"/>                                                   
    </struct>
</code>

   * Adjunto sin categorías ni protección
<code>
    <struct id="s_uncatattach" type="relation">
       <param name="form_split" value="rows=18%,*"/>
  
       <param ord="1" name="formid" value="f_entry"/>                        <!-- Formulario con datos genéricos -->
       <param ord="1" name="form_type" value="table"/>
       <param ord="1" name="fields_readonly" value="1"/>
       <param ord="1" name="source_filter_field" value="pk"/>                                                   
       <param ord="1" name="source_filter_value" value="3"/>                                                   
       <param ord="1" name="source_row" value="0"/>                                                   

       <param ord="2" name="formid" value="attach.form.catattach"/>          <!-- Formulario con adjuntos a los datos anteriores -->
       <param ord="2" name="form_type" value="table"/>
       <param ord="2" name="fields_hidden" value="4:6"/>                                                   
       <param ord="2" name="fields_remove" value="3:5:7"/>                                                   
       <param ord="2" name="button_data" value="1"/>                                                   
       <param ord="2" name="event_beforeupdate" value="0"/>                                                   
       <param ord="2" name="event_beforedelete" value="0"/>                                                   
       <param ord="2" name="source_filter_field" value="fk"/>                                                   
    </struct>
</code>


===== Notas =====