Demonstra Passo a passo: Implantando uma personalização em nível de documento com uma implantação do manifesto (sistema de 2003)

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Versão do Microsoft Office Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de documento

Versão do Microsoft Office

Microsoft Office 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Esta explicação passo a passo demonstra como implantar uma personalização de nível de documento do Microsoft Office Excel ou do Microsoft Office Word em um Compartilhar de rede em um servidor.No final da explicação passo a passo, você poderá executar a solução no servidor do seu computador de desenvolvimento.Para obter mais informações sobre personalizações em nível de documento, consulte Arquitetura de personalizações de nível de documento.

Em um ambiente de produção, uma solução de Ferramentas do Visual Studio para o Office com freqüência é publicada pela Primeiro vez em um servidor de teste, e, em seguida, ele é redistribuído em um servidor de produção depois que o departamento de TI aprova-lo.Nesta explicação passo a passo, você irá publicar uma solução para um local temporário no seu computador de desenvolvimento e, em seguida, reimplantar a solução do local temporário para um servidor.Para obter mais informações sobre as opções para implantar sua solução, consulte Modelos de implantação (sistema de 2003).

Essa explicação passo a passo ilustra as seguintes tarefas:

Usando o Assistente de publicação para publicar sua solução em um local no seu computador de desenvolvimento.
Reimplantar manualmente a solução do seu computador local para um Compartilhar de rede em um servidor.
Modificando por programação o manifesto do aplicativo que está incorporado no documento para apontar para o novo local de manifesto de implantação.
Editando o manifesto da implantação para apontar para o novo local do manifesto do aplicativo externo.
Editando o manifesto de aplicativo externo para apontar para o novo local do assembly e o manifesto da implantação.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).

Microsoft Office Word 2003 ou Microsoft Office Excel 2003.

Observação:
Esta explicação passo a passo assume que você estiver implantando uma solução do Word.Se você quiser executar explicação passo a passo com uma solução do Excel, substitua o nome do projeto Word com o nome do seu projeto do Excel no Todo o Código e exemplos XML.

O Acessar a um servidor de rede para implantação.Esta explicação passo a passo assume que você está reimplantar sua solução para o \\DeployServer\ShareFolder de compartilhamento de rede.
Privilégios de administrador no computador de desenvolvimento, portanto, você pode definir a diretiva de segurança para um Local da Rede.

Criando o projeto

Nesta etapa, Criar um projeto de documento do Word.

Para criar um novo projeto

Criar um projeto de documento do Word com o nome WordDeployment, usando o modelo de projeto para o Office 2003.

No assistente, Selecionar Criar um documento novo.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

O Visual Studio abre o novo documento do Word no designer e adiciona o projeto de WordDeployment para Gerenciador de Soluções.

Adicionando código por trás do documento

O projeto precisa algum código para que você possa verificar se a solução está funcionando quando você Abrir o documento.Para esta explicação passo a passo, Adicionar uma caixa de mensagem para o manipulador de eventos Startup do documento.

Para adicionar uma caixa de mensagem a um evento de inicialização

Em Gerenciador de Soluções, clique com o botão direito do mouse ThisDocument.vb ou ThisDocument.cse clique em Exibir Code no menu de atalho.

Adicionar o código a seguir ao manipulador de eventos Startup dentro da classe ThisDocument para mostrar uma caixa de mensagem durante a inicialização.

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    MessageBox.Show("The document is deployed correctly.")
End Sub

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    MessageBox.Show("The document is deployed correctly.");
}

Pressionarionar F5 para executar o projeto.

O Word inicia e a caixa de mensagem será exibida.
Fechar a caixa de mensagem.
Word Sair.

Publicação a solução

A Primeiro etapa de implantação desse processo é publicar sua solução para um local temporário no computador local.

Para publicar a solução

Clique com o botão direito do mouse o nó de projeto no Gerenciador de Soluções.
Clique em Publicar no menu de atalho.

O Assistente de Publicação aparece.
In the Especifica o local para publicar nesta caixa de do aplicativo, tipo C:\TestDeploy.
Clique em Finish.

O manifesto de documento e a implantação de solução são copiados para o C:\TestDeploy.O assembly de solução, manifesto de aplicativo atualizado e cópias do manifesto de documento e a implantação de solução são copiadas para o C:\TestDeploy\WordDeployment_1.0.0.0.For more information, see Implantação de personalizações de nível de documento (sistema de 2003).

