Importación de datos en Workfront mediante una plantilla de KickStart

Los Kick-Starts son libros de Excel con formato especial que se pueden rellenar con los datos que se desean importar a Workfront. Adobe Workfront proporciona una plantilla de KickStart que puede usar para hacerlo, tal como se explica en Importador de datos de Kick-Starts.

Este proceso se divide en 3 tareas principales:

  • En primer lugar, exporte una plantilla de KickStart como archivo de hoja de cálculo
  • En segundo lugar, se rellena la hoja de cálculo con los datos
  • Por último, importe la hoja de cálculo rellenada en Workfront

Cada uno de estos procedimientos se describe en el orden adecuado en este artículo.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Debe tener el siguiente acceso para realizar los pasos de este artículo:

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
plan de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

o

Actual: plan

Configuraciones de nivel de acceso Administrador del sistema

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación de Workfront.

Limitaciones

Puede importar una gran cantidad de objetos en Workfront mediante una plantilla de KickStart. Sin embargo, tenga en cuenta las siguientes limitaciones:

  • La importación de datos de este modo no actualiza la información de los registros que ya existen en Workfront.
  • Solo se pueden importar registros nuevos y su información.
  • No importe más de 2000 registros a la vez para garantizar que no se agote el tiempo de espera de la importación

Exportar una plantilla de KickStart como archivo de hoja de cálculo

Cuando exporta una plantilla de KickStart, recibe un libro de Excel en blanco. Una vez que la hoja de cálculo se haya descargado en el equipo, puede utilizarla para rellenarla con la información y, a continuación, importarla de nuevo a Workfront.

