Esquema de arquivo de exemplo no Jitterbit Integration Studio

Introdução

Se você já tiver um arquivo disponível que contenha a estrutura de dados que deseja usar, poderá usar esse arquivo de exemplo para definir um esquema em uma transformação. Após o upload de um arquivo de exemplo, ele se torna um esquema personalizado que você pode editar no editor de esquema para um esquema plano personalizado ou esquema hierárquico personalizado.

Esta opção é semelhante a fornecer o esquema durante configuração de uma atividade. No entanto, um esquema fornecido durante a configuração da atividade não pode ser editado após o upload.

Use um arquivo de amostra

Para poder definir um esquema usando um arquivo de amostra em uma transformação, primeiro crie uma transformação.

A opção Definir Esquema só fica visível quando uma transformação ainda não está herdando um esquema de uma atividade adjacente ou de uma atividade inicialmente adjacente que já foi removida. Os esquemas nessas atividades têm precedência sobre um esquema definido em uma transformação.

Se esta condição for atendida, o botão Definir Esquema será exibido no modo de mapeamento em cada lado da transformação que ainda não tenha um esquema definido em uma atividade. Clique em Definir Esquema no lado de origem ou destino da transformação e selecione Usar Arquivo de Exemplo:

Configurar um esquema de arquivo de amostra

O editor de esquema é aberto. No editor de esquema, selecione Usar Esquema Salvo ou Fornecer Novo Esquema. Cada uma dessas opções é abordada abaixo.

Usar esquema salvo

Selecione Usar Esquema Salvo para selecionar um esquema existente que tenha sido definido anteriormente no projeto atual. Quando esta opção é selecionada, as seguintes opções ficam disponíveis:

• Esquemas salvos: Use o menu suspenso para selecionar um esquema existente para reutilizar.

• Visualizar Esquema: Após selecionar um esquema carregado existente, você pode visualizá esquema diretamente na área de texto abaixo do menu suspenso. Para visualizar o esquema em uma área maior, clique no botão ícone pop-out (após abrir essa área, clique no ícone de retorno para retornar a esta tela).

  Embora um esquema salvo não seja editável, esta área de texto pode ser copiada usando Control+C (Windows ou Linux) ou Command+C (macOS).

  Esta área de texto é apenas para a exibição de esquemas enviados existentes e não exibe plano, hierárquico, ou espelhado esquemas personalizados.

• Validação: As informações de validação são fornecidas abaixo da área de texto e são baseadas na extensão de arquivo do esquema salvo.

• Esquema de visualização: Uma visualização do esquema é exibida à direita. O esquema é exibido usando os elementos de interface padrão descritos em Nós e campos.

• Salvar Alterações: Este botão não está disponível, pois não é possível fazer alterações em um esquema salvo a partir do editor de esquema. Para fazer alterações em um esquema salvo, use a opção Editar Esquema disponível no menu de ações do esquema.

• Concluir: Clique para salvar a seleção do esquema e fechar o editor de esquema.

• Cancelar: Clique para fechar o editor de esquema.

Fornecer novo esquema

Selecione Fornecer Novo Esquema para definir um novo esquema carregando um de uma URL, enviando um arquivo ou inserindo-o manualmente na área de texto. Quando esta opção é selecionada, as seguintes opções ficam disponíveis:

• Nome do esquema: Digite um nome para o esquema na caixa de texto superior, incluindo a extensão do arquivo (.csv, .json, .xml, .xsd, ou .zip). Se nenhuma extensão de arquivo for fornecida, o conteúdo será analisado para detectar automaticamente o tipo de arquivo a ser usado para validação. Se você estiver carregando o esquema de uma URL ou enviando um arquivo, pode deixar este campo em branco, pois o nome será preenchido assim que o arquivo for carregado.

• Carregar URL: Clique para abrir uma caixa de diálogo onde você pode carregar um esquema de uma URL:

  

  • Tipo de arquivo: Use o menu suspenso para selecionar entre os tipos de arquivo suportados, incluindo CSV, JSON, XML, XSD e ZIP. Observação:

    • XSD: Um XSD fornecido por URL pode importar/incluir outros URLs XSD por referência.

    • ZIP: Um arquivo ZIP pode conter uma coleção de XSDs, que podem importar/incluir uns aos outros por referência. Quaisquer arquivos não XSD no arquivo são ignorados. Vários níveis de diretório são suportados.

  • URL: Insira uma URL acessível sem autenticação. Arquivos de até 5 MB podem ser enviados.

  • Carregar: Clique para carregar o esquema da URL. Observe que o arquivo é recuperado apenas uma vez para a geração do esquema. Além disso, esteja ciente de que alguns dados podem ser convertidos durante o processamento, conforme descrito em Processamento de esquemas.

  • Cancelar: Clique para fechar a caixa de diálogo Carregar URL do esquema sem salvar.

