Návod: Vytvoření vlastního kroku nasazení pro projekty SharePoint

Článek
06/08/2015

Při nasazení projektu služby SharePoint, Visual Studio provede řadu kroků nasazení v určitém pořadí.Visual Studio obsahuje mnoho vestavěné kroky nasazení, ale můžete také vytvořit vlastní.

V tomto návodu vytvoříte vlastní krok nasazení řešení na serveru se spuštěnou službou SharePoint pro upgrade.Visual Studio obsahuje vestavěné kroky nasazení pro mnoho úkolů, takové svorkování nebo přidání řešení, ale neobsahují krok nasazení pro upgrade řešení.Ve výchozím nastavení, při nasazení řešení služby SharePoint, Visual Studio nejprve procházející řešení (Pokud již je nasazen) a potom redeploys celého řešení.Další informace o nasazení vestavěné kroky viz Nasazení, publikování a upgradování balíčků řešení služby SharePoint.

Tento návod demonstruje následující úkoly:

Vytvoření rozšíření aplikace Visual Studio, které provádí dvě hlavní úlohy:
- Rozšíření definuje vlastní krok nasazení řešení SharePoint upgradovat.
- Rozšíření vytvoří rozšíření projektu, který definuje nové konfigurace nasazení je sada kroků nasazení, které jsou u daného projektu.Nové konfigurace nasazení zahrnuje kroku vlastního nasazení a několik vestavěné kroky nasazení.
Vytvoření dvou vlastních příkazů služby SharePoint, které volá sestavení rozšíření.Příkazy služby SharePoint jsou metody, které mohou být volány sestavení rozšíření pro SharePoint použít rozhraní API v objektovém modelu serveru.Další informace naleznete v tématu Volání do objektových modelů služby SharePoint.
Vytváření balíčku rozšíření aplikace Visual Studio (VSIX) k nasazení obě sestavení.
Testování nového kroku nasazení.

Požadavky

Ve vývojovém počítači potřebujete následující součásti pro dokončení tohoto návodu:

Podporované edice systému Windows, SharePoint a Visual Studio.Další informace naleznete v tématu Požadavky na vývoj řešení služby SharePoint.
Visual Studio SDK.Tento návod používá šablonu Projektu VSIX v sadě SDK pro vytvoření balíčku VSIX k nasazení rozšíření.Další informace naleznete v tématu Rozšíření nástrojů SharePoint v aplikaci Visual Studio.

Znalost následujících konceptů je užitečná, ale není požadována k dokončení návodu:

Pomocí objektového modelu serveru SharePoint.Další informace naleznete v použití objektového modelu serveru SharePoint Foundation Server-Side.
Řešení SharePoint.Další informace naleznete v Přehled řešení.
Upgrade řešení SharePoint.Další informace naleznete v upgrade řešení.

Vytváření projektů

Chcete-li dokončit tento návod, musíte vytvořit tři projekty:

Projekt VSIX k vytvoření balíčku VSIX k nasazení rozšíření.
Projekt knihovny tříd, který implementuje rozšíření.Tento projekt musí cílová 4.5 rozhraní .NET Framework.
Projekt knihovny tříd, který definuje vlastní příkazy služby SharePoint.Tento projekt musí cíl 3.5 rozhraní.NET Framework.

Začněte postup vytvořením projektů.

Pro vytvoření projektu VSIX

Spusťte nástroj Visual Studio.
Na panelu nabídek zvolte soubor, Nový, projektu.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic uzly a pak zvolte rozšíření uzlu.

[!POZNÁMKA]

Rozšíření uzel je k dispozici pouze v případě, že nainstalujete Visual Studio SDK.Další informace naleznete v části požadavky dříve v tomto tématu.
V horní části dialogového okna zvolte .NET Framework 4.5 v seznamu verze rozhraní.NET Framework.
Zvolte Projektu VSIX šablony, název projektu UpgradeDeploymentStepa pak zvolte OK tlačítko.

Visual StudioPřidá UpgradeDeploymentStep projektu Průzkumníku.

Chcete-li vytvořit projekt rozšíření

