Nova colecção Microsoft Integration (Azure e muito mais) Stencils Pack v3.0.0 disponível para Visio

É bom estar de volta a este blog e a escrever em português após algum tempo de ausência. E desta vez para partilhar com vocês a minha nova colecção de stencils para Visio 2016 e 2013. Este pacote contém um conjunto de aproximadamente 1883 símbolos/ícones que o irão ajudar a representar diagramas conceptuais com a visão geral das suas soluções, funcionalidades ou processos de integração usando BizTalk Server, Microsoft Azure e tecnologias relacionadas, assim como a arquitectura dos seus ambientes:

• BizTalk Server
• Microsoft Azure
  • BizTalk Services
  • Azure App Service (API Apps, Web Apps, Mobile Apps and Logic Apps)
  • Event Hubs
  • Service Bus
  • API Management, IoT, and Docker
  • Machine Learning, Stream Analytics, Data Factory, Data Pipelines
  • and so on
• Microsoft Flow
• PowerApps
• Power BI
• PowerShell
• Infrastructure, IaaS
• e muito mais

Este pacote é composto por 22 ficheiros:

• Microsoft Integration Stencils v3.0.0

• MIS Additional or Support Stencils v3.0.0



• MIS Apps and Systems Logo Stencils v3.0.0



• MIS Azure Additional or Support Stencils v3.0.0



• MIS Azure Others Stencils v3.0.0



• MIS Azure Stencils v3.0.0



• MIS Buildings Stencils v3.0.0



• MIS Databases Stencils v3.0.0



• MIS Deprecated Stencils v3.0.0



• MIS Developer Stencils v3.0.0



• MIS Devices Stencils v3.0.0



• MIS Files Stencils v3.0.0



• MIS Generic Stencils v3.0.0



• MIS Infrastructure Stencils v3.0.0

• MIS Integration Patterns Stencils v3.0.0

• MIS IoT Devices Stencils v3.0.0



• MIS Power BI Stencils v3.0.0



• MIS PowerApps and Flows Stencils v3.0.0



• MIS Servers (HEX) Stencils v3.0.0



• MIS Users and Roles Stencils v3.0.0

Que você pode usar e redimensionar sem perder a qualidade.

INSTRUÇÕES:

• Descarregar o arquivo e copiar para a pasta " C:\Users\you_user\Documents\My Shapes" (que é a pasta padrão para as formas personalizados do Visio)
• Para acrescentar estas novas shapes, seleccione a partir da janela Shapes: More Shapes -> My Shapes -> Microsoft Integration Stencils v2.3”
• Repita o passo anterior para os restantes ficheiros

Poderá obter esta shapes a através do Microsoft TechNet Gallery: Microsoft Integration Stencils Pack for Visio 2016/2013 v3.0.0 (16,6 MB)

Leia mais »»

Erro ao Consumir Arquivo: File transport does not have read/write privileges for receive location

Então um novo projeto foi criado, publicado e configurado no Console Administration.

Porém ao ligar a Receive Location, aparentemente a Porta nao liga, e no Event Viewer aparece o seguinte erro:

The Messaging Engine failed to add a receive location "Nome_Porta" with URL "\\maquina_rede\diretorio_compartilhado\*.*" to the adapter "FILE". Reason: "File transport does not have read/write privileges for receive location \\maquina_rede\diretorio_compartilhado\"

Causa: O usuário que está setado no Host Instance, caso não tenha sido setado na aba Authentication, precisa de permissão de leitura e escrita.

Solução 1 : Dar permissão Full Control na pasta compartilhada.

Solução 2: Se o Full Control não for possível por politicas de segurança, então será necessário conceder o acesso em uma permissão especial.

a-) Clicar na aba Security e então no botão Advanced.

b-) Clicar no botão Change Permissions, adicionar o usuario, e habilitar o Allow na opção Delete subfolder and files.

É isso. Até a próxima.

Leia mais »»

COLECÇÃO Microsoft Integration Stencils para VISIO 2016/2013

