Ir al contenido principal

DocTemplates: Cree y utilice sus plantillas de documentos personalizadas

Cree sus plantillas Word con las variables de Boond, nómbrelas y genere sus documentos (DT, contratos, facturas, etc.) en Word o PDF.

Escrito por Charlie Troccaz

🤖 Este artículo fue traducido por IA.

La aplicación DocTemplates le permite generar sus documentos de Boond (dossiers técnicos, contratos, facturas, presupuestos, etc.) en formato Word (.docx) o PDF, con su identidad visual, a partir de sus propias plantillas Word. Este artículo está dirigido a los administradores que instalan la aplicación y crean las plantillas.

Pre-requisitos

DocTemplates está disponible para todas nuestras ofertas.

Para instalar DocTemplates y cargar plantillas, debe disponer de derechos de acceso a la Administración de Boond, sección Marketplace.
​
Sus plantillas deben ser documentos Word en formato .docx.

⠀


1 - Instalar la aplicación DocTemplates

Administración > Apps/Marketplace > pestaña Marketplace > DocTemplates

Para instalar la aplicación DocTemplates, diríjase al Marketplace de la Administración de Boond.

  1. Abra Administración, luego Apps/Marketplace.

  2. En la pestaña Marketplace, busque DocTemplates.

  3. Haga clic en Instalar.

Capture_d_e_cran_2021-01-26_a__14.43.15.png

Una vez instalada DocTemplates, la aplicación aparece en sus aplicaciones y puede cargar sus plantillas (ver sección 4).


2 - Crear su plantilla Word con las variables de DocTemplates

Para crear su plantilla DocTemplates, redacte un documento Word clásico en el que inserte variables. Al momento de la generación, DocTemplates reemplaza cada variable por el dato correspondiente de la ficha de Boond.

¿Qué documentos puede crear con DocTemplates?

DocTemplates le permite crear plantillas para los siguientes documentos:

  • Dossiers técnicos (DT) de candidatos y recursos

  • Contratos de RRHH y contratos de subcontratación

  • Documentos administrativos (préstamo de material, autorizaciones varias, etc.)

  • Facturas y abonos

  • Presupuestos

  • Prestaciones y órdenes de misión

  • Pedidos y albaranes de entrega

  • Oportunidades (oferta comercial)

  • Compras

Partir de un ejemplo de plantilla DocTemplates

Para ahorrar tiempo, puede partir de los ejemplos de plantillas DocTemplates puestos a disposición por Boond y adaptarlos a su identidad gráfica.

La lista completa de variables, clasificadas por tipo de documento, está disponible en la documentación de variables DocTemplates. Para cada variable, se indica la etiqueta, un ejemplo de resultado, la ficha y la pestaña donde se introduce el dato en Boond, y el tipo de variable (simple, lista o tabla).

Escribir una variable DocTemplates

Una variable DocTemplates se escribe entre dos símbolos de dólar, sin espacio: $nombreDeLaVariable$. Puede darle formato (negrita, subrayado, color) como cualquier texto de Word: el formato se conserva en el documento generado.

Ejemplo: para un recurso Señor Nicolas LEFRANC cuyo email es [email protected], la frase «La dirección de correo electrónico de $civility$ $firstName$ $lastName$ es $email1$.» se convierte en «La dirección de correo electrónico de Señor Nicolas LEFRANC es [email protected].»

Atención al símbolo $

Atención: DocTemplates utiliza el símbolo $ para identificar las variables. Nunca escriba el símbolo $ manualmente en su plantilla (por ejemplo, «1 000 $»): se interpretaría como el inicio de una variable y bloquearía la carga de la plantilla. Para mostrar una divisa, utilice la variable prevista, por ejemplo $currencySymbol$ (símbolo de la divisa) o $currency$ (código de la divisa, por ejemplo EUR) en una factura o presupuesto.

Los tres tipos de variables DocTemplates: simple, lista y tabla

