Incluir uma parte do suplemento no suplemento hospedado pelo provedor

Este é o sexto de uma série de artigos sobre os conceitos básicos do desenvolvimento de suplementos do SharePoint hospedados pelo provedor. Primeiro, você deve estar familiarizado com suplementos do SharePoint e os artigos anteriores desta série, que podem ser encontrados em Introdução à criação de suplementos do SharePoint hospedados pelo provedor.

Observação

Se você trabalhou com esta série sobre suplementos hospedados pelo provedor, você terá uma solução do Visual Studio que pode ser usada para continuar com este tópico. Você também pode baixar o repositório em SharePoint_Provider-hosted_Add-Ins_Tutorials e abrir o arquivo BeforeAdd-inPart.sln.

Neste artigo, você adiciona um tipo especial de Web Part chamado de parte de suplemento ao Suplemento do SharePoint. A parte de suplemento expõe o formulário de pedido do suplemento em uma página do SharePoint.

Criar a parte de suplemento

Observação

As configurações de Projetos de Inicialização no Visual Studio tendem a reverter para padrões sempre que a solução é reaberta. Sempre siga estas etapas imediatamente após a reabertura da solução de exemplo nesta série de artigos:

1. Clique com botão direito do mouse no nó da solução na parte superior do Gerenciador de Soluções e então selecione Definir Projetos de Inicialização.
2. Verifique se todos os três projetos estão definidos como Iniciar na coluna Ação.

1. Em Gerenciador de Soluções, clique com o botão direito do mouse no projeto ChainStore e selecione Adicionar>Novo Item.

2. Selecione Web Part do cliente (Host Web), dê-lhe o nome Ordem de Local e, em seguida, selecione Adicionar. ("Client Web Part" é outro nome para "parte de suplemento".)

3. Na próxima página do assistente, selecione a segunda opção: Selecione ou insira a URL de uma página da Web existente para o conteúdo da Web Part do cliente.

4. Na lista suspensa, selecione a URL da página OrderForm.aspx e selecione Concluir.

   Um arquivo elements.xml que define a parte de suplemento é adicionado ao projeto e aberto.

5. No elemento ClientWebPart , altere os seguintes atributos para esses valores:

   Atributo	Valor
   Título	Pedido de Local
   Descrição	Formulário para fazer um pedido
   DefaultHeight	320

   Deixe todos os outros atributos com seus padrões e salve o arquivo.

Execute o suplemento e teste a parte de suplemento

1. Use a tecla F5 para implantar e executar o suplemento. O Visual Studio hospeda o aplicativo Web remoto no IIS Express e hospeda o banco de dados SQL no SQL Express. Ele também faz uma instalação temporária do suplemento em seu site de teste do SharePoint e executa imediatamente o suplemento. Você é solicitado a conceder permissões ao suplemento antes que sua página inicial seja aberta.

2. Quando a página inicial do suplemento é aberta, o suplemento foi implantado e a parte de suplemento do Place Order está disponível para os usuários adicionarem a qualquer área da Web Part em qualquer página do SharePoint no site da loja de Hong Kong. Siga estas etapas para adicioná-la à home page:

   1. Selecione Voltar ao Site no controle cromado na parte superior da página inicial para abrir a página inicial da loja de Hong Kong.

   2. Na faixa de opções, abra a guia Página e selecione Editar.

   3. Depois que a página estiver no modo de edição, abra a guia Inserir na faixa de opções e selecione Parte de Suplemento (o botão ainda pode ser chamado de App Part).

   4. No controle de inserção da Web Part que é aberto, selecione a parte de suplemento Ordem de Lugar . O controle é semelhante ao seguinte.

      Figura 1. Controle de inserção da Web Part do SharePoint

      

   5. Selecione em algum lugar em uma das zonas da Web Part do formulário para definir o local para onde a parte de suplemento irá.

   6. Selecione Adicionar no controle de inserção da Web Part. A parte de suplemento do Pedido de Lugar é adicionada à zona da Web Part.

   7. Na faixa de opções, selecione Salvar.

3. O formulário de pedido agora aparece na página e tem a aparência do restante da página. Deve se parecer com o seguinte.

   Figura 2. Parte de suplemento do Place Order

   

4. Insira valores para Fornecedor, Produto e Quantidade e selecione Ordem de Local. Nada parece acontecer, mas uma ordem é inserida no banco de dados corporativo. Opcionalmente, você pode esvaziar os campos da parte do suplemento atualizando a página.

5. Use o botão de volta do navegador até que você esteja de volta à página inicial do suplemento da Chain Store e selecione Mostrar Pedidos. Seu novo pedido está listado.

6. Para encerrar a sessão de depuração, feche a janela do navegador ou interrompa a depuração no Visual Studio. Sempre que você seleciona F5, o Visual Studio retrai a versão anterior do suplemento e instala a mais recente.

7. Você lidará com esse suplemento e com a solução do Visual Studio em outros artigos, e recomenda-se retirar o suplemento uma última vez quando for deixar de trabalhar com ele por algum tempo. Clique com botão direito do mouse no projeto no Gerenciador de Soluções e escolha Retirar.

Próximas etapas

O suplemento depende de duas listas que você criou manualmente; você não quer que seus usuários tenham que fazer isso. No próximo artigo, você inicia o processo de criação automática dessas listas. A primeira grande etapa é criar manipuladores personalizados para o evento de instalação de um suplemento: manipular eventos de suplemento no suplemento hospedado pelo provedor.