Conector Clarizen Eliminar¶

La actividad de eliminación de Clarizen disponible dentro del Conector Clarizen le permite eliminar registros existentes en una instancia de Clarizen conectada usando Jitterbit.

Esta página describe cómo eliminar registros de Clarizen existentes usando un ejemplo de eliminación de una tarea existente por ID en Clarizen a partir de datos de origen proporcionados en un archivo XML a través de Jitterbit. Este ejemplo elimina el mismo archivo de ejemplo utilizado en Clarizen Connector Create y Actualización del conector Clarizen ejemplos.

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 eliminación, definir los componentes de la operación e desplegar y ejecutar la operación.

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

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

   • Vaya a Archivo > Nuevo > Conectores > Nuevo Clarizen Eliminar.
   • En el árbol de la izquierda, debajo de Conectores, haga clic con el botón derecho en la categoría Clarizen y luego seleccione Nueva eliminación de Clarizen.
   • En el árbol de la izquierda bajo Conectores, haga doble clic en la categoría Clarizen, luego haga clic derecho en Clarizen Eliminar actividades y seleccione Nueva eliminación de Clarizen.
   • 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 Eliminar.

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

   

3. La pantalla Objeto del Asistente de eliminación de Clarizen le pide que seleccione el objeto del que desea eliminar registros. En este ejemplo queremos eliminar una tarea existente en Clarizen, por lo que seleccionamos el objeto "Tarea" y luego hacemos 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á eliminar registros dentro de su instancia de Clarizen conectada. Debería aparecer una nueva pestaña en Studio llamada Clarizen Eliminar actividades. Puede cambiar el nombre de su actividad de eliminación aquí si lo desea; en el ejemplo el nuestro se llama "Ejemplo de tarea de eliminación 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 eliminará la tarea existente 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 eliminació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 varios discos para guardar todos los cambios en su proyecto de integración. Debería ver que el asterisco en la pestaña Operaciones y el título de la operación desaparecen a medida que su nueva actividad de actualización 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 eliminar una tarea existente con el ID proporcionado a continuación. Se debe incluir un ID en el origen de una actividad de eliminación y puede ser el ID externo o el ID interno (ID completo) en el formato /\<tipo_objeto>/\<id_externo>.

  <ns:INPUT xmlns:ns="urn:czoln:document:czoln:oln:entities">
      <Task>
          <id>jw47joqmno25rh7l5azcmo3o26</id>
      </Task>
  </ns:INPUT>
  

  Nota

  Una actividad de eliminación de Clarizen debe utilizar el ID interno o externo de la entidad dentro de Clarizen para asociar la eliminación con el objeto correcto. El ID interno completo de Clarizen incluye el nombre de la entidad en el formato /\<tipo_objeto>/\<id_externo> (por ejemplo, /Task/jw47joqmno25rh7l5azcmo3o26), mientras que el ID externo de Clarizen utilizará de forma predeterminada el ID únicamente, por ejemplo, jw47joqmno25rh7l5azcmo3o26.

  Nota

  En el ejemplo, utilizamos el ID de Clarizen devuelto en la respuesta del ejemplo utilizado en Crear conector Clarizen y Actualización del conector Clarizen. Si sigue el ejemplo, deberá reemplazar este ID con el de la tarea específica en su instancia de Clarizen.

  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, ClarizenDelete_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 'ClarizenDelete_Task_Request.xml'.

• Destino: haga doble clic en el icono Objetivo. En el ejemplo, enviaremos el ID y el estado a un archivo XML para asegurarnos de que la operación se haya realizado correctamente. Haga clic en el botón Crear nuevo destino, asigne un Nombre a su destino (p. ej., ClarizenDelete_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 'ClarizenDelete_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 radio para Eliminar, luego haga clic en Siguiente. En la siguiente pantalla, utilice el menú desplegable para seleccionar la operación de eliminación (por ejemplo, "Ejemplo de tarea de eliminació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. Arrastre el campo 'id' en el lado de entrada al campo 'id' en el lado de salida. 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 radio para Eliminar y luego haga clic en Siguiente. En la siguiente pantalla, utilice el menú desplegable para seleccionar la operación de eliminación (por ejemplo, "Ejemplo de tarea de eliminació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 actualizació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\ClarizenDelete_Task_Response.xml'. Dado que la operación se ejecutó correctamente, vemos el ID de la tarea en Clarizen y un estado de "1" que indica el éxito.

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

5. Además, cuando revise su instancia de Clarizen, debería encontrar que la tarea eliminada ya no existe.