Importar dados para o Workfront usando um modelo de Kick-Start

Kick-Starts são pastas de trabalho do Excel com formatação especial, que você pode preencher com os dados que deseja importar para o Workfront. O Adobe Workfront fornece um modelo de Kick-Start que você pode usar para isso, conforme explicado em Importador de dados de Kick-Starts.

Esse processo é dividido em três tarefas principais:

  • Primeiro, você exporta um modelo de Kick-Start como um arquivo de planilha
  • Depois, você preenche a planilha com seus dados
  • Por fim, você importa a planilha preenchida para o Workfront

Cada um desses procedimentos é descrito na ordem correta neste artigo.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Padrão

Plano

Configurações de nível de acesso Administrador de sistema

Para obter informações, consulte Requisitos de acesso na documentação do Workfront.

Limitações

Você pode importar um grande número de objetos para o Workfront usando um modelo de Kick-Start. No entanto, considere as seguintes limitações:

  • Importar dados usando esse método não atualiza as informações dos registros que já existem no Workfront.
  • Você pode importar apenas novos registros e as respectivas informações.
  • Importe no máximo 2.000 registros por vez para garantir que a importação não atinja o tempo-limite

Exportar um modelo de Kick-Start como um arquivo de planilha

Ao exportar um modelo de Kick-Start, você recebe uma pasta de trabalho de planilha do Excel em branco. Depois de baixar a planilha para o computador, você poderá preenchê-la com suas informações e importá-la de volta para o Workfront.

