Guia de fluxo de trabalho do Conector do Serviço Web para SOAP
Este artigo descreve como criar um novo projeto para a sua origem de dados na Ferramenta de Configuração do Serviço Web. Siga estes passos para criar um projeto.
Abra a Ferramenta de Configuração do Serviço Web. Abre um projeto em branco.
Selecione Projeto SOAP e, em seguida, selecione Adicionar.
Na página seguinte, forneça as seguintes informações e, em seguida, selecione Seguinte:
- O novo nome do serviço Web
- Endereço (caminho WSDL) para obter os serviços, pontos finais e operações expostos
- Espaço de Nomes
- Modo de segurança (tipo de autenticação)
Neste exemplo, a página Credenciais é apresentada com os requisitos para o modo de segurança Básico (o modo que foi selecionado no passo anterior). Se "Nenhum" tiver sido especificado para o modo de segurança, não será apresentada uma página credenciais. Selecione Seguinte.
O caminho WSDL está a ser acedido para obter as informações do serviço e é apresentada a lista de funções expostas. Se o caminho WSDL introduzido estiver incorreto, a ferramenta de configuração não obtém as informações do serviço e gera um erro.
Assim que a deteção for efetuada, lista o ponto final e as operações que são detetadas. Selecione Concluir.
A compilação é efetuada. A compilação é um processo de compilação da assemblagem do contrato de dados, que pode ser uma operação demorada. O utilizador é informado sobre quaisquer erros de compilação. Após a deteção ser efetuada, a ferramenta apresenta a seguinte página:
Expandir o projeto SOAP e selecionar o ponto final exposto fornecido abaixo do ecrã. Este ecrã lista as operações que são declaradas no ponto final.
A expansão do ponto final apresenta a lista de operações. Uma operação é uma função declarada por um Ponto Final. Cada operação aborda um tipo de tarefa que pode ser efetuada no serviço. Este ecrã lista os argumentos que são declarados para a operação. Estes argumentos são então definidos quando a operação é utilizada na configuração dos fluxos de trabalho.
O próximo passo é definir o esquema de espaço do conector, que é conseguido ao criar o Tipo de Objeto e definir os respetivos tipos de objeto. Selecione Tipos de Objeto e, em seguida, selecione Adicionar. Na nova janela, adicione um novo tipo de objeto e forneça um nome. Selecione OK.
Adicionar um tipo de objeto fornece o ecrã abaixo.
O painel direito correspondente ao tipo de objeto permite-lhe manter os atributos e as respetivas propriedades para o tipo de objeto selecionado. Selecione Adicionar. É aberta uma nova janela para adicionar atributos:
O ecrã seguinte aparece depois de adicionar todos os atributos necessários:
O tipo de objeto e os atributos depois de criados fornecem fluxos de trabalho em branco que atendem às operações realizadas no Microsoft Identity Manager 2016 (MIM).
Configurar fluxos de trabalho na Ferramenta de Configuração do Serviço Web
O próximo passo é configurar os fluxos de trabalho para o tipo de objeto. Os ficheiros de fluxo de trabalho são uma série de atividades que são utilizadas pelo Conector de Serviços Web no tempo de execução. Os fluxos de trabalho são utilizados para implementar a operação mim adequada. A Ferramenta de configuração do Serviço Web ajuda-o a criar quatro fluxos de trabalho diferentes:
Importação: importe dados de uma origem de dados para os dois tipos de fluxos de trabalho seguintes:
- Importação completa: uma importação completa que pode ser configurada.
- Importação delta: não suportada pela Ferramenta de Configuração do Serviço Web.
Exportar: exportar dados do MIM para uma origem de dados ligada. As três ações seguintes são suportadas para a operação. Pode configurar estas ações com base nos seus requisitos.
- Adicionar
- Eliminar
- Substituir
Palavra-passe: efetue a gestão de palavras-passe para o utilizador (tipo de objeto). Estão disponíveis duas ações para esta operação:
- Definir palavra-passe
- Alterar palavra-passe
Ligação de Teste: configure um fluxo de trabalho para verificar se a ligação com o servidor de origem de dados foi estabelecida com êxito.
Nota
Pode configurar estes fluxos de trabalho para o seu projeto ou transferir o projeto predefinido a partir do Centro de Transferências da Microsoft.
Designer de fluxo de trabalho
O fluxo de trabalho Designer abre a área de trabalho para configurar o fluxo de trabalho de acordo com os requisitos. Para cada tipo de objeto (novo /existente), a ferramenta de configuração fornece os nós para fluxos de trabalho suportados pela ferramenta.
A Designer de Fluxo de Trabalho é composta pelos seguintes elementos de IU:
Nós no painel esquerdo: estes ajudam-no a selecionar o fluxo de trabalho que pretende estruturar.
Fluxo de Trabalho Central Designer: aqui pode remover as atividades para configurar os fluxos de trabalho. Para realizar várias operações do MIM (Exportar, Importar, Gestão de palavras-passe), pode utilizar as atividades de fluxo de trabalho padrão e personalizadas do .NET Workflow Framework 4. A ferramenta de Configuração do Serviço Web utiliza atividades de fluxo de trabalho padrão e personalizadas. Para obter mais informações sobre atividades padrão, veja Utilizar designers de atividades.
No fluxo de trabalho central Designer, um círculo vermelho com ponto de exclamação ao lado de qualquer atividade indica que a operação foi removida e não está definida correta e completamente. Paire o cursor sobre o círculo vermelho para descobrir o erro exato. Depois de a atividade ser definida corretamente, o círculo vermelho muda para a marca de informação amarela.
No fluxo de trabalho central Designer, uma marca de informação de triângulo amarelo junto a qualquer atividade indica que a atividade está definida, mas há mais que pode fazer para concluir a atividade. Paire o cursor sobre o triângulo amarelo para ver mais informações.
Caixa de Ferramentas: empacota todas as ferramentas, incluindo atividades personalizadas e de sistema e instruções predefinidas para estruturar o fluxo de trabalho. Para obter mais informações, consulte Caixa de Ferramentas.
Secções da caixa de ferramentas: a Caixa de Ferramentas tem as seguintes secções e categorias:
Descrição: o cabeçalho da Caixa de Ferramentas. Um separador acede à Caixa de Ferramentas e às propriedades da atividade de fluxo de trabalho selecionada.
Importar fluxo de trabalho: atividades personalizadas para configurar fluxos de trabalho de importação.
Exportar fluxo de trabalho: atividades personalizadas para configurar fluxos de trabalho de exportação.
Comum: atividades personalizadas para configurar qualquer fluxo de trabalho.
Depuração: atividades de fluxo de trabalho do sistema para depuração definidas no Fluxo de Trabalho 4. Estas atividades permitem o controlo de problemas de um fluxo de trabalho.
Instruções: atividades de fluxo de trabalho do sistema definidas no Fluxo de Trabalho 4. Para obter mais informações, veja Utilizar designers de atividade.
Propriedades: o separador propriedades apresenta as propriedades de uma determinada atividade de fluxo de trabalho que é removida na área do estruturador e selecionada. A figura à esquerda mostra as propriedades de Atribuir atividade. Para cada atividade, as propriedades diferem e são utilizadas ao configurar o fluxo de trabalho personalizado. Este separador permite-lhe definir os atributos da ferramenta selecionada que foi largada no estruturador de fluxo de trabalho central. Para obter mais informações, veja Propriedades.
Barra de Tarefas: A barra de tarefas inclui três elementos: Variáveis, Argumentos e Importações. Estes elementos são utilizados em conjunto com as atividades de fluxo de trabalho. Para obter mais informações, veja Introdução de um programador ao Windows Workflow Foundation (WF) no .NET 4.
Configurar um fluxo de trabalho de importação completo na Ferramenta de Configuração do Serviço Web
Os passos seguintes mostram como configurar fluxos de trabalho de importação completos para SOAP com a Ferramenta de Configuração do Serviço Web.Aviso
Este exemplo só cria um fluxo de trabalho. Podem ser necessárias modificações ao fluxo de trabalho, como a utilização de lógica personalizada na API.
Selecione o fluxo de trabalho Importação Completa a configurar. Os Argumentos e Importações já estão definidos e são específicos das atividades. Consulte os ecrãs seguintes para obter mais informações.
Após a reconfiguração das chamadas, altere os nomes dos atributos que mudam, adicione ou altere o espaço de nomes para variáveis que se referem à estrutura de retorno da API e aos tipos de objeto que se referem ao espaço de nomes antigo. A caixa de ferramentas no painel direito contém todas as atividades personalizadas específicas do fluxo de trabalho necessárias para a configuração. Atribua os valores às variáveis que vai utilizar para a sua lógica. Aceda à secção inferior do estruturador de fluxo de trabalho central e declare as variáveis. As variáveis são declaradas no próximo passo.
Adicionar uma atividade de Sequência. Arraste o estruturador de atividade Sequência da Caixa de Ferramentas e largue-o na superfície de Designer fluxo de trabalho do Windows. Veja os ecrãs seguintes. A atividade Sequência contém uma coleção ordenada de atividades subordinadas que executa por ordem.
Para adicionar uma variável, localize Criar Variável. Escreva wsResponse para o Nome, selecione o menu pendente Tipo de variável e, em seguida, selecione Procurar Tipos. É apresentada uma caixa de diálogo. SelecioneRespostapredefinida>gerada>. Mantenha os valores Âmbito e Predefinidos desmarcados. Em alternativa, defina estes valores com a vista Propriedades .
Agora, adicione todas as outras variáveis e abaixo encontra-se o ecrã final.
Arraste mais um estruturador de atividade sequência da Caixa de Ferramentas dentro da atividade Sequência já adicionada.
Arraste um WebServiceCallActivity apresentado em Comum. Esta atividade é utilizada para invocar a operação de serviço Web disponível após a Deteção. Esta é uma atividade personalizada e é comum em diferentes cenários de operação.
Para utilizar a operação do serviço Web, defina as seguintes propriedades:
Nome do Serviço: introduza um nome para o serviço Web.
Nome do Ponto Final: especifique um nome de ponto final para o serviço selecionado.
Nome da Operação: especifique a respetiva operação para o serviço.
Argumento: selecione Argumentos. Na caixa de diálogo seguinte, atribua os valores do argumento, conforme mostrado na seguinte figura:
Importante
Não altere o Nome, Direção ou Tipo para um argumento através desta caixa de diálogo. Se algum destes valores for alterado, a atividade torna-se inválida. Defina apenas o Valor para o argumento . Conforme mostrado nesta figura, o valor wsResponse é definido.
Adicione uma atividade ForEach imediatamente abaixo de WebServiceCallActivity. Esta atividade é utilizada para iterar todos os atributos (âncoras e não âncoras) do tipo de objeto. Ao arrastar esta atividade para a superfície Designer fluxo de trabalho, enumera automaticamente todos os nomes de atributos do objeto. Defina os valores necessários de acordo com o ecrã seguinte:
Arraste uma atividade CreateCSEntryChangeScope no corpo de ForEach . Esta atividade é utilizada para criar uma instância do objeto CSEntryChange no domínio de fluxo de trabalho para cada registo respetivo ao obter dados da origem de dados de destino. Arrastar esta atividade fornece o ecrã abaixo. As atividades CreateAnchorAttribute são herdadas automaticamente.
Defina o valor da expressão DN como
‘string.Concat ("Employee",item.EmployeeID)’. Defina AnchorValue para EmployeeID como 'Convert.tostring(item). EmployeeID)'. Defina ObjectTypeName como Employee. Depois de efetuar estas modificações, verá o seguinte ecrã:
Nota
Os valores de âncora e os nomes dos objetos variam de acordo com o serviço Web exposto. A figura mostra um exemplo.
Arraste uma atividade CreateAttributeChange abaixo da atividade CreateAnchorAttribute . O número de atividades a arrastar é igual ao número de atributos não ancorados. Veja a seguinte figura para referência.
Arraste CreateValueChangeActivity na atividade CreateAttributeChange e defina o valor do atributo de acordo com o ecrã abaixo.
Nota
Para utilizar esta atividade, escolha e atribua os respetivos campos na lista pendente e atribua os valores. Para atributos de valores múltiplos, remova várias atividades CreateValueChangeActivity numa atividade CreateAttributeChangeActivity .
Para adicionar condições a um atributo, adicione uma atividade If , conforme mostrado na figura seguinte:
Por fim, adicione uma atividade Assign e defina a expressão, conforme mostrado na figura seguinte:
Guarde este projeto na localização
%FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.Os projetos predefinidos devem ser transferidos e guardados na localização
%FIM_INSTALL_DIR\2010\Synchronization Service\Extensionsno sistema de destino. Em seguida, os projetos são visíveis no assistente do conector do serviço Web.Ao executar o ficheiro executável, ser-lhe-á pedido que especifique a localização da instalação. Introduza a localização para guardar.
Importante
O ficheiro de projeto pode ser guardado e aberto a partir de qualquer localização (com os privilégios de acesso adequados do executor). Apenas os ficheiros de projeto guardados na
Synchronization Service\Extensionpasta podem ser selecionados no assistente do conector do Serviço Web que é acedido através da IU de Sincronização do MIM.O utilizador que está a executar a ferramenta de Configuração do Serviço Web necessita dos seguintes privilégios:
- Controlo Total para a pasta Extensão do Serviço de Sincronização.
- Leia o acesso à chave
HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parametersde registo através da qual está localizado o caminho da pasta Extensão.
Configurar fluxos de trabalho de exportação na Ferramenta de Configuração do Serviço Web
As secções seguintes mostram como exportar os fluxos de trabalho com a Ferramenta de Configuração do Serviço Web.
Adicionar fluxos de trabalho
Adicione fluxos de trabalho de exportação ao seguir estes passos na Ferramenta de Configuração do Serviço Web.Selecione o fluxo de trabalho de exportação a configurar. Em Exportar, selecione Adicionar. Os Argumentos e Importações já estão definidos e são específicos das atividades. Veja os ecrãs seguintes para referência.
Adicionar uma atividade de Sequência . Arraste o estruturador de atividade Sequência da Caixa de Ferramentas e largue-o na superfície de Designer fluxo de trabalho do Windows. A atividade Sequência contém uma coleção ordenada de atividades subordinadas que executa por ordem. Selecione Criar Variável. Atribua os valores às variáveis que vai utilizar para a sua lógica.
Nota
Os passos para adicionar uma variável estão descritos na secção para criar fluxos de trabalho de importação completos.
Arraste uma atividade ForEach dentro da atividade Sequence já adicionada para iterar sobre os valores de atributo de âncora.
Selecione Propriedades e defina os Valores de acordo com o ecrã abaixo. Aqui objectToExport é o argumento .
Definir DisplayName como ForEach<AnchorAttribute>
Defina TypeArgument como
Microsoft.MetadirectoryServices.AnchorAttribute.
Adicione uma atividade Switch no corpo ForEach do AnchorAttribute.
Adicione uma expressão de acordo com o ecrã abaixo.
Selecione Adicionar um novo caso e introduza um valor para EmployeeId. Arraste uma atividade de Sequência e, dentro dela, adicione uma atividade Atribuir .
Atribua as propriedades Para e Valor para a atividade Assign .
A atividade ForEach é utilizada para valores de âncora. Adicione outra atividade ForEach para atribuir valores que não são de âncora. Neste exemplo, é utilizada a âncora AttributeChange .
Adicione uma atividade Switch no corpo ForEach da âncora AttributeChange .
Adicione uma expressão de acordo com o ecrã abaixo.
Selecione Adicionar um novo caso e introduza um valor para FirstName. Arraste uma atividade de Sequência e, dentro dela, adicione uma atividade Atribuir . Atribua as propriedades Para e Valor para a atividade Assign .
Adicione valores para os atributos necessários, como LastName, Email, etc.
Em Comum, arraste um WebServiceCallActivity e defina Valores para os respetivos Argumentos.
Importante
Não altere o Nome, Direção ou Tipo para um argumento através desta caixa de diálogo. Se algum destes valores for alterado, a atividade torna-se inválida. Defina apenas o Valor para o argumento . Conforme mostrado nesta figura, o valor wsResponse é definido.
Por fim, adicione uma atividade If para verificar as respostas devolvidas da operação do serviço Web.
A criação do fluxo de trabalho de exportação com a operação Adicionar está concluída:
Guarde este projeto na localização %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.
Eliminar fluxos de trabalho
Elimine os fluxos de trabalho de exportação ao seguir estes passos na Ferramenta de Configuração do Serviço Web.
Selecione o fluxo de trabalho de exportação a configurar. Em Exportar, selecione Eliminar. Os Argumentos e Importações já estão definidos e são específicos das atividades. Veja os ecrãs seguintes para referência.
Adicionar uma atividade de Sequência . Selecione Criar Variável. Atribua os valores às variáveis que vai utilizar para a sua lógica.
Nota
Os passos para adicionar uma variável estão descritos na secção para criar fluxos de trabalho de importação completos.
Arraste uma atividade ForEach dentro da atividade Sequence já adicionada para iterar sobre os valores de atributo de âncora.
Selecione Propriedades e defina os Valores por ecrã abaixo. Aqui objectToExport é o argumento .
Defina DisplayName como
ForEach\<AnchorAttribute\>:
Defina o TypeArgument como
Microsoft.MetadirectoryServices.AnchorAttribute:
Adicione uma atividade Switch no corpo ForEach do AnchorAttribute.
Adicione uma expressão de acordo com o ecrã abaixo.
Selecione Adicionar um novo caso e introduza um valor para EmployeeId. Arraste uma atividade de Sequência e, dentro dela, adicione uma atividade Atribuir .
Atribua as propriedades Para e Valor para a atividade Assign .
Em Comum, arraste um WebServiceCallActivity e defina Valores para os respetivos Argumentos.
Importante
Não altere o Nome, Direção ou Tipo para um argumento através desta caixa de diálogo. Se algum destes valores for alterado, a atividade torna-se inválida. Defina apenas o Valor para o argumento . Conforme mostrado nesta figura, o valor employeeID está definido.
Por fim, adicione uma atividade If para verificar as respostas devolvidas pela operação do serviço Web.
A eliminação do fluxo de trabalho de exportação com a operação Eliminar está concluída:
Guarde este projeto na localização %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.
Substituir fluxos de trabalho
Substitua os fluxos de trabalho de exportação ao seguir estes passos na Ferramenta de Configuração do Serviço Web.
Selecione o fluxo de trabalho de exportação a configurar. Em Exportar, selecione Substituir. Os Argumentos e Importações já estão definidos e são específicos das atividades. Veja o ecrã abaixo para obter referência.
Adicionar uma atividade de Sequência .
Arraste uma atividade ForEach para <AnchorAttribute>.
Adicione outra atividade ForEach<AttributeChange> para atribuir valores não ancorados.
Por fim, o ecrã tem o seguinte aspeto. As instruções para configurar esta atividade são fornecidas na secção para adicionar fluxos de trabalho de exportação.
Em Comum, arraste um WebServiceCallActivity e defina Valores para os respetivos Argumentos.
Importante
Não altere o Nome, Direção ou Tipo para um argumento através desta caixa de diálogo. Se algum destes valores for alterado, a atividade torna-se inválida. Defina apenas o Valor para o argumento . Conforme mostrado nesta figura, o colaborador do valor está definido.
Por fim, adicione uma atividade If para verificar as respostas devolvidas da operação do serviço Web.
A substituição do fluxo de trabalho de exportação pela operação Substituir está concluída:
Guarde este projeto na localização %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.
Atividades de depuração
As seguintes atividades personalizadas estão disponíveis para ajudar a depurar o modelo de fluxo de trabalho.
Atividade de registo
A atividade Registo é utilizada para escrever mensagens de texto no ficheiro de registo. Para obter mais informações, veja Registo.
Nota
Se não conseguir depurar facilmente o fluxo de trabalho, experimente depurar o fluxo de trabalho no ambiente de produção.
Para utilizar a atividade Registo , defina as seguintes propriedades. As propriedades são visíveis quando seleciona a atividade no Fluxo de Trabalho Designer e vê as Propriedades da atividade.
Atividade WriteLine
A atividade WriteLine é utilizada para escrever mensagens de texto no escritor de um fornecedor. Se não existir nenhum escritor disponível, a atividade WriteLine escreve o texto na janela da consola.
Na caixa de texto, escreva a mensagem que pretende que seja visível no destino do escritor.
Importante
A janela da consola não pode ser utilizada para esta atividade. Utilize outro escritor de saída de janela para esta tarefa.
Para utilizar a atividade WriteLine , defina as seguintes propriedades. As propriedades são visíveis quando seleciona a atividade no Fluxo de Trabalho Designer e vê as Propriedades da atividade.
Nível de Registo: especifica a quantidade de conteúdo a escrever no valor de registo. Os valores possíveis são:
- Alta: escreva a mensagem LogText no ficheiro de registo se a gravidade do registo estiver definida como Alta.
- Verboso: escreva a mensagem LogText no ficheiro de registo se a gravidade do registo estiver definida como Verboso.
- Desativado: não escreva no ficheiro de registo.
LogText: especifica o conteúdo do texto a escrever no registo.
Etiqueta: adiciona uma etiqueta ao texto para identificar o tipo de conteúdo que está a ser escrito no registo. Os valores possíveis são: Erro, Rastreio ou Aviso.