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

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

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

Fluxos de trabalho criados em Visual Studio 2012, como fluxos de trabalho sequencial e de estado do computador, são chamados fluxos de trabalho de código.Fluxos de trabalho consistem de código em arquivos XML e código módulos no qual os usuários podem personalizar o comportamento de fluxo de trabalho.

O Visual Studio permite que você importe os fluxos de trabalho reutilizáveis criados no SharePoint Designer 2010 e convertê-los para codificar fluxos de trabalho para uso em sites da web do SharePoint.

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

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

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

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

• Alterando o fluxo de trabalho adicionando código.

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

Observaçã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 de Visual Studio.

Pré-requisitos

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

• Edições suportadas de Microsoft Windows e do SharePoint.Para obter mais informações, consulte Requisitos para o desenvolvimento de soluções do SharePoint.

• O Visual Studio.

• Microsoft Office o SharePoint Designer 2010.

Crie subsites do SharePoint de destino

Primeiro você cria duas novas subsites do SharePoint: um para hospedar os fluxos de trabalho reutilizáveis do SharePoint Designer, para hospedar outros fluxos de trabalho convertidos.

Para criar subsites do SharePoint

1. No SharePoint Designer 2010, na barra de menu, escolha Arquivo, Novo Site em Branco.

2. Na caixa de diálogo de Novo Site em Branco , vá para um site da web do SharePoint onde você deseja criar o fluxo de trabalho, ou use o valor de http://SystemName/e então escolha o botão de OK .

   A página aparece.

3. Na seção de Subsites , escolha o botão de Novo .

4. Na caixa de diálogo de Novo , escolha Modelos do SharePoint da lista no painel esquerdo, e escolha Site da Equipe da lista no painel direito.

5. Na caixa de Especifique o local do site , substitua a palavra subsite no URL com o SPD1, e então escolha o botão de OK .

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

6. Repita as etapas 3 - 5 para criar a segunda subsite, dessa vez que substituem as palavras subsite em URL com o SPD2.

Crie um fluxo de trabalho reutilizável do SharePoint Designer

Porque o SharePoint não inclui nenhum fluxos de trabalho reutilizáveis que você pode usar para esse exemplo, você criará um.Nesse fluxo de trabalho simples, quando um usuário insere uma nova tarefa na lista de tarefas que tem um título específico, a tarefa é atribuída ao usuário.

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

1. Na seção de Subsites , escolha o site de SPD1 para alterá-la.

2. Em fita, escolha o botão de Fluxo de Trabalho Reutilizável .

   O assistente reutilizável de fluxo de trabalho de criação aparece.

3. Na caixa de Nome , insira o fluxo de trabalho de tarefa de SPD.

4. Na lista de Tipo de Conteúdo , escolha, e escolha Tarefano botão de OK .

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

5. No designer de fluxo de trabalho, escolha a etapa 1, e em seguida, em fita, clique no botão de Condição .

6. Na lista das circunstâncias, escolha Se o campo do item atual for igual a zero.

   Esta etapa adiciona uma condição que é chamado Se o valor do campo equals.

7. Na condição de Se o valor do campo equals , escolha o link de campo .

8. Na lista de valores, escolha Título.

9. Na condição de Se o valor do campo equals , escolha o link de valor .

10. Na caixa, digite a nova tarefa.

    A declaração da condição ler agora Se o item atual: O título é igual a nova tarefa.

11. Escolha a linha abaixo da declaração da condição e, em seguida, em fita, escolha o botão de Ação .

12. Na lista de ações, escolha Definir Campo no Item Atual.

13. Em ação de Defina o campo para avaliar , escolha o link de campo e, em seguida, na lista, escolha Atribuído a.

14. Em ação de Defina o campo para avaliar , escolha o link de valor e, em seguida, na lista de usuários e grupos existentes, escolha do O usuário que criou o item.

15. Escolha o botão de Adicionar , e então escolha o botão de OK .

    A declaração de ação ler agora Conjunto atribuído ao item atual: CreatedBy.

Salvar e implantar o fluxo de trabalho reutilizável

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