Para exportar um modelo de Kick-Start:

  1. Clique no ícone Menu Principal Menu Principal no canto superior direito do Adobe Workfront ou (se disponível) clique no ícone Menu Principal Menu Principal no canto superior esquerdo e clique no ícone Instalação Instalação .

  2. Clique em Sistema > Importar dados (Kick-Starts).

  3. Selecione os tipos de informações que deseja incluir.

    Cada opção selecionada representa uma coleção de várias guias na planilha exportada. Por exemplo, se você selecionar a opção Relatório, todos os objetos necessários para criar um relatório serão incluídos na planilha (exibições, filtros, agrupamentos, relatórios).

    Você pode usar todos os tipos de objetos listados abaixo para importar dados para o Workfront. (A única exceção é a opção Níveis de acesso. A planilha de dados Níveis de acesso em uma exportação é fornecida para fins de referência. Ela permite atribuir um nível de acesso a uma nova conta de usuário por ID).

    O modelo de cada um dos tipos de objeto pode ser exportado nos seguintes formatos de arquivo e contém as seguintes folhas:

    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 Exportar como Folhas na planilha exportada

    Painel

    Todos os painéis compartilhados publicamente no sistema estão disponíveis para exportação. Não é possível exportar painéis que não foram compartilhados em todo o sistema. Você pode selecionar até 100 painéis específicos em uma única exportação.

    Exportar como arquivo ZIP

    Parâmetro

    Texto descritivo

    Opção de parâmetro

    Grupo de parâmetros

    Parâmetro da categoria

    Categoria

    Relatório

    Seção de guias do portal

    Painel

    Preferências

    Relatório

    Todos os relatórios do sistema estão disponíveis para exportação. É possível selecionar até 100 relatórios específicos em uma única exportação.

    O Kick-Start não permite o uso de filtros ou agrupamentos no Modo texto. Para uma exportação bem-sucedida, os filtros e agrupamentos de relatórios devem ser alternados para o Modo padrão.

    Exportar como arquivo ZIP

    Parâmetro

    Texto descritivo

    Opção de parâmetro

    Grupo de parâmetros

    Parâmetro da categoria

    Categoria

    Relatório

    Preferências

    Aprovação Exportar como arquivo do Excel

    Aprovador de estágio

    Estágio de aprovação

    Aprovação

    Processo de aprovação

    Preferências

    Dados personalizados Exportar como arquivo do Excel

    Parâmetro

    Texto descritivo

    Opção de parâmetro

    Grupo de parâmetros

    Parâmetro da categoria

    Categoria

    Preferências

    Tipo de despesa Exportar como arquivo do Excel

    Tipo de despesa

    Preferências

    Tipo de hora Exportar como arquivo do Excel

    Tipo de hora

    Preferências

    Equipe Exportar como arquivo do Excel

    Membro da equipe

    Equipe

    Preferências

    Usuário Exportar como arquivo do Excel. Para ver a lista completa de opções, clique em Mais opções.

    Usuário

    Preferências

    Nível de acesso Exportar como arquivo do Excel

    Nível de acesso

    Preferências

    Atribuição Exportar como arquivo do Excel

    Atribuição

    Preferências

    Empresa Exportar como arquivo do Excel

    Empresa

    Preferências

    Modelo de email Exportar como arquivo do Excel

    Modelo de email

    Preferências

    Despesa Exportar como arquivo do Excel

    Despesa

    Preferências

    Página externa Exportar como arquivo do Excel

    Página externa

    Preferências

    Filtro Exportar como um arquivo ZIP

    Filtro

    Preferências

    Grupo Exportar como arquivo do Excel

    Grupo

    Preferências

    Agrupamento Exportar como um arquivo ZIP

    Agrupamento

    Preferências

    Hora Exportar como arquivo do Excel

    Hora

    Preferências

    Problema Exportar como arquivo do Excel

    Problema

    Preferências

    Função no trabalho Exportar como arquivo do Excel

    Função no trabalho

    Preferências

    Caminho de marcos Exportar como arquivo do Excel

    Marco

    Caminho de marcos

    Preferências

    Nota Exportar como arquivo do Excel

    Nota

    Preferências

    Portfólio Exportar como arquivo do Excel

    Portfólio

    Preferências

    Projeto Exportar como arquivo do Excel

    Fila

    Projeto

    Regra de roteamento

    Tópico da fila

    Preferências

    Estimativa de recursos Exportar como arquivo do Excel

    Estimativa de recursos

    Preferências

    Risco Exportar como arquivo do Excel

    Risco

    Preferências

    Tipo de risco Exportar como arquivo do Excel

    Tipo de risco

    Preferências

    Cartão de pontuação Exportar como arquivo do Excel

    Pergunta do cartão de pontuação

    Opção de cartão de pontuação

    Cartão de pontuação

    Preferências

    Tarefa Exportar como arquivo do Excel

    Tarefa

    Preferências

    Modelo Exportar como arquivo do Excel

    Fila

    Modelo

    Regra de Roteamento

    Tópico da fila

    Preferências

    Atribuição do modelo Exportar como arquivo do Excel

    Atribuição do modelo

    Preferências

    Tarefa de modelo Exportar como arquivo do Excel

    Tarefa de modelo

    Preferências

    Folha de horas Exportar como arquivo do Excel

    Perfil da folha de horas

    Folha de horas

    Preferências

    Visualizar Exportar como arquivo ZIP

    Visualizar

    Preferências

  4. Clique em Baixar.

  5. Continue com Preencher o modelo de planilha com seus dados para preencher o modelo de planilha em branco com suas informações.

Preencher o modelo de planilha com seus dados populate-the-spreadsheet-template-with-your-data

Visão geral das abas (folhas de dados) incluídas na planilha

TIP
Para entender melhor como você precisará formatar as informações em cada coluna ao preencher o modelo Kick-Start, considere fazer um teste exportando um Kick-Start com dados existentes do Workfront nos objetos que você está tentando importar. Para obter instruções, consulte Exportar dados do Adobe Workfront via Kick-Starts.

Ao abrir um modelo Kick-Starts em branco, várias abas (folhas de dados) são disponibilizadas. Elas dependem dos objetos que você selecionou para download. Cada uma representa um objeto no aplicativo, como projeto, tarefas, horas, painel e usuários:

Ao abrir uma dessas abas, a linha 2 exibe os campos de cada objeto que podem ser definidos durante uma importação. Em um cabeçalho de coluna, após a palavra “set”, o nome do campo é exibido conforme aparece no banco de dados. Esses campos funcionam como cabeçalhos de coluna.