V Průzkumníku, otevřete místní nabídku pro uzel UpgradeDeploymentStep řešení, zvolte Přidata pak zvolte Nový projekt.

[!POZNÁMKA]

V projektech v jazyce Visual Basic se uzel řešení zobrazí v Průzkumníku řešení pouze pokud je označeno zaškrtávací políčko Vždy zobrazit řešeníObecné – Projekty a řešení – dialogové okno Možnosti.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic uzly a pak zvolte Windows uzlu.
V horní části dialogového okna zvolte .NET Framework 4.5 v seznamu verze rozhraní.NET Framework.
Zvolte Knihovny tříd šablonu projektu, název projektu DeploymentStepExtensiona pak zvolte OK tlačítko.

Visual StudioPřidá DeploymentStepExtension projekt do řešení a otevře soubor výchozího kódu Class1.
Odstraňte soubor kódu Class1 z projektu.

Vytvoření příkazu projektu SharePoint

V Průzkumníku, otevřete místní nabídku pro uzel UpgradeDeploymentStep řešení, zvolte Přidata pak zvolte Nový projekt.

[!POZNÁMKA]

V projekty Visual Basic uzel řešení pouze zobrazí v Průzkumníku když vždy zobrazit řešení políčko v Obecné – Projekty a řešení – dialogové okno Možnosti.
V Nový projekt dialogovém okně rozbalte Visual C# nebo Visual Basica pak zvolte Windows uzlu.
V horní části dialogového okna zvolte 3.5 rozhraní.NET Framework v seznamu verze rozhraní.NET Framework.
Zvolte Knihovny tříd šablonu projektu, název projektu SharePointCommandsa pak zvolte OK tlačítko.

Visual Studio přidá SharePointCommands projekt do řešení a otevře soubor výchozího kódu Class1.
Odstraňte soubor kódu Class1 z projektu.

Konfigurace projektů

Před napsáním kódu vytvořit krok nasazení vlastní musíte přidat soubory kódu a odkazy na sestavení a je nutné konfigurovat projekty.

Konfigurace projektu DeploymentStepExtension

V DeploymentStepExtension projektu, přidejte dva soubory kódu, které mají následující názvy:
- UpgradeStep
- DeploymentConfigurationExtension
Otevření místní nabídky na DeploymentStepExtension projektu a pak zvolte Přidat odkaz.
Na Framework karta, zaškrtněte políčko pro sestavení System.ComponentModel.Composition.
Na rozšíření karta, zaškrtněte políčko pro sestavení Microsoft.VisualStudio.SharePoint a pak zvolte OK tlačítko.

Konfigurace projektu SharePointCommands

V SharePointCommands projektu, přidejte v souboru kódu s názvem příkazy.
V Průzkumníku, otevřete místní nabídku na SharePointCommands uzel projektu a pak zvolte Přidat odkaz.
Na rozšíření karta, zaškrtněte políčka pro následující sestavení a pak zvolte klepnutím OK tlačítko
- Microsoft.SharePoint
- Microsoft.VisualStudio.SharePoint.Commands

Definování vlastního kroku nasazení

Vytvořte třídu, která definuje krok nasazení upgrade.Definovat krok nasazení třída implementuje IDeploymentStep rozhraní.Implementujte toto rozhraní pokaždé, když chcete definovat vlastní krok nasazení.

Definovat kroku vlastního nasazení

V DeploymentStepExtension projektu, otevřete soubor kódu UpgradeStep a poté do něj vložte následující kód.

[!POZNÁMKA]

Po přidání tohoto kódu, bude mít projekt několik chyb kompilace, ale budete okamžitě přejít po přidání kódu v dalších krocích.

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);
        }
    }
}

Vytvoření konfigurace nasazení, který zahrnuje Custom Deployment Step

Vytvořte rozšíření projektu pro nové konfigurace nasazení, který zahrnuje několik vestavěné kroky nasazení a upgrade nasazení nového kroku.Vytvořením rozšíření této pomoci vývojářům SharePoint použít krok nasazení upgrade projektů SharePoint.

