Formato do Arquivo de Carregamento da Solicitação

Este tópico descreve o formato das planilhas do Microsoft Excel usadas para carregar itens solicitados.

Considerações

• Cada planilha em um arquivo de planilhas corresponde a um ponto de vista.

• Você pode carregar várias planilhas em vários pontos de vista.

• As planilhas (e seus pontos de vista correspondentes) devem usar rótulos com 30 ou menos caracteres.

  Nota:

  Se o nome de um ponto de vista tiver mais de 30 caracteres, você precisará criar um rótulo que será usado pela planilha ao carregar os itens de solicitação em um ponto de vista. Consulte Como Inspecionar um Ponto de Vista para obter informações sobre como usar um rótulo.

• Planilhas podem conter fórmulas para derivar valores de propriedade para as colunas padrão. Fórmulas de planilha também podem ser usadas para propriedades específicas de aplicativo (FCGL, PLN) e propriedades personalizadas. Células de propriedade com valores de fórmulas iguais a branco são ignoradas. Células de propriedade com valores de fórmula iguais a <clear> ou <blank>.

• As planilhas são processadas na ordem da esquerda para a direita.

• As linhas duplicadas no arquivo de importação não são processadas durante o carregamento.

• As datas e os timestamps para as configurações regionais suportadas devem estar em um destes padrões de formato de data Java:

  • Curto

  • Padrão

  • Longo

  • Médio

  Nota:

  Para obter mais informações sobre formatos de data e hora do Java, consulte Utilização de Formatos Predefinidos.

• Se você tiver mais de 10.000 nós, crie vários arquivos de carregamento, cada um contendo menos de 10.000 nós.

• Para nós que foram adicionados ou inseridos em um ponto de vista de hierarquia em que o pai não é conhecido, use a palavra-chave <Unknown> na coluna Pai para que o valor do pai seja calculado e armazenado para cada item de solicitação. É necessário que um administrador tenha definido uma expressão para calcular o valor do pai. Consulte Cálculo e Armazenamento do Pai de um Nó.

• Para calcular os nomes dos nós que estão sendo adicionados ou inseridos, deixe a coluna de nome em branco ou use as palavras-chave <cn> ou <cn ####>. O nó deve ser configurado para calcular o valor do nome. Consulte Cálculo e Armazenamento do Nome de um Nó.

Considerações para Colunas

• A planilha deve ter cabeçalhos de coluna que correspondam aos nomes de colunas reservadas ou aos nomes de propriedades. Consulte Nomes de Colunas Reservadas.

  Nota:

  Não será possível carregar uma planilha se a coluna Nome não estiver presente.

• Os cabeçalhos de colunas das propriedades deverão ser formados pelo nome da propriedade ou pelo rótulo exibido personalizado da propriedade se um rótulo tiver sido configurado (essa opção é definida na guia Propriedades do inspetor do Ponto de Vista). O nome da propriedade não pode conter o namespace. Por exemplo, Core.Description não é válido.
• As colunas podem estar em qualquer ordem.
• Se o cabeçalho de uma coluna não corresponder a nenhum dos nomes de propriedades ou de colunas reservadas, a coluna será ignorada. Isso quer dizer que pode haver comentários na planilha que não serão carregados.
• Se o arquivo de carregamento tiver uma coluna para a propriedade Nome Alternativo:
  • Se o tipo do nó que estiver sendo carregado contiver a propriedade Nome Alternativo, as operações a seguir serão executadas durante o carregamento do arquivo:
    • Se uma linha contiver o nome de um nó, o nome alternativo será carregado na coluna Nome Alternativo.
    • Se uma linha não contiver o nome de um nó, o Nome Alternativo será usado para encontrar um nó correspondente no ponto de vista com o mesmo valor da propriedade Nome Alternativo.

  • Se o tipo de nó para onde o carregamento estiver sendo feito não contiver a propriedade Nome Alternativo, a coluna será ignorada.

Processamento de Ordem das Linhas

Durante o carregamento de registros de um arquivo de solicitações, o processo de carregamento classifica o conteúdo do arquivo para que nós pais sejam adicionados a um ponto de vista antes dos nós filhos. Isso evita erros de validação caso a linha de um nó filho preceda a linha do nó pai no arquivo de carregamento.

