Instruktaż: Tworzenie kroku wdrożenia niestandardowe dla projektów programu SharePoint

Artykuł
02/27/2013

Podczas wdrażania projektu programu SharePoint, Visual Studio wykonuje serię kroków wdrażania w określonej kolejności.Visual Studio zawiera wiele wbudowanych wdrażania kroków, ale można również tworzyć własne.

W tym instruktażu będą tworzyć krok wdrażania niestandardowego uaktualnienia rozwiązania na serwerze, na którym jest uruchomiony program SharePoint.Visual Studio zawiera kroki wdrażania wbudowane dla wielu zadań, takie wycofanie lub dodawanie rozwiązań, ale nie zawiera krok wdrażania rozwiązań do uaktualniania.Domyślnie, gdy wdrożyć rozwiązanie programu SharePoint, Visual Studio najpierw chowa rozwiązanie (jeśli jest już wdrożony) i następnie redeploys całego rozwiązania.Aby uzyskać więcej informacji na temat kroków wdrażania wbudowane, zobacz Wdrażania, publikowania i uaktualnianie pakiety rozwiązań programu SharePoint.

W tym instruktażu przedstawiono następujące zadania:

Tworzenie rozszerzeń programu Visual Studio, które wykonuje dwa główne zadania:
- Rozszerzenie krok wdrażania niestandardowego, aby uaktualnić rozwiązanie programu SharePoint.
- Rozszerzenie tworzy rozszerzenie projektu, który definiuje nowe Konfiguracja wdrażania, który jest zestaw kroków wdrażania, które są wykonywane dla danego projektu.Nowa konfiguracja wdrażania zawiera etap wdrożenia niestandardowe i kilka kroków wdrażania wbudowane.
Tworzenie dwa niestandardowe polecenia programu SharePoint, które zwraca zestaw rozszerzeń.Polecenia programu SharePoint są metody, które mogą być wywoływane przez zespoły rozszerzenie użycia interfejsów API w modelu serwer programu SharePoint.Aby uzyskać więcej informacji, zobacz Wywołanie do modeli obiektów programu SharePoint.
Budowanie pakietu Visual Studio rozszerzenie (VSIX) do wdrażania obu zestawów.
Testowanie nowy etap wdrożenia.

Wymagania wstępne

Potrzebne są następujące składniki na komputerze deweloperskim do przeprowadzenia tego instruktażu:

Obsługiwane wersje systemu Windows, programu SharePoint i Visual Studio.Aby uzyskać więcej informacji, zobacz Wymagania dotyczące rozwiązań programu SharePoint.
Visual Studio SDK.W tym instruktażu wykorzystano Projektu VSIX szablon w zestawie SDK, aby utworzyć pakiet VSIX wdrożyć rozszerzenia.Aby uzyskać więcej informacji, zobacz Rozszerzanie narzędzi programu SharePoint w programie Visual Studio.

Znajomość następujące pojęcia jest przydatne, ale nie jest to wymagane, aby ukończyć Instruktaż:

Za pomocą modelu obiektów serwera programu SharePoint.Aby uzyskać więcej informacji, zobacz za pomocą modelu obiektów programu SharePoint Foundation po stronie serwera.
Rozwiązanie programu SharePoint.Aby uzyskać więcej informacji, zobacz Rozwiązań Przegląd.
Uaktualnianie rozwiązań programu SharePoint.Aby uzyskać więcej informacji, zobacz Aktualizacja rozwiązania.

Tworzenie projektów

Do przeprowadzenia tego instruktażu, należy utworzyć trzy projekty:

Projekt VSIX, aby utworzyć pakiet VSIX wdrożyć rozszerzenia.
Projektu biblioteki klas, który implementuje rozszerzenie.Ten projekt musi być ukierunkowana na 4.5.NET Framework.
Projektu biblioteki klas, który określa niestandardowe polecenia programu SharePoint.Ten projekt musi być ukierunkowana na.NET Framework 3.5.

Instruktaż należy rozpocząć od utworzenia projektów.

Aby utworzyć projekt VSIX

Start Visual Studio.
Na pasku menu wybierz pliku, Nowa, Projekt.
W Nowy projekt okno dialogowe rozwiń Visual C# lub języka Visual Basic węzłów, a następnie wybierz polecenie rozszerzalności węzła.

[!UWAGA]

Rozszerzalności węzeł jest dostępne tylko po zainstalowaniu programu Visual Studio SDK.Aby uzyskać więcej informacji zobacz sekcję Warunki wstępne, wcześniej w tym temacie.
W górnej części okna dialogowego wybierz opcję 4.5.NET Framework na liście wersje.NET Framework.
Wybierz Projektu VSIX szablonu, nazwę projektu UpgradeDeploymentStep, a następnie wybierz polecenie OK przycisk.

Visual Studiododaje UpgradeDeploymentStep projekt Solution Explorer.

Aby utworzyć rozszerzenie projektu

W Solution Explorer, otwórz menu skrótów dla węzła rozwiązanie UpgradeDeploymentStep, wybierz Dodaj, a następnie wybierz polecenie Nowy projekt.

[!UWAGA]

