Personalización del flujo de trabajo de integración de IDM

Puede usar las funciones avanzadas del formulario Flujos de trabajo de documento IDM, junto con las tareas en segundo plano del Sistema de eventos de la aplicación (AES), para personalizar los flujos de trabajo predefinidos o para añadir flujos de trabajo de documento nuevos.

Estos son algunos casos en los que le podría interesar editar o añadir un flujo de trabajo de documento:

  • Sus usuarios desean buscar OC según el número de contrato de OC, por lo que quiere añadirlo como un atributo para la búsqueda y recuperación de documentos Document Management. Puede añadir como atributo cualquier valor existente en el IDO de referencia para el flujo de trabajo.
  • El formulario Informes de orden de compra tiene una personalización que incluye un campo nuevo y desea que los usuarios puedan filtrar por ese campo. El formulario de informe personalizado aún usa el nombre de tarea en segundo plano estándar. En tal caso, puede anexar el nombre de propiedad del atributo IDM nuevo a IDOPropertyList en el registro del flujo de trabajo estándar.
  • Su documento de facturación se ha personalizado con un nombre de tarea en segundo plano no estándar. Desea usar esta tarea en segundo plano del flujo de trabajo, en lugar del nombre estándar.
  • Desea añadir un flujo de trabajo para otra tarea de informe en segundo plano que no está en la lista predefinida actual de flujos de trabajo.

