Proyecto

General

Perfil

Enviar correo con cc, cco, anexo principal y anexos secundarios

Información

Autor David Henriquez
Sitio Web http://www.facebook.com/adapting-lab
Repositorio source:Acciones-America/trunk/src/SendSecundaryAnnexes
Código fuente http://svn-community.adapting.com:8080/svn/Community/Plugins/Acciones-America/trunk/src/SendSecundaryAnnexes/
Versión Actual v1.0
Compatible con Abox 2.7.4

Resumen

Envia un mail a los correo especificados por los parámetros, y ademas el anexo principal y los anexos secundarios si estos son especificados. El correo de origen es el definido en la parametrización de abox.

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.SendCustom.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 worlflow 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="SendCustomMail">

          <!-- Obligatorio -->
          <param name="subject">Asunto del correo</param>

          <!-- Opcionales y irrepetibles -->

          <!--opcional-->
          <param name="body">cuerpo del correo</param>

          <!-- Opcional, para enviar body personalizados se espera etiqueta resx redireccionada a "Messages.resx" si se usa el siguiente parámetro se recomienda no usar "body" como parametro -->
          <param name="richbody">[NULL]</param>

          <!-- uno de estos 2 es obligatorio -->

          <!-- En caso de que se quiera poner mas correo electronicos de deberá separar por comas -->
          <param name="to">ejemplo@mail.com, ejemplo2@mail.com</param> 

          <!-- El valor del metadato también puede contener mas de un correo separado por coma ',' a menos que este sea de tipo mail que solo soporta uno-->   
          <param name="metadataTo">Codigo_del_metadato_con_correo_destinatario</param>   

          <!-- Opcionales y repetibles -->

          <!-- En caso de que se quiera poner mas correo electronicos de deberá separar por comas -->
          <param name="cc">ejemplo@mail.com, ejemplo2@mail.com</param>

          <!-- El valor del metadato también puede contener mas de un correo separado por coma ',' a menos que este sea de tipo mail que solo soporta uno -->
          <param name="metadataCC">Codigo_del_metadato_con_correo_destinatario</param>

          <!-- En caso de que se quiera poner mas correo electronicos de deberá separar por comas -->
          <param name="cco">Codigo_del_metadato_con_correo_destinatario</param>

          <!-- El valor del metadato también puede contener mas de un correo separado por coma ',' a menos que este sea de tipo mail que solo soporta uno -->
          <param name="metadataCCO">Codigo_del_metadato_con_correo_destinatario</param>

          <!-- Opcional si no se coloca es false por defecto -->
          <param name="sendSecundaryAnnexes">true/false</param>

          <!--  Opcional, es posible indicar los usuarios destinatarios a través de un metadato tipo "enlace a roles" -->
          <param name="rolesMetadata">codigo_metadato</param>

          <!--  Opcional, es posible indicar plantilla -->
          <param name="templatecode">SSPD-NOTIF-EXT</param>

          <!--  Opcional, es posible indicar plantilla por metadato-->
          <param code="templatecode_metadata">(metadato texto)</param>

          <!-- Opcional, Para validar, se espera un codigo de metadato -->
          <param name="metadata">Doc.DatosTramite.EsRta</param>

          <!-- Opcional, para validar se espera (equal,less,greater,lessorequal,greaterorequal,different,contains,notcontains,folderisthedaughterof,notfolderisthedaughterof,regex) -->
          <param name="operator">Equal</param>

          <!-- Opcional, para validar se espera (true, false) -->
          <param name="constant">false</param>

          <!-- Opcional, para validar se espera Keyword -->
          <param name="keyword">[NULL]</param>

          <!-- Opcional, para correo certificado se espera un correo electrónico  -->
          <param name="certimail">string</param>

        </action>

Nota: El cuerpo del correo son los comentarios de la transición.

Histórico

24/01/2013 (2.7.6) En el parámetro "subject" puede utilizar las palabras reservadas [EntityName] [EntityCode] [CaseFolderName] [CaseFolderCode].
En el cuerpo del correo tambien puede utilizar las palabras reservadas.

31/01/2013 (2.7.6) Ahora es posible indicar los usuarios destinatarios a través de un metadato tipo "enlace a roles" 


                        <param name="rolesMetadata">codigo_metadato</param>

ATENCIÓN: En este caso el email del destinatario debe encontrarse en un metadato de la organización con código: "emailOrg". En caso de no encontrarse este metadato, NO se manda la notificación y el sistema muestra mensaje de error.

2/12/2015 ya se puede utilizar con metadatos MirrorField en los parametro metadataTo , metadataCC, metadataCCO

10/07/2017 se agrega un nuevo parametro para adicionar body al correo, a parte del body actual que es el mensaje entre las transicciones, ahora cuando se envie este parametro se adicionara este por debajo del mensaje de las transiciones, admite las mismas keyword's que el parametro "subject".