W projektach programu Visual Basic, węzeł rozwiązanie pojawia się w Solution Explorer tylko wtedy, gdy Zawsze pokazuj rozwiązanie pole wyboru jest zaznaczone w General, Projects and Solutions, Options Dialog Box.
W Nowy projekt okno dialogowe rozwiń Visual C# lub języka Visual Basic węzły, a następnie wybierz polecenie Windows węzła.
W górnej części okna dialogowego wybierz opcję 4.5.NET Framework na liście wersje.NET Framework.
Wybierz Biblioteka klas projektu szablonu, nazwa projektu DeploymentStepExtension, a następnie wybierz polecenie OK przycisk.

Visual Studiododaje DeploymentStepExtension projektu do rozwiązania i otwiera plik domyślny kod Class1.
Usuń plik Class1 kodu z projektu.

Tworzenie projektu polecenia programu SharePoint

W Solution Explorer, otwórz menu skrótów dla węzła rozwiązanie UpgradeDeploymentStep, wybierz Dodaj, a następnie wybierz polecenie Nowy projekt.

[!UWAGA]

W projektach programu Visual Basic, węzeł rozwiązanie tylko pojawia się w Solution Explorer po Zawsze pokazuj rozwiązanie pole wyboru jest zaznaczone w General, Projects and Solutions, Options Dialog Box.
W Nowy projekt okno dialogowe rozwiń Visual C# lub języka Visual Basic, a następnie wybierz polecenie Windows węzła.
W górnej części okna dialogowego wybierz opcję 3.5.NET Framework na liście wersje.NET Framework.
Wybierz Biblioteka klas projektu szablonu, nazwa projektu SharePointCommands, a następnie wybierz polecenie OK przycisk.

Dodaje Visual Studio SharePointCommands projektu do rozwiązania i otwiera plik domyślny kod Class1.
Usuń plik Class1 kodu z projektu.

Konfigurowanie projektów

Przed pisać kod, aby utworzyć krok wdrażania niestandardowego, należy dodać kod plików i odwołania do zestawów i należy skonfigurować projektów.

Aby skonfigurować projektu DeploymentStepExtension

W DeploymentStepExtension projektu, należy dodać dwa pliki kodu, które mają następujące nazwy:
- UpgradeStep
- DeploymentConfigurationExtension
Otwórz menu skrótów dla projektu DeploymentStepExtension, a następnie wybierz Dodaj odwołanie.
Na Framework , następnie wybierz pole wyboru dla zestawu System.ComponentModel.Composition.
Na rozszerzenia tab, zaznacz pole wyboru dla zestawu Microsoft.VisualStudio.SharePoint, a następnie wybierz OK przycisk.

Aby skonfigurować projektu SharePointCommands

W SharePointCommands projektu, dodać plik kodu o nazwie polecenia.
W Solution Explorer, otwórz menu skrótów na SharePointCommands projektu węzła, a następnie wybierz Dodaj odwołanie.
Na rozszerzenia kartę, zaznacz pole wyboru dla następujących zestawów i następnie kliknij przycisk Wybierz OK przycisku
- Microsoft.SharePoint
- Microsoft.VisualStudio.SharePoint.Commands

Definiowanie etap wdrożenia niestandardowe

Tworzenie klasy, która definiuje etap wdrożenia aktualizacji.Aby zdefiniować etap wdrożenia implementuje klasy IDeploymentStep interfejsu.Implementuje ten interfejs, w każdym przypadku, gdy chcesz zdefiniować krok wdrażania niestandardowego.

Aby zdefiniować etap wdrożenia niestandardowe

W DeploymentStepExtension projekt, otwórz plik UpgradeStep kod i następnie wklej następujący kod do niego.

[!UWAGA]

Po dodać ten kod, projekt będzie mieć pewne błędy kompilacji, ale będziesz odejść podczas dodawania kodu w dalszych krokach.

Imports System
Imports Microsoft.VisualStudio.SharePoint
Imports Microsoft.VisualStudio.SharePoint.Deployment
Imports System.ComponentModel.Composition

