Centro de Soporte i2factory

Puedes crear Plantillas para para facilitar al resto de usuarios de tu organización la creación rápida de soluciones similares, tan sólo configurando algunos parámetros de una solución ya construida. Debes tener plantillas creadas para poder crear soluciones basadas en plantillas. Por favor, dirígete a la sección de plantillas y crea tu primera plantilla.

Asistente de creación de plantillas

Si no has creado ninguna plantilla con anterioridad, podrás hacerlo fácilmente a través del asistente pulsando en el botón de Ayuda. Este asistente desaparecerá cuando tengas una primera plantilla creada, y la Ayuda te explicará los elementos de la sección. Para poder volver a acceder al asistente es necesario que borres todos las plantillas que hayas creado previamente.

Guía paso por paso

Vamos a crear una plantilla para la solución Dropbox2Dropbox que hemos creado en los pasos anteriores.

Accede a la Sección de Plantillas y sigue los pasos marcados a continuación:

1. Haz clic en el botón Nuevo de la barra inferior para mostrar el asistente de Creación de Plantilla:
   
   
2. Selecciona la solución base a utilizar para generar tu plantillas. Si has seguido los pasos de este tutorial, te debería aparecer la solución Dropbox2Dropbox con la imagen y la descripción de la solución:
   
   
   
   
3. A continuación, introduce la siguiente información obligatoria para todas las plantillas. Tendrás que hacerlo en todos los idiomas en los que deseas que aparezca la plantilla:

1. 
   
   1. Nombre: nombre identificativo de la plantilla, 16 caracteres máximo, sólo se admiten letras, números, guiones bajos, puntos y espacios (aunque el nombre no puede comenzar ni finalizar en punto y/o espacio)
   2. Descripción: descripción completa de la plantilla, admite hasta 200 caracteres
   3. Palabras clave: etiquetas destinadas a clasificar las plantillas en el futuro.
      
      
      
       
      
       
2. Podemos asignarle una imagen descriptiva a la plantilla. La imagen debe ser de tipo JPG o PNG y el peso de la imagen debe ser menor de 200 Kb. Pincha en el icono de la imagen y selecciona tu imagen deseada:
      
   
   
   Nota: La imagen de la plantilla y los pasos necesarios para crear la plantilla son requeridos para que la plantilla pueda ser guardada con el icono de Guardar: (los campos requeridos son notificados con letras en color rojo)
   
   
   
3. A continuación hay que introducir uno a uno cada uno de los pasos del tutorial de la plantilla. Para el caso de Dropbox2Dropbox vamos a necesitar crear lo siguientes pasos
   1. Indicar una credencial para la cuenta de Dropbox de la carpeta origen.
   2. Indicar una credencial para la cuenta de Dropbox de la carpeta destino.
   3. Indicar una credencial para la cuenta de correo saliente SMTP.
   4. Definir la ruta desde donde se van a leer los ficheros en la carpeta origen.
   5. Definir la ruta desde donde se van a escribir los ficheros en la carpeta destino.
   6. Indicar el email del remitente y destinatario 
   7. Especificar la dirección del servidor SMTP del proveedor de email.
   8. Especificar el puerto usado por el proveedor de email. 
   9. Indicar si se usa conexión segura TLS para el envío de emails
       
4. Para cada uno de los pasos tendremos que indicar:
   1. Un nombre del paso
   2. Una descripción
   3. Un elemento a configurar: tendremos que escoger el conector o la tarea sobre la que queremos preguntar al usuario en el asistente. Para cada uno de los elementos tendremos que escoger una Propiedad y establecer qué se le va a pedir al usuario.  
      
      
5. PASOS a, b y c: credenciales de Dropbox entrada, Dropbox salida y SMTP:
   1. Indica el nombre y la descripción de del paso. Por ejemplo:
      1. Nombre: por ejemplo Credencial de DROPBOX de origen
      2. Descripción: por ejemplo Especifica la credencial de DROPBOX para la cuenta de la carpeta origen
   2. Escoge el elemento "DropboxOrigen" (o el nombre que le diste al puerto de entrada de Dropbox)
   3. Escoge la propiedad "Alias de la Credencial" y en Tipo escoge Alias
   4. Deja sin marcar la casilla "Aplicar el mismo valor a todos los elementos del mismo tipo"
   5. Haz click en Añadir
   6. Repite los pasos anteriores para las credenciales de Dropbox de salida y SMTP
       