Utilice este proceso:

  1. Abra el formulario Flujos de trabajo de documento IDM.
  2. Cree un nuevo registro de flujo de trabajo. (Si solo está añadiendo un atributo a un flujo de trabajo existente o cambiando el nombre de la tarea en segundo plano al nombre de tarea predeterminado, basta con copiar el registro del flujo de trabajo existente y no seleccionar el campo Activo para el registro existente).
  3. Haga clic en Avanzado para ver los campos de configuración avanzada.

    La información de estos campos define los metadatos que usa el Sistema de eventos de la aplicación (AES) para extraer valores de los parámetros de la tarea en segundo plano. Los valores se transmiten a Document Management través de una API.

  4. Especifique esta información, según sea necesario para su flujo de trabajo:
    Nota: Puede ver un ejemplo que ilustra cómo se usan estos campos en Ejemplo de flujo de trabajo de documento IDM.
    Visualización
    Seleccione las opciones para las secciones que desea mostrar en el formulario:
    • Los valores de Texto clave se resuelven en variables de evento AES a las que se puede hacer referencia con variables de Texto clave adicionales. Se pueden definir hasta 15 valores o fórmulas como texto clave. Puede mostrar los 5 valores a la vez.
    • Los valores de Texto finalización se resuelven en variables de evento AES a las que se puede hacer referencia con variables de Texto finalización adicionales. Se pueden definir hasta 15 valores o fórmulas como texto de finalización. Puede mostrar los 5 valores a la vez.
    • Los valores de IDO se usan para definir el origen de datos (vIdoName) de la búsqueda utilizada para configurar valores de atributo Document Management en vIdoPropertyList y filtrar en vIdoFilter.
    • Los valores de Documento se usan para definir cómo se almacenará el documento en Document Management: el tipo de documento Document Management, el tipo de entidad y la descripción que se usarán para este documento.

      En Document Management se deben definir una descripción de tipo de entidad y un tipo de documento coincidentes.

    vKeyText (01-15)
    Seleccione el conjunto de campos de texto clave que desea mostrar (01-05, 06-10, 11-15). Cuando se muestren los campos, defina una función similar a AES en cada campo, según proceda. AES evalúa la función, o series de funciones, que están definidas en el primer campo y coloca el valor en una variable de evento llamada KeyText01. Si hay una función en el segundo campo, esa función se evalúa y su valor se coloca en una variable de evento denominada KeyText02, y así sucesivamente.
    vFinishText (01-15)
    Seleccione el conjunto de valores de texto clave que desea mostrar (01-05, 06-10, 11-15). Cuando se muestren los campos, defina variables de evento AES para referencia. Podrá usar textos de finalización si, por ejemplo, hay un determinado valor en el documento y no desea enviar el documento a AES. En casos así, el proceso se finaliza o suspende.
    vFinishExpression1, vFinishOperator y vFinishExpression2
    Se pueden usar los valores de Texto finalización para "finalizar", o suspender, el evento AES si la condición se evalúa como True. Por ejemplo, si FinishText01 se define para extraer un valor específico, puede indicar a AES que se suspenda antes de añadir contenido a Document Management si FinishText01 = “REPRINT”.

    Si se usan literales para las variables de la expresión "finish", se deben incluir entre comillas dobles para que AES interprete los valores correctamente.

    El operador suele ser de tipo igualitario, como =, >= o <>.

    vIDOName
    Especifique el nombre del IDO que contiene la información que desea proporcionar como valores de atributo.
    vIDOFilter
    Especifique una función AES, que sea similar a C# string.format(), para crear un filtro en el IDO. El filtro busca en el IDO un registro específico.
    vIDOPropertyList
    Especifique una lista de propiedades IDO que pertenezcan al IDO de vIdoName. Salvo las subrecopilaciones, cualquier nombre de propiedad IDO es válido, incluidas las propiedades de TEU.
    Nota: El tipo de documento Document Management que especifique en vExtDocName debe incluir atributos que coincidan exactamente con los nombres de las propiedades IDO de esta lista. De esta forma, el documento Document Management se puede etiquetar con los valores de propiedades IDO a efectos de filtrado.
    Nombre vExtDoc
    Especifique el tipo de documento Document Management que se utiliza para almacenar el documento enviado. Si es un tipo de documento nuevo, también debe añadirlo en Document Management.
    vExtMsgEntity
    Especifique el tipo de entidad que se transmite en un mensaje JSON desde los formularios SyteLine en los que debe estar disponible este documento en la aplicación contextual Información relacionada.
    vExtDocDescription
    Especifique una función AES que cree una descripción relevante del documento que incluya los valores de la variable KeyText.
  5. Guarde los cambios.
  6. Si va a configurar un flujo de documento para un informe que no está actualmente en la lista de flujos de trabajo, probablemente desee que el documento esté disponible en la aplicación contextual Información relacionada cuando se visualicen determinados formularios de SyteLine. (Por ejemplo, podría interesarle que el formulario Reversión de cargos muestre documentos CS_SalesInvoice para un proyecto específico en el panel Información relacionada). Determine qué formularios de SyteLine incluyen los documentos, y a continuación, asegúrese de que los mensajes del contenedor web para estos formularios están correctamente configurados. El controlador de evento del formulario StdObjectSelectCurrentCompleted debe transmitir el tipo de entidad y al menos uno de los valores clave (en nuestro ejemplo Reversión de cargos, el InvNum) asociados al tipo de documento.
  7. Si su personalización envía un tipo nuevo de informe o documento a Document Management, siga estos pasos de Document Management:
    • Configure un documento nuevo en Document Management que coincida con el valor vExtDocName especificado en el flujo de trabajo.
    • Configure los atributos para el tipo de documento nuevo. Siempre debe incluir los atributos Entidad contable, Tipo de entidad, Ubicación y Descripción. Puede añadir otros atributos que sean específicos a este tipo de documento. Estos atributos deben coincidir exactamente con las propiedades IDO especificadas en el flujo de trabajo de documento SyteLine para ese tipo de documento.
    • Configure una lista de control de acceso (ACL) para el tipo de documento nuevo.
    • Configure un modelo de contexto de negocio (BCM) para el tipo de documento nuevo que asigne la información contextual transmitida por los formularios SyteLine a variables que la aplicación contextual Información relacionada espere ver para este tipo de documento.

    Para obtener más información acerca de estos pasos, consulte la Guía de administración de Infor Operating Service.

  8. Si su personalización modifica uno de los documentos predefinidos para enviar metadatos adicionales, configure los atributos nuevos del ACL para el tipo de documento en la aplicación Document Management. Así se asegura de que el valor de metadatos nuevo está disponible para los usuarios de Document Management y de la aplicación contextual Información relacionada. También debe añadir el ID de atributo nuevo a IDOPropertyList.
  9. En SyteLine, vuelva a abrir el formulario Flujos de trabajo de documento Document Management y seleccione el registro modificado o nuevo de tarea en segundo plano. Haga clic en Activo para activar el flujo de trabajo.
  10. En SyteLine, genere el documento para el que ha añadido o modificado un flujo de trabajo. Verifique que el documento está disponible en Document Management y en la aplicación contextual Información relacionada.