Namespace Contoso.DeploymentSteps.Upgrade

    ' Export attribute: Enables Visual Studio to discover and load this deployment step.
    ' DeploymentStep attribute: Specifies the ID for this new deployment step.
    ' UpgradeStep class: Defines a new deployment step that can be used to upgrade a solution 
    '     on a SharePoint site.
    <Export(GetType(IDeploymentStep))> _
    <DeploymentStep("Contoso.DeploymentSteps.UpgradeSolution")> _
    Friend Class UpgradeStep
        Implements IDeploymentStep

        Private solutionName As String
        Private solutionFullPath As String

        Private Sub Initialize(ByVal stepInfo As IDeploymentStepInfo) _
            Implements IDeploymentStep.Initialize
            stepInfo.Name = "Upgrade solution"
            stepInfo.StatusBarMessage = "Upgrading solution..."
            stepInfo.Description = "Upgrades the solution on the local machine."
        End Sub

        ' Specifies whether the solution can be upgraded.
        Private Function CanExecute(ByVal context As IDeploymentContext) As Boolean _
            Implements IDeploymentStep.CanExecute

            ' SharePoint returns all the installed solutions names in lower case.
            solutionName = (context.Project.Package.Model.Name & ".wsp").ToLower()
            solutionFullPath = context.Project.Package.OutputPath
            Dim solutionExists As Boolean = _
                context.Project.SharePointConnection.ExecuteCommand(Of String, Boolean)(
                "Contoso.Commands.IsSolutionDeployed", solutionName)

            ' Throw exceptions in error cases because deployment cannot proceed.
            If context.Project.IsSandboxedSolution = True Then
                Dim sandboxMessage As String = "Cannot upgrade the solution. Upgrade deployment " & _
                    "configuration does not support Sandboxed solutions."
                context.Logger.WriteLine(sandboxMessage, LogCategory.Error)
                Throw New InvalidOperationException()
            ElseIf solutionExists = False Then
                Dim notDeployedMessage As String = String.Format("Cannot upgrade the solution. The IsSolutionDeployed " & _
                    "command cannot find the following solution on the SharePoint site: {0}.", solutionName)
                context.Logger.WriteLine(notDeployedMessage, LogCategory.Error)
                Throw New InvalidOperationException(notDeployedMessage)
            End If

            ' Execute step and continue with deployment.
            Return True
        End Function

        Private Sub Execute(ByVal context As IDeploymentContext) _
            Implements IDeploymentStep.Execute
            context.Logger.WriteLine("Upgrading solution: " & solutionName, LogCategory.Status)
            context.Project.SharePointConnection.ExecuteCommand("Contoso.Commands.UpgradeSolution", _
                solutionFullPath)
        End Sub

    End Class
End Namespace

using System;
using Microsoft.VisualStudio.SharePoint;
using Microsoft.VisualStudio.SharePoint.Deployment;
using System.ComponentModel.Composition;

namespace Contoso.DeploymentSteps.Upgrade
{
    // Enables Visual Studio to discover and load this deployment step.
    [Export(typeof(IDeploymentStep))]

    // Specifies the ID for this new deployment step.
    [DeploymentStep("Contoso.DeploymentSteps.UpgradeSolution")]

    // Defines a new deployment step that can be used to upgrade a solution on a SharePoint site.
    internal class UpgradeStep : IDeploymentStep
    {
        private string solutionName;
        private string solutionFullPath;

        // Implements IDeploymentStep.Initialize.
        public void Initialize(IDeploymentStepInfo stepInfo)
        {
            stepInfo.Name = "Upgrade solution";
            stepInfo.StatusBarMessage = "Upgrading solution...";
            stepInfo.Description = "Upgrades the solution on the local machine.";
        }

        // Implements IDeploymentStep.CanExecute. Specifies whether the solution can be upgraded.
        public bool CanExecute(IDeploymentContext context)
        {
            // SharePoint returns all the installed solutions names in lower case.
            solutionName = (context.Project.Package.Model.Name + ".wsp").ToLower();
            solutionFullPath = context.Project.Package.OutputPath;
            bool solutionExists = context.Project.SharePointConnection.ExecuteCommand<string, bool>(
                "Contoso.Commands.IsSolutionDeployed", solutionName);

            // Throw exceptions in error cases because deployment cannot proceed.
            if (context.Project.IsSandboxedSolution)
            {
                string sandboxMessage = "Cannot upgrade the solution. The upgrade deployment configuration " +
                    "does not support Sandboxed solutions.";
                context.Logger.WriteLine(sandboxMessage, LogCategory.Error);
                throw new InvalidOperationException(sandboxMessage);
            }
            else if (!solutionExists)
            {
                string notDeployedMessage = string.Format("Cannot upgrade the solution. The IsSolutionDeployed " +
                    "command cannot find the following solution: {0}.", solutionName);
                context.Logger.WriteLine(notDeployedMessage, LogCategory.Error);
                throw new InvalidOperationException(notDeployedMessage);
            }

            // Execute step and continue with deployment.
            return true;
        }

        // Implements IDeploymentStep.Execute.
        public void Execute(IDeploymentContext context)
        {
            context.Logger.WriteLine("Upgrading solution: " + solutionName, LogCategory.Status);
            context.Project.SharePointConnection.ExecuteCommand("Contoso.Commands.UpgradeSolution",
                solutionFullPath);
        }
    }
}

Tworzenie konfiguracji wdrażania, które obejmuje etap wdrożenia niestandardowe

Tworzenie rozszerzenia projektu dla nowych konfiguracji wdrażania, które obejmuje kilka kroków wdrażania wbudowane i nowy etap wdrożenia aktualizacji.Tworząc to rozszerzenie, możesz pomóc deweloperom SharePoint etap wdrożenia aktualizacji w projektach programu SharePoint.

Do tworzenia konfiguracji wdrażania implementuje klasy ISharePointProjectExtension interfejsu.Implementuje ten interfejs, w każdym przypadku, gdy użytkownik chce utworzyć rozszerzenie projektu programu SharePoint.

Aby utworzyć Konfiguracja wdrażania

W DeploymentStepExtension projekt, otwórz plik DeploymentConfigurationExtension kod i następnie wklej następujący kod do niego.