• Carregar arquivo: Clique para abrir uma caixa de diálogo onde você pode carregar um esquema de um arquivo que pode ser acessado na máquina atual:

  

  • Tipo de arquivo: Use o menu suspenso para selecionar entre os tipos de arquivo suportados, incluindo CSV, JSON, XML, XSD e ZIP.

    Nota

    Um arquivo ZIP pode conter uma coleção de XSDs, que podem importar/incluir uns aos outros por referência. Quaisquer arquivos não XSD no arquivo são ignorados. Vários níveis de diretório são suportados.

  • Arquivo: Use o botão Navegar à direita para navegar até um arquivo que ainda não foi usado no projeto atual. Arquivos de até 5 MB podem ser enviados.

  • Carregar: Clique para carregar o esquema do arquivo. Observe que alguns dados podem ser convertidos durante o processamento, conforme descrito em Processamento de esquemas.

  • Cancelar: Clique para fechar a caixa de diálogo Carregar arquivo de esquema sem salvar.

• Visualizar/Editar Esquema: Se não estiver carregando um esquema, você pode inserir um manualmente na área de texto abaixo dos botões Carregar URL e Carregar Arquivo. Caso contrário, após carregar um esquema, você pode visualizá-lo ou editá- esquema diretamente nessa área de texto.

  Para visualizar ou editar o esquema em uma área maior, clique no ícone pop-out (após abrir essa área, clique no ícone de retorno para retornar a esta tela).

  Esta área de texto também pode ser copiada usando Control+C (Windows ou Linux) ou Command+C (macOS).

• Validação: Conforme você edita um esquema, as informações de validação são fornecidas abaixo da área de texto, com os erros relatados uma linha por vez. Ou seja, após resolver um erro em uma linha, erros de sintaxe adicionais a serem resolvidos podem ser relatados nas linhas subsequentes. A validação é baseada na extensão de arquivo do esquema fornecido.

• Visualizar Esquema: Uma prévia do esquema é exibida à direita. Após carregar um novo esquema ou fazer edições na área de texto à esquerda, você deve primeiro clicar no botão Salvar Alterações para que as alterações sejam refletidas na área de visualização. O esquema é exibido usando os elementos de interface padrão descritos em Nós e campos.

• Salvar alterações: Clique para salvar o esquema e atualizar a visualização do esquema mostrada no lado direito.

  Aviso

  Se você tentar enviar um arquivo com o mesmo nome de um arquivo existente já definido no projeto, uma caixa de diálogo perguntará se você deseja sobrescrever o arquivo existente. Se você clicar em Continuar, o arquivo será substituído pelo novo arquivo com o mesmo nome em todos os lugares onde for usado no projeto. Se não quiser sobrescrever o arquivo, clique em Cancelar e modifique-o manualmente para que ele tenha um nome que ainda não esteja em uso e tente salvá-lo novamente.

  

  Nota

  Ao enviar um arquivo XSD que contém vários elementos de nível superior, ao clicar em Salvar alterações, você será solicitado a selecionar o nó raiz desejado. Selecione o elemento desejado e clique em Concluir para salvar:

  

• Concluir: Clique para salvar o esquema e fechar o editor de esquema.

• Cancelar: Clique para fechar o editor de esquema.

  Nota

  Se você já usou o botão Salvar Alterações, as alterações já foram salvas e usar Cancelar apenas fecha a configuração. Usar Cancelar sem primeiro usar Salvar Alterações fecha o editor de esquema sem salvar.

Menu de ações do esquema

Depois que um esquema do arquivo de amostra for criado, você poderá acessar opções de menu adicionais disponíveis para todos os esquemas.

Isso inclui Excluir, Renomear, Exibir Dependências, Implantar, Implantação Configurável e Adicionar ao Grupo, bem como Editar Esquema e Limpar Esquema. Para obter detalhes sobre essas ações, consulte menu de ações do esquema.