Crear Conector Clarizen¶

La actividad de creación de Clarizen está disponible dentro del Conector Clarizen le permite crear nuevos datos en una instancia de Clarizen conectada usando Jitterbit.

Esta página describe cómo crear nuevos registros de Clarizen usando un ejemplo de creación de una nueva tarea en Clarizen a partir de datos de origen proporcionados en un archivo XML a través de Jitterbit.

Este ejemplo se utiliza únicamente con fines de demostración y no cubre todas las opciones disponibles en el producto; consulte Design Studio para obtener documentación más completa.

Las siguientes secciones se dividen en comenzar la actividad de creación, definir los componentes de la operación e desplegar y ejecutar la operación.

Crear una Operación de Creación de Clarizen¶

1. Dentro de su proyecto dentro de Jitterbit Studio, hay varias formas de iniciar una nueva actividad de creación de Clarizen. Cada una de las siguientes opciones iniciará el Asistente de creación de Clarizen para guiarlo a través del proceso.

   • Vaya a Archivo > Nuevo > Conectores > Nueva creación de Clarizen.
   • En el árbol de la izquierda, debajo de Conectores, haga clic con el botón derecho en la categoría Clarizen y luego seleccione Crear nuevo Clarizen.
   • En el árbol de la izquierda debajo de Conectores, haga doble clic en la categoría Clarizen, luego haga clic derecho en Clarizen Create Activity y seleccione New Clarizen Create.
   • En la barra de herramientas superior, haga clic en el icono del conector (pieza de rompecabezas naranja) . En la ventana emergente, seleccione Clarizen, luego seleccione Clarizen Create.

2. La pantalla Extremo del Clarizen Create Wizard debería abrirse en la vista principal de Studio. Esta pantalla le solicita que seleccione el extremo en el que desea crear nuevos datos. Ya debería haber configurado su extremo en Clarizen Connector Extremo. Utilice el menú desplegable para seleccionar el extremo apropiado. Haga clic en Siguiente cuando haya terminado.

   

3. La pantalla Objeto del Asistente de creación de Clarizen le pide que seleccione el objeto en el que desea crear nuevos datos. En este ejemplo queremos crear una nueva tarea en Clarizen, así que seleccionamos el objeto "Tarea", luego haga clic en Finalizar para continuar.

   Nota

   Si tiene muchos objetos disponibles en su instancia de Clarizen, es posible que deba esperar un momento para que se carguen. También puede ingresar un nombre de objeto en el campo Filtro. Pruebe el botón Actualizar si los resultados no son los esperados.

   

4. Luego, Jitterbit procederá a crear una estructura de solicitud y respuesta de la API de Clarizen que permitirá que se creen datos dentro de su instancia de Clarizen conectada. Debería aparecer una nueva pestaña en Studio llamada Clarizen Create Activity. Puede cambiar el nombre de su actividad de creación aquí si lo desea; en el ejemplo el nuestro se llama "Ejemplo de creación de tarea de Clarizen ". También puede utilizar los botones o flechas + - para expandir todos los elementos dentro de cada estructura.

   

5. A continuación, en la misma pantalla, haga clic en el botón Crear operación ubicado en Usar en una integración en la esquina superior derecha. Esto creará la operación Jitterbit que creará una nueva tarea en Clarizen.

6. Debería abrirse una nueva pestaña en Studio llamada Operaciones, que contiene una representación gráfica de la actividad de creación.

   

   Nota

   Los íconos para Fuente, Solicitud, Respuesta y Destino en la imagen de arriba son marcadores de posición para los componentes de la operación, que definiremos en la siguiente sección.

   Guarde su operación haciendo clic en el ícono de un solo disco para guardar solo esta operación o en el ícono de múltiples discos para guardar todos los cambios en su proyecto de integración. Debería ver el asterisco en la pestaña Operaciones y el título de la operación desaparecer a medida que su nueva actividad de creación ahora se crea y se guarda en su proyecto.

Definición de los Componentes de la Operación¶

A continuación, debemos definir los otros componentes de la operación que aparecen dentro de la representación gráfica, incluidos Fuente, Solicitud, Respuesta y Destino.

Para cada uno, las instrucciones a continuación le indican que regrese a la representación gráfica de la operación que ha creado y haga doble clic en cada icono para configurar cada componente. Como alternativa, también puedes crear Fuente, Solicitud, Respuesta y Destino por separado y luego arrastrarlos y soltarlos desde el árbol de la izquierda directamente en los íconos. en la representación visual de su operación.

Para fines de este tutorial, proporcionamos los siguientes ejemplos como referencia arriba: Jitterpak ClarizenExample.jpk y los archivos adjuntos en ClarizenSampleFiles.zip. Se pueden utilizar muchos tipos diferentes de datos para cada componente de la operación. Para obtener más información sobre opciones de personalización adicionales, consulte Design Studio sección de nuestra documentación.