IMPORTANT
Para evitar erros, certifique-se do seguinte:
  • Não exclua a primeira linha vazia de uma planilha de kick-start.
  • Não exclua, modifique nem reorganize esses campos (cabeçalhos de coluna) de nenhuma forma. Por exemplo, não altere a ordem nem os nomes deles.
  • Adicione valores a todos os campos que aparecem em negrito no cabeçalho da coluna. Esses representam campos obrigatórios.
No entanto, se um campo obrigatório contiver um valor padrão definido nas preferências do sistema, você não precisará preenchê-lo.
Por exemplo, na aba PROJ Project, os campos setCondition e setConditionType podem ser deixados em branco, mas não as colunas setGroupID e setName.
  • Determinados campos, incluindo setResourceRevenue e setEnteredByID, são gerados automaticamente pelo sistema. Se você inserir dados nesses campos na planilha, o processo de kick-start os substituirá quando você fizer o upload da planilha.

Importar um registro import-a-record

Cada linha da planilha corresponde a um objeto exclusivo.

  1. Adicionar informações na coluna isNew:

    • Se o objeto que você está importando for novo, digite TRUE para importar os dados na linha. Esse valor diferencia maiúsculas de minúsculas e sempre deve estar em letras maiúsculas

    • Se o objeto já estiver no Workfront, digite FALSE na coluna isNew para ignorar a linha. Esse valor diferencia maiúsculas de minúsculas e sempre deve estar em letras maiúsculas

      • Os registros que já existem no Workfront não são atualizados.
      • Se você baixou um modelo com dados do Workfront, os objetos existentes já estarão marcados com FALSE.
      • Se você baixou um modelo em branco, não precisará adicionar novas linhas para objetos existentes.
  2. Adicione informações na coluna ID de uma das seguintes maneiras:

    • Se o objeto que você está importando for novo (e você digitou TRUE na coluna isNew), digite qualquer número para a ID. Esse número deve ser exclusivo na planilha. Por exemplo, se você importar três objetos, poderá fornecer a eles a ID 1, 2 e 3, respectivamente.

    • Se o objeto já existir no Workfront (e FALSE estiver na coluna isNew) e você estiver importando novas informações sobre objetos existentes, a ID deverá ser o GUID alfanumérico que existe no Workfront para esse objeto.

    note tip
    TIP
    Para descobrir o GUID exclusivo de um objeto no Workfront, você pode criar um relatório para esse objeto e adicionar a coluna ID ao relatório. O valor de cada objeto nessa coluna é o GUID do objeto.
    • Os registros que já existem no Workfront não são atualizados.
    • Se você baixou um modelo com dados, os objetos existentes já conterão o GUID como a ID.
    • Você pode importar um novo objeto com base em um objeto existente alterando FALSE para TRUE na coluna isNew, alterando a ID e fazendo os ajustes necessários nos dados antes da importação.

    Amostra de ID para um grupo

    • Ao importar um projeto, você deve indicar uma ID de grupo.

      • Se o grupo já existir no Workfront, você deverá adicionar a ID exclusiva ao campo setGroupID do projeto.
      • Se o grupo não existir no Workfront, você poderá adicionar a planilha Grupo GROUP ao arquivo de importação, definir o campo isNew como TRUE na planilha Grupo e indicar uma ID numérica para o novo grupo na coluna ID. O campo setGroupID do novo projeto deve corresponder à ID numérica do novo grupo.

      Exemplo: para um projeto, o valor exibido na coluna setGroupID deve ser um dos seguintes:

      • O GUID de um grupo existente na instância do Workfront
      • O valor (número) na coluna ID da planilha Grupo GROUP se você estiver criando um novo grupo durante a importação
  3. Insira valores nos campos obrigatórios e quaisquer outros campos que você deseje preencher durante a importação.

  4. (Opcional) Para adicionar dados personalizados:

    • Crie uma nova coluna para cada campo personalizado que você deseje incluir no processo de importação.

    • Nomeie cada nova coluna do campo personalizado correspondente da seguinte maneira: DE:[nome do campo personalizado conforme exibido no Workfront]. Por exemplo, você pode criar o seguinte campo personalizado: “DE: departamentos”.

    • Na coluna setCategoryID, digite o GUID do formulário personalizado existente no qual o campo personalizado reside. Esse campo é exigido ao importar dados personalizados.

    • Se precisar adicionar múltiplos valores de dados no campo personalizado (como botões de opção, caixas de seleção ou listas), use o delimitador de dados personalizados de barra vertical “|” listado na guia Preferências para separar os valores.

      Exemplo: digite A|D na coluna DE:Departments para preencher o departamento A e o departamento D no formulário personalizado.

      note note
      NOTE
      Use o delimitador “|” somente para separar valores de campos personalizados. Você não pode usá-lo em nenhuma outra coluna da planilha, incluindo setCategoryID.