Chcete-li vytvořit konfiguraci nasazení, třída implementuje ISharePointProjectExtension rozhraní.Implementujte toto rozhraní pokaždé, když vytvoříte rozšíření projektu SharePoint.

Chcete-li vytvořit konfiguraci nasazení

V DeploymentStepExtension projektu, otevřete soubor kódu DeploymentConfigurationExtension a poté do něj vložte následující kód.

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";
        }
    }
}

Vytvoření vlastních příkazů služby SharePoint

Vytvoření dvou vlastních příkazů, které volají do objektového modelu serveru SharePoint.Jeden příkaz určuje, zda již nasazení řešení; ostatní příkaz upgrade řešení.

Chcete-li definovat příkazy služby SharePoint

V SharePointCommands projektu, otevřete soubor kódu příkazy a pak do něj vložte následující kód.

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);
        }
    }
}

Checkpoint

V tomto bodě návodu, jsou všechny kód kroku vlastního nasazení a příkazy služby SharePoint projektů.Sestavení je zajistit, že zkompiluje bez chyb.

Chcete-li sestavit projekty

V Průzkumníku, otevřete místní nabídku pro DeploymentStepExtension projektu a pak zvolte sestavení.
Otevření místní nabídky SharePointCommands projektu a pak zvolte sestavení.

Vytvoření balíčku VSIX k nasazení přípony

Chcete-li nasadit rozšíření, použijte VSIX projekt ve vašem řešení k vytvoření VSIX balíčku.Nejprve nakonfigurujte VSIX balíček úpravou souboru source.extension.vsixmanifest v projektu VSIX.Potom vytvořte VSIX balíček vytvořením řešení.

Chcete-li konfigurovat a vytvořit balíček VSIX

V Průzkumníkupod UpgradeDeploymentStep projektu, otevřete místní nabídku pro source.extension.vsixmanifest souboru a pak zvolte otevřete.

Visual Studio otevře soubor v editoru manifestu.Soubor source.extension.vsixmanifest je základem pro soubor extension.vsixmanifest, který vyžadují všechny balíčky VSIX.Další informace o tomto souboru získáte v tématu VSIX rozšíření schématu Reference.
V Název produktu zadejte Upgrade krok nasazení pro projekty SharePoint.
V Autor zadejte Contoso.
V Popis zadejte vlastní upgrade krok nasazení, lze použít v projektech SharePoint poskytuje.
V majetku kartě Editor, zvolte Nový tlačítko.

Přidat nový majetek zobrazí se dialogové okno.
V typu seznam, zvolte Microsoft.VisualStudio.MefComponent.

[!POZNÁMKA]

Tato hodnota odpovídá prvku MefComponent v souboru extension.vsixmanifest file.Tento prvek určuje název sestavení rozšíření v balíčku VSIX.Další informace naleznete v tématu MEFComponent Element.
V zdroje seznam, zvolte projektu v aktuálním řešení.
V projektu seznam, zvolte DeploymentStepExtensiona pak zvolte OK tlačítko.
Zvolte v editoru manifestu Nový znovu na tlačítko.

Přidat nový majetek zobrazí se dialogové okno.
V typu seznam, zadejte SharePoint.Commands.v4.

[!POZNÁMKA]

Tento prvek určuje vlastní rozšíření, které chcete zahrnout do rozšíření aplikace Visual Studio.Další informace naleznete v tématu Prvek majetku (VSX schéma).
V zdroje seznam, zvolte projektu v aktuálním řešení.
V projektu seznam, zvolte SharePointCommandsa pak zvolte OK tlačítko.
Na panelu nabídek zvolte sestavení, Sestavit řešenía ujistěte se, že řešení zkompiluje bez chyb.
Zkontrolujte složku výstupu sestavení pro projekt UpgradeDeploymentStep nyní obsahuje soubor UpgradeDeploymentStep.vsix.

Ve výchozím nastavení je výstupní složka sestavení\bin\Debug složka pod složkou, která obsahuje soubor projektu.

Příprava testování upgradu krok nasazení