Clique em do Close Solution no menu de arquivo para fechar o WordDeployment solução no Visual Studio.

Observação:
O assembly não tem permissão para executar ainda, se você tentar executar a solução lançará um erro.Você irá atualizar sua diretiva de segurança para conceder permissão Confiar Completo para o assembly em uma etapa posterior.

Quando você Publicar uma solução, o manifesto de aplicativo incorporado nos pontos de documento de solução para o caminho completo do manifesto da implantação.Se você reimplantar os arquivos de solução para outro local, você deverá atualizar o manifesto do aplicativo incorporado para apontar para a Novo localização do manifesto da implantação.Você também deve atualizar o manifesto da implantação e o manifesto de aplicativo externo para apontar para o Novo Arquivo locais.

Atualizando o manifesto de aplicativo incorporado

Para editar o manifesto do aplicativo incorporado, use a classe ServerDocument que Ferramentas do Visual Studio para o Office fornece.Quando você usa a classe de ServerDocument , você deve executar o código em um novo projeto (não a solução Ferramentas do Visual Studio para o Office ) como um projeto de console e o documento de solução Ferramentas do Visual Studio para o Office devem ser Fechadas.

Observação:
Ferramentas do Visual Studio para o Office inclui um exemplo que demonstra como criar uma ferramenta que pode ser usada para editar o manifesto do aplicativo incorporado.For more information, see Exemplo do ServerDocument.

Para atualizar o manifesto do aplicativo incorporado

Criar um novo projeto de Aplicativo do Console.
Adicionar referências para o Microsoft.VisualStudio.Tools.Applications.Runtime e System.Windows.Forms assemblies este projeto.
Abra o arquivo Programa.cs ou Module1.vb, e Adicionar o seguinte Imports ou uma instrução de using para o início do arquivo.
```
Imports Microsoft.VisualStudio.Tools.Applications.Runtime
```
```
using Microsoft.VisualStudio.Tools.Applications.Runtime;
```

Copiar o código a seguir para a função Main.Esse código cria um ServerDocument que fornece Acessar ao manifesto do aplicativo incorporado de seu documento de solução.O código atribui à propriedade de DeployManifestPath , o novo caminho de manifesto de implantação e, em seguida, salva e fecha o ServerDocument.

Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("C:\TestDeploy\WordDeployment.doc")
    sd.AppManifest.DeployManifestPath = _
        "\\DeployServer\ShareFolder\WordDeployment.application"
    sd.Save()

Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try

ServerDocument sd = null;
try
{
    sd = new ServerDocument(@"C:\TestDeploy\WordDeployment.doc");
    sd.AppManifest.DeployManifestPath = 
        @"\\DeployServer\ShareFolder\WordDeployment.application";
    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}

Pressionarionar F5 para executar o projeto.

Uma janela de console aparece rapidamente enquanto o manifesto do aplicativo incorporado está sendo atualizado e fecha a janela de console.

Atualizando o manifesto de implantação

Agora que você atualizou o manifesto do aplicativo incorporado no documento Ferramentas do Visual Studio para o Office solução, você deve atualizar o manifesto da implantação para apontar para o novo local do manifesto do aplicativo externo.

Para atualizar o manifesto da implantação

Abrir o manifesto da implantação em um editor de texto, como o Bloco de notas.O manifesto de implantação está localizado no Publicar pasta C:\TestDeploy.Ele é denominado WordDeployment.Aplicativo.
Defina o atributo codebase do elemento <dependentAssembly> para o caminho completo do local implantação final do manifesto do aplicativo externo.For more information, see < dependentAssembly > Elemento (Visual Studio Tools for Office Referência).O atributo para esta explicação passo a passo deve ter aparência o exemplo a seguir.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\
    WordDeployment_1.0.0.0\WordDeployment.dll.manifest"
