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
| 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:
-
Clique no ícone Menu Principal
no canto superior direito do Adobe Workfront ou (se disponível) clique no ícone Menu Principal
no canto superior esquerdo e clique no ícone Instalação
.
-
Clique em Sistema > Importar dados (Kick-Starts).
-
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
-
Clique em Baixar.
-
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
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.
- 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.
- 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.
-
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.
-
-
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.
-
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
-
-
Insira valores nos campos obrigatórios e quaisquer outros campos que você deseje preencher durante a importação.
-
(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.
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.
Usar curingas use-wildcards
Você pode usar os seguintes curingas ao preencher a planilha de modelo Kick-Start:
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.
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.
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.
-
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:
-
Clique no ícone Menu Principal
no canto superior direito do Adobe Workfront ou (se disponível) clique no ícone Menu Principal
no canto superior esquerdo e clique no ícone Instalação
.
-
Clique em Sistema > Importar dados (Kick-Starts).
-
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.
-
(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.
-
(Condicional) Se estiver usando o Workfront Fusion, agora você poderá ativar os FLOs ou cenários quando a importação for concluída.