Por exemplo, esse arquivo de carregamento contém uma linha pai, Analytics, que é precedida de duas linhas filhas, Emily e Jack, e ambas têm Analytics como pai:

Quando esse arquivo é carregado, o processo classifica o conteúdo para que Analytics seja adicionado primeiro e depois Emily, Jack e Mary.

Processamento de <Blank> e <Clear> x Campos em Branco

Inserir as palavras-chave <blank> ou <clear> e deixar as células vazias no arquivo de carregamento da solicitação são ações tratadas de maneira diferente ao processar um arquivo de solicitação:

• A palavra-chave <clear> apaga os valores existentes de uma propriedade.
• A palavra-chave <blank> estabelece um valor definido de branco para a propriedade.
• As células vazias no arquivo são ignoradas.

As palavras-chave <blank> e <clear> e células vazias são permitidos para todos os tipos de dados. No entanto, para os tipos de dados lista, não são permitidas entradas em branco dentro de uma lista. Ou seja, a lista propriamente dita pode estar vazia, mas uma entrada dentro dela não pode estar vazia.

Alguns exemplos:

• Valor da lista: '<blank>' não é suportado. Note que a importação de um campo em branco para uma lista substituirá qualquer valor definido, herdado ou padrão existente na lista.
• Valor da lista: 'A,B,C' é suportado.
• Valor da lista: 'A,,C' não é suportado.

Execução de Operações Copiar e Modelar Igual em um Arquivo de Carregamento da Solicitação

Use as colunas Copy Node e Copy Action para criar um nó por meio da cópia de um nó existente ou da modelagem (em um ponto de vista de hierarquia) com base em um nó existente usando um arquivo de carregamento de solicitação. (Consulte Adição de um Nó por Modelagem Igual a um Nó Existente para obter mais informações sobre a operação modelar igual.)

Considerações

• As colunas Copy Node e Copy Action são usadas apenas nas operações Adicionar ou Atualizar. Se a coluna Action Code tiver qualquer outra operação, as colunas Copy Node e Copy Action serão ignoradas.
• Se a coluna Copy Node tiver um nó para o qual já existe um item de solicitação no arquivo de carregamento, as colunas Copy Node e Copy Action desse nó serão ignoradas.
• Se a propriedade Core.Name do tipo de um nó que está sendo adicionado por meio da operação copiar ou modelar igual estiver configurada para ser calculada e armazenada (consulte Propriedades Calculadas e Armazenadas), o nome do novo nó será calculado automaticamente.
• Use a palavra-chave <Ignore> na coluna pai para indicar que o pai deve ser ignorado durante uma operação modelar igual. O novo nó é inserido somente abaixo dos pais do nó que está sendo copiado.

Para executar uma operação copiar ou modelar igual em um arquivo de carregamento da solicitação:

• Use a coluna Copy Node para especificar o nó a ser copiado ou usado como base na modelagem.
• Use a coluna Copy Action para especificar o tipo de operação de cópia. Especifique um dos seguintes valores:
  • Properties: Executa uma operação de cópia para o nó especificado na coluna Copy Node. Essa operação copia do nó especificado os valores definidos das propriedades no nível de nó e relacionamento, depois os inclui como ações Atualizar no item de solicitação. (Esse será o valor padrão se você não especificar o tipo da operação de cópia.)
  • Model After (somente pontos de vista de hierarquia): Executa uma operação modelar igual para o nó especificado na coluna Copy Node. A operação modelar igual faz o seguinte:
    • Copia os relacionamentos pai do nó especificado e os inclui como ações Inserir no item de solicitação
    • Copia os valores definidos das propriedades no nível do relacionamento de cada pai, depois os inclui como ações Atualizar no item de solicitação.

    Nota:

    A execução da operação Modelar Igual usando pontos de vista relacionados não é suportada durante uploads de arquivo da solicitação. Por isso, não é possível executar operações modelar igual ao fazer upload de arquivos da solicitação em pontos de vista de lista.

Como Trabalhar com Origens de Dados em Arquivos de Carregamento da Solicitação

Melhor Prática