• Fuente: En el ejemplo, utilizamos un archivo XML como solicitud de entrada para crear una nueva tarea con los valores de campo proporcionados a continuación:

  Input

  <ns:INPUT xmlns:ns="urn:czoln:document:czoln:oln:entities">
      <Task>
          <Name>Task1</Name>
          <Description>FirstTask</Description>
          <Duration>
              <unit>Days</unit>
              <value>3</value>
          </Duration>
          <ActualStartDate>2016-12-13 12:12:12</ActualStartDate>
          <ActualCost/>
          <PlannedBudget></PlannedBudget>
          <FixedCost/>
          <FixedPrice/>
          <PlannedRevenue/>
          <ActualRevenue/>
          <DirectPlannedExpenses/>
          <DirectPlannedBilledExpenses/>
          <AllowReportingOnSubItems>1</AllowReportingOnSubItems>
          <BudgetedHours/>
          <ActualEffortUpdatedFromTimesheets>1</ActualEffortUpdatedFromTimesheets>
          <Deliverable>1</Deliverable>
          <PlannedAmount/>
          <ChargedAmount/>
          <TotalEstimatedCost/>
          </Task>
  </ns:INPUT>
  

  Nota

  Hay una variedad de tipos de fuentes disponibles en Jitterbit. Vea Fuentes para más.

  Para usar el archivo XML, primero haga doble clic en el icono Fuente, luego haga clic en el botón Crear nueva fuente y asigne un Nombre a su fuente (por ejemplo, ClarizenCreate_Task_Request.xml). A continuación, para este ejemplo, estamos usando un Agente Privado con archivos locales habilitados, y así seleccionar un Tipo de "Archivo local" y luego Buscar hasta la ubicación. Si está utilizando los archivos de ejemplo, la Carpeta es 'C:\ClarizenSampleFiles' y Obtener archivos es 'ClarizenCreate_Task_Request.xml'.

• Destino: haga doble clic en el icono Objetivo. En el ejemplo, enviaremos el ID y el estado de la nueva tarea en Clarizen a un archivo XML para asegurarnos de que se haya creado. Haga clic en el botón Crear nuevo destino, asigne un Nombre a su destino (p. ej., ClarizenCreate_Task_Response.xml) y seleccione nuevamente un Tipo de "Archivo local" y Buscar en una ubicación. en el Agente Privado donde queremos guardar los datos. En el ejemplo, la Carpeta es 'C:\ClarizenSampleFiles' y el Nombre de archivo es 'ClarizenCreate_Task_Response.xml'.

  Nota

  También puede generar salida a una variedad de tipos de destino diferentes. El tipo no tiene que ser el mismo que el tipo de origen. Consulte Objetivos para opciones.

• Solicitud: Haga doble clic en el icono Solicitar y seleccione Crear nueva Transformación. Esto abrirá el Asistente de Transformación que le guiará en el proceso de creación de la solicitud.

  Nota

  Se proporciona información adicional sobre las estructuras solicitadas en Transformaciones.

  1. En la primera pantalla, Nombre, proporcione un Nombre para su transformación o déjelo como predeterminado. Luego use el menú desplegable Fuente para seleccionar "Solicitud de función Clarizen ". Haga clic en Siguiente para continuar.

  2. En la siguiente pantalla, Fuente, seleccione el botón de opción Crear y luego haga clic en Siguiente. En la siguiente pantalla, utilice el menú desplegable para seleccionar la operación de creación (por ejemplo, "Ejemplo de tarea de creación de Clarizen ") y luego haga clic en Finalizar.

  3. La pestaña Transformaciones debería abrirse donde podrás completar tu mapeo. Utilice + para expandir los elementos de origen y destino en cada árbol. Luego arrastre y suelte cada campo que desee asignar de un árbol a otro. Como atajo para este ejemplo, puede hacer clic en el icono del mapa automático que aparece debajo del lado objetivo del árbol:

     

     Su mapeo de transformación debería ser similar al que se muestra a continuación:

     

• Respuesta: Haga doble clic en el icono Respuesta y seleccione Crear nueva Transformación. Esto abrirá el Asistente de Transformación que le guiará en la creación de la respuesta.

  Nota

  Se proporciona información adicional sobre las estructuras de respuesta en Transformaciones.

  1. En la primera pantalla, Nombre, proporcione un Nombre para su transformación o déjelo como predeterminado. Luego use el menú desplegable Destino para seleccionar "Respuesta de la función Clarizen ". Haga clic en Siguiente para continuar.

  2. En la siguiente pantalla, Destino, seleccione el botón de opción Crear y luego haga clic en Siguiente. En la siguiente pantalla, utilice el menú desplegable para seleccionar la operación de creación (por ejemplo, "Ejemplo de tarea de creación de Clarizen ") y luego haga clic en Finalizar.

  3. La pestaña Transformaciones debería abrirse donde podrás completar tu mapeo. Utilice el + para expandir los lados de origen y destino. En este ejemplo, crearemos la respuesta de salida para que incluya el ID, el estado y cualquier mensaje de error en la respuesta. Haga clic y arrastre la carpeta "SALIDA" desde el lado izquierdo (lado de origen) a la carpeta "SALIDA" en el lado derecho (lado de destino). Su pantalla de mapeo ahora debería verse similar a la siguiente.

     

Despliegue y Ejecución de la Operación¶

Con la actividad de creación de Clarizen completamente configurada, estamos listos para desplegar y ejecutar la operación.

1. Desde la pestaña Operaciones, haga clic en desplegar icono.

2. Luego haga clic en ejecutar para colocar la operación en la cola para su ejecución.

3. En la parte inferior de la pantalla, el monitor de operación debería indicar que su operación se ejecutó exitosamente. De lo contrario, puede hacer doble clic en el icono Estado para ver los mensajes de registro.

   

4. Ahora también debería ver la respuesta de salida que se asignó a su archivo de destino. En el ejemplo, el archivo ahora se crea en 'C:\ClarizenSampleFiles\ClarizenCreate_Task_Response.xml'. Dado que la operación se ejecutó correctamente, vemos el ID interno completo de la tarea en Clarizen y un estado de "1" que indica el éxito.

   Output

   <ns:OUTPUT xmlns:ns="urn:czoln-res:document:czoln:oln:entities">
       <Task>
           <id>/Task/jw47joqmno25rh7l5azcmo3o26</id>
           <status>1</status>
       </Task>
   </ns:OUTPUT>
   

5. Además, cuando revise su instancia de Clarizen, debería encontrar la nueva tarea creada.