Imports Microsoft.VisualStudio.SharePoint
Imports Microsoft.VisualStudio.SharePoint.Deployment
Imports System.ComponentModel.Composition

Namespace Contoso.DeploymentSteps.Upgrade

    ' Export attribute: Enables Visual Studio to discover and load this project-level extension.
    ' DeploymentConfigurationExtension class: Defines a project-level extension. The extension creates 
    '     a new deployment configuration that includes the upgrade deployment step.
    <Export(GetType(ISharePointProjectExtension))> _
    Friend Class DeploymentConfigurationExtension
        Implements ISharePointProjectExtension

        Private Sub Initialize(ByVal projectService As ISharePointProjectService) _
            Implements ISharePointProjectExtension.Initialize
            AddHandler projectService.ProjectInitialized, AddressOf ProjectInitialized
        End Sub

        ' Creates the new deployment configuration.
        Private Sub ProjectInitialized(ByVal Sender As Object, ByVal e As SharePointProjectEventArgs)
            Dim deploymentSteps As String() = New String() _
            {
                DeploymentStepIds.PreDeploymentCommand, _
                DeploymentStepIds.RecycleApplicationPool, _
                "Contoso.DeploymentSteps.UpgradeSolution", _
                DeploymentStepIds.PostDeploymentCommand _
            }
            Dim retractionSteps As String() = New String() _
            {
                DeploymentStepIds.RecycleApplicationPool, _
                DeploymentStepIds.RetractSolution
            }
            Dim configuration As IDeploymentConfiguration = e.Project.DeploymentConfigurations.Add( _
                "Upgrade", deploymentSteps, retractionSteps)
            configuration.Description = "This is the upgrade deployment configuration"
        End Sub

    End Class
End Namespace

using Microsoft.VisualStudio.SharePoint;
using Microsoft.VisualStudio.SharePoint.Deployment;
using System.ComponentModel.Composition;

namespace Contoso.DeploymentSteps.Upgrade
{
    // Enables Visual Studio to discover and load this project-level extension.
    [Export(typeof(ISharePointProjectExtension))]

    // Defines a project-level extension. The extension creates a new deployment configuration that includes the
    // upgrade deployment step.
    internal class DeploymentConfigurationExtension : ISharePointProjectExtension
    {
        // Implements ISharePointProjectExtension.Initialize.
        public void Initialize(ISharePointProjectService projectService)
        {
            projectService.ProjectInitialized += ProjectInitialized;
        }

        // Creates the new deployment configuration.
        private void ProjectInitialized(object sender, SharePointProjectEventArgs e)
        {
            string[] deploymentSteps = new string[] 
            {
                DeploymentStepIds.PreDeploymentCommand,
                DeploymentStepIds.RecycleApplicationPool,
                "Contoso.DeploymentSteps.UpgradeSolution",
                DeploymentStepIds.PostDeploymentCommand 
            };

            string[] retractionSteps = new string[] 
            {
                DeploymentStepIds.RecycleApplicationPool,
                DeploymentStepIds.RetractSolution                
            };

            IDeploymentConfiguration configuration = e.Project.DeploymentConfigurations.Add(
                "Upgrade", deploymentSteps, retractionSteps);
            configuration.Description = "This is the upgrade deployment configuration";
        }
    }
}

Tworzenie niestandardowych poleceń programu SharePoint

Utwórz dwa niestandardowe polecenia, odwołujących się do modelu obiektu serwera programu SharePoint.Jedno polecenie Określa, czy rozwiązanie jest już wdrożony; inne polecenia uaktualnienia rozwiązania.

Aby zdefiniować poleceń programu SharePoint

W SharePointCommands projekt, otwórz plik kod polecenia i następnie wklej następujący kod do niego.

Imports System
Imports System.IO
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Administration
Imports Microsoft.VisualStudio.SharePoint.Commands

Namespace Contoso.DeploymentSteps.Upgrade

    Friend Class Commands

        ' Determines whether the specified solution has been deployed to the local SharePoint server.
        <SharePointCommand("Contoso.Commands.IsSolutionDeployed")> _
        Private Function IsSolutionDeployed(ByVal context As ISharePointCommandContext, ByVal solutionName As String) As Boolean
            Dim solution As SPSolution = SPFarm.Local.Solutions(solutionName)
            Return solution IsNot Nothing
        End Function

        ' Upgrades the specified solution to the local SharePoint server.
        <SharePointCommand("Contoso.Commands.UpgradeSolution")> _
        Private Sub UpgradeSolution(ByVal context As ISharePointCommandContext, ByVal fullWspPath As String)
            Dim solution As SPSolution = SPFarm.Local.Solutions(Path.GetFileName(fullWspPath))
            If solution Is Nothing Then
                Throw New InvalidOperationException("The solution has not been deployed.")
            End If
            solution.Upgrade(fullWspPath)
        End Sub

    End Class
End Namespace

using System;
using System.IO;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;
using Microsoft.VisualStudio.SharePoint.Commands;

namespace Contoso.DeploymentSteps.Upgrade
{
    internal class Commands
    {
        // Determines whether the specified solution has been deployed to the local SharePoint server.
        [SharePointCommand("Contoso.Commands.IsSolutionDeployed")]
        private bool IsSolutionDeployed(ISharePointCommandContext context, string solutionName)
        {
            SPSolution solution = SPFarm.Local.Solutions[solutionName];
            return solution != null;
        }