Testování krok nasazení upgrade, je nejprve nutné zavést roztoku vzorku webu služby SharePoint.Spusťte ladění rozšíření v experimentální instanci Visual Studio.Vytvořit seznam definici a instanci seznamu použít k testování krok nasazení a poté nasadit na web služby SharePoint.Dále upravit definice seznamu a instanci seznamu a znovu nasadit jim ukazují, jak přepíše výchozí proces nasazení řešení na webu služby SharePoint.

Dále v tomto návodu budete upravovat seznam definici a instanci seznamu a potom si budete inovovat na webu služby SharePoint.

Chcete-li začít ladit rozšíření

Restartujte aplikaci Visual Studio s pověřeními pro správu a otevřete řešení UpgradeDeploymentStep.
V projektu DeploymentStepExtension otevřete soubor kódu UpgradeStep a potom přidejte zarážku do prvního řádku kódu v CanExecute a Execute metod.
Spuštění ladění pomocí klávesy F5 nebo panel nabídek, výběr ladění, Spuštění ladění.
Visual Studio nainstaluje rozšíření do %UserProfile%\AppData\Local\Microsoft\VisualStudio\11.0Exp\Extensions\Contoso\Upgrade krok nasazení pro SharePoint Projects\1.0 a spustí experimentální instanci aplikace Visual Studio.Krok nasazení upgradu budete testovat v této instanci aplikace Visual Studio.

Definice seznamu a instanci seznamu vytvořit projekt služby SharePoint

V experimentální instanci Visual Studio v řádku nabídek zvolte soubor, Nový, projektu.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# uzel nebo jazyka Visual Basic uzel, rozbalte SharePoint uzlu a pak zvolte 2010 uzlu.
V horní části dialogového okna, ujistěte se, že rozhraní.NET Framework 3.5 se zobrazí v seznamu verze rozhraní.NET Framework.

Projekty pro Microsoft SharePoint Foundation 2010 a Microsoft SharePoint Server 2010 vyžadují tuto verzi rozhraní.NET Framework.
V seznamu šablon projektu zvolte Projektu služby SharePoint 2010, název projektu EmployeesListDefinitiona pak zvolte OK tlačítko.
V SharePoint Průvodce vlastním nastavením, zadejte adresu URL webu, který chcete použít pro ladění.
Podle Co je úroveň důvěryhodnosti pro toto řešení SharePoint, zvolte nasadit jako řešení farmy přepínač.

[!POZNÁMKA]

Krok nasazení upgrade nepodporuje řešení v izolovaném prostoru.
Zvolte Dokončit tlačítko.

Visual StudioVytvoří projekt EmployeesListDefinition.
Otevření místní nabídky pro projekt EmployeesListDefinition, zvolte Přidata pak zvolte Nová položka.
V Přidat novou položku – EmployeesListDefinition dialogové okno pole, rozbalte položku SharePoint uzel a pak zvolte 2010 uzlu.
Zvolte seznam šablony položky, název položky Seznam zaměstnancůa pak zvolte Přidat tlačítko.

Zobrazí se Průvodce nastavením služby SharePoint
Na Nastavení seznamu zvolte stránky, ověřte následující nastavení a pak zvolte Dokončit tlačítka:
1. Seznam zaměstnanců se zobrazí v Jaký název chcete zobrazit seznam? pole.
2. Vytvořit přizpůsobitelné seznam založený na: je zvolen přepínač.
3. Výchozí (prázdné) zvolena vytvořit přizpůsobitelné seznam založený na: seznamu.
Visual StudioVytvoří záhlaví sloupce a jednu instanci prázdné položky seznamu zaměstnanců a otevře se Návrhář seznamu.
V Návrháři seznamu na sloupce , vyberte do nové nebo existující sloupec název řádku a poté přidat následující sloupce v Název zobrazení sloupce seznam:
1. Křestní jméno
2. Společnost
3. Telefon do zaměstnání
4. E-mailu
Uložit všechny soubory a potom zavřete Návrhář seznamu.
V Průzkumníku, rozbalte Seznam zaměstnanců uzlu a potom rozbalte Instanci seznamu zaměstnanců podřízený uzel.

