Demonstra Passo a passo: Importar de um fluxo de trabalho reutilizáveis do SharePoint Designer para Visual Studio

  • Artigo

Esta explicação passo a passo demonstra como importar um fluxo de trabalho reutilizável criado em 2010 do SharePoint Designer em um Visual Studio projeto de fluxo de trabalho do SharePoint.

Fluxos de trabalho criados no SharePoint Designer, ou fluxos de trabalho declarativos, consistem em XML instruções em vez de código. Apresenta a 2010 do SharePoint Designer fluxos de trabalho reutilizáveis, que são portáteis, declarativos fluxos de trabalho que podem ser usados por listas diferentes nos sites do SharePoint.

São chamados de fluxos de trabalho criados em 2010 Visual Studio, como, por exemplo, fluxos de trabalho seqüenciais e estado de máquina, fluxos de trabalho de código. Fluxos de trabalho de código consistem em arquivos XML e os módulos de código na qual os usuários podem personalizar o comportamento do fluxo de trabalho.

Visual Studio 2010permite que você importe o criadas em 2010 do SharePoint Designer de fluxos de trabalho reutilizáveis e convertê-los em fluxos de trabalho de código para uso em seus sites do SharePoint.

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

  • Criando um fluxo de trabalho reutilizável simple no SharePoint Designer.

  • Exportando o fluxo de trabalho reutilizável do SharePoint Designer para um arquivo. wsp e no SharePoint.

  • Importando o arquivo. wsp em Visual Studio usando o projeto de fluxo de trabalho importação reutilizável.

  • Alterar o fluxo de trabalho, adicionando código.

  • Usando o fluxo de trabalho importado em um site do SharePoint.

ObservaçãoObservação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Pré-requisitos

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

Criar Subsites do SharePoint de destino

Primeiro, você cria dois novos subsites do SharePoint: um para hospedar os fluxos de trabalho reutilizáveis do SharePoint Designer, outro para hospedar os fluxos de trabalho convertidos.

Para criar subsites do SharePoint

  1. Em 2010 do SharePoint Designer, clique em Abrir Site sobre o arquivo menu.

  2. No Abrir Site caixa de diálogo Procurar para um site do SharePoint onde você deseja criar o fluxo de trabalho ou usar o valor padrão de http://nome do sistema/ e, em seguida, clique em Abrir.

    A Home page é exibida.

  3. No Subsites seção, clique em nova.

  4. No nova caixa de diálogo, selecione Modelos do SharePoint no painel esquerdo e selecione O Site de equipe no painel à direita.

  5. No Especifique o local do site da Web caixa, substitua a palavra subsite na URL com SPD1 e clique OK.

    Isso abre o novo subsite no SharePoint Designer. Fechar esta instância do SharePoint Designer e voltar para a primeira instância (o site de nível superior).

  6. Repita as etapas 3 a 5 para criar o subsite de segundo, desta vez substituir a palavra subsite na URL com SPD2.

Criar um fluxo de trabalho reutilizáveis do SharePoint Designer

Como o SharePoint não inclui quaisquer fluxos de trabalho reutilizáveis que podem ser usadas para esse exemplo, você criará um. Este fluxo de trabalho simple, quando um usuário insere uma nova tarefa na lista de tarefas que tem um título específico, a tarefa é atribuída a esse usuário.

Para criar um fluxo de trabalho reutilizável do SharePoint Designer

  1. Clique o SPD1 do site no Subsites seção para modificá-lo.

  2. Clique em Fluxo de trabalho reutilizável na faixa de opções.

    O assistente criar fluxo de trabalho reutilizável aparece.

  3. No nome , digite o fluxo de trabalho de tarefa SPD.

  4. No Tipo de conteúdo , clique em tarefae em seguida, clique em OK.

    O fluxo de trabalho abre no designer de fluxo de trabalho do SharePoint Designer.

  5. Verifique se essa etapa 1 está selecionada e clique no condição botão na faixa de opções e, em seguida, selecione se o mesmo valor de campo do item atual da lista de condições.

    Isso adiciona uma nova condição chamada se igual valor do campo.

  6. Clique o campo vincular a se o campo de valor igual a condição.

  7. Na lista de valores, selecione título.

  8. Clique o valor vincular a se o campo de valor igual a condição.

  9. Na caixa, digite a nova tarefa.

    A instrução da condição agora lê se atual: título do Item é igual a nova tarefa.

  10. Clique na linha sob a instrução da condição, clique na ação botão na faixa de opções e, em seguida, selecione Definir campo no item atual da lista de ações.

  11. Clique o campo vincular o definir o campo valor ação e selecione atribuído a.

  12. Clique o valor vincular o definir o campo valor ação, selecione usuário que criou o item da lista de grupos e usuários existentes, clique no Adicionar e, em seguida, clique OK.

    A instrução de ação agora lê Definir atribuído para a atual Item: CreatedBy.