Cada variable DocTemplates tiene un tipo, indicado en la columna «Tipo de variable» de la documentación. El tipo determina dónde colocar la variable en su documento Word.

  • Variable simple: contiene un solo valor (texto o número), como el nombre de un recurso. Insértela directamente en el texto. Ejemplo: $lastName$.

  • Variable lista: contiene varios valores, como los dominios de un dossier técnico. Colóquela en una lista con viñetas (o numerada) de un solo elemento: DocTemplates crea una viñeta por valor. Ejemplo: una viñeta que contenga $activityAreas$ se convierte en «• Desarrollador Web» y «• Certificación 1».

  • Variable tabla: contiene varias filas, como los idiomas y su nivel. Colóquela en una fila de tabla de Word: DocTemplates crea una fila de tabla por elemento, con las columnas definidas en su plantilla. Ejemplo: una fila de tabla que contenga $languages.language$ y $languages.level$ se convierte en «Inglés | Fluido» y luego «Alemán | Nativo».

Modificadores de variables DocTemplates: count, col, join y literal

Los modificadores de DocTemplates transforman el valor de una variable en el momento de la generación. Se escriben después de la variable, separados por una barra vertical: $variable|modificador$. Puede encadenar varios: $variable|modificador1|modificador2$.

  • count (variables lista o tabla): muestra el número de elementos. Ejemplo: $activityAreas|count$ muestra «3» si el recurso tiene 3 dominios.

  • join (variables lista): transforma la lista en texto, valores separados por coma. Ejemplo: $activityAreas|join$ muestra «Formación, Consultoría tecnológica, Internet & multimedia».

  • col (variables tabla): extrae una columna de la tabla como lista; a menudo seguido de join. Ejemplo: $languages|col('language')|join$ muestra «inglés, alemán».

  • literal (variables simples con número): escribe el número en letras. Ejemplo: para un salario mensual de 2800, $monthlySalary|literal$ muestra «dos mil ochocientos».

Mostrar la fecha del día en una plantilla DocTemplates

Para mostrar la fecha del día de generación en su plantilla DocTemplates, utilice una de las siguientes variables (ejemplos para lunes 11 de enero de 2016):

  • $TODAY$: 11/01/2016

  • $TODAY_MEDIUM$: 11 ene. 2016

  • $TODAY_LONG$: 11 enero 2016

  • $TODAY_FULL$: lunes 11 enero 2016

Cada tipo de plantilla tiene sus propias variables

Atención: las variables DocTemplates disponibles dependen del tipo de documento. Por ejemplo, una plantilla de contrato de RRHH no puede utilizar variables propias de una prestación. Utilice solo las variables de la pestaña de la documentación que corresponde a su tipo de plantilla.

Facturas y presupuestos: separe la tabla de totales

Atención: en una plantilla DocTemplates de factura o presupuesto, coloque los totales en una tabla separada de la que contiene las líneas de factura o presupuesto. Si los totales están en la misma tabla, el documento no se generará correctamente.


3 - Nombrar su plantilla DocTemplates para que se seleccione automáticamente

El nombre de archivo de su plantilla DocTemplates permite imponer el formato PDF y seleccionar automáticamente la plantilla correcta según la ficha (polo, agencia jurídica) y el idioma del usuario. Estas reglas de nomenclatura también se muestran en cada apartado de la configuración de DocTemplates.

Debe modificar el nombre de su archivo antes de subirlo como plantilla.

En cada apartado, le mostramos las instrucciones de nomenclatura de plantillas a respetar.

Capture_d_e_cran_2021-01-26_a__15.02.01.png

Cómo escribir los campos en el nombre del archivo docx

Los campos se escriben entre corchetes, en la forma [CAMPO], y cada campo va precedido de un guion bajo (_).

Ejemplo: nombredelarchivo_[CAMPO1]_[CAMPO2].docx.

Los campos disponibles en el nombre de un archivo de plantilla DocTemplates son los siguientes:

  • Formato de generación – [PDF]: el documento se genera en PDF. Sin este campo, el documento se genera en Word (.docx).

  • Polo de la ficha – [POLEX]: X es la referencia interna del polo. Ejemplo: [POLE3].

  • Sociedad de la ficha: [CSOCX], siendo CSOCX la referencia interna de la sociedad

  • Tipo de contrato: [TYPEX], siendo TYPEX el ID, de los parámetros globales, del tipo de contrato

  • Agencia jurídica de la ficha – [AJUX]: X es la referencia interna de la agencia jurídica. Ejemplo: [AJU1].

  • Idioma del usuario que genera el documento – [FR] o [EN].

