Cenário de inicializações: importar campos personalizados de várias opções 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 .

Expanda Sistema no menu esquerdo e clique em Exportar Dados (Kick-Starts).

Selecione Dados personalizados na seção O que incluir.

Escolha o arquivo .xlsx na seção Formato de download.

Clique em Baixar. Um arquivo .xlsx é baixado no computador. Navegue até ele e abra-o.

Examine o arquivo baixado e anote os seguintes detalhes:

• O arquivo contém várias folhas. Talvez você não precise saber as informações em todas as planilhas, mas usará algumas planilhas para importar suas informações. Reserve algum tempo para se familiarizar com o conteúdo e, especialmente, com o formato do conteúdo em cada planilha.
• Preste atenção especial aos nomes das colunas e ao formato no qual os dados em cada coluna são exibidos.
• Você não deve alterar os nomes nem a ordem das colunas em nenhuma das planilhas. Os cabeçalhos de coluna indicam campos que você precisa preencher com suas informações em cada linha. Se o cabeçalho da coluna for exibido em negrito, ele será um campo obrigatório, portanto, você deverá ter informações sobre ele.

• Mantenha o arquivo baixado para referência futura e continue para a seção a seguir.

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 .

Expanda Sistema no menu esquerdo.

Clique em Importar Dados (Kick-Starts).

Na área Baixar uma planilha em branco do Kickstart, marque a caixa de seleção Dados Personalizados e clique em Baixar.

Um arquivo em branco de início é baixado para o computador.

Abra a planilha do Excel baixada na seção anterior e revise as planilhas. Cada planilha representa um objeto no aplicativo.

Por exemplo, Parâmetro (que se refere ao Campo Personalizado), Opção de Parâmetro (que se refere à opção de Campo Personalizado), Categoria (que se refere ao Formulário Personalizado).

Você deve gravar os nomes dos objetos e seus atributos no formato suportado pelo banco de dados do Workfront.

Para obter informações sobre o significado desses objetos, consulte o Glossário da Adobe Workfront terminologia.

Para obter informações sobre os nomes dos objetos no banco de dados do Workfront, consulte o API Explorer.

Verifique se as informações a seguir estão formatadas corretamente:

• A primeira linha de cada planilha deve permanecer vazia, caso contrário, a importação gera um erro.

• Os cabeçalhos de coluna em cada planilha representam atributos dos objetos que podem ser definidos durante uma importação. Todos os cabeçalhos de coluna devem permanecer na mesma ordem em que são localizados ao exportar a planilha e não podem ser renomeados.

• Os cabeçalhos de coluna em negrito são campos obrigatórios e devem ter um valor.

  note tip
  TIP
  Algumas colunas são necessárias, embora não estejam em negrito. Por exemplo, as colunas isNew e ID não estão em negrito, mas são campos obrigatórios.

Selecione a planilha **PARAM Parameter** e adicione informações sobre os novos campos personalizados nas seguintes colunas necessárias:

• isNew = digite TRUE nesta coluna para cada linha que representa um novo campo personalizado. Isso indica que o campo é novo e não existe no Workfront.

  note tip
  TIP
  Se uma linha representa um campo existente já no Workfront, você digitaria isNew = FALSE.

• ID = deve ser um número exclusivo para cada linha que representa um novo campo. Você pode usar qualquer número que comece com 1, desde que cada novo campo tenha um número exclusivo.

• setDataType = para cada linha que representa um novo campo, insira o tipo de dados aceito pelo campo. O tipo de dados deve ser inserido da maneira como aparece no banco de dados. Selecione um dos seguintes tipos de dados:

  • NMBR para número
  • CURC para Moeda
  • TEXT para texto

• **setDisplaySize**= o tamanho de exibição ('setDisplaySize') para qualquer campo personalizado de várias opções é sempre 0.

• setDisplayType = para cada linha que representa um novo campo, insira o tipo de exibição do campo. O Tipo de Exibição deve ser inserido da maneira como apareceria no banco de dados.

  Para campos personalizados de várias opções, selecione uma das seguintes opções:

  • MULT para lista suspensa de várias seleções
  • SLCT para lista suspensa
  • RDIO para botões de opção
  • CHCK para Caixas de Seleção

  note tip
  TIP
  Para encontrar informações sobre Tipo de Dados e Tipo de Exibição, consulte o API Explorer, expanda o objeto Parâmetro e procure esses atributos na guia campos.

• setName = digite o nome dos campos personalizados conforme você quer que sejam exibidos no Workfront.

  note info
  INFO
  Por exemplo, podemos importar dois campos personalizados, chamados Marca, um campo de caixa de seleção, e Mídia, um campo de botão de opção.

• As colunas setName e setValue geralmente contêm as mesmas informações e devem refletir os nomes desejados na interface do Workfront para o seu novo campo.

O valor de um campo é o nome que aparece nos relatórios, por exemplo, enquanto o nome é exibido nos formulários personalizados anexados aos objetos.

Para obter mais informações, consulte Criar um formulário personalizado.

Selecione a planilha POPT Parameter Options e adicione informações sobre as opções de cada campo personalizado nas seguintes colunas necessárias:

• isNew = digite TRUE nesta coluna para cada linha que representa uma nova opção de campo.

  note tip
  TIP
  Se uma linha representa uma opção existente, você digitaria isNew = FALSE.

• ID = deve ser um número exclusivo para cada linha que representa uma nova opção. Você pode usar qualquer número que comece com 1, desde que cada nova opção tenha um número exclusivo.

• setIsDefault = digite TRUE para as opções que deseja exibir por padrão e FALSE para todas as outras opções, para cada campo. Por exemplo, queremos que Nike seja a opção padrão para Brand e Print seja a opção padrão para Media.

  note tip
  TIP
  Você só pode ter uma opção padrão para cada campo.

• setParameterID = as opções correspondentes ao campo personalizado Marca têm um setParameterID de 1, e as opções correspondentes à Mídia têm um setParameterID​de 2. As planilhas PARAM e POPT fazem referência cruzada entre si para indicar quais opções pertencem a qual campo personalizado.

• setDisplayOrder= a coluna de ordem de exibição indica a ordem na qual as opções serão exibidas no campo personalizado. Você pode começar com 1 e continuar em ordem crescente para todas as opções, independentemente de a quais campos eles pertencerão. O importante aqui é ter números exclusivos para cada opção.

• As colunas setLabel e **setValue** geralmente contêm as mesmas informações e devem refletir os nomes desejados na interface do usuário do Workfront. O valor de uma opção é o nome exibido nos relatórios, por exemplo, enquanto o rótulo é exibido nos formulários personalizados quando anexados a um objeto. Para obter mais informações, consulte Criar um formulário personalizado.

• setIsHidden = digite TRUE se quiser que qualquer uma das opções fique oculta.

(Opcional) Se você também quiser criar um formulário personalizado em que poderá adicionar os novos campos posteriormente, selecione a planilha CTGY Category e atualize as seguintes colunas necessárias para as informações de formulário personalizado:

• isNew = digite TRUE nesta coluna para cada linha que representa um novo formulário personalizado.
• ID = digite um número exclusivo para cada linha que representa um novo formulário. Você pode usar qualquer número que comece com 1, desde que cada nova opção ou linha tenha um número exclusivo.
• setGroupID = adicione a ID de Grupo para seu Grupo Doméstico ou qualquer outro grupo no sistema cujos membros você deseja ter acesso a este formulário. Este campo é obrigatório.

Para descobrir o ID de um Grupo, você pode criar um relatório de Grupo e adicionar o campo ID no Modo de Exibição ou navegar para um grupo e localizar a URL do grupo. A ID do grupo estará no URL da página do grupo. Por exemplo, se a URL do grupo for https://companyName.my.workfront.com/group/575b000800467a6f66e747932c807464/members, a ID do Grupo será 575b000800467a6f66e747932c807464.

• setCatObjCode= este é o código de objeto para o tipo de objeto para o qual você deseja criar o formulário. Insira um código entre as seguintes opções:

  • CMPY para a Empresa
  • TASK para Tarefa
  • PROJ para Projeto
  • PORT para Portfolio
  • PRGM para o programa
  • USER para Usuário
  • DOCU para documento
  • OPTASK para problema
  • EXPNS para Despesa
  • ITRN para Iteração
  • BILL para registros de cobrança
  • GROUP para Grupo

  note note
  NOTE
  Para formulários de vários objetos, insira o primeiro objeto que você selecionaria ao criar um formulário na interface do usuário. Por exemplo, defina o setCatObjCode como TASK, se você selecionar Tarefa na interface do Workfront e depois Problema, Portfolio, etc., mas não quiser que o formulário fique disponível para Projetos.

• setName = este é o nome do formulário personalizado como você deseja que ele apareça na interface do Workfront.

  

Salve a planilha como um arquivo .xls ou .xlsx no computador. Sua planilha do Excel está preenchida e agora está pronta para importação 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).

Clique em Escolher arquivo na seção Carregar dados com a planilha do Kickstart.

Procure a planilha do Excel que você preparou no computador e selecione-a quando a encontrar.

O arquivo é carregado automaticamente, e uma notificação de que a importação foi bem-sucedida é exibida. Dependendo da quantidade de informações que você está importando, essa etapa pode levar de alguns segundos a um minuto.

Os novos campos e formulários personalizados agora estão em seu sistema do Workfront. Você pode encontrá-los na área Forms personalizado da Configuração.

Para obter informações sobre como adicionar campos a formulários personalizados, consulte Criar um formulário personalizado.

(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) Dependendo do problema, conforme indicado na mensagem de erro, algumas informações podem já ter sido importadas. Você deve executar um dos seguintes procedimentos antes de importar a planilha novamente:

• Exclua as informações que foram importadas com êxito do Workfront da área Forms personalizado e faça a correção indicada pela mensagem de erro.
• Indique que um campo ou um formulário já está no sistema para os campos ou formulários que já foram importados e faça a correção.
  Para indicar que um campo ou um formulário personalizado já está no Workfront, você deve garantir que o campo inNew esteja marcado como FALSE em planilhas que contêm informações sobre o formulário (CTGY) ou o campo (PARAM) na planilha de importação do kick-start.