Plantillas de documentos—Servicios de plataforma

Las plantillas de documentos se utilizan principalmente para las llamadas a servicios web (API) realizadas desde la plataforma.

Acerca de las plantillas de documentos

Una plantilla de documento suele ser un documento con campos de fusión del objeto en el ámbito y objetos relacionados que realizan llamadas a la API. Por ejemplo, para que tu aplicación de desarrollo de productos escriba una solicitud de compra, puedes crear un archivo con campos de fusión que contenga todos los valores necesarios para la solicitud de compra. A continuación, puedes guardar el archivo como plantilla de documento. Puedes utilizar la plantilla de documento como parte de un activador de tipo API que realiza la llamada a la API de servicios web de Intacct para generar la solicitud de compra.

Las plantillas ejecutadas desde la plataforma no requieren credenciales de autenticación. Intacct utiliza las credenciales del usuario que ha iniciado sesión. Por lo tanto, el usuario que ejecuta la acción debe tener permisos para acceder a los objetos de la API.

Dado que no se requieren credenciales al realizar una llamada a servicios web desde la plataforma, el archivo solo necesita incluir el código que estaría dentro de la sección de contenido de la llamada. Por ejemplo, {"name": "{!objects/accounts-payable/vendor.name!}", "id": "{!objects/accounts-payable/vendor.id!}"}.

Añadir una plantilla de documento

Puedes crear una plantilla de documento al añadir un nuevo activador o crear una plantilla a partir de la página Definición de objeto de un objeto para usarla en el futuro.

Para añadir una plantilla de documento a un objeto:

  1. Ir a Servicios de plataforma > Todos > Objetos.

  2. En la lista de objetos, busque y seleccione el objeto deseado.
  3. En la página Propiedades de definición de objeto, seleccione Plantillas de documentos de la plataforma en la parte superior y, a continuación, selecciona Nueva plantilla.
  4. Introduce un nombre para la plantilla en Nombre de la plantilla Esto se puede reconocer en los campos Definición de objeto, Activadores y Plantilla de documento.
    Utiliza un nombre que sea lo suficientemente descriptivo como para que otros usuarios puedan determinar fácilmente el propósito de la plantilla de documento.
  5. Seleccionar Privado para evitar que otros usuarios editen esta plantilla.
  6. Escribe y da formato al documento en el área de texto.
  7. Utilice el parámetro Campos de fusión disponibles para seleccionar los campos de fusión adecuados.
    1. Selecciona un Tipo de campo, luego un Campo. Intacct muestra el Token de fusión de campo para el campo.
    2. Corta y pega el archivo Token de fusión de campo en el área de texto.
    3. Repite el procedimiento para cada campo que desees como parte de la plantilla de documento.
  8. Seleccionar Vista previa de la plantilla para obtener una vista previa de la plantilla y verificar los campos de fusión.
  9. Para probar la plantilla con los permisos de otro usuario, selecciona...
  10. Haz clic en Guardar.

Editar una plantilla de documento

A medida que cambie la aplicación, es posible que tengas que editar una plantilla de documento. Por ejemplo, supongamos que deseas cambiar las definiciones de transacción en Compras. Es posible que tengas que reflejar los cambios en tu plantilla de documento para que tus activadores de API sigan funcionando.

Para editar una plantilla de documento:

  1. Ir a Servicios de plataforma > Todos > Objetos.

  2. En la lista Objetos, busca y selecciona el objeto deseado.
  3. En la página Propiedades de definición de objeto, seleccione Plantillas de documentos de la plataforma en la parte superior.
  4. Seleccionar Modificar junto a la plantilla de documento que quieras cambiar.
  5. Cambia la plantilla de documento en el área de texto.
    1. Utilice el parámetro Campos de fusión disponibles para seleccionar los nuevos campos de fusión que quieras añadir.
      1. Selecciona un Tipo de campo, luego un Campo. Intacct muestra el Token de fusión de campo para el campo.
      2. Corta y pega el archivo Token de fusión de campo en el área de texto.
      3. Repite el procedimiento para cada campo que desees como parte de la plantilla de documento.
  6. Seleccionar Vista previa de la plantilla para obtener una vista previa de la plantilla y verificar los campos de fusión.

  7. Para probar la plantilla con los permisos de otro usuario, selecciona...
  8. Haz clic en Guardar.

Ver la lista de plantillas de documentos

Tanto los desarrolladores como los usuarios pueden ver una lista de plantillas de documentos. Como desarrollador, debe acceder a una lista de plantillas en cualquier momento que desee organizarlas y actualizarlas. Las plantillas de documentos se enumeran en la sección Plantillas de documentos de la Definición de objeto y en un menú Plantillas independiente al que pueden acceder los usuarios.

Para ver una lista de plantillas de documento en la definición de objeto:

  1. Ir a Servicios de plataforma > Todos > Objetos.

  2. En la lista Objetos, busca y selecciona el objeto deseado.
  3. En la página Propiedades de definición de objeto, seleccione Plantillas de documentos de la plataforma en la parte superior.

Eliminar una plantilla de documento

Cuando una plantilla de documento se vuelve obsoleta, simplemente puedes borrarla. Antes de eliminar una plantilla de documento, asegúrate de que no forme parte de ningún tipo de API Activadores.

Para borrar una plantilla de documento:

  1. Ir a Servicios de plataforma > Todos > Objetos.

  2. En la lista Objetos, busca y selecciona el objeto deseado.
  3. En la página Propiedades de definición de objeto, seleccione Plantillas de documentos de la plataforma en la parte superior.
  4. Selecciona el icono Del junto a la plantilla que deseas borrar.
  5. En el cuadro de confirmación del cuadro de diálogo, seleccione el icono y, a continuación, selecciona Borrar.

Descripciones de campos

Descripciones de los campos de plantillas de documentos
Campo Descripción
Nombre de la plantilla

Introduce un nombre para la plantilla.

Tipo de plantilla

Selecciona un tipo de plantilla para consultarla en el futuro. El tipo de plantilla no cambia nada en el editor de código.

  • Genérico: esta es una plantilla genérica

  • Función de la API de Intacct: la plantilla es para una función de la API de Intacct

  • HTTP POST: la plantilla es para una función HTTP Post

  • HTTP GET: la plantilla es para una función HTTP Get

Privado

Selecciona si la plantilla es privada o no. Selecciona esta opción para que la plantilla sea visible solo para ti.

Campos de fusión disponibles

Utiliza la herramienta Campos de fusión disponibles para buscar campos de fusión para utilizarlos en la plantilla.

Archivo

Seleccionar Seleccionar archivo para añadir una plantilla existente.

Editor de código

Utiliza el editor de código para introducir el contenido de la plantilla.