Ejemplos de nombres válidos: nombredelarchivo_[POLE3]_[FR].docx · nombredelarchivo_[AJU1]_[FR].docx · nombredelarchivo_[EN].docx · nombredelarchivo_[PDF].docx

Cómo DocTemplates elige la plantilla a utilizar

Cuando hay varias plantillas DocTemplates disponibles, la selección automática se basa en una puntuación: cuanto más campos coincidan en el nombre de la plantilla con la ficha y el usuario, mayor será la puntuación. Se selecciona la plantilla con la puntuación más alta. Si la puntuación es igual, se prioriza la plantilla que contiene un formato (por ejemplo [PDF]).

Ejemplo 1: el usuario tiene su interfaz en francés y la ficha pertenece a la agencia jurídica con referencia interna AJU4. Las plantillas disponibles son: nombredelarchivo_[AJU4]_[EN].docx, nombredelarchivo_[AJU1].docx, nombredelarchivo_[FR].docx, nombredelarchivo_[FR]_[PDF].docx, nombredelarchivo_[EN].docx y nombredelarchivo.docx. La plantilla seleccionada es nombredelarchivo_[FR]_[PDF].docx: las plantillas en [EN] y en [AJU1] no corresponden, y entre [FR] y [FR]_[PDF], gana la plantilla con formato.

Ejemplo 2: en el mismo contexto, las plantillas disponibles son: nombredelarchivo_[AJU4]_[FR].docx, nombredelarchivo_[AJU4].docx, nombredelarchivo_[EN].docx y nombredelarchivo.docx. La plantilla seleccionada es nombredelarchivo_[AJU4]_[FR].docx, ya que corresponde tanto a la agencia jurídica como al idioma.


4 - Cargar su plantilla en DocTemplates

Administración > Apps/Marketplace > DocTemplates > Configuración

Para cargar su plantilla en DocTemplates, suba su archivo Word en la sección correspondiente al tipo de documento.

  1. Abra la configuración de la aplicación DocTemplates.

  2. Identifique la sección que corresponde a su tipo de documento (por ejemplo, Facturas o Contratos).

  3. Cargue su archivo .docx en esa sección.

Si la plantilla es aceptada, aparece en la sección. Si DocTemplates rechaza la plantilla, muestra la lista de variables que no reconoce: consulte la FAQ al final del artículo para corregir su plantilla.


5 - Generar un documento a partir de su plantilla DocTemplates

Para generar un documento a partir de su plantilla DocTemplates, abra la ficha correspondiente (recurso, factura, oportunidad, presupuesto, etc.). Luego haga clic en el botón en la parte superior derecha "Generar un documento".

Génération d'un document DocTemplates depuis une fiche facture

Luego puede elegir la plantilla en el menú desplegable que aparece:


FAQ

¿Es posible tener varios modelos de presupuesto?

Sí, puede tener varios modelos de presupuesto en DocTemplate. Podrá elegir la plantilla que desee al generar el presupuesto en PDF.

¿Qué variables DocTemplates utilizar para la factura electrónica?

Desde la implementación de los formatos Factur-X y CII en Boond (diciembre de 2023), hay nuevas variables DocTemplates disponibles para la factura electrónica.

Lado factura: $billingDetailVatNumber$ (N° IVA), $billingDetailSiren$ (SIREN), $billingDetailNic$ (NIC), $billingDetailRegistrationNumber$ (SIRET), $billingDetailNumber$ (número proveedor), $billingDetailSendingMode$ (modo de envío).

Lado pedido: $billingDetail.vatNumber$ (N° IVA), $billingDetail.siren$ (SIREN), $billingDetail.nic$ (NIC), $billingDetail.registrationNumber$ (SIRET), $billingDetail.number$ (número proveedor), $billingDetail.sendingMode$ (modo de envío).