É bom estar de volta a este blog e a escrever em português após algum tempo de ausência. E desta vez para partilhar com vocês a minha nova colecção de stencils para Visio 2016 e 2013. Este pacote contém um conjunto de aproximadamente 911 símbolos/ícones que o irão ajudar a representar diagramas conceptuais com a visão geral das suas soluções, funcionalidades ou processos de integração usando BizTalk Server, Microsoft Azure e tecnologias relacionadas, assim como a arquitectura dos seus ambientes:

• BizTalk Server
• Microsoft Azure
  • BizTalk Services
  • Azure App Service (API Apps, Web Apps, Mobile Apps, PowerApps and Logic Apps)
  • Microsoft Flow
  • Event Hubs
  • Service Bus
  • API Management, IoT and Docker
  • Machine Learning, Stream Analytics, Data Factory, Data Pipelines
  • and so on
• PowerBI
• PowerShell
• And many more

Este pacote é composto por 8 ficheiros:

• Microsoft Integration Stencils v2.3 (406 Shapes)
• MIS Apps and Systems Logo Stencils v2.3 (109 shapes)
• MIS IoT Devices Stencils v2.3 (131 shapes)
• MIS Support Stencils v2.3 (108 shapes)
• MIS Servers and Hardware v2.3 (45 shapes)
• MIS Originals v2.3 (42 shapes)
• MIS Users v2.3 (40 shapes)
• MIS Devices v2.3 (30 shapes)

Que você pode usar e redimensionar sem perder a qualidade.

Instruções:

• Descarregar o arquivo e copiar para a pasta " C:\Users\you_user\Documents\My Shapes" (que é a pasta padrão para as formas personalizados do Visio)
• Para acrescentar estas novas shapes, seleccione a partir da janela Shapes: More Shapes -> My Shapes -> Microsoft Integration Stencils v2.3”
• Repita o passo anterior para os restantes ficheiros

Poderá obter esta shapes a através do Microsoft TechNet Gallery: Microsoft Integration Stencils Pack for Visio 2016/2013

Leia mais »»

VERMAS D16A XSD for BizTalk Server 2013 R2

O VERMAS é uma nova mensagem EDIFACT, criada pela UNECE para atender a definição do SOLAS de que todo container cheio antes de embarcar deve ser pesado e informado aos responsáveis pelo planejamento do Navio.

Então a UNECE publicou no dia 13/06/2016 a Guia de Implementação final da versão VERMAS D16A.

A questão é que como tudo é muito novo o Biztalk Server não tem schema criado para suportar esse novo mapa e poder trabalhar com essa mensagem.

Então por isso, baseado nessa versão, criamos um schema EFACT_D16A_VERMAS que é aceito e reconhecido pelo BizTalk.

Você pode fazer o download dessa versão no MSDN Code Gallery aqui:
VERMAS D16A XSD for BizTalk Server 2013 R2

Depois de publicar o schema no seu projeto, podemos configurar o EDIFACT Agreement normalmente:

Leia mais »»

BAPLIE 1911 XSD for BizTalk Server 2013 R2

Ola Pessoal BAPLIE é um tipo de mensagem no formato EDIFACT utilizado para ajudar a planejar o embarque do navio.

Então nessa mensagem tem informações sobre tudo o que é referente ao navio, como: número do container, o tipo, tamanho e peso, qual a carga que contem aquele container e por ai vai.

A versão mais utilizada no mercado é a D95B, e a documentação dessa versão pode ser encontrado no site oficial da UNECE.

Porém muitos terminais ainda utilizam a versão 1911, que não existe nenhum tipo de documentação oficial.

Consequentemente o BizTalk não suporta essa versão, por padrão não consegue ler esse tipo de mensagem.

Então para atender ao processo, foi necessário criarmos um schema XSD que se adequasse ao arquivo enviado, que pudesse ser lido pelo BizTalk.
Essa versão não é oficial e talvez tenha que ser feitos ajustes para cada caso.

Espero que possa ajudar!