Importante
Se você receber um erro de tempo de execução que executa o procedimento a seguir, você precisa executar o procedimento em um sistema que tenha acesso ao site da web do SharePoint.

Para salvar e implantar o fluxo de trabalho reutilizável

1. Na parte superior do SharePoint Designer, escolha o botão de Salvar para salvar seu progresso, e então escolha o botão de Publicar para implantar o fluxo de trabalho para o site do SharePoint de SPD1 .

2. No painel de navegação, escolha o objeto de Fluxos de Trabalho .

3. Em Fluxo de Trabalho Reutilizável, escolha Fluxo de trabalho de tarefa de SPD.

4. Em fita, escolha o botão de Salvar como Modelo para salvar o fluxo de trabalho como um arquivo de .wsp.

5. Abra o site da web do SharePoint de SPD1 em um navegador para exibir o arquivo de .wsp no SharePoint.

6. Na barra de QuickLaunch, escolha o link de Bibliotecas .

7. Na seção de Bibliotecas de documentos , escolha o link de Ativos do Site .

   O arquivo de Fluxo de trabalho de tarefa de SPD é listado com outros recursos do site.

8. Na lista de arquivos, escolha o nome do arquivo

9. Na caixa de diálogo de Download de Arquivo , escolha o botão de Salvar para salvar o arquivo de .wsp em seu sistema local.

Importar o .wsp Arquivo no Visual Studio

Importar o arquivo de .wsp em Visual Studio usando um projeto e de fluxo de trabalho de importação.Este projeto converte o trabalho do trabalho reutilizáveis, declarativos em um fluxo de trabalho de código.Depois que o fluxo de trabalho é convertido, você usará o código para alterar seu comportamento.

Para importar um fluxo de trabalho de um .wsp arquive-o e altere-

1. Em Visual Studio, na barra de menu, escolha Arquivo, Novo, Projeto.

2. Na caixa de diálogo de Novo Projeto , expanda o nó de SharePoint em Visual C# ou Visual Basic, e então escolha o nó de 2010 .

3. No painel de Modelos , escolha o modelo de Fluxo de trabalho reutilizável do SharePoint 2010 de importação , deixe o nome do projeto como WorkflowImportProject1, e então escolha o botão de OK .

   O assistente de personalização do SharePoint aparece.

4. Na página do Especificar o site e o nível de segurança para depuração , entre em URL para a segunda subsite do SharePoint que você criou anteriormente: http://nome do sistema/SPD2.

5. Na seção de Que é o nível de confiança para esta solução do SharePoint? , escolha o botão de opção de Implantar como uma solução de farm , e então escolha o botão de Avançar .

   Para obter mais informações sobre o na área restrita contra soluções de farm, consulte na Considerações sobre a solução no modo seguro.

6. Na página de Especificar a nova fonte de projeto , navegue até o local onde você salvou no sistema anteriormente o arquivo de .wsp, abra o arquivo, e escolha o botão de Avançar .

   Observação
   Escolha o botão de Concluir para importar todos os itens disponíveis no arquivo de .wsp.

   Isso exibe uma lista de fluxos de trabalho reutilizáveis disponíveis para importar.

7. Na caixa de Itens selecionados a importar , escolha o fluxo de trabalho de Fluxo de trabalho de tarefa de SPD , e então escolha o botão de Concluir .

   Após a operação de importação é concluída, um projeto chamado WorkflowImportProject1 é criado contendo um fluxo de trabalho SPD_Workflow_TestFTchamado.Nesta pasta é o arquivo Elements.xml de definição de fluxo de trabalho e o arquivo de designer de fluxo de trabalho (.xoml).O designer contém dois arquivos: as regras .rules arquivo () e um arquivo code-behind (.cs ou .vb, dependendo da linguagem de programação do projeto).

8. Em Gerenciador de Soluções, exclua a pasta de Outros arquivos importados .

9. No arquivo de Elements.xml, excluir InstantiationURL="_layouts/IniErkflIP.sspx".

10. Em Gerenciador de Soluções, escolha WorkflowImportProject1e, em seguida, na barra de menu, escolha Projeto, Definir como projeto de inicialização para definir WorkflowImportProject1 como o item de inicialização.

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