Salvar e implantar o fluxo de trabalho reutilizável

Porque Visual Studio pode importar somente os arquivos. wsp, você deve salvar o fluxo de trabalho reutilizável, como um arquivo. wsp e implantá-lo no SharePoint antes de importá-la em Visual Studio.

Observação importanteImportante

Se você receber um erro de runtime que executar o procedimento a seguir, você precisará executar o procedimento em um sistema que tenha acesso ao site do SharePoint.

Para salvar e implantar o fluxo de trabalho reutilizável

  1. Clique o Salvar botão na parte superior do SharePoint Designer para salvar seu progresso e clique o Publicar botão para implantar o fluxo de trabalho para o SPD1 site do SharePoint.

  2. Clique em fluxos de trabalho no painel de navegação.

  3. Clique em o fluxo de trabalho do SPD tarefa em o fluxo de trabalho reutilizável.

  4. Na faixa de opções, clique em Salvar como modelo para salvar o fluxo de trabalho como um arquivo. wsp.

  5. Abrir o SPD1 o site do SharePoint em um navegador para exibir o arquivo. wsp no SharePoint.

  6. Clique em bibliotecas na barra Inicialização rápida.

  7. Clique em Ativos do Site na Bibliotecas de documentos seção.

    O o fluxo de trabalho do SPD tarefa arquivo está relacionado com outros ativos do site.

  8. Clique em seu nome na lista e o Download do arquivo caixa de diálogo aparece.

  9. Clique o Salvar botão no Download do arquivo caixa de diálogo para salvar o arquivo. wsp no sistema.

Importe o arquivo. wsp do Visual Studio

Importar o arquivo. wsp para Visual Studio usando um projeto de importação de fluxo de trabalho de reutilizável. Este projeto converte o fluxo de trabalho a partir de um fluxo de trabalho reutilizável e declarativo em um fluxo de trabalho do código. Depois que o fluxo de trabalho for convertido, você usará o código para modificar seu comportamento.

Importar um fluxo de trabalho a partir de um arquivo. wsp e modificá-lo

  1. No Visual Studio, exibir o Novo projeto caixa de diálogo, apontando para nova na arquivo menu e, em seguida, clicando em Novo projeto.

  2. Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.

  3. Clique em o fluxo de trabalho do importação reutilizável na modelos painel, deixar o nome do projeto como WorkflowImportProject1e, em seguida, clique em OK.

    O Assistente de personalização do SharePoint é exibida.

  4. Sobre o especificar o site e o nível de segurança de depuração página, digite o URL para o segundo subsite do SharePoint que você criou anteriormente: http://nome do sistema/SPD2.

  5. No o que é o nível de confiança para essa solução do SharePoint? seção, deixe a seleção como Deploy como uma solução do farm.

    Para obter mais informações sobre o modo seguro em relação às soluções de farm, consulte Considerações sobre a solução no modo seguro.

  6. No especificar a nova fonte de projeto , navegue até o local no sistema onde você salvou o arquivo. wsp e, em seguida, em próximo.

    ObservaçãoObservação

    Clicando em Concluir nesta página faz com que todos os itens disponíveis no arquivo. wsp para ser importado.

    Isso exibe uma lista de fluxos de trabalho reutilizáveis disponíveis para importação.

  7. No Selecionar itens para importar , selecione o fluxo de trabalho o fluxo de trabalho do SPD tarefa e, em seguida, clique em Concluir.

    Após a operação de importação, um projeto chamado WorkflowImportProject1 é criado contendo um fluxo de trabalho chamado SPD_Workflow_TestFT. Nessa pasta é o arquivo de definição do fluxo de trabalho elements e o arquivo de designer de fluxo de trabalho (. xoml). O designer contém dois arquivos: o arquivo de regras (. Rules) e o arquivo de code-behind (. cs ou. vb, dependendo da linguagem de programação do projeto).

  8. Definir o item de projeto de fluxo de trabalho WorkflowImportProject1 como o Item de inicialização.

    Isso exibe a lista imediatamente quando você depura o projeto.

  9. Porque o Fluxo de trabalho de importação reutilizável não importa os valores de propriedade da associação do fluxo de trabalho importados, você deverá inseri-los. Para fazer isso:

    1. Clique na SPD_Workflow_TestFT item de projeto de fluxo de trabalho no Solution Explorer.

    2. Clique nas reticências (Elipse do designer do ASP.NET para dispositivos móveis) botão ao lado do A lista de destino propriedade ou outra propriedade que tem um botão de reticências.

    3. Preencha os valores ausentes do Assistente para personalização do SharePoint. Quando tiver terminado, clique em Concluir.

  10. Clique com o botão direito no arquivo. xoml e selecione View Designer para exibir o fluxo de trabalho importado no designer de fluxo de trabalho.

  11. Na caixa de ferramentas, no v 3.0 do fluxo de trabalho do Windows seção, arraste um código atividade para o designer e soltá-lo sob o SequenceActivity1 atividade.

    Isso adiciona uma atividade para o designer de fluxo de trabalho chamado CodeActivity1. Nesta atividade, você irá adicionar uma ação de código que cria um anúncio na lista de anúncios, quando o usuário inicia o fluxo de trabalho.

  12. Clique duas vezes em CodeActivity1 para gerar um manipulador de eventos e exiba o código.

  13. Adicione o seguinte em existente using ou Imports instruções:

    Imports Microsoft.SharePoint