        // Upgrades the specified solution to the local SharePoint server.
        [SharePointCommand("Contoso.Commands.UpgradeSolution")]
        private void UpgradeSolution(ISharePointCommandContext context, string fullWspPath)
        {
            SPSolution solution = SPFarm.Local.Solutions[Path.GetFileName(fullWspPath)];

            if (solution == null)
            {
                throw new InvalidOperationException("The solution has not been deployed.");
            }

            solution.Upgrade(fullWspPath);
        }
    }
}

Punkt kontrolny

W tym momencie w instruktażu, cały kod kroku wdrażania niestandardowego i poleceń programu SharePoint są teraz w projektach.Konstruuje się je, aby upewnić się, że ich skompilować bez błędów.

Tworzenie projektów

W Solution Explorer, otwórz menu skrótów dla DeploymentStepExtension projektu, a następnie wybierz budować.
Otwórz menu skrótów dla SharePointCommands projektu, a następnie wybierz budować.

Tworzenie rozszerzenia wdrożyć pakiet VSIX

Aby wdrożyć rozszerzenie, należy użyć projektu VSIX w swoje rozwiązanie tworzenia pakiet VSIX.Najpierw należy skonfigurować pakiet VSIX modyfikując plik source.extension.vsixmanifest w projekcie VSIX.Następnie utworzyć pakiet VSIX budowania rozwiązania.

Aby skonfigurować i utworzyć pakiet VSIX

W Solution Explorerpod UpgradeDeploymentStep projekt, otwórz menu skrótów dla source.extension.vsixmanifest pliku, a następnie wybierz Otwórz.

Visual Studio otwiera plik w edytorze manifestu.Plik source.extension.vsixmanifest jest podstawą dla pliku extension.vsixmanifest, które wymagają wszystkie pakiety VSIX.Aby uzyskać więcej informacji na temat tego pliku, zobacz VSIX rozszerzenie schematu odwołania.
W Nazwa produktu wprowadź Uaktualnić krok wdrażania projektów SharePoint.
W autora wprowadź Contoso.
W Opis wprowadź krok niestandardowych wdrożenia aktualizacji, które mogą być używane w projektach programu SharePoint zawiera.
W aktywów kartę Edytor, należy wybrać Nowa przycisk.

Dodać nowego środka pojawi się okno dialogowe.
W typu listy, wybierz opcję Microsoft.VisualStudio.MefComponent.

[!UWAGA]

Wartość ta odpowiada MefComponent elementu w pliku extension.vsixmanifest.Ten element Określa nazwę zestawu rozszerzeń w pakiecie VSIX.Aby uzyskać więcej informacji, zobacz MEFComponent Element.
W źródło listy, wybierz opcję projektu w bieżącym rozwiązaniem.
W Projekt listy, wybierz opcję DeploymentStepExtension, a następnie wybierz polecenie OK przycisk.
W edytorze manifestu, wybierz opcję Nowa przycisk ponownie.

Dodać nowego środka pojawi się okno dialogowe.
W typu listy, wprowadź SharePoint.Commands.v4.

[!UWAGA]

Ten element określa niestandardowe rozszerzenia, które chcesz dołączyć do rozszerzenia programu Visual Studio.Aby uzyskać więcej informacji, zobacz Element aktywów (schemat VSX).
W źródło listy, wybierz opcję projektu w bieżącym rozwiązaniem.
W Projekt listy, wybierz opcję SharePointCommands, a następnie wybierz polecenie OK przycisk.
Na pasku menu wybierz budować, Budowania rozwiązania, a następnie upewnij się, że rozwiązanie kompiluje się bez błędów.
Upewnij się, że folder wyjściowy kompilacji dla projektu UpgradeDeploymentStep zawiera teraz plik UpgradeDeploymentStep.vsix.

Domyślnie folder wyjściowy kompilacji jest...folder \bin\Debug w folderze, który zawiera plik projektu.

Przygotowanie do testowania aktualizacji etap wdrożenia

Aby przetestować etap wdrożenia aktualizacji, należy najpierw wdrożyć roztworu próbki w witrynie programu SharePoint.Rozpocznij debugowanie rozszerzenie w doświadczalnych wystąpienie programu Visual Studio.Następnie utworzyć listy definicji i instancji list do sprawdzenia etap wdrożenia, a następnie wdrażać je w witrynie programu SharePoint.Następnie modyfikować listy definicji i wystąpienie listy i ponownie rozmieścić je do wykazania, jak proces wdrażania domyślnie zastępuje rozwiązania w witrynie programu SharePoint.

Później w tym instruktażu będą wprowadzane zmiany definicji listy i wystąpienie listy, a następnie będziesz uaktualnić je w witrynie programu SharePoint.

Aby rozpocząć debugowanie rozszerzenia