Você pode fazer o download dessa versão no MSDN Code Gallery aqui:
BAPLIE 1911 XSD for BizTalk Server 2013 R2

Enjoy!

E você? Já ajudou a comunidade hoje?

Leia mais »»

Modulo 3 - Criando um mapa no BizTalk

Na maioria das Integrações entre Sistemas será necessário criar uma mensagem a partir de uma outra.

Por exemplo: Ao receber uma mensagem representando um pedido, eu preciso verificar se o produto realmente existe. O que envolve banco de dados e execução de procedures.

Existem várias formas de atingir esse objetivo, e um deles é criando um mapeamento entre as mensagens.

BizTalk Map

BizTalk Mapper: Ferramenta visual que faz parte do pacote do Visual Studio, utilizado para contruir os mapas, que define as transformações de dados.

Transformação de Dados: Processo de transformar um documento XML baseado em um schema de entrada em outro documento XML completamente diferente.

BizTalk Map: Arquivo .btm que vai executar o mapeamento propriamente dito. É baseado na linguagem de mercado XML Extensible Stylesheet Language Transformations (XSLT).

Extensible Stylesheet Language Transformations (XSLT): Linguagem de tranformação entre dois documentos definido pelo World Wide Web Consortium (WC3). 

Tradução de Dados: Caso especial de Transformação de dados, tipicamente usado quando envolve transformação do formato da mensagem de XML para EDI ou Flat File. Um exemplo pratico é a função do pipeline que setamos na receive e/ou send port.

Functoids: Pedaços de código em XLST ou C# para facilitar visualmente a transformação dos dados entre dois documentos. 

Criando um Mapa utilizando o BizTalk Mapper

A ferramenta BizTalk Mapper, que é integrada ao Visual Studio irá iniciar automaticamente quando criarmos um novo mapa ou adicionarmos um mapa existente (Arquivo *.btm) dentro do projeto. Ao criar um novo mapa, devemos especificar o schema de origem e o schema de destino que devem fazer parte do mesmo projeto ou ser referenciado em uma dll.

 Ao abrir um novo mapa no BizTalk Mapper temos esses 3 paineis.

Painel do Schema de Entrada - Onde será setado o schema de origem, a mensagem de entrada que vai ser transformada.

Painel do Grid do Mapa - Mostra os links e os functoids que irão controlar como a mensagem de origem será transformada na mensagem de destino.

Painel do Schema de Saida - Onde será setado o schema de saída, a mensagem de destino. Será o nosso resultado final.

É importante sabermos que o mapa é na verdade escrito em linguagem XSLT, o que nos permite uma grande liberdade na hora de criar transformações customizadas.

Recomendo fortemente a leitura deste artigo, do grande Sandro Pereira, que traz uma explicação mais detalhada sobre a construção dos mapas.

Leia mais »»

BizTalk Mapping Patterns and Best Practices – O livro está disponível para download gratuito

Sandro Pereira anunciou durante o evento BizTalk Innovation Day Oslo, que ocorreu no passado dia 25 de Setembro, o lançamento e disponibilidade do livro "BizTalk Mapping Patterns and Best Practices" de forma gratuita, uma livro com aproximadamente 400 páginas com vários exemplos práticos e dicas para programadores desenvolver os seus mapas de uma forma mais eficaz, robustos e organizados.

Autor

Sandro Pereira

Descrição do livro

O livro "BizTalk Mapping Patterns and Best Practices" é um guia prático cheio de receitas e cenários reais que podem ser usados ​​como um guia de referência para seu trabalho do dia-a-dia e destinado principalmente para programadores de BizTalk. O foco técnico do livro vai faze-lo menos aplicável para arquitetos ou administradores de BizTalk pois obriga a um conhecimento técnico mais profundo, mas poderá ser útil para eles de forma a garantir que sua equipe implemente algumas boas práticas de desenvolvimento permitindo uma maior eficácia, robustez, organização e uma melhor documentação dos seus mapas.