Incluir datas include-dates

O Workfront pode processar a maioria dos formatos de data. No entanto, você deve garantir que a coluna de data na planilha seja formatada como uma data. A importação falhará se a coluna estiver formatada como geral, um número ou texto.

TIP
O formato mais popular é DD/MM/AAAA.
Por exemplo, 10/07/2023.

O Workfront também aceita valores de hora como parte da data.

Por exemplo: 10/07/2022 01:30 ou 10/07/2022 1:00 PM.

Se você omitir uma hora na data, o Workfront executará um dos seguintes procedimentos:

  • Presumirá que a hora seja 12:00 AM. Para ver o resultado de data esperado, o fuso horário do sistema deve corresponder ao seu fuso horário.
  • Se estiver em um objeto associado a um cronograma, a hora será ajustada para o horário mais cedo permitido pelo cronograma.
NOTE
Ao usar um carimbo de data e hora UNIX, você deve incluir três zeros adicionais no final do valor.
Por exemplo, se o carimbo de data e hora for 7336899000, você deve inserir 7336899000000 na célula.

Usar curingas use-wildcards

Você pode usar os seguintes curingas ao preencher a planilha de modelo Kick-Start:

Curinga
Comportamento
$$TODAY

Quando usado em um campo setDate, esse curinga define a data como meia-noite do dia em que você importa o Kick-Start.

Você pode modificar o curinga usando a sintaxe padrão permitida com o curinga em um filtro.

Exemplo: se você quiser que um projeto comece na segunda-feira da semana em que for importado, independentemente do dia em que você for realizar a importação, poderá usar $$TODAYbw. Isso define a data de início planejada do seu projeto como 00h00 do domingo. Como a agenda do projeto provavelmente não permite trabalho nesse horário, ele começará às 9:00 da manhã de segunda-feira.

$$NOW

Quando usado em um campo setDate, esse curinga define a data de acordo com o momento em que você cria o registro durante a importação do Kick-Start.

Você pode modificar o curinga usando a sintaxe padrão permitida com o curinga em um filtro.

Exemplo: se quiser que um projeto seja iniciado 3 horas após ser importado, você poderá usar $$NOW+3h.

$$USER.ID
Quando usado em um setAssignedToID ou outro campo baseado em userID, esse curinga atribui o trabalho ou associa o registro à pessoa que está executando a importação.
$$CUSTOMER

Este curinga foi adicionado especificamente para importações de usuários de Kick-Start. Ao criar uma conta do Workfront, um usuário com nível de acesso de admin do sistema é criado. O nome de usuário atribuído ao(à) admin padrão pode ser usado como um prefixo ao criar outros usuários na conta.

Como os nomes de usuário devem ser únicos para todos os clientes, isso é útil quando você tem várias pessoas com nomes de usuário muito comuns, como John Smith, que pode ter o nome de usuário “jsmith”. Ao prefixar a atribuição do nome de usuário com o nome de usuário padrão do(a) admin, você garante que cada nome de usuário seja único (por exemplo: $$CUSTOMER.jsmith).

Dica: uma maneira mais elegante de garantir que os nomes de usuário sejam únicos em todo o sistema é inserir o endereço de email da pessoa no campo setUsername.

Substituição de nome de atributo para IDs attribute-name-substitution-for-ids