Uruchom ponownie program Visual Studio z poświadczeniami administracyjnymi, a następnie otwórz rozwiązanie UpgradeDeploymentStep.
Projektu, DeploymentStepExtension, należy otworzyć plik UpgradeStep kod, a następnie Dodaj punkt przerwania w pierwszej linii kodu w CanExecute i Execute metody.
Rozpocząć debugowanie wybierając klawisz F5 lub, na pasku menu, wybierając Debug, Start Debugging.
Visual Studio instaluje rozszerzenie do %UserProfile%\AppData\Local\Microsoft\VisualStudio\11.0Exp\Extensions\Contoso\Upgrade etap wdrożenia dla SharePoint Projects\1.0 i uruchamia wystąpienie doświadczalnych Visual Studio.Będziesz test etap wdrożenia aktualizacji, w tym wystąpieniu programu Visual Studio.

Tworzenie projektu programu SharePoint z listy definicji i wystąpienie listy

Eksperymentalne wystąpienie programu Visual Studio, na pasku menu wybierz pliku, Nowa, Projekt.
W Nowy projekt okno dialogowe rozwiń Visual C# węzła lub języka Visual Basic węzła, rozwiń węzeł SharePoint węzła, a następnie wybierz 2010 węzła.
Upewnij się, że u góry okna dialogowego, .NET Framework 3.5 pojawia się na liście wersje.NET Framework.

Projekty dla Microsoft SharePoint Foundation 2010 i Microsoft SharePoint Server 2010 wymaga ta wersja programu.NET Framework.
Na liście szablonów projektu, wybierz Programu SharePoint 2010 projektu, nazwa projektu EmployeesListDefinition, a następnie wybierz polecenie OK przycisk.
W Kreatora dostosowania programu SharePoint, wprowadź adres URL witryny, którą chcesz używać do debugowania.
Pod jaki jest poziom zaufania dla tego rozwiązania programu SharePoint, wybierz opcję Wdrażanie rozwiązań gospodarstwa jako przycisku opcji.

[!UWAGA]

Etap wdrożenia aktualizacji nie obsługuje rozwiązania w trybie piaskownicy.
Wybierz wykończenie przycisk.

Visual Studiotworzy projekt EmployeesListDefinition.
Otwórz menu skrótów dla projektu EmployeesListDefinition, wybierz polecenie Dodaj, a następnie wybierz polecenie Nowego elementu.
W Dodaj nowy element-EmployeesListDefinition okno dialogowe rozwiń SharePoint węzła, a następnie wybierz polecenie 2010 węzła.
Wybierz Lista przedmiotu szablonu, nazwa elementu Listy pracowników, a następnie wybierz Dodaj przycisk.

Zostanie wyświetlony Kreator dostosowania programu SharePoint
Na Wybierz ustawienia listy strony, sprawdź następujące ustawienia, a następnie wybierz wykończenie przycisku:
1. Lista pracowników pojawia się w jaką nazwę chcesz wyświetlić na liście? pole.
2. Tworzenia listy można dostosować na podstawie: przycisk opcji jest wybrany.
3. Domyślne (puste) jest wybrany w tworzenia listy można dostosować na podstawie: listy.
Visual StudioTworzy element listy pracowników z tytułu kolumny i pojedyncze wystąpienie pusty i zostanie otwarty projektant listy.
Projektant listy na kolumny tab, wybrać Wpisz nazwę nowej lub istniejącej kolumny wiersza, a następnie dodaj następujące kolumny w Nazwa wyświetlana kolumna listy:
1. Imię
2. Firma
3. Telefon służbowy
4. Wiadomości e-Mail
Zapisz wszystkie pliki, a następnie zamknij projektanta listy.
W Solution Explorer, rozwiń węzeł Listy pracowników węzła, a następnie rozwiń węzeł Wystąpienie listy pracowników węzła podrzędnego.

W pliku Elements.xml zastąpić domyślne XML w tym pliku następujący kod XML.Ten XML zmienia nazwę na liście, aby pracowników i dodaje informacje dla pracownika, który ma o nazwie Jan Kowalski.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <ListInstance Title="Employees"
                OnQuickLaunch="TRUE"
                TemplateType="10000"
                Url="Lists/Employees"
                Description="Simple list to test upgrade deployment step">
    <Data>
      <Rows>
        <Row>
          <Field Name="Title">Hance</Field>
          <Field Name="FirstName">Jim</Field>
          <Field Name="Company">Contoso</Field>
          <Field Name="Business Phone">555-555-5555</Field>
          <Field Name="E-Mail">jim@contoso.com</Field>
        </Row>
      </Rows>
    </Data>
  </ListInstance>
</Elements>

Zapisz i zamknij plik Elements.xml.
Otwórz menu skrótów dla projektu EmployeesListDefinition, a następnie wybierz Otwórz lub Właściwości.

Zostanie otwarty projektant właściwości.
Na SharePoint kartę, a następnie kliknij polecenie Wyczyść wycofać Auto po pole wyboru, a następnie Zapisz właściwości.

Aby wdrożyć definicji listy i lista instancji