Este livro requer que o leitor tenha um conhecimento básico de BizTalk Server e Visual Studio. Destinado principalmente para programadores de BizTalk de nível intermédio e avançado, e que tenha experiência anterior no desenvolvimento de mapas de BizTalk por forma a que possam aprender alguns novos truques ou poderem melhorar o seu já extenso conhecimento. Mas, como todas as exemplos e padrões presentes neste livro são muito detalhados e o mesmo contêm um capítulo para descrever os princípios básicos dos mapas, o livro também pode ser usado por programadores que estão a começar a sua atividade em projetos de BizTalk.

Com este livro você pode ganhar alguns insights sobre como as transformações podem ser realizadas, quais são os padrões mais comuns e como funcionam os Mapas e você pode usar este livro como um guia de referência para suas transformações do dia-a-dia.

Padrões abordados:

• Direct Translation Pattern
• Data Translation Pattern
• Content Enricher Pattern
• Aggregator Pattern
• Content Filter Pattern
• Splitter Pattern
• Grouping Pattern
• Sorting Pattern
• Conditional Pattern
• Looping Pattern
• Canonical Data Model Pattern
• Name-Value Transformation Pattern

Revisores Técnicos

Steef-Jan Wiggers, Nino Crudele, Michael Stephenson e José António Silva

 

Saiba mais sobre o livro e descarregue a sua copia de forma gratuita aqui: http://www.biztalk360.com/biztalk-mapping-patterns/

Leia mais »»

Modulo 2 – Criando Schemas XML e Flat File

No Biztalk podemos criar um schema XSD de várias formas:

1. Criar um schema sem uma instancia da mensagem.
2. Criar um schema através de uma instancia bem formada de XML.
3. Utilizar o Wizard para criar schemas de um arquivo Flat File (txt).
4. Utilizar o Wizard para consumir um serviço WCF e criar o respectivo schema.
5. Importar ao projeto um schema, arquivo xsd, já pronto, como no caso dos schemas EDI.

Ao longo desses anos, postamos aqui no blog vários exemplos de como criar esses tipos de schema:

Flat File

Criar schema Flat File Posicional

Criar schema Flat File baseado em símbolos

SQL Adapter

Criando schema do SQL Adapter através de procedure
Criando schema do SQL Adapter com Updategram

WCF-SAP

Criando schema RFC Destination

WCF-SQL

Criando Schema WCF-SQL procedure FOR XML
Criando schema Procedure na ReceivePort
Inserir Varios registros com procedure na SendPort
Como fazer debatching na Receive Port

WCF-Oracle

Criando schemas
Criando procedure Tipada
Configurando Receive Port

EDI

Os schemas dos arquivos no padrão EDI já vem pré-instalados junto com o BizTalk.

Então para utiliza-los basta executar o arquivo MicrosoftEdiXSDTemplates.exe, que irá descompactar os schemas e criar uma pasta com o mesmo nome do seguinte diretório:

C:\Program Files (x86)\Microsoft BizTalk Server 2013\XSD_Schema\EDI

Dentro dessa pasta vamos encontrar todos os schemas que o BizTalk suporta. A partir daí, basta copiar e adicioná-los ao nosso projeto.

Testando os Schemas

Criar e Testar schemas a partir de uma Instancia XML.

Nesse artigo vimos como criar vários tipos de schemas.

Até a próxima.

Leia mais »»

Criando e Testando Schemas BizTalk Editor

No BizTalk podemos criar schemas de várias maneiras, nesse artigo vou demonstrar como criar um schema a partir de um XML bem formado e utilizando o BizTalk Schema Editor.

Criando Schema a Partir de uma Instancia XML

Vamos considerar a seguinte Instancia de XML

   1:  <ns0:Root xmlns:ns0="http://CriandoSchemas.schInstanciaXML">

   2:    <ns0:Funcionarios>

   3:      <ns0:Codigo>1</ns0:Codigo>

   4:      <ns0:Nome>Ruth Resende</ns0:Nome>

   5:      <ns0:Cargo>Analista de Sistemas</ns0:Cargo>

   6:    </ns0:Funcionarios>

   7:  </ns0:Root>

