Transformar soluções de farm para o modelo de suplemento do SharePoint

Artigo
04/08/2023

Se você tiver estendido seu ambiente do SharePoint usando as soluções de farm e quiser migrar suas extensões para o modelo de suplemento do SharePoint para facilitar a transição para o SharePoint Online, é preciso transformar suas soluções de farm no modelo de suplemento do SharePoint.

Transformar suas soluções de farm no modelo de Suplementos do SharePoint envolve a análise das extensões existentes, o design e o desenvolvimento do seu novo Suplemento do SharePoint e, em seguida, o teste e a implantação do suplemento em seu ambiente de produção.

Este artigo descreve o processo e as práticas recomendadas para usar quando transformar suas soluções de farm no modelo de suplemento do SharePoint.

Planejando o processo de transformação

Quando você transforma suas soluções farm no modelo de Suplemento do SharePoint, você quer garantir que o impacto sobre seus usuários seja mínimo. Analise com cuidado suas soluções de farm atuais e, em seguida, projete seu novo Suplemento do SharePoint para atender às necessidades de sua organização. Recomendamos o seguinte processo para garantir uma transformação bem-sucedida.

Preparação

Saiba mais:

O modelo de suplemento do SharePoint, diferentes tipos de suplementos e opções de hospedagem. Veja mais informações em Suplementos do SharePoint.
Tecnologias de acesso remoto para acessar seus dados locais.

Avaliação da solução

Analise os requisitos comerciais e funcionais por meio de:

Identificar soluções de farm implantadas no ambiente atual. Considere usar ferramentas de terceiros para ajudar a identificar extensões implantadas. Realize uma análise detalhada de cada solução de farm identificada.
Analisando requisitos com seus usuários. Considere pedir a seus usuários que demonstrem como usam as soluções de farm existentes na realização do seu trabalho diário.
Identificar, documentar e projetar novas funcionalidades para incluir no novo Suplemento do SharePoint. Considere analisar sua lista de novas solicitações de recursos de seus usuários para ter ideias adicionais.
Identificar recursos não utilizados e concordar com seus usuários para omitir essa funcionalidade do novo Suplemento do SharePoint.
Para cada solução de farm, determinar se deseja substituí-la por um Suplemento do SharePoint. Algumas soluções, como extensões de administração do SharePoint, não podem ser duplicadas no modelo de Suplemento do SharePoint. Para saber mais, confira Gerenciamento do Ciclo de Vida do Aplicativo do SharePoint e Suplementos do SharePoint comparados às soluções do SharePoint.

Planejamento de soluções

Projetar o novo aplicativo usando o modelo de Suplemento do SharePoint com base em:

Os requisitos reunidos na etapa de Avaliação de soluções.
Sua análise do código existente. Durante sua análise de código, considere identificar de partes do código que podem ser descartadas (por exemplo, o código não está mais sendo usado ou os requisitos foram alterados).

Desenvolver e testar a versão de modelo do Suplemento do SharePoint do seu aplicativo

Esta é geralmente a etapa mais demorada no processo de transformação.

Implante seu novo suplemento

Dependendo de suas necessidades, você pode decidir manter as soluções de farm em execução em paralelo ao novo Suplemento do SharePoint ou você pode cancelar a solução de farm e só permitir que os usuários usem o novo Suplemento do SharePoint. Em qualquer cenário, certifique-se de que sua implantação esteja estável e envie um aviso apropriado para seus usuários.

Se o conteúdo, em conjuntos de sites existentes, depende das suas soluções de farm (por exemplo, se o conteúdo foi criado usando um tipo de conteúdo) antes de retirar totalmente a solução de farm, será necessário transformar o conteúdo existente para usar sua nova solução de modelo de Suplemento do SharePoint. Assegure-se de que você tenha tempo suficiente para concluir essa tarefa, pois ela pode ser demorada e difícil.

Abordagens de transformação para implantar o novo Suplemento do SharePoint

Após terminar o desenvolvimento e o teste da unidade do seu novo Suplemento do SharePoint, inicie a transformação da solução de farm no novo Suplemento do SharePoint usando uma das abordagens de transformação listada na tabela a seguir.

