Ir para o conteúdo

Jitterbit Northwinds App

Visão Geral

A Jitterbit fornece o Northwinds através do Jitterbit Marketplace como um pacote de lançamento do Jitterbit App Builder. Em vez de um aplicativo finalizado, o pacote contém apenas o banco de dados de amostra clássico Northwinds, pré-carregado com dados de amostra, que é instalado como uma fonte de dados do App Builder.

O Northwinds é destinado a ser utilizado em conjunto com a série de tutoriais Introdução ao App Builder, que utiliza este banco de dados para construir um aplicativo de atendimento de pedidos passo a passo nas camadas de dados, negócios e UI. Instale o pacote para carregar os dados de amostra em sua instância e, em seguida, siga o tutorial para aprender como um aplicativo do App Builder é construído.

Você baixa o Northwinds como um pacote de lançamento do App Builder (um arquivo .LP) do Marketplace e o instala em sua própria instância do App Builder.

Esta página descreve como funciona, seu modelo de dados, os pré-requisitos, como baixar e instalar, como usá-lo para aprender App Builder e etapas comuns de solução de problemas.

Como funciona

Instalar o pacote adiciona o banco de dados de amostra Northwinds à sua instância do App Builder como uma fonte de dados, pré-carregada com dados de amostra. A fonte de dados é instalada selada. Para construir sobre ela, você a des sela em um ambiente de desenvolvimento e, em seguida, segue o tutorial para construir um aplicativo sobre ela:

flowchart TD A["Install the Northwinds
package in App Builder"] --> B["Northwinds data source
added to your instance,
pre-loaded with sample data"] B --> C["Unseal the data source
in a development environment"] C --> D["Build an order-fulfillment app
by following the tutorial"]

Modelo de dados

O banco de dados de amostra Northwinds inclui as entidades padrão do Northwinds: clientes, pedidos, itens de linha de pedido, produtos, categorias, funcionários e transportadoras. Cada tabela é instalada pré-carregada com dados de amostra.

Pré-requisitos

Para usar o Northwinds, você precisa do seguinte:

  • Uma licença Jitterbit Harmony com acesso ao App Builder. Isso permite o download do Marketplace; se sua organização não estiver licenciada para o App Builder, a ação Baixar aplicativo é substituída por uma ação de solicitação Obter aplicativo (veja Baixar e instalar).

  • Uma instância do App Builder e um banco de dados suportado. O Northwinds é fornecido como um pacote separado para cada versão do App Builder e banco de dados: App Builder 4.46 até 4.58 para PostgreSQL, e 4.48 até 4.57 para Microsoft SQL Server. Cada pacote instala apenas na versão exata do App Builder para a qual foi construído, então baixe o que corresponde à versão e banco de dados da sua instância. Se nenhum pacote listado corresponder à sua versão, entre em contato com o suporte da Jitterbit para solicitar um.

Baixar e instalar

Baixar o aplicativo do Marketplace

  1. Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.

  2. Localize o aplicativo chamado Northwinds. Você pode usar a barra de pesquisa ou, no painel Filtros sob Tipo, selecionar Aplicativo para mostrar apenas aplicativos.

  3. Clique no cartão do aplicativo para abrir o painel Detalhes. Revise os Requisitos do aplicativo (a versão do App Builder e o banco de dados que ele precisa).

  4. Clique no link Ir para a documentação do aplicativo para abrir esta documentação em uma nova aba e mantenha-a aberta para referência.

  5. Faça uma das seguintes ações, dependendo se sua organização possui licença para o App Builder:

    • Baixar aplicativo: Se sua organização possui licença para o App Builder, clique em Baixar aplicativo, tanto no cartão do aplicativo quanto no painel Detalhes. Seu navegador salva o arquivo .LP em sua localização de download, e uma notificação Arquivo do App Builder baixado com sucesso confirma o download.

    • Obter aplicativo: Se sua organização não possui licença para o App Builder, a ação é rotulada como Obter aplicativo. O painel Detalhes mostra uma mensagem informando que uma licença do App Builder é necessária, com um botão Enviar. Clique em Enviar para enviar um pedido para que um representante entre em contato com você sobre o App Builder; uma notificação Mensagem enviada com sucesso confirma isso.

Instalar o aplicativo no App Builder

Instale o arquivo .LP baixado em sua instância do App Builder:

  1. Faça login no App Builder e vá para o IDE.

  2. Em Deploy, clique em Install Release.

  3. Clique em + Package, depois em Browse e selecione o arquivo .LP que você baixou.

  4. Clique em Save. O painel Release exibe as informações do pacote, então feche o diálogo Package.

  5. Confirme se os detalhes estão corretos e clique em Install.

Desbloquear a fonte de dados

A fonte de dados Northwinds é instalada selada. Se você implantar o pacote em um ambiente de desenvolvimento e quiser construir sobre os dados de exemplo ou estender seu modelo de dados (por exemplo, para seguir a série de tutoriais Introdução ao App Builder), desbloqueie a fonte de dados. Mantenha-a selada em QA e produção para preservar a equivalência entre os ambientes.

  1. Selecione IDE > Data Servers.

  2. No painel Data Servers, clique em View All Data Sources.

  3. Selecione a fonte de dados Northwinds instalada.

  4. No painel Data Source, clique em More > Unseal Data Source.

Para mais detalhes, veja Selar ou desbloquear uma fonte de dados.

Aprenda App Builder com Northwinds

Northwinds é o banco de dados usado ao longo da série de tutoriais Introdução ao App Builder, que constrói um aplicativo de atendimento de pedidos passo a passo nas camadas de dados, negócios e UI. Se você é novo no App Builder, instale o banco de dados de exemplo e siga o tutorial para ver como cada parte é construída.

Ao final do tutorial, você terá construído um aplicativo com uma página Customers para navegar e gerenciar clientes, e uma página Orders que mostra cada pedido junto com suas informações de envio, cliente e itens de linha:

Página de clientes construída seguindo o tutorial

Página de pedidos construída seguindo o tutorial

Solução de Problemas

Para obter ajuda com a instalação, a fonte de dados ou os dados de exemplo, revise os logs do seu App Builder e entre em contato com o suporte da Jitterbit.