Mi plantilla DocTemplates es rechazada al cargarla: ¿qué hacer?

Cuando su plantilla DocTemplates es rechazada al cargarla, DocTemplates muestra la lista de variables que no reconoce. El número de errores le orienta:

  • Solo una variable señalada: verifique su ortografía, su sintaxis completa ($nombreDeLaVariable$), que realmente existe para ese tipo de plantilla y que no la rodea ningún carácter especial o $ adicional.

  • Muchas variables señaladas: busque una causa global, por ejemplo un $ aislado en el documento, una variable mal cerrada o variables provenientes de otro tipo de plantilla (por ejemplo, variables de prestación en un contrato de RRHH).

¿Cómo mostrar el símbolo $ (dólar) o una divisa en mi plantilla DocTemplates?

Para mostrar una divisa en su plantilla DocTemplates, no escriba el símbolo $ manualmente (por ejemplo, «1 000 $»): DocTemplates utiliza el carácter $ para identificar variables y lo interpreta como el inicio de una variable incompleta, lo que bloquea la carga de la plantilla.

Utilice en su lugar la variable de divisa prevista, por ejemplo $currencySymbol$ (símbolo de la divisa) o $currency$ (código de la divisa, por ejemplo EUR) en una factura o presupuesto. El nombre exacto de la variable depende del tipo de plantilla: consulte la pestaña correspondiente de la documentación de variables.

Mi plantilla DocTemplates está cargada pero no la veo al generar mi documento: ¿por qué?

Si su plantilla DocTemplates está cargada pero no se muestra al generar el documento, verifique el nombre del archivo. El nombre de la plantilla determina en qué contexto se selecciona (agencia jurídica, polo, idioma del usuario, formato PDF). Una plantilla válida pero cuyo nombre no corresponde al contexto de la ficha no será propuesta. Las reglas de nomenclatura se muestran en cada apartado de la configuración de DocTemplates.

Una información está vacía en el documento generado por DocTemplates: ¿por qué?

Cuando una información está vacía en el documento generado por DocTemplates aunque la variable sea correcta, normalmente es porque el dato no está introducido en Boond o no está vinculado a la ficha correcta. Por ejemplo, la información del proveedor de un recurso externo queda vacía si no se asocia ningún proveedor a ese recurso. La documentación de variables indica, para cada variable, en qué ficha y en qué pestaña debe introducirse el dato.

Mi variable DocTemplates funciona en el texto pero no en una tabla (o viceversa): ¿por qué?

Una variable DocTemplates que funciona en el texto pero no en una tabla (o viceversa) probablemente no se utiliza según su tipo. Una variable simple se inserta en el texto, una variable lista en una lista con viñetas de un solo elemento (o con el modificador join para mostrarla como texto), y una variable tabla en una fila de tabla de Word. El tipo de cada variable se indica en la documentación de variables; los tres tipos se detallan en la sección 2 de este artículo.

Mi factura o presupuesto DocTemplates no se genera correctamente: ¿qué verificar?

Si su plantilla de factura o presupuesto DocTemplates no se genera correctamente, verifique la estructura de las tablas: los totales deben colocarse en una tabla separada de la que contiene las líneas de factura o presupuesto.

¿Cómo saber si el problema viene de mi documento Word o de la variable DocTemplates?

Para saber si el problema viene de su documento Word o de la variable DocTemplates, haga una prueba con un documento mínimo:

  1. Cree un nuevo documento Word que contenga una sola línea de texto y la variable a probar.

  2. Cargue este documento en el mismo tipo de plantilla DocTemplates.

  3. Genere un documento a partir de esa plantilla.

Si el documento mínimo funciona, el problema está en su documento Word original: caracteres ocultos, contenido copiado desde Excel o un PDF, zonas de texto, tablas anidadas o variables colocadas en el encabezado o pie de página. Simplifique entonces su documento progresivamente para identificar la parte en cuestión.

¿Es posible tener varios modelos de presupuesto en DocTemplates?

Sí, es posible tener varios modelos de presupuesto en DocTemplates. Usted elige el modelo que desee al generar el presupuesto en PDF.

¿Ha quedado contestada tu pregunta?