Embora seja uma prática recomendada usar IDs sempre que possível, às vezes é inconveniente cruzar referências de IDs de uma folha para outra ao definir um valor setAttributeID. Você pode referenciar valores pelo nome simplesmente alterando o cabeçalho da coluna.

Exemplos:

  • Importação de projeto

    Ao importar projetos, defina o setGroupID dos projetos acessando a folha Grupo GROUP, anotando os respectivos IDs de grupo e colando-os nas células corretas (coluna setGroupID) na planilha Projeto PROJ.

    Isso é viável quando se trabalha com apenas alguns grupos e projetos, mas se você estiver trabalhando com vários de cada, isso não é prático.

    Para realizar a substituição de nome de atributo do exemplo descrito acima, altere o cabeçalho da coluna setGroupID para #setGroupID nome do GROUP. Você pode então referenciar o grupo de cada projeto pelo nome.

    note note
    NOTE
    A opção de usar a substituição de nome de atributo é limitada apenas a referências para registros existentes. Você não pode usar a substituição de nomes para objetos que está criando na mesma importação.
  • Importação de usuários

    Ao importar usuários, preencha o setRoleID a partir de uma lista de funções na aba Função ROLE.

    Algumas das IDs de função são para registros que já existem na conta, e outras estão sendo criadas durante a importação.

    Para os novos registros de usuários atribuídos a funções existentes, você pode usar a substituição de nomes. No entanto, isso não é possível para os novos registros de usuários atribuídos a funções recém-importadas.

    Veja como você pode usar os dois métodos no mesmo arquivo de importação:

    • Adicione uma coluna na planilha à esquerda da coluna setRoleID.

    • Nomeie a nova coluna como #setRoleID nome de ROLE.

    • Para atribuir funções a registros existentes, insira os nomes das funções na coluna #setRoleID nome de ROLE.

      Para atribuir funções a novos registros de função, insira a ID que você atribuiu na folha Função ROLE no campo setRoleID.

      ID de função para usuários

Importar os dados da planilha para o Workfront

Depois de preencher o modelo do Excel com seus dados, você pode fazer upload deles para o Workfront.

A importação de Kick-Start é compatível com os seguintes tipos de arquivo:

  • Excel (.xls ou .xlsx)

  • Arquivo compactado (.ZIP) (que contém apenas arquivos .xlsx ou .xls)

    note note
    NOTE
    Você deve usar um arquivo .ZIP ao importar planilhas do Excel que fazem referência aos seguintes objetos:
    • Relatórios
    • Documentos
    • Avatares
    • Visualizar, filtrar ou agrupar arquivos de propriedade
    Ao usar um arquivo de importação compactado, o arquivo .ZIP deve ter o mesmo nome do arquivo .xlsx ou .xls e todos os arquivos devem estar no mesmo nível de estrutura (sem pastas).

Para importar os dados da planilha de modelo para o Workfront:

  1. Clique no ícone Menu Principal Menu Principal no canto superior direito do Adobe Workfront ou (se disponível) clique no ícone Menu Principal Menu Principal no canto superior esquerdo e clique no ícone Instalação Instalação .

  2. Clique em Sistema > Importar dados (Kick-Starts).

  3. Na seção Carregar dados com planilha do Kick-Start, clique em Escolher arquivo, procure e selecione a planilha preenchida.

    O arquivo é carregado automaticamente, e uma notificação de que a importação foi bem-sucedida é exibida.

    Se o arquivo do Excel levar mais de 5 minutos para ser carregado para o Workfront, o aplicativo expirará e o Workfront não poderá carregar o arquivo. Tente importar os dados em lotes menores de objetos.

  4. (Condicional) Se a importação não tiver sido bem-sucedida, você receberá uma mensagem de erro informando qual é o problema. Tente identificar o campo, a planilha e o número da linha em que o problema foi encontrado e corrija as informações no arquivo do Excel. Em seguida, tente importar o arquivo mais uma vez.

  5. (Condicional) Se estiver usando o Workfront Fusion, agora você poderá ativar os FLOs ou cenários quando a importação for concluída.

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