Duplicar un documento.¶
Información¶
Autor David Henriquez Sitio Web http://www.facebook.com/adapting-lab Repositorio source:Acciones-America/trunk/src/DuplicateDocument Código fuente http://svn-community.adapting.com:8080/svn/Community/Plugins/Acciones-America/trunk/src/DuplicateDocument/ Versión Actual v1.0 Compatible con Abox 2.5.5
Resumen¶
A través de esta acción se puede realizar las siguientes operaciones.
1. Solo Duplica.
No se requieren parámetros para esta operación.
2. Duplica y mueve a carpeta.
Requiere el parámetro con la ubicación de la carpeta
3. Crea versión (menor).
Requiere el parámetro de acción.
4. Crea versión y asigna tipo por parámetro.
Requiere el parámetro de acción y tipo.
5. Duplica y relaciona (bidireccionalmente).
Requiere el parámetro de acción.
6. Duplica, relaciona bidireccionalmente y mueve a carpeta.
Requiere el parámetro de acción y carpeta.
7. Duplica, relaciona unidir/bidir, y mueve a carpeta.
Requiere el parámetro de acción, tipo y carpeta.
Nota: Para las operaciones con carpeta destino se requiere la acción "MoveToFolderFromMetadata".
Notas de instalación¶
Descargue el código fuente del plugin y compílelo usando Visual Studio 2010. Luego dependiendo si lo va a integrar en una instalación de Abox o en un proyecto de extensión de Abox sigua las siguientes instrucciones.
En una instalación de Abox¶
Copiar la dll que genera el proyecto, en principio se debe llamar Adapting.DuplicateDocumentAction.dll, en la carpeta /bin del sitio web donde esta Abox.
Incluya el proyecto en su proyecto para extender Abox, añada una referencia en Adapting.Web al proyecto que acaba de incluir.
Guía de uso¶
Una vez incluida la clase en el proyecto y recompilado el proyecto, tiene que modificar el XML del workflow para añadir esta acción en las acciones que ejecuta el workflow al cambiar de estado. Para hacer esto incluya este código en las acciones de la transición en la que quiere que se ejecute.
<action type="DuplicateDocument">
<param name="action">relate/versioning</param>
<param name="type">menor/mayor/unidir/bidir</param>
<!-- Parámetros para mover a carpeta destino -->
<param name=".constant_value">Código_o_ruta_de_la_carpeta_destino</param>
<param name=".foldercodemetadata_value">Código_del_metadato_con_el_código_o_ruta_carpeta_destino</param>
<param name="expectdoccode">Código_del_documento_esperado_por_el_expediente</param>
</action>
Donde,
action: Acción que desea ejecutar sobre el nuevo documento. Al relacionar el documento se crea en la misma carpeta del original. (relate/versioning)
type: Si la acción es relacionar (relate) entonces el tipo de relación puede ser unidireccional (unidir) o bidireccional (bidir) (Por defecto es bidireccional);
si la acción es versionar (versioning), entonces los tipos pueden ser menor (menor) o mayor (mayor)para la nueva versión (Por defecto es menor).
type: Código de la carpeta destino donde se moverá el expediente duplicado.
h2. Notas
A partir de la versión 2.7.3 si se escogió la opción de versionar un documento, en el mensaje de la acción aparecerá un link que lo llevará a la ficha de edición del documento creado.
Nota: Para entender el funcionamiento de completo de la acción deberá revisar la wiki de "MoveToFolderFromMetadata".
Histórico¶
24/09/2012
30/11/2012 A partir de la 2.7.5 se podrá especificar un carpeta destino del documento duplicado si lo que se hizo fue duplicar o duplicar y relacionar. En el caso de versionar no se podrá mover el documento resultante.
07/02/2013 A partir de la versión 2.7.6 se incluye mover carpeta con "MoveToFolderFromMetadata" se hace necesario tener el plugin. Esto permitirá mover documentos con rutas relativas de carpetas.
10/05/2016 A partir de la 3.2.0 se podra indicar si se dessea copia del anexo principal para el documento copia, por defecto si lo copiara.
parametro opcional
<action type="DuplicateDocument">
<param name="omitMainAnnex">true/false</param>
</action>
En el HotEditor añadir parámetro:
<param code="omitMainAnnex" minOccurs="0" maxOccurs="1">
<type>boolean</type>
<name>Omitir anexo principal en copia</name>
<description>No duplicará el anexo principal cuando se realiza la copia</description>
</param>
También es posible ahora indicar el estado del nuevo documento creado: heredado (mismo estado del documento original) o estado inicial.
<param code="state" minOccurs="0" maxOccurs="1">
<type>list</type>
<name>Estado del duplicado</name>
<values>
<value code="inherit">Mismo estado</value>
<value code="initial">Estado inicial</value>
</values>
<description>Estado que tendrá el nuevo documento duplicado: conservar estado del original o poner estado inicial</description>
</param>
21/08/2018 A partir de la 4.2.0 La nueva versión creada de un documento aparecerá como versión activa.
22/11/2018 se agrega nuevo parámetro opcional para cambiar el tipo al documento duplicado, se ajustan los mensajes de respuesta para apuntar al modo editar del documento.
Ejemplo del nuevo parametro, recibe como valor el codigo de un tipo documental.
<param name="newdocumenttypecode">CodeDocumentType</param>
19/02/2020 Se actualiza el parámetro "type" añadiéndole la nueva opción de tipos de relaciones.
<param code="type" minOccurs="0" maxOccurs="1">
<type>list</type>
<name>Tipo de versión/ relación</name>
<description>Tipo de versión/ relación que desea efectuar. Por defecto es menor/ bidireccional.</description>
<values>
<value code="menor">Versión menor (sólo versionamiento)</value>
<value code="mayor">Versión mayor (sólo versionamiento)</value>
<value code="unidir">Relación unidireccional (sólo relaciones)</value>
<value code="bidir">Relación bidireccional (sólo relaciones)</value>
<value code="isResponseOfRelation">Es respuesta de (sólo relaciones)</value>
<value code="isOriginOfRelation">Es originado de (sólo relaciones)</value>
</values>
</param>
25/01/2021 Se añade validación del metadato "CustomOrganizationDataBaseLink".
28/09/2021 se agrega 4 nuevos parámetros opcionales dos para actualizar metadatos del documento nuevo creado. 1 para cambiar el modo del registro de registro y otro para evitar activar la versión del documento recién creado
<param code="fieldcode" minOccurs="0" maxOccurs="*"> <type>metadata</type> <name>Código del campo a actualizar</name> <description>Código del campo a actualizar</description> </param> <param code="constant_fieldvalue" minOccurs="0" maxOccurs="*"> <type>string</type> <name>Constante</name> <description>Valor que se va a copiar</description> </param> <param code="registrymode" minOccurs="0" maxOccurs="1"> <type>list</type> <name>Modo de registro</name> <description>Modo de registro</description> <values> <value code="normal">Normal</value> <value code="input">Entrada</value> <value code="output">Salida</value> </values> </param> <param code="omitactivateversion" minOccurs="0" maxOccurs="1"> <type>bool</type> <name>Omitir activación de versión</name> <description>No Activa la versión creada. Valor por defecto: False</description> </param>
05/10/2021 Se agrega un nuevo parámetro para agregar un prefijo al código del detalle de la versión ,
se cambia el código del parámetro del la constante del metadato se quitó el punto previo
<param code="fieldcode" minOccurs="0" maxOccurs="*"> <type>metadata</type> <name>Código del campo a actualizar</name> <description>Código del campo a actualizar</description> </param> <param code="constant_fieldvalue" minOccurs="0" maxOccurs="*"> <type>string</type> <name>Constante</name> <description>Valor que se va a copiar</description> </param> <param code="registrymode" minOccurs="0" maxOccurs="1"> <type>list</type> <name>Modo de registro</name> <description>Modo de registro</description> <values> <value code="normal">Normal</value> <value code="input">Entrada</value> <value code="output">Salida</value> </values> </param> <param code="omitactivateversion" minOccurs="0" maxOccurs="1"> <type>bool</type> <name>Omitir activación de versión</name> <description>No Activa la versión creada. Valor por defecto: False</description> </param> <param code="prefixversion" minOccurs="0" maxOccurs="1"> <type>string</type> <name>Prefijo versión</name> <description>Prefijo de código de versión </description> </param>
03/03/2023 Se creo nuevo parámetro con el nombre: "inheritCreationDate" para indicar si la nueva versión del documento heredara la fecha de creación del documento original, el parámetro es opcional.
Nota: para esta funcionalidad es necesario activar el parámetro SortDocumentVersionByCaptureDate en el AppSettings ya que se presenta una incidencia con el versionamiento mas información tiket: http://lab.adapting.com:83/redmine/issues/5401
<!--HotEditor-->
<param code="inheritCreationDate" minOccurs="0" maxOccurs="1">
<type>bool</type>
<name>Indica si la nueva versión del documento heredara la fecha de creación del documento original</name>
<description>Indica si la nueva versión del documento heredara la fecha de creación del documento original, opcional</description>
</param>
<!--Xml-->
<action type="DuplicateDocument">
<param name="action">versioning</param>
<param name="type">mayor</param>
<param name="omitMainAnnex">true</param>
<param name="omitactivateversion">false</param>
<param name="inheritCreationDate">true</param>
</action>