Imports System

    using Microsoft.SharePoint;
using System;

  14. Substitua codeActivity1_ExecuteCode com o seguinte:

    Private Sub codeActivity1_ExecuteCode(ByVal sender As System.Object, ByVal e As System.EventArgs)
    Try
        ' Get reference to SharePoint site.
        Dim site As SPSite = New SPSite("http://MyServer")
        Dim web As SPWeb = site.OpenWeb("SPD2/")
        ' Get reference to Announcements list.
        Dim announcementsList As SPList = web.Lists("Announcements")
        ' Add announcement to Announcements list for the Task.
        Dim oListItem As SPListItem = announcementsList.Items.Add
        oListItem("Title") = ("Assigned task on " + DateTime.Now.ToString)
        oListItem.Update()
    Catch err As Exception
        Console.WriteLine(("Error: " + err.ToString))
    End Try
End Sub

    private void codeActivity1_ExecuteCode(object sender, System.EventArgs e)
{

    try
    {
        // Get reference to SharePoint site.
        SPSite site = new SPSite("http://MyServer");
        SPWeb web = site.OpenWeb("SPD2/");
        // Get reference to Announcements list.
        SPList announcementsList = web.Lists["Announcements"];

        // Add announcement to Announcements list for the Task.
        SPListItem oListItem = announcementsList.Items.Add();
        oListItem["Title"] = "Assigned task on " + DateTime.Now.ToString();
        oListItem.Update();
    }

    catch (Exception err)
    {
        Console.WriteLine("Error: " + err.ToString());
    }        
}

Implantar o projeto e associar o fluxo de trabalho.

Em seguida, execute WorkflowImportProject1 para implantá-lo em um site do SharePoint e associar o fluxo de trabalho a lista de tarefas para visualizar e testar modificado, convertido em fluxo de trabalho.

Para implantar o projeto e associar o fluxo de trabalho.

  1. Em Visual Studio, pressione F5 para executar e implantar o projeto de fluxo de trabalho convertido.

  2. Clique em tarefas na barra Inicialização rápida para exibir a lista de tarefas.

  3. Clique em itens na Lista de ferramentas faixa de opções e clique no Novo Item botão.

  4. No tarefas - Novo Item caixa de diálogo, digite a nova tarefa na título caixa e clique Salvar.

  5. Exibir o As configurações da lista página clicando em lista no Ferramentas da lista botão faixa de opções e, em seguida, clicando em As configurações da lista.

  6. Clique o As configurações de fluxo de trabalho vincular o permissões e gerenciamento seção.

    O Adicionar um fluxo de trabalho página é exibida.

  7. No fluxo de trabalho lista, selecione WorkflowImportProject1 - teste de fluxo de trabalho do SPD.

  8. No nome caixa, digite teste de fluxo de trabalho de SPD e, em seguida, clique em OK.

  9. Clique em tarefas na barra Inicialização rápida.

  10. Clique na seta suspensa ao lado de nova tarefa e selecione fluxos de trabalho.

  11. Clique no link para Teste de fluxo de trabalho do SPD na Iniciar um novo fluxo de trabalho seção e, em seguida, clique em Iniciar para iniciar o fluxo de trabalho.

    ObservaçãoObservação

    Como alternativa, você pode auto-associar um fluxo de trabalho com uma lista de executar o Assistente de configurações de fluxo de trabalho e definindo o fluxo de trabalho para associar automaticamente.

    Observe que as duas ações são executadas pelo fluxo de trabalho: seu nome aparece na tarefa de Atribuído A coluna e um anúncio é exibido o anúncios lista.

Consulte também

Conceitos

A importação de itens de um Site do SharePoint existente

Outros recursos

Desenvolvimento de soluções do SharePoint

Criando controles reutilizáveis para Web Parts ou páginas de aplicativo