Embora seja possível adicionar itens de solicitação de várias origens de dados em um único arquivo de carregamento, é recomendável criar um arquivo de carregamento separado para cada origem de dados. Um item de solicitação só pode ter uma origem de dados no arquivo de carregamento. Se você carregar um arquivo de solicitação com um nó que tenha mesmo nome de várias origens de dados, somente a primeira origem de dados no arquivo será mantida. A criação de arquivos de carregamentos separados para cada origem de dados permite que você execute a correspondência do nó para todas as origens de dados.

Coluna Origem de Dados

Os itens de solicitação no arquivo de carregamento são atualizados com a origem de dados especificada na coluna Origem de Dados (consulte Noções Básicas sobre Origens de Dados). Isso permite que eles sejam vinculados ou associados e mesclados aos nós existentes no ponto de vista (consulte Sobre Links de Nó e Correspondência e Mesclagem de Itens de Solicitação).

Considerações

• Você pode usar o Código ou o Nome da origem de dados para identificá-la no arquivo de carregamento. É recomendável usar o código da origem de dados, visto que o nome pode mudar ao longo do tempo.
• Só será possível carregar origens de dados registradas quando o arquivo de carregamento tiver sido originalmente gerado dessa origem (por exemplo, recarregamento de um arquivo de solicitação de assinatura gerada). As linhas no arquivo de carregamento devem conter o ID do Nó de Origem e o Tipo do Nó de Origem gerados das origens de dados registradas para serem carregadas.
• Se o item de solicitação já fizer referência a uma origem de dados diferente daquela presente na linha, a linha será ignorada.

Nomes de Colunas Reservadas

Considerações

• Se uma propriedade tiver o mesmo nome que o de uma coluna reservada, você poderá usar um nome de coluna alternativa. Por exemplo, se você tiver uma propriedade chamada Data Source, poderá usar um nome alternativo, como Data_Source, DataSource ou {Data Source}.

• Se a planilha estiver sendo carregada para um ponto de vista de uma lista, as colunas e ações das hierarquias serão ignoradas. Por exemplo, as ações Mover e Inserir seriam ignoradas em um ponto de vista de lista.

Tabela 10-3 Códigos de Ação

Código de Ação	Descrição
Adicionar	Cria uma nova regra.
Excluir	Exclui um nó.
<Célula vazia>	Se a célula Código de Ação estiver vazia, a linha será processada usando o código de ação Atualizar.
Inserir	Insere um nó existente em uma hierarquia no nó especificado pelas células Pai e Tipo de Nó Pai.
Mover	Move um nó existente para uma nova posição em uma hierarquia, removendo o nó da respectiva posição existente.
Prop_Update	Atualiza o valor da propriedade somente para um nó existente. Para realizar outras ações, use o código de ação Update. É possível limpar o valor de uma propriedade definida. Limpar o valor da propriedade exclui o valor armazenado e o valor é retornado para o padrão ou herdado. Por exemplo, a ação Prop_Update abaixo limpa o valor de Descrição.
Renomear	Renomeia um nó existente.
Reordenar	Reordena um nó em um ponto de vista de hierarquia. Você só pode reordenar nós em um ponto de vista que use um conjunto de hierarquias que permita a reordenação desse tipo de nó (nó pai ou inferior). Para obter mais informações, consulte Como Reordenar um Nó.
Remover	Remove o nó do nó pai especificado.
Atualizar	Atualiza os valores de propriedades de um nó existente. A ação Atualizar também executará ações adicionais se as células em uma linha indicarem que essas ações são necessárias. A lista a seguir descreve como isso funciona: Se o nó não existir, ele será adicionado. Se o ponto de vista for hierárquico, o nó será inserido na posição da hierarquia especificada pelas células Pai e Tipo de Nó Pai. Se o ponto de vista for hierárquico e o nó existir, mas não estiver abaixo do pai especificado, a ação resultante dependerá de o conjunto de hierarquias permitir nós compartilhados: Se nós compartilhados forem permitidos, o nó será inserido abaixo do pai especificado. Se nós compartilhados não forem permitidos, o nó será inserido abaixo do pai especificado. Você pode atualizar uma propriedade para um valor em branco se a propriedade permitir tal valor. Você deve usar o indicador <blank> na célula; uma célula vazia não produz os mesmos resultados. Por exemplo, a ação de atualização abaixo define a propriedade Entidade Legal para um valor em branco. Embora a célula de descrição esteja vazia, a descrição existente para EMA não muda.