Nahraďte výchozí XML v tomto souboru v souboru Elements.xml následujícím XML.Tento XML změní název v seznamu zaměstnanci a přidá informace pro zaměstnance, který má s názvem Jan Hance.

<?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>

Uložte a zavřete soubor Elements.xml.
Otevření místní nabídky pro projekt EmployeesListDefinition a pak zvolte Open nebo Vlastnosti.

Otevře se Návrhář vlastnosti.
Na SharePoint kartu vymazat odvolání automaticky po ladění políčko a pak uložit vlastnosti.

Definice seznamu a instanci seznamu nasazení

V Průzkumníku, zvolte EmployeesListDefinition uzel projektu.
V Vlastnosti okna, ujistěte se, že Aktivní konfigurace nasazení vlastnost výchozí.
Zvolte klávesu F5, nebo v řádku nabídek zvolte ladění, Spuštění ladění.
Ověřte úspěšně sestavení projektu, že webový prohlížeč otevře web služby SharePoint, seznamy obsahuje nové položky na panelu Snadné spuštění zaměstnanci seznamu a zaměstnanci seznam obsahuje položky pro Jan Hance.
Zavřete webový prohlížeč.

Upravit seznam definici a instanci seznamu a znovu je zavést

V projektu EmployeesListDefinition otevřete soubor Elements.xml, který je podřízeným Instanci seznamu zaměstnance položky projektu.

Odebrat Data prvek a jeho podřízené položky ze seznamu odeberte položku pro Jan Hance.

Po dokončení soubor by měl obsahovat následující kód 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>

Uložte a zavřete soubor Elements.xml.
Otevření místní nabídky pro Seznam zaměstnanců položku projektu a pak zvolte Otevřít nebo Vlastnosti.
V Návrháři seznamu zvolte zobrazení kartu.
V vybrané sloupce seznam, zvolte přílohya pak zvolte < Přesunutí sloupce na klíč sloupce k dispozici seznamu.
Opakujte předchozí krok přesunout Telefon sloupec z vybrané sloupce seznamu sloupce k dispozici seznamu.

Tato akce odebere z výchozí zobrazení těchto polí zaměstnanci seznam na webu služby SharePoint.
Spuštění ladění pomocí klávesy F5 nebo panel nabídek, výběr ladění, Spuštění ladění.
Ověřte, zda Konflikty nasazení zobrazí se dialogové okno.

Web služby SharePoint, které již byla nasazena řešení zobrazí toto dialogové při Visual Studio se pokusí zavést řešení (seznam instance).Toto dialogové okno se nezobrazí při spuštění kroku nasazení upgrade později v tomto návodu.
V Konflikty nasazení dialogovém okně zvolte Vyřešit automaticky přepínač.

Visual Studio odstraní instanci seznamu na webu služby SharePoint, nasadí položky seznamu v projektu a otevře web služby SharePoint.
V seznam části panelu Snadné spuštění zvolte zaměstnanci seznamu a potom ověřte následující podrobnosti:
- Přílohy a Telefon domů sloupce se nezobrazí v tomto zobrazení seznamu.
- Seznam je prázdný.Při použití výchozí konfigurace nasazení znovu nasazovat řešení, zaměstnanci seznam byl nahrazen v projektu nový prázdný seznam.

Testování krok nasazení

Nyní jste připraveni k testování krok nasazení upgrade.Nejprve přidejte položku pro instanci seznamu služby SharePoint.Definice seznamu a instanci seznamu změnit, je upgrade na webu služby SharePoint a potvrdit, že krok nasazení upgrade není přepsat novou položku.

Ručně přidat položku do seznamu

V pásu karet na webu služby SharePoint pod Nástroje seznamu , vyberte položky kartu.
V Nový skupinu, zvolte Nová položka.

Jako alternativu můžete použít Přidat novou položku odkaz v samotném seznamu položek.
V zaměstnanci – nová položka okno, v název zadejte Správce zařízení.
V jméno zadejte Martin.
V společnosti zadejte Contoso.
Zvolte Uložit tlačítko, ověřte, že nové položky se zobrazí v seznamu a potom zavřete webový prohlížeč.