```
Salvar e Fechar o arquivo de manifesto de implantação.

Atualizando o manifesto de aplicativo externo

Bem como atualizar o manifesto da implantação, você deve editar o manifesto de aplicativo externo para apontar para a localidade de implantação final do assembly de solução e o manifesto da implantação.Toda vez que você publicar uma solução de Ferramentas do Visual Studio para o Office, um novo manifesto de aplicativo externo é gerado que aponta para o Versão Atual do assembly solução.

Para atualizar o manifesto de aplicativo externo

Abrir o manifesto do aplicativo em um editor de texto, como o Bloco de notas.O manifesto do aplicativo está localizado no Publicar pasta C:\TestDeploy\WordDeployment_1.0.0.0.Ele é denominado WordDeployment.dll.Manifesto.
Localize o elemento <installFrom> que é o filho do elemento <dependency> e defina o atributo codebase como o caminho completo do assembly solução atual.For more information, see < installFrom > Elemento (Visual Studio Tools for Office Referência).O atributo para esta explicação passo a passo deve ter aparência o exemplo a seguir.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\
    WordDeployment_1.0.0.0\WordDeployment.dll"
```
Localize o elemento <installFrom> que é o filho do elemento <assembly> e defina o atributo codebase como o caminho completo do manifesto da implantação.For more information, see < installFrom > Elemento (Visual Studio Tools for Office Referência).O atributo para esta explicação passo a passo deve ter aparência o exemplo a seguir.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\WordDeployment.application"
```
Salvar e Fechar o arquivo de manifesto do aplicativo.

Copiar os arquivos de solução para o servidor

Agora que você tem Editado os manifestos, está pronto para copiar os arquivos de solução para o destino de implantação final no servidor.

Para copiar os arquivos de solução para o servidor

Criar \\DeployServer\ShareFolder de compartilhar uma pasta WordDeployment_1.0.0.0 no arquivo de rede.
Copiar que o documento de solução e a implantação de manifesto para \\DeployServer\ShareFolder.
Copiar que o assembly de solução e o aplicativo de manifesto para \\DeployServer\ShareFolder\WordDeployment_1.0.0.0.

Concedendo completo Confiar para a pasta de rede

Para executar sua solução Ferramentas do Visual Studio para o Office da pasta de rede, você deve conceder completo Confiar à pasta de rede em sua diretiva de segurança no computador de desenvolvimento.Você pode modificar a diretiva de segurança em um prompt de comando usando a ferramenta de Política de segurança de Acessar ao código (Caspol.exe).Para conceder Confiar para um Local da Rede, você deve ter privilégios de administrador e você deve alterar a diretiva de segurança no nível do computador.

Observação:
Este procedimento destina-se com a finalidade de executar esta explicação passo a passo.Não use esse procedimento para conceder Confiar para módulos (assemblies) ou pastas se você não tiver certeza de que eles serão seguros e seguro.Para obter mais informações sobre como conceder e remover as permissões, consulte Como: Conceder permissões a pastas e conjuntos de módulos (sistema de 2003) and Como: Remover permissões de pastas e conjuntos de módulos (sistema de 2003).

Este procedimento destina-se com a finalidade de executar esta explicação passo a passo.Não use esse procedimento para conceder Confiar para módulos (assemblies) ou pastas se você não tiver certeza de que eles serão seguros e seguro.Para obter mais informações sobre como conceder e remover as permissões, consulte Como: Conceder permissões a pastas e conjuntos de módulos (sistema de 2003) and Como: Remover permissões de pastas e conjuntos de módulos (sistema de 2003).

Para conceder completo Confiar para a pasta de rede

tipo o seguinte comando no prompt de comando do Visual Studio:

caspol -m -ag LocalIntranet_Zone -url \\DeployServer\ShareFolder\* FullTrust -n "Remote Deployment" -d "Deployment Walkthrough"

Testando a solução

Agora você pode testar sua solução para garantir que seu código seja executado quando você Abrir o documento do computador de desenvolvimento.

Para testar a implantação

No computador de desenvolvimento, Abrir o arquivo de de WordDeployment.doc no \\DeployServer\ShareFolder\.
Confirme se a caixa de mensagem aparece.

Próximas etapas

Você também pode implantar sua solução usando um arquivo do Microsoft Windows Instalador (.msi).For more information, see Demonstra Passo a passo: Implantando uma personalização em nível de documento usando um Windows Instalador de arquivos (sistema de 2003).

Consulte também

Tarefas

Demonstra Passo a passo: Implantando uma personalização em nível de documento usando um Windows Instalador de arquivos (sistema de 2003)

Conceitos

Implantando soluções do Office (Sistema de 2003)

Implantação de personalizações de nível de documento (sistema de 2003)

Modelos de implantação (sistema de 2003)

Compartilhar via