<!--opcional-->
<param name="body">cuerpo del correo</param>
08/07/2021
  • Ahora se permiten los saltos de línea "\n" en el parámetro "body".
  • Ahora se puede utilizar la palabra reservada [EntityDateCreated] en el parámetro "body", para llamar a la fecha de alta del contenido.
<param name="body"> Fecha de alta: [EntityDateCreated] \n\n Párrafo 2 \n siguiente línea.</param>

12/01/2022 (Versión. 5472). Se soluciona el defecto #3778 que no permitía enviar CC Y CCO en un solo correo para diferenciarlos

29/03/2022 (Versión. 5628). Parámetro nuevo para agregar correo certificado. "certimail"

07/04/2022 (Versión 5637). Se permite introducir una guarda en la acción para validar si se realiza el envío en función de la misma. Parámetros "metadata", "operator" y "constant/keyword".

21/04/2022 (Version 5670). Se permite anexar plantilla de notificación "templatecode" , "templatecode_metadata"

05/05/2022 (Versión 5710). Se añade nuevo parámetro "richbody" que tiene como objetivo poder construir body desde un recurso en especifico "Message.resx", adicional se agregaron nuevas Keywords:

- [RelatedDocuments(In)]: Documentos relacionados de tipo Entrada
- [RelatedDocuments(Out)]: Documentos relacionados de tipo Salida
- [RelatedDocuments(Normal)]: Documentos relacionados de tipo Interno

Para el Uso de metadatos la Keywords esta conformada por [_Metadata.Code] empezando por [ seguido de un guion *_ para identificar que es un metadato luego el código del metadato y finalizando con un ]*

26/05/2022 (Versión 5762). Se añade nuevo Keyword para encriptar keywors o valores según se solicite, esta encriptación requiere de una Key para poder encriptar y desencriptar por defecto se toma la Key "Pti99ada!" pero esta se transforma a Base64: "UHRpOTlhZGEh"

-[documentLinkEncrypted] : Keywors para indicar que se encriptara el valor de la keyword [EntityCode]

04/04/2023 Se modifica la acción SendCustomMail para agregar esta nueva funcionalidad, quiero recalcar que si esta nueva funcionalidad esta activa no usara el envió normal de abox. Siga estos pasos para configurar correctamente la funcionalidad:

1) Agregue la siguiente línea en su Web.config dentro de la etiqueta <basicHttpBinding>

<!-- Mejora Andes -->
          <binding name="EstadoServicioBinding">
              <security mode="Transport" />
          </binding>
          <binding name="RegistrarMensajeBinding">
              <security mode="Transport">
                  <transport clientCredentialType="Digest" />
              </security>
          </binding>
          <binding name="RegistrarMensajesBinding">
              <security mode="Transport">
                  <transport clientCredentialType="Digest" />
              </security>
          </binding>
          <!-- fin Andes -->

2) Agregue la siguiente línea en su Web.config dentro de la etiqueta <system.serviceModel>
Nota: la propiedad address es para indicar la url del servicio a consumir, en este caso el servicio esta alojado en: https://test.correocertificado4-72.com.co/webService.php

<!-- Mejora Andes -->
      <client>
          <endpoint address="https://test.correocertificado4-72.com.co/webService.php" 
              binding="basicHttpBinding" bindingConfiguration="EstadoServicioBinding" 
              contract="AndesServices.EstadoServicioPortType" name="EstadoServicioPort" />

          <endpoint address="https://test.correocertificado4-72.com.co/webService.php" 
                binding="basicHttpBinding" bindingConfiguration="RegistrarMensajeBinding" 
                contract="AndesServices.RegistrarMensajePortType" name="RegistrarMensajePort" >

          </endpoint>
          <endpoint address="https://test.correocertificado4-72.com.co/webService.php" 
                binding="basicHttpBinding" bindingConfiguration="RegistrarMensajesBinding" 
                contract="AndesServices.RegistrarMensajesPortType" name="RegistrarMensajesPort" >

          </endpoint>

      </client>
      <!-- fin Andes -->

3) Agregue la siguiente línea en su appSettings.config:

<!-- correo CertiAndes -->
  <add key="AddresCertiAndes" value="sspd@superservicios.gov.co"/>
  <add key="PasswordCertiAndes" value="d7c678ad8d7b8f0c2955004047714e724856aeff"/> <!-- Contrasena codificada en SHA1 -->
  <add key="certiandes" value="true"/> <!-- Activa la funcionalidad -->

4) Pegar la DLL a el bin de su abox:

Dll Adapting.CertiAndesServices: http://intranet.adapting.com/intranet/Document/Documents/Show/ADP-2023-04-00082-I?Version=6202

22/08/2023


          <param name="isMailOut">true</param>
Volver al inicio
Agregar imagen desde el portapapeles (Tamaño máximo: 10 MB)