11. Porque o modelo de Fluxo de trabalho reutilizável do SharePoint 2010 de importação não importa os valores de propriedade da associação para o fluxo de trabalho importado, você deve incorporá-los.Para fazer isso:

    1. Em Gerenciador de Soluções, escolha o nó de SPD_Workflow_TestFT .

    2. Escolha o botão reticências () próximo a uma das propriedades da lista, como a propriedade de Lista de Destino .

    3. Preencha valores faltando no assistente de personalização do SharePoint, e então escolha o botão de Concluir .

12. Escolha o arquivo de .xoml e, em seguida, na barra de menu, escolha Modo de Visualização, Designer para exibir os trabalhos importados no designer de trabalho.

13. No nó de Windows Workflow v3.0 de Caixa de Ferramentas, execute uma das seguintes etapas:

    • Abra o menu de atalho para atividades de Código , e então escolha Copiar.No designer de fluxo de trabalho, abra o menu de atalho para a linha abaixo da atividade de SequenceActivity1 , e então escolha Colar.

    • Arraste a atividade de Código de Caixa de Ferramentas para o designer de fluxo de trabalho, e conecta-se a linha abaixo da atividade de SequenceActivity1 .

    Isso adiciona uma atividade o designer de fluxo de trabalho CodeActivity1chamado.Nesta atividade, você adicionará uma ação de código que cria um comunicado nos anúncios lista quando o usuário inicia o fluxo de trabalho.

14. Execute um dos seguintes conjuntos de etapas:

    • Clique duas vezes CodeActivity1 para gerar um manipulador de eventos e para exibir o código.

    • Na janela de Propriedades para CodeActivity1, defina o valor da propriedade de ExecuteCode a codeActivity_ExecuteCode.

15. Adicione o seguinte em using ou instruções existentes de Imports :

    Imports Microsoft.SharePoint
    Imports System
    

    using Microsoft.SharePoint;
    using System;
    

16. 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 e associar o fluxo de trabalho

Em seguida, WorkflowImportProject1 execução para implantá-lo em um site da web do SharePoint e para associar no fluxo de trabalho com a lista de tarefas para exibir e testar alterada, converteu o fluxo de trabalho.

Para implantar o projeto e associar o fluxo de trabalho

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

2. Na barra de QuickLaunch, escolha o link de Tarefas para exibir a lista de tarefas.

3. Na guia de Ferramentas de Lista , escolha o botão de Itens , e então escolha o botão de Novo Item .

   A caixa de diálogo de Tarefas - novo item é aberta.

4. Na caixa de Título , insira novas tarefas, e então escolha o botão de Salvar .

5. Na guia de Ferramentas de Lista , escolha o botão de Lista , e então escolha o botão de Configurações da lista .

   A página de Configurações da lista aparece.

6. Na seção de Permissões e Gerenciamento , escolha o link de Configurações de Fluxo de Trabalho .

   A página de Configurações de Fluxo de Trabalho aparece.

7. Escolha o link de Adicionar um Fluxo de Trabalho .

8. Na lista de Fluxo de Trabalho , escolha WorkflowImportProject1 - teste de fluxo de trabalho de SPD.

9. Na caixa de Nome , insira o teste de fluxo de trabalho de SPD, e então escolha o botão de OK .

10. Na barra de QuickLaunch, escolha a lista de Tarefas .

11. Escolha a seta ao lado de Nova Tarefae, em seguida, na lista, escolha Fluxos de Trabalho.

12. Na seção de Iniciar um novo fluxo de trabalho , escolha o link para Teste de fluxo de trabalho de SPD, e então escolha o botão de Iniciar para iniciar o fluxo de trabalho.

    Observação
    Como alternativa, você pode automaticamente associado um fluxo de trabalho com uma lista executando o assistente de configuração de fluxo de trabalho e definindo o associado automática de fluxo de trabalho.

    Observe que duas ações são executadas pelo fluxo de trabalho: seu nome aparece na coluna da Atribuído a de tarefas, e um comunicado aparece na lista de Comunicados .

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