Para exportar una plantilla de KickStart:

  1. Haga clic en el icono Menú principal Menú principal en la esquina superior derecha de Adobe Workfront o (si está disponible), haga clic en el icono Menú principal Menú principal en la esquina superior izquierda y, a continuación, haga clic en Configurar Icono de configuración .

  2. Haga clic en Sistema > Importar datos (Kick-Starts).

  3. Seleccione los tipos de información que desea incluir.

    Cada opción seleccionada representa una colección de varias fichas en la hoja de cálculo exportada. Por ejemplo, si selecciona la opción Informe, todos los objetos necesarios para crear un informe se incluirán en la hoja de cálculo (vistas, filtros, agrupaciones, informes).

    Puede utilizar todos los tipos de objetos enumerados a continuación para importar datos en Workfront. (La única excepción es la opción Niveles de acceso. La hoja de datos Niveles de acceso de una exportación se proporciona con fines de referencia (le permite asignar un nivel de acceso a una nueva cuenta de usuario por identificador).

    La plantilla para cada uno de los tipos de objeto se puede exportar en los siguientes formatos de archivo y contiene las siguientes hojas:

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 layout-auto
    Objeto Exportaciones como Hojas en la hoja de cálculo exportada

    Panel de control

    Todos los paneles del sistema están disponibles para exportar. Puede seleccionar hasta 100 paneles específicos en una sola exportación.

    Exportaciones como archivo ZIP

    Parámetro

    Texto descriptivo

    Opción del parámetro

    Grupo de parámetros

    Parámetro de categoría

    Categoría

    Informe

    Sección de la ficha de portal

    Panel de control

    Preferencias

    Informe

    Todos los informes del sistema están disponibles para exportar. Puede seleccionar hasta 100 informes específicos en una sola exportación.

    Kick-Starts no admite filtros o agrupaciones en modo texto. Para que la exportación se realice correctamente, los filtros y las agrupaciones de informes deben cambiarse al modo Estándar.

    Exportaciones como archivo ZIP

    Parámetro

    Texto descriptivo

    Opción del parámetro

    Grupo de parámetros

    Parámetro de categoría

    Categoría

    Informe

    Preferencias

    Aprobación Exportaciones como archivo de Excel

    Aprobador de fase

    Fase de aprobación

    Aprobación

    Proceso de aprobación

    Preferencias

    Datos personalizados Exportaciones como archivo de Excel

    Parámetro

    Texto descriptivo

    Opción del parámetro

    Grupo de parámetros

    Parámetro de categoría

    Categoría

    Preferencias

    Tipo de gasto Exportaciones como archivo de Excel

    Tipo de gasto

    Preferencias

    Tipo de hora Exportaciones como archivo de Excel

    Tipo de hora

    Preferencias

    Equipo Exportaciones como archivo de Excel

    Miembro del equipo

    Equipo

    Preferencias

    Usuario Se exporta como un archivo de Excel. Para ver la lista completa de opciones, haga clic en Más opciones.

    Usuario

    Preferencias

    Nivel de acceso Exportaciones como archivo de Excel

    Nivel de acceso

    Preferencias

    Asignación Exportaciones como archivo de Excel

    Asignación

    Preferencias

    Compañía Exportaciones como archivo de Excel

    Compañía

    Preferencias

    Plantilla de mensaje de correo electrónico Exportaciones como archivo de Excel

    Plantilla de mensaje de correo electrónico

    Preferencias

    Gasto Exportaciones como archivo de Excel

    Gasto'

    Preferencias

    Página externa Exportaciones como archivo de Excel

    Página externa

    Preferencias

    Filtro Exportaciones como archivo ZIP

    Filtro

    Preferencias

    Grupo Exportaciones como archivo de Excel

    Grupo

    Preferencias

    Agrupación Exportaciones como archivo ZIP

    Agrupación

    Preferencias

    Hora Exportaciones como archivo de Excel

    Hora

    Preferencias

    Problema Exportaciones como archivo de Excel

    Problema

    Preferencias

    Función Exportaciones como archivo de Excel

    Función del puesto

    Preferencias

    Ruta de hitos Exportaciones como archivo de Excel

    Hito

    Ruta de hitos

    Preferencias

    Nota Exportaciones como archivo de Excel

    Nota

    Preferencias

    Portafolio Exportaciones como archivo de Excel

    Portafolio

    Preferencias

    Proyecto Exportaciones como archivo de Excel

    Cola

    Proyecto

    Regla de enrutamiento

    Tema de la cola

    Preferencias

    Estimación de recursos Exportaciones como archivo de Excel

    Estimación de recursos

    Preferencias

    Riesgo Exportaciones como archivo de Excel

    Riesgo

    Preferencias

    Tipo de riesgo Exportaciones como archivo de Excel

    Tipo de riesgo

    Preferencias

    Tarjeta de puntuación Exportaciones como archivo de Excel

    Pregunta de tarjeta de puntuación

    Opción de tarjeta de puntuación

    Tarjeta de puntuación

    Preferencias

    Tarea Exportaciones como archivo de Excel

    Tarea

    Preferencias

    Plantilla Exportaciones como archivo de Excel

    Cola

    Plantilla

    Regla de enrutamiento

    Tema de la cola

    Preferencias

    Asignación de plantilla Exportaciones como archivo de Excel

    Asignación de plantilla

    Preferencias

    Tarea de plantilla Exportaciones como archivo de Excel

    Tarea de plantilla

    Preferencias

    Hoja de horas Exportaciones como archivo de Excel

    Perfil de hoja de horas

    Hoja de horas

    Preferencias

    Ver Exportaciones como archivo ZIP

    Ver

    Preferencias

  4. Haga clic en Descargar.

  5. Continúe con Rellene la plantilla de hoja de cálculo con sus datos para rellenar la hoja de cálculo de plantilla en blanco con su información.

Rellene la plantilla de hoja de cálculo con los datos populate-the-spreadsheet-template-with-your-data

Descripción general de las fichas (hojas de datos) incluidas en la hoja de cálculo

TIP
Para comprender mejor cómo tendrá que dar formato a la información de cada columna al rellenar la plantilla de KickStart, considere la posibilidad de realizar una ejecución de práctica exportando un KickStart con datos de Workfront existentes en los objetos que está intentando importar. Para obtener instrucciones, consulte Exportar datos de Adobe Workfront mediante Kick-Starts.

Al abrir una plantilla de Kick-Starts en blanco, hay varias pestañas (hojas de datos) disponibles. Dependen de los objetos seleccionados para la descarga. Cada uno representa un objeto en la aplicación, como proyecto, tareas, horas, panel y usuarios:

Al abrir una de estas pestañas, la fila 2 muestra los campos de cada objeto que se puede establecer durante una importación. En un encabezado de columna, después de la palabra "set", el nombre del campo se muestra tal y como aparece en la base de datos. Estos campos actúan como encabezados de columna.

IMPORTANT
Para evitar errores, asegúrese de lo siguiente:
  • No elimine la primera fila vacía de una hoja de cálculo de inicio rápido.
  • No elimine, modifique ni reorganice estos campos (encabezados de columna) de ninguna manera. Por ejemplo, no cambie el orden ni los nombres.
  • Agregue valores a cada campo que se muestre en negrita en el encabezado de la columna. Estos representan campos obligatorios.
Sin embargo, si un campo obligatorio contiene un valor predeterminado establecido en las preferencias del sistema, no tiene que rellenarlo.
Por ejemplo, en la ficha Proyecto PROJ, los campos setCondition y setConditionType pueden dejarse vacíos, pero las columnas setGroupID y setName no pueden.
  • El sistema genera automáticamente ciertos campos, como setResourceRevenue y setEnteredByID. Si se introducen datos para estos campos en la hoja de cálculo, el proceso de KickStart los sustituirá al cargar la hoja de cálculo.

Importar un registro import-a-record

Cada fila de la hoja corresponde a un objeto único.

  1. Agregar información en la columna isNew:

    • Si el objeto que está importando es nuevo, escriba TRUE para importar los datos de la fila. Este valor distingue entre mayúsculas y minúsculas y siempre debe escribirse en mayúsculas

    • Si el objeto ya está en Workfront, escriba FALSE en la columna isNew para omitir la fila. Este valor distingue entre mayúsculas y minúsculas y siempre debe escribirse en mayúsculas

      • Los registros que ya existen en Workfront no se actualizan.
      • Si ha descargado una plantilla con datos de Workfront, los objetos existentes ya están marcados con FALSE.
      • Si ha descargado una plantilla en blanco, no es necesario agregar nuevas filas para los objetos existentes.
  2. Agregue información en la columna ID de una de las siguientes maneras:

    • Si el objeto que está importando es nuevo (y escribió TRUE en la columna isNew), escriba cualquier número para el identificador. Este número debe ser único en la hoja de cálculo. Por ejemplo, si importa tres objetos, puede darles el ID de 1, 2 y 3 respectivamente.

    • Si el objeto ya existe en Workfront (y FALSE está en la columna isNew) y está importando información nueva sobre objetos existentes, el identificador debe ser el GUID alfanumérico que existe en Workfront para ese objeto.

    note tip
    TIP
    Para averiguar el GUID único de un objeto en Workfront, puede crear un informe para ese objeto y agregar la columna ID al informe. El valor de cada objeto de esa columna es el GUID del objeto.
    • Los registros que ya existen en Workfront no se actualizan.
    • Si ha descargado una plantilla con datos, los objetos existentes ya contienen el GUID como ID.
    • Puede importar un nuevo objeto basado en un objeto existente cambiando FALSE a TRUE en la columna isNew, cambiando el identificador y realizando los ajustes de datos necesarios antes de la importación.

    ID de muestra para un grupo

    • Al importar un proyecto, debe indicar un ID de grupo.

      • Si el grupo ya existe en Workfront, debe agregar su identificador único al campo setGroupID del proyecto.
      • Si el grupo no existe en Workfront, puede agregar la hoja GROUP Group al archivo de importación, establecer el campo isNew en TRUE en la hoja Group e indicar un identificador numérico para el nuevo grupo en la columna ID. El campo setGroupID del nuevo proyecto debe coincidir con el ID numérico del nuevo grupo.

      Ejemplo: Para un proyecto, el valor mostrado en la columna setGroupID debe ser uno de los siguientes:

      • GUID de un grupo existente en su instancia de Workfront
      • El valor (número) de la columna Id. de la hoja Grupo de grupo si está creando un nuevo grupo durante la importación
  3. Introduzca valores para los campos obligatorios y cualquier otro campo que desee rellenar durante la importación.

  4. (Opcional) Para agregar datos personalizados:

    • Cree una nueva columna para cada campo personalizado que desee incluir en el proceso de importación.

    • Asigne un nombre a cada nueva columna para su campo personalizado correspondiente de la siguiente manera: DE:[Nombre del campo personalizado tal como aparece en Workfront]. Por ejemplo, puede crear el siguiente campo personalizado: "DE: Departamentos".

    • En la columna setCategoryID, escriba el GUID del formulario personalizado existente en el que reside este campo personalizado. Este campo es obligatorio al importar datos personalizados.

    • Si necesita agregar varios valores de datos en el campo personalizado (como botones de opción, casillas de verificación o listas), utilice el delimitador de datos personalizados de barra vertical "|" que aparece en la pestaña Preferencias para separar los valores.

      Ejemplo: escriba A|D en la columna DE:Departamentos para rellenar los departamentos A y D en el formulario personalizado.

Incluir fechas include-dates

Workfront puede procesar la mayoría de los formatos de fecha. Sin embargo, debe asegurarse de que la columna de fecha de la hoja de cálculo tenga el formato de fecha. La importación fallará si la columna tiene el formato general, un número o texto.

TIP
El formato más popular es el formato MM/DD/AAAA.
Por ejemplo: 10/07/2023.

Workfront también acepta valores de hora como parte de la fecha.

Por ejemplo: 10/07/2022 01:30 o 10/07/2022 1:00 p.m.

Si omite una hora en la fecha, Workfront realiza una de las siguientes acciones:

  • Asume que la hora es 12:00 AM. Para ver el resultado de la fecha que espera, la zona horaria del sistema debe coincidir con la del sistema.
  • Si se encuentra en un objeto asociado a una programación, el tiempo se difiere a la primera vez que la programación lo permite.
NOTE
Cuando utilice una marca de tiempo UNIX, debe incluir tres ceros adicionales al final del valor.
Por ejemplo, si la marca de tiempo es 7336899000, debe introducir 7336899000000 en la celda.

Usar caracteres comodín use-wildcards

Al rellenar la hoja de cálculo de la plantilla de KickStart, puede utilizar los siguientes caracteres comodín:

Comodín
Comportamiento
$$TODAY

Cuando se usa en un campo setDate, este comodín establece la fecha como medianoche del día en que se importa el Kick-Start.

Puede modificar el comodín utilizando la sintaxis estándar permitida con el comodín en un filtro.

Ejemplo: Si desea que un proyecto comience el lunes de la semana en que se importa, independientemente del día en que realmente realice la importación, puede usar $$TODAYbw. Esto establece la fecha planificada de inicio del proyecto como 12:00 a.m. del domingo. Dado que el horario del proyecto probablemente no permita trabajar a esa hora, comenzará a las 9:00 AM del lunes por la mañana.

$$NOW

Cuando se usa en un campo setDate, este comodín establece la fecha según el momento en que se crea el registro durante la importación de KickStart.

Puede modificar el comodín utilizando la sintaxis estándar permitida con el comodín en un filtro.

Ejemplo: Si desea que un proyecto se inicie 3 horas después de importarlo, puede usar $$NOW+3h.

$$USER.ID
Cuando se utiliza en setAssignedToID u otro campo basado en userID, este comodín asigna el trabajo o asocia de otro modo el registro con el individuo que realiza la importación.
$$CUSTOMER

Este comodín se agregó específicamente para importaciones de usuarios de KickStart. Cuando se crea una cuenta de Workfront, se crea un usuario con el nivel de acceso de administrador del sistema. El nombre de usuario asignado al administrador predeterminado puede utilizarse como prefijo al crear otros usuarios en la cuenta.

Dado que los nombres de usuario deben ser únicos en todos los clientes, esto resulta útil cuando tiene varias personas con nombres de usuario muy comunes, como Juan Pérez, que pueden tener un nombre de usuario "jsmith". Al anteponer la asignación de nombre de usuario con el nombre de usuario de administrador predeterminado, garantiza que cada nombre de usuario es único (por ejemplo: $$CUSTOMER.jsmith).

Sugerencia: Una forma más elegante de asegurarse de que los nombres de usuario sean únicos en todo el sistema es introducir la dirección de correo electrónico del individuo en el campo setUsername.

Sustitución de nombres de atributo para ID attribute-name-substitution-for-ids

Aunque es recomendable usar identificadores siempre que sea posible, a veces resulta incómodo hacer referencias cruzadas de los identificadores de una hoja a otra al establecer un valor setAttributeID. Puede hacer referencia a los valores por nombre simplemente cambiando el encabezado de la columna.

Ejemplos:

  • Importación de proyecto

    Al importar proyectos, establezca el setGroupID de los proyectos en la hoja GROUP Group, tome nota de los respectivos ID de grupo y péguelos en las celdas correctas (columna setGroupID) en la hoja PROJ Project.

    Esto es factible cuando se trabaja con solo unos pocos grupos y proyectos, pero si se trabaja con varios de cada uno, no es práctico.

    Para realizar la sustitución de nombres de atributo para el ejemplo descrito anteriormente, cambia el encabezado de columna setGroupID a #setGroupID GROUP name. A continuación, puede hacer referencia al grupo de cada proyecto por su nombre.

    note note
    NOTE
    La opción de usar Sustitución de nombre de atributo se limita únicamente a las referencias para los registros existentes. No se puede utilizar la sustitución de nombres para los objetos que se están creando en la misma importación.
  • Importación de usuario

    Al importar usuarios, rellene setRoleID de una lista de funciones en la ficha FUNCIÓN.

    Algunos de los identificadores de rol son para registros que ya existen en la cuenta y otros se están creando durante la importación.

    Para los registros de usuario nuevos asignados a funciones existentes, puede utilizar la sustitución de nombres. Para los registros de usuario nuevos asignados a roles recién importados, no puede.

    A continuación se muestra cómo puede utilizar ambos métodos en el mismo archivo de importación:

    • Agregue una columna en la hoja de cálculo a la izquierda de la columna setRoleID.

    • Asigne un nombre a la nueva columna #setRoleID ROLE name.

    • Para las asignaciones de roles a registros existentes, escriba los nombres de roles en la columna #setRoleID ROLE name.

      Para las asignaciones de roles a nuevos registros de roles, introduzca el ID asignado en la hoja ROL Rol en setRoleID.

      Identificador de rol para usuarios

Importar los datos de la hoja de cálculo en Workfront

Después de rellenar la plantilla de Excel con los datos, puede cargar los datos en Workfront.

La importación de KickStart admite los siguientes tipos de archivo:

  • Excel (.xls o .xlsx)

  • Archivo comprimido (.ZIP) (que contiene solo archivos .xlsx o .xls)

    note note
    NOTE
    Debe utilizar un archivo .ZIP al importar hojas de cálculo de Excel que hagan referencia a los objetos siguientes:
    • Informes
    • Documentos
    • Avatares
    • Ver, filtrar o agrupar archivos de propiedades
    Al utilizar un archivo de importación comprimido, el archivo .ZIP debe tener el mismo nombre que el archivo .xlsx o .xls y todos los archivos deben tener el mismo nivel de estructura (sin carpetas).

Para importar los datos de la hoja de cálculo de plantillas en Workfront:

  1. Haga clic en el icono Menú principal Menú principal en la esquina superior derecha de Adobe Workfront o (si está disponible), haga clic en el icono Menú principal Menú principal en la esquina superior izquierda y, a continuación, haga clic en Configurar Icono de configuración .

  2. Haga clic en Sistema > Importar datos (Kick-Starts).

  3. En la sección Cargar datos con hoja de cálculo de KickStart, haga clic en Elegir archivo, busque y seleccione la hoja de cálculo rellenada.

  4. Haga clic en Cargar.

    Si el archivo de Excel tarda más de 5 minutos en cargarse en Workfront, la aplicación agota el tiempo de espera y Workfront no puede cargar el archivo.

    Intente importar los datos en lotes de objetos más pequeños.

  5. (Condicional) Si utiliza Workfront Fusion, ahora puede activar los FLO o escenarios.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43