Abordagem de transformação	Descrição	Vantagens	Desvantagens
In-loco	Implante o novo Suplemento do SharePoint em seu ambiente existente do SharePoint. Certifique-se de que seu site está usando o novo Suplemento do SharePoint antes de cancelar a solução de farm.	Menos impacto geral ao usuário. Menos recursos necessários porque você está usando o seu ambiente existente no SharePoint. Não há necessidade de ferramentas de terceiros. Tempo de inatividade de site mínimo. Atualize um conjunto de sites por vez, em vez de atualizar todo o farm de uma só vez. As URLs não mudam.	É difícil de acompanhar o andamento da conclusão de todos os ativos afetados em um site. Aumenta a possibilidade de criar órfãos (quando um ativo aponta para um arquivo em um sistema de arquivos que não existe, isso é conhecido como órfão).
Movimento ou a migração de conteúdo	Extrair o conteúdo dos conjuntos de sites existentes onde suas soluções de farm estão implantadas no momento e implantar o conteúdo em um novo conjunto de sites que usa o novo Suplemento do SharePoint. Quando você migra o conteúdo do SharePoint Online, esse processo é usado normalmente.	Limpe o ambiente do SharePoint sem dependências de soluções de farm anteriores. O novo conjunto de sites é isolado de seu ambiente de produção. Lance o conjunto de sites atualizado quando estiver pronto. .	Requer ferramentas de terceiros para ajudar com a migração de conteúdo. Requer um ambiente adicional do SharePoint. Tempo de inatividade de site necessário. As URLs podem mudar se você manter os dois sites em execução em paralelo por um período de tempo.

Práticas recomendadas para soluções de farm específicas

Aplique as seguintes práticas recomendadas ao transformar soluções específicas.

Layouts de página e páginas mestras

Layouts de página e páginas mestras personalizadas podem existir em sites de publicação ou sites de equipes com os recursos de publicação habilitados.

Para substituir layouts de página e páginas mestras:

Carregue o novo layout de página ou a página mestra no site. Carregue novas páginas mestras e layouts de página para seu conjunto de sites, manualmente ou usando as APIs remotas. APIs remotas incluem o modelo de objeto do lado cliente (CSOM) ou REST. Isso garante que as páginas mestras e layouts de página não tenham dependências em uma solução de farm.
Configure seu site para usar os novos layouts de página e páginas mestras.
Cancele a versão anterior dos layouts de página e páginas mestras.

Web Parts e controles

Para substituir web parts e controles:

Verifique todas as páginas existentes para determinar quais páginas possuem webparts.
(Opcional) Revise as web parts prontas para uso para determinar se alguma delas pode substituir sua web part personalizada.
Substitua as web parts existentes por instâncias de parte de aplicativo ou use outras técnicas (como JavaScript inserido em páginas ou layouts de página) para obter a mesma funcionalidade.
Use o JavaScript inserido para manipular os elementos da interface do usuário.

Observação

Para substituir suas web parts existentes por partes de aplicativo, você precisa:

Habilitar o sideloading de suplementos em sua assinatura do Office 365. Consultar o administrador do Office 365.
Usar o CSOM para habilitar o sideloading de suplementos em seu site. Para saber mais, confira o exemplo de código Core.SideLoading.
Instale o parte do aplicativo em seu site.
Desabilite o sideloading de suplementos em seu site.
Desabilite o sideloading de suplementos na assinatura do Office 365. Consultar o administrador do Office 365.

Manipulação de página:

Talvez seja necessário implementar a manipulação de página durante o processo de provisionamento de site personalizado. O exemplo de código Provisioning.Pages mostra técnicas de manipulação de página, incluindo a criação de uma página wiki, a adição de conteúdo HTML à página, a criação de uma lista de links promovidos, a criação de páginas com layouts diferentes, a adição de web parts fora da caixa à página e a remoção da página.

Colunas de site, definições de lista e tipos de conteúdo

Se as colunas do site, as definições de lista e tipos de conteúdo foram criados usando os elementos da Estrutura de Recursos que foram implantados usando as soluções de farm, você deve usar a abordagem de movimento ou transformação de migração de conteúdo. Isso não diz respeito aos elementos da Estrutura de Recursos implantados por meio de soluções de área restrita. Para usar a abordagem de transformação de migração de conteúdo, você deve usar ferramentas de terceiros para remover as dependências das soluções de farm.

Módulos ou Estrutura de Recursos

Módulos usam ponteiros para arquivos, ou seja, os arquivos não são personalizados e implantados no sistema de arquivos. Se suas soluções de farm usam módulos, personalize os arquivos implantando versões alternativas dos mesmos arquivos no banco de dados do conteúdo, examine e atualize suas soluções para que apontem para os novos arquivos armazenados no banco de dados do conteúdo e retire a solução de farm que apontava para os arquivos armazenados no sistema de arquivos.

Modelos de site e modelos da web

Você deve se concentrar em transformar os elementos da Estrutura de Recurso implantados pelo modelo de site ou um modelo da web. Por exemplo, certifique-se de que a página default.aspx do site não seja substituída ao cancelar a solução de farm.

Trabalhos de timer

Se você estiver usando o SharePoint Online, você não pode criar e gerenciar trabalhos de timer. Em vez disso, você pode criar um aplicativo de console que usa o Agendador de Tarefas do Windows ou um Azure WebJob para agendar e executar o aplicativo de console remotamente.

Ao criar um trabalho de timer personalizado, determine se você precisa usar uma conta específica ou um aplicativo com base em OAuth apenas token. O exemplo de código Core.TimerJobs.Samples mostra como criar seu próprio trabalho de timer personalizado.