6. PASO d: ruta de origen
   1. Indica el nombre y la descripción de del paso. 
   2. Escoge el elemento "DropboxOrigen" (o el nombre que le diste al puerto de entrada de Dropbox)
   3. Escoge la propiedad "Ruta" y en Tipo escoge "Texto"
   4. En Texto de la plantilla indicar @@VALUE@@: esto indica que lo que el usuario introduzca será tomado como el campo Ruta.
   5. Indica como Expresión Regular "/\w+" que controlará que el valor introducido sea siempre una secuencia de cadena de caracteres precedida por "/"
   6. Deja sin marcar la casilla "Aplicar el mismo valor a todos los elementos del mismo tipo"
   7. Haz click en Añadir
      
      
       
7. PASO e: ruta de destino
   1. Indica el nombre y la descripción de del paso. 
   2. Escoge el elemento "TranslatorDestino" (o el nombre que le diste a la tarea Translator que precede al puerto de salida de Dropbox)
   3. Escoge la Propiedad "Código XSLT" y en Tipo escoge "Texto"

   4. Debes copiar el Valor configurado en la solución (código XSLT) y pegarlo en Texto de la plantilla, sustituyendo donde aparece <![CDATA[/destino/]]>por <![CDATA[@@VALUE@@/]]>. Puedes también copiar el código de XSLT siguiente:

      <?xml version="1.0"?><xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><xsl:template match="/"> <FileDropboxBean><content><base64Content><xsl:value-of select="//FileDropboxBean/content/base64Content"/></base64Content></content><path> <![CDATA[@@VALUE@@/]]><xsl:value-of select="//FileDropboxBean/fileName"/></path></FileDropboxBean></xsl:template></xsl:stylesheet>

          
   5. Indica como Expresión Regular "/\w+" que controlará que el valor introducido sea siempre una secuencia de cadena de caracteres precedida por "/"
   6. Deja sin marcar la casilla "Aplicar el mismo valor a todos los elementos del mismo tipo"

   7. Haz click en Añadir

       

       

8. PASO f: email de destinatario y remitente
   1. Indica el nombre y la descripción de del paso. 
   2. Escoge el elemento "TranslatorSMTP" (o el nombre que le diste a la tarea Translator que precede al puerto de salida SMTP)
   3. Escoge la Propiedad "Código XSLT" y en Tipo escoge "Texto"

   4. Debes copiar el Valor configurado en la solución (código XSLT) y pegarlo en Texto de la plantilla, sustituyendo donde aparece cada dirección de email <![CDATA[direccion@de.email]]> por <![CDATA[@@VALUE@@]]>. Puedes también copiar el código de XSLT siguiente:

      
      

      
      

      <?xml version="1.0"?><xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><xsl:template match="/"> <MailSmtpBean><mailFrom><![CDATA[@@VALUE@@]]></mailFrom><mailToList><String><![CDATA[@@VALUE@@]]></String></mailToList><subject> <![CDATA[Tienes un nuevo fichero en tu carpeta ]]><xsl:value-of select="//FileDropboxBean/parentFolder"/></subject><content><![CDATA[Fichero ]]> <xsl:value-of select="//FileDropboxBean/fileName"/><![CDATA[ movido con extensión ]]><xsl:value-of select="//FileDropboxBean/extension"/><![CDATA[ y tamaño ]]><xsl:value-of select="//FileDropboxBean/fileSize"/></content></MailSmtpBean></xsl:template></xsl:stylesheet>

        

   5. Indica como Expresión Regular "\w+[\.\w]*@\w+[\.\w]*\.\w+$" que controlará que el valor introducido sea siempre una dirección de email válida
   6. Deja sin marcar la casilla "Aplicar el mismo valor a todos los elementos del mismo tipo"

   7. Haz click en Añadir

      
      
      
      