Dále v tomto návodu použijete tuto položku ověřit, že krok nasazení upgrade není přepsání obsahu tohoto seznamu.

Testování krok nasazení upgrade

V experimentální instanci Visual Studio v Průzkumníku, otevřete místní nabídku pro EmployeesListDefinition uzel projektu a pak zvolte Vlastnosti.

Otevře se Editor vlastností/Designer.
Na SharePoint karta, nastavit Aktivní konfigurace nasazení vlastnost Upgrade.

Konfigurace vlastního nasazení obsahuje nový krok nasazení upgrade.
Otevření místní nabídky pro Seznam zaměstnanců položku projektu a pak zvolte Vlastnosti nebo Otevřít.

Otevře se Editor vlastností/Designer.
Na zobrazení , vyberte E-Mail sloupec a pak zvolte < klíč přesunout daný sloupec z vybrané sloupce seznamu sloupce k dispozici seznamu.

Tato akce odebere z výchozí zobrazení těchto polí zaměstnanci seznam na webu služby SharePoint.
Spuštění ladění pomocí klávesy F5 nebo panel nabídek, výběr ladění, Spuštění ladění.
Ověřte, že se kód ve druhé instanci aplikace Visual Studio zastaví na zarážce, kterou jste nastavili výše v metodě CanExecute.
Zvolte klávesu F5 znovu nebo zvolte na panelu nabídek ladění, pokračovat.
Ověřte, že kód zastaví na zarážce, kterou jste nastavili výše v Execute metoda.
Zvolte klávesu F5, nebo v řádku nabídek zvolte ladění, pokračovat konečný čas.

Webový prohlížeč otevře web služby SharePoint.
V seznam části oblasti snadné zvolit zaměstnanci seznamu a potom ověřte následující podrobnosti:
- Zboží, které jste přidali ručně (pro Andy Správce zařízení) je stále v seznamu.
- Telefon a E-mailovou adresu sloupce se nezobrazí v tomto zobrazení seznamu.
Upgrade konfigurace nasazení změní existující zaměstnanci instanci seznamu na webu služby SharePoint.Pokud jste použili výchozí konfigurace nasazení místo Upgrade konfigurace by nastat konflikt nasazení.Visual Studio by konflikt vyřešit nahrazením zaměstnanci chcete odstranit seznam a položky pro Andy Správce zařízení.

Čištění vývojového počítače

Po dokončení testování krok nasazení upgrade instance seznam a definice seznamu odebrat z webu služby SharePoint a odebrat rozšíření krok nasazení ze sady Visual Studio.

Chcete-li odebrat instanci seznamu z webu služby SharePoint

Otevřít zaměstnanci seznam na webu služby SharePoint, pokud již není otevřený seznam.
V pásu karet na webu služby SharePoint, zvolte Nástroje seznamu kartu a pak zvolte seznam kartu.
V Nastavení skupinu, zvolte Nastavení seznamu zboží.
Podle oprávnění a správa, zvolte Odstranit tento seznam příkaz, zvolte OK potvrďte, že chcete odeslat seznam do odpadkového koše a poté zavřete webový prohlížeč.

Definice seznamu odebrat z webu služby SharePoint

V experimentální instanci Visual Studio v řádku nabídek zvolte sestavení, odvolání.

Visual Studio procházející definice seznamu z webu služby SharePoint.

Chcete-li odinstalovat rozšíření

V experimentální instanci Visual Studio v řádku nabídek zvolte Nástroje, aktualizace a rozšíření.

Aktualizace a rozšíření dialogové okno.
Zvolte v seznamu rozšíření Upgrade krok nasazení pro projekty SharePointa pak zvolte Odinstalace příkaz.
V dialogovém okně pole vyberte Ano potvrďte, že chcete odinstalovat rozšíření a pak zvolte Restartovat nyní pro dokonční odinstalace.
Zavřete obě instance programu Visual Studio (experimentální instanci a instanci aplikace Visual Studio, ve kterém je UpgradeDeploymentStep řešení otevřené).

Viz také

Koncepty

Rozšíření balení a nasazení SharePoint

Sdílet prostřednictvím