W Solution Explorer, wybierz opcję EmployeesListDefinition węzła projektu.
W Właściwości okna, upewnij się, że Konfiguracji wdrażania usługi Active właściwość jest ustawiona na domyślne.
Wybierz klawisz F5 lub, na pasku menu wybierz Debug, Start Debugging.
Sprawdź, że projekt pomyślnie buduje, że przeglądarka sieci web otwiera się w witrynie programu SharePoint, która zawiera listę element na pasku Szybkie uruchamianie zawiera nowe pracowników listy, a pracowników lista zawiera zapis Jan Kowalski.
Zamknij przeglądarkę sieci web.

Aby zmodyfikować listę definicji i wystąpienie listy i ponownie je rozmieścić

W programie project EmployeesListDefinition, otwórz plik Elements.xml, który jest elementem podrzędnym Wystąpienie listy pracowników element projektu.

Usuń Data elementu i jego elementy podrzędne, aby usunąć wpis dla Jan Kowalski z listy.

Gdy skończysz, plik powinien zawierać następujące XML.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <ListInstance Title="Employees"
                OnQuickLaunch="TRUE"
                TemplateType="10000"
                Url="Lists/Employees"
                Description="Simple list to test upgrade deployment step">
  </ListInstance>
</Elements>

Zapisz i zamknij plik Elements.xml.
Otwórz menu skrótów dla Listy pracowników towary do projektu, a następnie wybierz Otwórz lub Właściwości.
Projektant listy wybierz Widoki kartę.
W Wybrane kolumny listy, wybierz opcję Załączniki, a następnie wybierz polecenie < klawisz, aby przenieść kolumnę, w celu Dostępne kolumny listy.
Powtórz poprzedni krok, aby przenieść Telefon służbowy kolumny z Wybrane kolumny listy do Dostępne kolumny listy.

Ta akcja powoduje usunięcie tych pól w widoku domyślnym z pracowników listy w witrynie programu SharePoint.
Rozpocząć debugowanie wybierając klawisz F5 lub, na pasku menu, wybierając Debug, Start Debugging.
Sprawdź, czy Konflikty wdrażania pojawi się okno dialogowe.

To okno dialogowe pojawia się kiedy Visual Studio próbuje wdrożyć rozwiązanie (instancji list) w witrynie programu SharePoint, do którego zostały już wdrożone rozwiązanie.To okno dialogowe nie są wyświetlane podczas wykonywania kroku wdrażania uaktualnień później w tym instruktażu.
W Konflikty wdrażania okno dialogowe Wybierz Rozwiązać automatycznie przycisku opcji.

Visual Studio usuwa wystąpienie listy w witrynie programu SharePoint, wdraża elementu listy w projekcie, a następnie otworzy witryny programu SharePoint.
W zawiera listę sekcji paska szybkiego uruchamiania wybierz pracowników listy, a następnie sprawdź następujące dane:
- Załączniki i Telefon domowy kolumny nie są wyświetlane w tym widoku listy.
- Lista jest pusta.Kiedy używane domyślne Konfiguracja wdrażania ponownie wdrażać rozwiązania, pracowników listy został zastąpiony nową pustą listę w projekcie.

Testowanie etap wdrożenia

Teraz można przystąpić do badania etap wdrożenia aktualizacji.Po pierwsze należy dodać element do instancji list programu SharePoint.Następnie zmień listę definicji i instancji list, uaktualnić je w witrynie programu SharePoint i potwierdzić, że etap wdrożenia aktualizacji nie nadpisuje nowy element.

Aby ręcznie dodać element do listy

Na Wstążce w witrynie programu SharePoint w obszarze Listę narzędzi tab, wybrać elementów kartę.
W Nowa grupy, wybierz opcję Nowego elementu.

Alternatywnie, można wybrać Dodaj nowy element łącza na liście element sam.
W pracowników-nowy element okno, w Tytuł wprowadź Menedżera obiektów.
W Imię wprowadź Adama.
W firmy wpisz Contoso.
Wybierz zapisać przycisk, sprawdź, czy na liście pojawi się nowy element, a następnie zamknij przeglądarkę sieci web.

Później w tym instruktażu będzie użyć tej funkcji, aby zweryfikować, że etap wdrożenia aktualizacji nie zastąpienie zawartości tej listy.

Aby przetestować etap wdrożenia aktualizacji

Eksperymentalne wystąpienie programu Visual Studio w Solution Explorer, otwórz menu skrótów dla EmployeesListDefinition projektu węzła, a następnie wybierz Właściwości.

Otwiera Edytor właściwości/projektanta.
Na SharePoint kartę, należy ustawić Konfiguracji wdrażania usługi Active właściwość, aby uaktualnienia.

Ta konfiguracja wdrażania niestandardowego zawiera nowy etap wdrożenia aktualizacji.
Otwórz menu skrótów dla Listy pracowników towary do projektu, a następnie wybierz Właściwości lub Otwórz.

Otwiera Edytor właściwości/projektanta.
Na Widoki tab, wybrać E-Mail kolumny, a następnie wybierz < klawisz, aby przenieść tej kolumny z Wybrane kolumny listy do Dostępne kolumny listy.