9. Paso g: Especificar la dirección del servidor SMTP del proveedor de email.
   1. Indica el nombre y la descripción de del paso. 
   2. Escoge el elemento "SMTP" (o el nombre que le diste al puerto de salida de SMTP)
   3. Escoge la Propiedad "Servidor" y en Tipo escoge "Texto"
   4. En Texto de la plantilla indicar @@VALUE@@: esto indica que lo que el usuario introduzca será tomado como la dirección del servidor SMTP.
   5. Indica como Expresión Regular "\w+[\.\w]*\.\w+$" que controlará que el valor introducido sea siempre una secuencia de cadena de caracteres y puntos.
   6. Deja sin marcar la casilla "Aplicar el mismo valor a todos los elementos del mismo tipo"
   7. Haz click en Añadir
       
10. 
    
11. Paso h: Especificar el puerto usado por el proveedor de email.
    1. Indica el nombre y la descripción de del paso. 
    2. Escoge el elemento "SMTP" (o el nombre que le diste al puerto de salida de SMTP)
    3. Escoge la  Propiedad "Puerto" y en Tipo escoge "Texto"
    4. En Texto de la plantilla indicar @@VALUE@@: esto indica que lo que el usuario introduzca será tomado como el campo Puerto.
    5. Indica como Expresión Regular "[0-9]+" que controlará que el valor introducido sea un número
    6. Deja sin marcar la casilla "Aplicar el mismo valor a todos los elementos del mismo tipo"
    7. Haz click en Añadir
        
12. 
    
13. Paso i: Indicar si se usa conexión segura TLS para el envío de emails
    1. Indica el nombre y la descripción de del paso. 
    2. Escoge el elemento "SMTP" (o el nombre que le diste al puerto de salida de SMTP)
    3. Escoge la Propiedad  "¿TLS?" y en Tipo escoge "Selector"
    4. Haz click en Añadir una opción más y rellena los siguientes valores:
       1. Opción 0: 
          1. Valor: "Si"
          2. Slot0: "true"
       2. Opción 1:
          1. Valor: "No"
          2. Slot0: "False" 
    5. Deja sin marcar la casilla "Aplicar el mismo valor a todos los elementos del mismo tipo"
    6. Haz click en Añadir
        
14. 
    
15. Antes de hacer click en Guardar, comprueba que has implementado todos los pasos necesarios, lo puedes ver en el resumen final. Recuerda que si guardas a continuación y te falta algo, tendrás que repetir la plantilla por completo.
    
16. Haz click en Guardar.
    
    Si todo va bien, como resultado obtendremos una plantilla creada en el panel de control, aunque aún no está publicada ni en uso. Podrás visualizar la plantilla recién creado en la parte superior del listado, donde las columnas indican el nombre de la plantilla, su descripción, el número de soluciones creadas a partir de ella, si está pública para otros usuarios y el usuario que lo creó. En caso de tener más de uno podrás ordenar el listado como quierar haciendo clic en la columna por la que quieras ordenar (cronológicamente, alfabéticamente por nombre del entorno o nombre de usuario, etc.) tanto de manera ascendente como descendente.
    
     

 Publicación de la plantilla: Una vez probada la plantilla en tu organización de forma interna, podrás publicarla para que la usen el resto de usuarios de i2factory. Para ello, selecciona la plantilla en el listado y haz click en Publicar. No te preocupes si algo falla luego porque podrás despublicarla luego para corregirla.

Sólo para partners autorizados: La funcionalidad de crear plantillas y la sección de Plantillas sólo está habilitada para ciertos partners certificados y autorizados. Si te interesa esta funcionalidad, solicita ser partner de i2factory en: https://www.i2factory.com/es/partner/

  Requerimientos previos: Te en cuenta que para crear tu primera plantilla debes tener al menos una solución de integración válida que sirva de base, además de disponer de un entorno creado y tener preparadas al menos una credencial de Dropbox y SMTP. Para poder probar, desplegar y usar la plantilla necesitarás también haber dado de alta un servidor.