Salvar cópia como XML

Salva uma cópia de um arquivo aberto como uma representação em XML do esquema, dos layouts e dos scripts.

Opções

• Nome da janela especifica o nome da janela de um arquivo aberto. Se não for especificado, a janela atual será usada.

• Arquivo de destino é o caminho do arquivo XML a ser criado. Consulte Criação de caminhos de arquivo.

• Incluir detalhes para ferramentas de análise adiciona informações ao arquivo XML.

  Essa opção adiciona o elemento DDR_INFO, que fornece informações adicionais úteis para ferramentas de terceiros que você pode usar para analisar seu aplicativo personalizado. Dependendo do seu aplicativo, essa opção pode produzir um arquivo XML significativamente maior.

• Salvar os dados binários de cada objeto de layout em seu nó armazena os dados binários de cada objeto de layout (por exemplo, uma imagem) sob o nó do objeto de layout no arquivo XML. Isso pode tornar o XML mais fácil para algumas ferramentas usarem, mas pode aumentar o tamanho do arquivo XML.

  Quando esta opção é desmarcada, apenas uma referência é armazenada sob o nó de cada objeto de layout, que aponta para o catálogo de dados da biblioteca onde os dados binários são armazenados. Isso pode ajudar a reduzir o tamanho do arquivo quando os mesmos dados binários são usados para muitos objetos de layout.

• Especificar opções como JSON é uma expressão de texto para um objeto JSON que permite especificar as seguintes opções para esta etapa de script:

  • catalogs_included (matriz JSON): uma matriz de strings de nome de catálogo que especificam quais catálogos devem ser incluídos no arquivo XML. Se omitidos, todos os catálogos são incluídos por padrão.

  • include_details (booleano): esta opção tem o mesmo propósito que Incluir detalhes para ferramentas de análise e substitui seu valor, se especificado.

  • split_catalogs (booleano): quando verdadeiro, cria um arquivo XML separado para cada catálogo especificado na chave catalogs_included. Quando falso ou omitido, cria um único arquivo XML. Veja Notas para obter detalhes sobre o comportamento do catálogo dividido.

  • standalone_binarydata (booleano): esta opção tem o mesmo propósito que Salvar os dados binários de cada objeto de layout em seu nó e substitui seu valor, se especificado.

  Quando você seleciona essa opção pela primeira vez, o FileMaker Pro gera automaticamente um cálculo de modelo que retorna todas as chaves acima com valores padrão, incluindo todos os nomes de catálogo suportados para catalogs_included, que você pode personalizar.

Originada na versão

18.0

Descrição

Esta etapa de script é semelhante a escolher Ferramentas > Salvar cópia como XML. Consulte Documentação de esquemas de bancos de dados.

Você pode usar Especificar opções como JSON para automatizar cenários complexos em que você precisa especificar dinamicamente quais catálogos incluir ou se deve dividir a saída em vários arquivos.

Notas

• Para realizar essa etapa de script, o usuário ou o script deve ter privilégios de acesso completo. Consulte Criação e edição de scripts.

• Esse formato XML pode mudar de uma versão do FileMaker Pro para a posterior. Ao usar o XML para comparar duas versões de um arquivo do FileMaker Pro, verifique se a mesma versão do FileMaker Pro é usada para salvar uma cópia de cada arquivo como XML. Se você usar o XML com outras ferramentas, verifique se essas ferramentas foram feitas para usar o XML salvo pela sua versão do FileMaker Pro.

• Para Especificar as opções como JSON, quando split_catalogs é verdadeiro:

  • A opção Arquivo de destino é tratada como um nome de pasta, e arquivos XML separados são criados para cada catálogo especificado em catalogs_included. Se a pasta não existir, esta etapa de script a cria.

  • A chave standalone_binarydata é automaticamente definida como verdadeiro ao dividir catálogos.

  • O valor LibraryCatalog é ignorado, mesmo se especificado em catalogs_included.

• Se Especificar opções como JSON contiver um erro de formatação, a etapa de script retornará o código de erro 878 ("Os dados JSON para Opções contêm um erro de formatação e não puderam ser analisados").

Exemplo 1

Salva uma cópia do arquivo aberto cujo nome da janela é Inventário em um arquivo XML.

Salvar cópia como XML [ Nome da janela: "Inventário" ; Arquivo de destino: "Inventário.xml" ]

Exemplo 2

Salva apenas scripts, layouts e funções personalizadas do arquivo especificado pela janela atual em um arquivo XML usando Especificar opções como JSON.

Definir variável [ $jsonOptions ; Valor:
 JSONSetElement ( "{}" ;
    [ "catalogs_included" ; JSONMakeArray ( 
"ScriptCatalog LayoutCatalog CustomFunctionsCatalog" ;
      " " ; JSONString ) ; JSONArray ] ;
    [ "include_details" ; Falso ; JSONBoolean ] ;
 [ "split_catalogs" ; Falso ; JSONBoolean ] ;
    [ "standalone_binarydata" ; Falso ; JSONBoolean ]
  )
]

Salvar cópia como XML [ Nome da janela: ; Arquivo de destino: "MyApp_SaveAsXML" ; Incluir detalhes para ferramentas de análise ; Especificar as opções como JSON: $jsonOptions ]

Observe que, embora a opção Incluir detalhes para ferramentas de análise esteja selecionada na etapa de script, ela é substituída pela chave include_details em Especificar opções como JSON, sendo definida como Falso.

Exemplo 3

Salva scripts, layouts e campos em arquivos XML separados dentro de uma pasta chamada "MyApp_SaveAsXML".

Definir variável [ $jsonOptions ; Valor:
 JSONSetElement ( "{}" ;
    [ "catalogs_included" ; JSONMakeArray ( 
"ScriptCatalog LayoutCatalog FieldCatalog";
 " " ; JSONString ) ; JSONArray ] ; [ "include_details" ;
 Verdadeiro ; JSONBoolean ] ;
 [ "split_catalogs" ; Verdadeiro ; JSONBoolean ]
  )
]

Salvar cópia como XML [ Nome da janela: ; Arquivo de destino: "MyApp_SaveAsXML" ; Especificar as opções como JSON: $jsonOptions ]

Isso cria uma pasta chamada "MyApp_SaveAsXML" contendo três arquivos:

• MyApp_SaveAsXML_ScriptCatalog.xml
• MyApp_SaveAsXML_LayoutCatalog.xml
• MyApp_SaveAsXML_FieldCatalog.xml

Tópicos relacionados 

• Referência de etapas de script