Ta akcja powoduje usunięcie tych pól w widoku domyślnym z pracowników listy w witrynie programu SharePoint.
Rozpocząć debugowanie wybierając klawisz F5 lub, na pasku menu, wybierając Debug, Start Debugging.
Sprawdź, że kod w inne wystąpienie programu Visual Studio zatrzymuje się na punkt przerwania, które wcześniej w zestaw CanExecute metoda.
Ponownie wybierz klawisz F5 lub, na pasku menu wybierz Debug, Kontynuuj.
Sprawdź, że kod zatrzymuje się na punkt przerwania, które wcześniej w zestaw Execute metoda.
Wybierz klawisz F5 lub, na pasku menu wybierz Debug, Kontynuuj raz ostatni.

Przeglądarka sieci web otwiera witrynę programu SharePoint.
W zawiera listę sekcji obszaru szybkiego uruchamiania wybierz pracowników listy, a następnie sprawdź następujące dane:
- Element dodane ręcznie (dla Andy, Menedżer urządzeń) ma jeszcze na liście.
- Telefon służbowy i Adres E-mail kolumny nie są wyświetlane w tym widoku listy.
Uaktualnienia Konfiguracja wdrażania modyfikuje istniejący pracowników instancji list w witrynie programu SharePoint.Jeśli użyto domyślne Konfiguracja wdrażania zamiast uaktualnienia konfiguracji, może pojawić się konflikt wdrażania.Visual Studio by rozwiązać konflikt, zastępując pracowników listy i element do Adama, Menedżer urządzeń, będą usuwane.

Oczyszczanie na komputerze deweloperskim

Po zakończeniu badania etap wdrożenia aktualizacji, Usuń wystąpienie listy i definicji listy w witrynie programu SharePoint i usunąć rozszerzenie kroku wdrażania z programu Visual Studio.

Aby usunąć wystąpienie listy w witrynie programu SharePoint

Otwórz pracowników listy w witrynie programu SharePoint, jeśli lista nie jest jeszcze otwarty.
Na Wstążce w witrynie programu SharePoint, należy wybrać Listę narzędzi kartę, a następnie wybierz Lista kartę.
W Ustawienia grupy, wybierz opcję Ustawienia listy przedmiotu.
Pod uprawnienia i zarządzanie, wybierz opcję usunąć tę listę polecenia, wybierz opcję OK potwierdzić, że chcesz wysłać listy do Kosza, a następnie zamknij przeglądarkę sieci web.

Aby usunąć definicji listy w witrynie programu SharePoint

Eksperymentalne wystąpienie programu Visual Studio, na pasku menu wybierz budować, anulowanie.

Visual Studio chowa definicji listy w witrynie programu SharePoint.

Aby odinstalować rozszerzenie

Eksperymentalne wystąpienie programu Visual Studio, na pasku menu wybierz Narzędzia, rozszerzenia i aktualizacje.

Rozszerzenia i aktualizacje zostanie otwarte okno dialogowe.
Na liście Rozszerzenia wybierz Uaktualnić krok wdrażania projektów SharePoint, a następnie wybierz odinstalować polecenia.
W wyświetlonym oknie dialogowym wybierz Tak , aby potwierdzić, że chcesz odinstalować rozszerzenie, a następnie wybierz Uruchom ponownie teraz do ukończenia dezinstalacji.
Zamknij oba wystąpienia programu Visual Studio (wystąpienie eksperymentalnych i wystąpienie programu Visual Studio, w którym roztwór UpgradeDeploymentStep jest otwarty).

Zobacz też

Koncepcje

Rozszerzanie programu SharePoint, pakowania i rozmieszczania

Udostępnij za pośrednictwem

Instruktaż: Tworzenie kroku wdrożenia niestandardowe dla projektów programu SharePoint

Wymagania wstępne

Tworzenie projektów

Aby utworzyć projekt VSIX

Aby utworzyć rozszerzenie projektu

Tworzenie projektu polecenia programu SharePoint

Konfigurowanie projektów

Aby skonfigurować projektu DeploymentStepExtension

Aby skonfigurować projektu SharePointCommands

Definiowanie etap wdrożenia niestandardowe

Aby zdefiniować etap wdrożenia niestandardowe

Tworzenie konfiguracji wdrażania, które obejmuje etap wdrożenia niestandardowe

Aby utworzyć Konfiguracja wdrażania

Tworzenie niestandardowych poleceń programu SharePoint

Aby zdefiniować poleceń programu SharePoint

Punkt kontrolny

Tworzenie projektów

Tworzenie rozszerzenia wdrożyć pakiet VSIX

Aby skonfigurować i utworzyć pakiet VSIX

Przygotowanie do testowania aktualizacji etap wdrożenia

Aby rozpocząć debugowanie rozszerzenia

Tworzenie projektu programu SharePoint z listy definicji i wystąpienie listy

Aby wdrożyć definicji listy i lista instancji

Aby zmodyfikować listę definicji i wystąpienie listy i ponownie je rozmieścić

Testowanie etap wdrożenia

Aby ręcznie dodać element do listy

Aby przetestować etap wdrożenia aktualizacji

Oczyszczanie na komputerze deweloperskim

Aby usunąć wystąpienie listy w witrynie programu SharePoint

Aby usunąć definicji listy w witrynie programu SharePoint

Aby odinstalować rozszerzenie

Zobacz też

Koncepcje

Dodatkowe zasoby