Compartilhar via

Instruções passo a passo: expondo e consumindo um serviço OData em LightSwitch

  • Artigo

Os aplicativos LightSwitch podem expor seus dados como um serviço OData (Open Data), que pode ser consumido por qualquer aplicativo que dê suporte ao protocolo OData. Esta explicação passo a passo demonstra como expor dados de um aplicativo LightSwitch e consumi-los em um segundo aplicativo LightSwitch.

Criar um aplicativo host

A primeira etapa é criar um aplicativo host que exponha um feed OData.

Para criar um projeto de aplicativo host

  1. Na barra de menus, escolha Arquivo, Novo Projeto.

  2. Na lista Modelos Instalados, expanda o nó Visual Basic ou Visual C#, escolha Aplicativo LightSwitch (Visual Basic) ou Aplicativo LightSwitch (Visual C#).

  3. No campo Nome, insira Host de Contato e escolha o botão OK.

  4. No Gerenciador de Soluções, abra o menu de atalho de Propriedades e escolha Abrir.

  5. Escolha a guia Tipo de Aplicativo e, em Cliente, escolha Web.

    Somente aplicativos Web podem expor seus dados como um serviço.

Para adicionar uma fonte de dados

  1. No Gerenciador de Soluções, escolha Fontes de Dados.

  2. No menu Projeto , escolha Adicionar Tabela.

  3. Na janela Propriedades, escolha a propriedade Nome e insira Contato.

  4. No designer de dados, adicione os seguintes campos:

    Nome

    Tipo

    Obrigatório

    Nome

    Cadeia de caracteres

    True

    Telefone

    Número de telefone

    False

    Email

    Endereço de email

    False

Para expor o serviço

  1. Na barra de menus, escolha Depurar, Iniciar Depuração.

    O aplicativo Host de Contato é aberto em uma janela do navegador.

  2. Copie a primeira parte da URL (https://localhost:#####/).

    Deixe o aplicativo em execução. Ele deve estar em execução para expor o serviço.

Criar um aplicativo cliente

A próxima etapa é criar um aplicativo que consumirá o serviço OData

Para criar um projeto de cliente

  1. Abra uma nova instância do Visual Studio.

  2. Na barra de menus, escolha Arquivo, Novo Projeto.

  3. Na lista Modelos Instalados, escolha Aplicativo LightSwitch (Visual Basic) ou Aplicativo LightSwitch (Visual C#).

  4. No campo Nome, digite Cliente de Contato e escolha o botão OK.

Para adicionar uma fonte de dados

  1. No Gerenciador de Soluções, escolha Fontes de Dados.

  2. Na barra de menus, escolha Projeto, Adicionar Fonte de Dados.

  3. Em Assistente para Anexar Fonte de Dados, escolha Serviço OData e o botão Próximo.

  4. No campo Endereço de Origem de OData, cole a URL que você copiou do aplicativo Host de Contato (https://localhost:#####/) e insira ContactData.svc após a última barra invertida (https://localhost:#####/ApplicationData.svc).

  5. Escolha o botão Testar Conexão.

  6. Na caixa de diálogo Testar Conexão, escolha Contatos na lista e o botão Testar.

    Após um breve intervalo, deve aparecer uma caixa de diálogo Conexão de teste bem-sucedida.

  7. Clique no botão OK, escolha o botão Fechar para descartar as caixas de diálogo e clique no botão Próximo.

  8. Expanda o nó Entidades, escolha Contatos e o botão Finalizar.

    O designer de dados abre e exibe o esquema da tabela que você criou no projeto de Host de Contato.

Para adicionar uma tela

  1. No Gerenciador de Soluções, escolha Telas.

  2. Na barra de menus, escolha Projeto, Adicionar Tela.

  3. Na caixa de diálogo Adicionar Nova Tela, escolha Tela de Grade Editável.

  4. Na lista Dados da Tela, escolha ApplicationDataData.Contacts e o botão OK.

Nesse ponto, você pode executar o aplicativo e inserir dados. Qualquer dado que você inserir será salvo no banco de dados intrínseco do projeto do Host de Contato.

Próximas etapas

Esta explicação passo a passo demonstra o consumo de OData no ambiente de tempo de design. Depois de publicar o aplicativo Host de Contato para um servidor que esteja executando o IIS (Serviços de Informações da Internet) ou o Microsoft Azure, você deverá atualizar o Endereço de Origem do OData para que o aplicativo cliente coincida com a URL do aplicativo publicado.

Dica

Se você fechar o aplicativo Host de Contato no ambiente de tempo de design e reiniciá-lo, a URL LocalHost será alterada e será necessário atualizar o Endereço de Origem de OData no projeto cliente.

Para atualizar a fonte de dados

  1. Abra o projeto do cliente de Contato.

  2. No Gerenciador de Soluções, escolha ApplicationDataData.

  3. Na barra de menus, escolha Projeto, Atualizar Fonte de Dados.

  4. No Assistente para Anexar Fonte de Dados, escolha o botão Anterior.

  5. Na caixa de texto Endereço de Origem de OData, digite a nova URL para o aplicativo Host de Contato publicado (por exemplo, https://www.contoso.com/ApplicationData.svc).

  6. Clique no botão Próximo e no botão Finalizar para atualizar a fonte de dados.

Consulte também

Conceitos

Expondo dados de aplicativo LightSwitch