1 - Salve esse arquivo em algum diretório.

2 - Crie um projeto de BizTalk

3 - Clique com o botão direito em cima do Projeto e em Add –> Add Generated Items.

4 - No painel esquerdo clique em Generate Schemas –> Generate Schemas.





5 - Clique em Add.

6 - Em Document type, escolha Well-Formed XML.

7 - Em Input file, procure o arquivo XML.



8 - Clique em OK.

Segue o Schema criado a partir da mensagem.

Criando schema pelo Biztalk Editor

1 - Vamos criar o mesmo schema, mas na munheca usando o BizTalk Schema Editor.

2 - Clique com o botão direito em cima do Projeto e em Add –> New Item.

3 – Escolha a opção Schema e de um nome para o arquivo. Nesse caso nomeei schFuncionario.xsd



4 – Clique em Add.

Como podemos notar o arquivo foi criado, ele tem um Root Node que por padrão é chamado de Root (o que pode ser alterado) e também foi dado um Namespace padrão pra ele ( o que também pode ser alterado).

5 – Clique com o botão direito em cima do Root Node e em Insert Schema Node –> Child Record.

Esse Node, é criado quando queremos agrupar informações (campos), que podem ou não se repetir.

6 – Coloque o nome de Funcionarios.

Cada Node do Schema tem suas próprias propriedades.

7 – Clique no Node Funcionarios e na Opção Max Occurs, coloque um ‘*’ (asterisco) , ou escreva unbounded.

Isso indica que o Node Funcionarios pode se repetir infinitamente.

8 – Clique com o botão direito no Node Funcionarios e em Insert Schema Node –> Child Field Element

Essa opção Child Field Element criará um elemento abaixo do Node Funcionarios. Para criar um atributo basta escolher Child Field Atributte.

9 – Coloque o Nome do Campo de Codigo.

10 – Repita o passo 8 e 9 para os campos Nome e Cargo.

11 – Salve o Schema.

Gerando uma Intancia XML do Schema

É possível gerar um modelo do Schema e para verificar como deveriamos receber a mensagem do BizTalk.

1 – Clique com o botão direiro em cima do schema schFuncionario.xsd e em Generate Instance.

Isso irá criar uma Instancia do XML daquele Schema.

2 – Para visualizar a Instancia criada, visualize no Painel Inferior do Visual Studio, janela Output, o link com o caminho do XML. Com a tecla CTRL pressionada, clique nesse link.

O Visual Studio mostra o arquivo em um tipo de Pagina Html, a qual não conseguimos fazer qualquer tipo de alteração com o arquivo.

3 – Em cima do text em XML, clique com o botão direito e em View Source. Agora sim o arquivo poderá ser editado.

Testando a Instancia de XML contra o Schema

O BizTalk disponibiliza alguns recursos muito úteis quando queremos testar e ver se uma determinada instancia de XML combina com o schema que temos.

1 – Clique no schema schFuncionario.xsd e configure as seguinte propriedades:

• Generate Instance Output Type – XML ou Native. Essa propriedade configura o tipo de saida dessa mensagem, se for Native, a saída será em TXT ou EDI, e XML será em XML mesmo.
• Input Instance FileName – Aponte uma instancia do XML que precisa ser testada.
• Output Instance FileName – Apontar um caminho de saida da mensagem.
• Validate Instance Input Type – XML ou Native. Essa propiedade configura o tipo de Entrada que queremos testar. Native pode ser Txt ou EDI.

2 – Clique com o botão direito no Schema  e em Validate Instance.

O BizTalk vai validar a Instancia e o resultado vai aparecer na tela Output do Visual Studio, que normalmente fica no Painel inferior.

Nesse meu caso deu erro porque o Namespace da minha Instancia está errado.

Alterando o Namespace da minha Instancia

Hoje vimos como criar schemas a partir de Instancias de XML, como também Criar Schemas utilizando o Biztalk Schema Editor além de gerar uma Instancia e testar o Schema.

