Ir para o conteúdo

Exemplo de esquema de arquivo no Jitterbit Integration Studio

Introdução

Você pode criar um esquema a partir de um arquivo existente que contém a estrutura de dados que deseja usar. Faça o upload de um arquivo de exemplo para definir um esquema em uma transformação. Após fazer o upload de um arquivo de exemplo, ele se torna um esquema personalizado. Você pode editar esse esquema no editor de esquemas para um esquema plano personalizado ou esquema hierárquico personalizado.

Essa opção funciona como fornecer o esquema durante a configuração de uma atividade. No entanto, você não pode editar um esquema que forneceu durante a configuração da atividade após fazer o upload.

Usar um arquivo de exemplo

Quando você usa um arquivo de exemplo, pode fornecer um novo esquema ou usar um esquema salvo.

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

Fornecer arquivo de esquema

Você pode fornecer um novo esquema a partir da zona de upload. A zona de upload aparece apenas quando uma transformação não herda um esquema de uma atividade adjacente ou de uma atividade adjacente inicialmente que foi removida. Esquemas dessas atividades têm prioridade sobre esquemas definidos em uma transformação.

Quando essa condição é atendida, a zona de upload aparece no modo de mapeamento em cada lado da transformação que não tem um esquema definido em uma atividade:

definir esquema usar arquivo de exemplo

Uma caixa de diálogo de seleção de arquivo é aberta. Selecione o arquivo e clique em Upload:

arquivo de exemplo selecionado

O editor de esquema é aberto:

arquivo de exemplo salvo esquema

  • Nome do Esquema: Insira um nome para o esquema na caixa de texto superior. Inclua a extensão do arquivo (.csv, .json, .xml, .xsd ou .zip). Se você não fornecer uma extensão de arquivo, o sistema analisa o conteúdo para detectar o tipo de arquivo para validação. O nome é preenchido automaticamente quando o arquivo é carregado.

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

    carregar URL do esquema 2

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

      • XSD: Um XSD fornecido por URL pode importar/incluir outros URLs de 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 que não sejam XSD no arquivo são ignorados. Vários níveis de diretório são suportados.

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

    • Carregar: Clique para carregar o esquema da URL. Observe que o arquivo é recuperado apenas uma única 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 Esquema.

    • 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 seja acessível a partir da máquina atual:

    carregar arquivo de esquema zip

    • 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 que não sejam XSD no arquivo são ignorados. Vários níveis de diretório são suportados.

  • Arquivo: Use o botão Procurar à direita para navegar até um arquivo que ainda não foi utilizado 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 Esquema.

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

  • Visualizar/Editar Esquema: Se você não estiver carregando um esquema, 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 visualizar ou editar o esquema diretamente nessa área de texto.

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

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

  • Validação: À medida que você edita um esquema, as informações de validação são fornecidas abaixo da área de texto, com quaisquer erros relatados linha por linha. Ou seja, após resolver um erro em uma linha, erros de sintaxe adicionais a serem resolvidos podem ser relatados para linhas subsequentes. A validação é baseada na extensão do 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 mudanças sejam refletidas na área de prévia. 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 prévia do esquema exibida no lado direito.

    Aviso

    Se você tentar carregar um arquivo com o mesmo nome de um arquivo existente já definido no projeto, uma caixa de diálogo (transcrita abaixo) pergunta se você deseja substituir 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 é utilizado no projeto. Se você não quiser substituir o arquivo, clique em Cancelar e, em seguida, modifique manualmente o arquivo para que tenha um nome que não esteja sendo utilizado, e tente salvá-lo novamente.

    Texto do diálogo

    Substituir arquivo?
    Um arquivo com o mesmo nome já existe. Você tem certeza de que deseja substituir o arquivo antigo?

    Nota

    Ao fazer o upload de um arquivo XSD que contém múltiplos 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:

    Texto do diálogo

    Por favor, selecione a raiz a ser usada
    Existe mais de uma raiz possível no arquivo XSD selecionado.

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

  • Cancelar: Clique para fechar o editor de esquemas.

    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 esquemas sem salvar.

Usar um esquema salvo

Você pode acessar e selecionar esquemas salvos usando a opção Esquemas Salvos. Ela é visível apenas quando uma transformação não está herdando um esquema de uma atividade adjacente ou de uma atividade inicialmente adjacente que foi removida. Os esquemas em tais atividades têm precedência sobre um esquema definido em uma transformação.

Desde que essa condição seja atendida, a opção Esquema Salvo é exibida no modo de mapeamento em cada lado da transformação que não possui um esquema definido em uma atividade:

exemplo de arquivo de esquema salvo

O editor de esquemas é aberto:

exemplo de arquivo esquema salvo

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

  • Ver Esquema: Após selecionar um esquema existente carregado, você pode visualizar o esquema diretamente na área de texto abaixo do menu suspenso. Para visualizar o esquema em uma área maior, clique no ícone de expansão (após abrir essa área, clique no ícone de retorno para voltar 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 exibir esquemas carregados existentes e não exibe esquemas personalizados flat, hierárquicos ou espelhados.

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

  • Visualizar Esquema: Uma prévia 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 é utilizável, pois não é possível fazer alterações em um esquema salvo a partir do editor de esquemas. Para fazer alterações em um esquema salvo, utilize a opção Editar Esquema disponível no menu de ações do esquema.

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

  • Cancelar: Clique para fechar o editor de esquemas.

Menu de ações do esquema

Após a criação de um esquema a partir do arquivo de amostra, você pode acessar opções de menu adicionais disponíveis para todos os esquemas.

Essas incluem Excluir, Renomear, Ver Dependências, Implantar, Implantação Configurável e Adicionar ao Grupo, além de Editar Esquema e Limpar Esquema. Para detalhes sobre essas ações, veja Menu de ações do esquema.

Nota

Ao editar um esquema que foi criado a partir de um arquivo de amostra, a tela de configuração para um esquema flat personalizado ou esquema hierárquico personalizado é aberta para que você possa adicionar ou editar campos e/ou nós conforme necessário.

It seems there was no Markdown content provided for translation. Please provide the text you would like me to translate into Brazilian Portuguese.