Comando SAVE LAYOUT

Salva um layout da tabela do Analytics em um layout da tabela externo (.layout) ou salva metadados do layout da tabela em uma tabela do Analytics.

Nota

Antes da versão 11 do Analytics, os arquivos externos de layout de tabela usavam a extensão de arquivo .fmt. Os arquivos de layout de tabela com extensão .fmt ainda podem ser salvos, especificando a extensão manualmente.

Sintaxe

SAVE LAYOUT {FILE|TABLE} TO {nome_arquivo|nome_tabela}

Parâmetros

Nome Descrição

FILE | TABLE
  • FILE salve um layout da tabela do Analytics em um arquivo de layout da tabela externo (.layout)
  • TABLE salve metadados do layout da tabela em uma tabela do Analytics (.fil)

TO nome_arquivo | nome_tabela

O nome do arquivo de saída e o local da saída:

  • nome_arquivo o nome do arquivo .layout

    Especifique nome_arquivo como uma cadeia entre aspas. Por exemplo: TO "Trans_Cp.layout".

    A extensão de arquivo .layout é utilizada por padrão, portanto, sua especificação é opcional.

    Por padrão, o arquivo é salvo na pasta que contém o projeto do Analytics.

    Use um caminho de arquivo absoluto ou relativo para salvar o arquivo em uma pasta diferente já existente:

    • TO "C:\Trans_Cp.layout"
    • TO "Layouts da tabela\Trans_Cp.layout"

    Nota

    Limite o nome do layout da tabela a 64 caracteres alfanuméricos, sem incluir a extensão .layout, para garantir que o nome não seja truncado durante a importação da tabela para o Analytics.

    O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

  • nome_tabelao nome da tabela do Analytics e do arquivo .fil

    Especifique nome_arquivo como uma cadeia entre aspas. Por exemplo: TO "Metados_layout_Trans_Cp.fil".

    A extensão de arquivo .fil é utilizada por padrão, portanto, sua especificação é opcional.

    Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics.

    Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente:

    • TO "C:\Metados_layout_Trans_Cp.fil"
    • TO "Metadados Layout\C:\Metados_layout_Trans_Cp.fil"

    Nota

    Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

Exemplos

Salvar um layout de tabela em um arquivo externo de layout de tabela (.layout)

Os exemplos a seguir salvam o layout da tabela usado pela tabela aberta em um arquivo de layout de tabela externo chamado Trans_Cp.layout:

Aqui, o arquivo de layout da tabela é salvo na pasta do projeto do Analytics:

SAVE LAYOUT FILE TO Trans_Cp.layout

Aqui, o arquivo de layout da tabela é salvo em uma pasta especificada:

SAVE LAYOUT FILE TO "C:\ACL_DATA\Auditoria CP 2013\Trans_Cp.layout"

Salvar uma cópia dos metadados de layout da tabela em uma nova tabela do Analytics

Os exemplos a seguir salvam uma cópia dos metadados do layout da tabela em uso pela tabela aberta em uma nova tabela do Analytics chamada Metadados_layout_Trans_Cp.

Aqui, a nova tabela do Analytics é salva na pasta do projeto do Analytics:

SAVE LAYOUT TABLE TO Metadados_layout_Trans_Cp

Aqui, a nova tabela do Analytics é salva na pasta especificada:

SAVE LAYOUT TABLE TO "C:\ACL_DATA\Auditoria CP 2013\Metadados_layout_Trans_Cp"

Observações

SAVE LAYOUT arquivo vs. tabela

O comando SAVE LAYOUT pode ser usado para dois propósitos distintos:

  • FILE salva o layout da tabela do Analytics aberta em um arquivo de layout da tabela externo com uma extensão .layout
  • TABLE extrai os metadados do layout da tabela do Analytics aberta e os salva em uma nova tabela do Analytics

SAVE LAYOUT FILE

Como funciona?

SAVE LAYOUT FILE salva o layout da tabela da tabela do Analytics aberta em um arquivo de layout de tabela externo com extensão .layout.

O layout da tabela contém metadados que fornecem uma interpretação estruturada dos dados puros em um arquivo de dados associado. O layout da tabela em si não contém nenhum dado.

Quando usar SAVE LAYOUT FILE

Salvar um layout de tabela como arquivo .layout torna o layout da tabela e seus metadados portáveis e reutilizáveis.

O arquivo .layout pode ser importado em qualquer projeto do Analytics e associado a um arquivo de dados de origem correspondente. Os elementos de dados no arquivo de dados de origem devem corresponder às definições de campos especificadas nos metadados do layout da tabela.

Por exemplo, seria possível salvar o layout da tabela de um arquivo de transações de Março e associá-lo a um arquivo de dados contendo transações de Abril, assumindo que a estrutura dos dados nos arquivos de dados de Março e Abril seja idêntica. Utilizados dessa forma, os arquivos .layout podem economizar o trabalho de criar novos layouts de tabela a partir do zero.

Para obter mais informações sobre a estrutura das tabelas do Analytics, consulte o Estruturação de dados com layouts das tabelas.

SAVE LAYOUT TABLE

Como funciona?

O SAVE LAYOUT TABLE extrai os metadados do layout da tabela do Analytics aberta e os salva em uma nova tabela do Analytics.

A nova tabela não é o layout da tabela original, mas uma tabela do Analytics comum que contém um resumo dos metadados de layout da tabela original. O acesso a este resumo dentro de um script do Analytics permite a tomada de decisões no script baseadas nessa informação.

Para cada campo da tabela original, os seguintes trechos de metadados de layout da tabela são extraídos para a nova tabela.

Nota

Esses nomes de campos na nova tabela sempre são gerados em inglês, qualquer que seja a versão localizada do Analytics usada.

Nome do campo na nova tabela Metadados de layout da tabela
nome_campo O nome do campo
tipo_de_dados O tipo de dados do campo
categoria A categoria de dados do campo
posição_inicial A posição inicial do campo
tamanho_campo O comprimento do campo
decimais O número de casas decimais no campo (somente para campos numéricos)
formato O formato do campo (somente para campos datahora e numéricos)
título_alternativo O título alternativo da coluna do campo
largura_coluna A largura da coluna na exibição

Detalhes adicionais

Campos calculados Campos calculados são incluídos nos metadados extraídos, mas a expressão utilizada pelo campo calculado e possíveis condições não são gravados. A posição inicial, o tamanho do campo e as casas decimais também não são registrados para campos calculados.
Campos relacionados Os campos relacionados não são incluídos porque não fazem parte do layout da tabela.

Filtros de campo

Notas do campo

 Os filtros e as notas de campo não são incluídos.

Título de coluna alternativo

Largura da coluna

 Os valores registrados para título alternativo da coluna e largura de coluna são os especificados no layout da tabela e não os valores de exibição que também podem ser especificados para as colunas.