Até a próxima.

Leia mais »»

Criando Schema Flat File Posicional

Vamos imaginar que precisamos criar schemas para receber um arquivo Flat File do tipo posicional.
Como esse:



Então o arquivo tem um cabeçalho, e o corpo como texto.

Esse arquivo contem 3 campos:

CODIGO – Posicao 0 a 6
PRODUTO – Posicao 7 a 20
QUANTIDADE – Posicao 21 a 30

Importando o Schema

Crie um projeto do tipo Biztalk.
Esse arquivo vai se dividir em dois schemas, um representando o Header e o outro representando o Body.
1 - Clique com o botão direito em cima do projeto e em Add –>; New Item.

2 - Escolha a opção Flat File Schema Wizard.

3 - De um nome para o schema, aqui usei o schHeaderProduto.xsd.

4 - Clique em Add.

5 - A tela BizTalk Flat File Schema Wizard vai aparecer. Clique em Next.

6 - No campo Instance file, procure a instancia do Arquivo que queremos importar.

7 - No campo Record Name, esse vai ser o Root do nosso schema. Nesse caso, coloquei Header.

8 - No campo Target namespace, podemos escolher o Namespace que o schema terá. Como o arquivo do Body deverá ter o mesmo namespace que o arquivo do Header, coloquei o valor http://BizTalk_Server_Project1.schProduto .

9 - No campo Code Page, deixei o UTF-8 que é o padrão. Porém se o arquivo contiver caracteres especiais sugiro escolher o Western-European (1252). Pois podemos ter problemas como descrito aqui.

10 - Clique em Next.
11 - Nessa tela devemos selecionar os dados que devem ser considerados. Útil quando o arquivo tem muitos registros.
12 - Selecione apenas o Header.



13 - Clique em Next.
14 - Nessa tela ele pergunta como queremos identificar os registros, como o arquivo é baseado em posição, Escolha a opção By relative positions.



15 - Clique em Next.
16 - Clicando na posição, delimite os campos, como no exemplo a seguir:



17 - Clique em Next.
18 - Nessa tela nomeie os campos com nomes sugestivos.



19 - Clique em Next.



20 - Clique em Finish. O arquivo schHeaderProduto.xsd foi criado.
21 – Repita os passos de 1 ao 9 para criar o arquivo de schBodyProduto.xsd



22 - Clique em Next.
23 - Selecione somente os registros que representam o corpo do arquivo.



24 - Clique em Next.
25 - Como vamos criar um Record que se repete, escolha a opção By delimiter positions.



26 - Clique em Next.
27 - Nessa tela escolha o simbolo que delimita o registro. Aqui será o ENTER, representado pelo {CR}{LF}

28 - Clique em Next.

29 - No primeiro registro, no campo Element Name, coloque um nome para o Record, no caso Produtos.

30 - No campo Element Type, escolha o tipo Repeating record.

31 - E nos outros registros no campo Element Type, escolha Ignore.

32 - Clique em Next.
33 - Ficará assim:



34 - Clique em Next.
35 - Selecione o primeiro registro.



36 - Clique em Next.
37 - Escolha a opção By relative positions.



38 - Clique em Next.
39 - Clique no posição para delimitar os campos.



40 - Clique em Next.
41 - No campo Element Name, coloque nomes sugestivos.



42 - Clique em Next.

43 - Clique em Finish. E o arquivo schBodyProduto.xsd foi criado no seu projeto.

Ao abrirmos esse arquivo no Visual Studio, podemos notar que o Record Produtos foi criado com a propriedade Max Occurs igual unbounded. Isso quer dizer que esse Node pode se repetir várias vezes.

Hoje vimos como criar um schema de um arquivo Flat File Posicional.

Mas somente criar o schema que representa o Arquivo não basta, para o BizTalk conseguir traduzir isso tudo para o XML, precisamos criar um Pipeline Customizado, como ensina meu amigo Sandro Pereira neste Post.

Até a próxima.

Leia mais »»