Adicionar esquemas para usar com fluxos de trabalho com os Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Ações de fluxo de trabalho, como Arquivo simples e Validação XML, exigem um esquema para executar suas tarefas. Por exemplo, a ação Validação de XML requer um esquema XML para verificar se os documentos usam XML válido e têm os dados esperados no formato predefinido. Este esquema é um documento XML que usa a linguagem XSD (XML Schema Definition) e tem a extensão de nome de arquivo .xsd. As ações Arquivo simples usam um esquema para codificar e decodificar conteúdo XML.

Este artigo mostra como adicionar um esquema à sua conta de integração. Se você estiver trabalhando com um fluxo de trabalho de aplicativo lógico padrão, também poderá adicionar um esquema diretamente ao recurso do aplicativo lógico.

Pré-requisitos

• Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição, inscreva-se numa conta gratuita do Azure.

• O arquivo de esquema que você deseja adicionar. Para criar esquemas, você pode usar o Visual Studio 2019 e a Extensão de Ferramentas de Integração Empresarial de Aplicativos Lógicos do Microsoft Azure.

  Nota

  Não instale a extensão juntamente com a extensão do BizTalk Server. Ter ambas as extensões pode produzir um comportamento inesperado. Certifique-se de que tem apenas uma destas extensões instaladas.

  Em monitores de alta resolução, você pode enfrentar um problema de exibição com o designer de mapa no Visual Studio. Para resolver esse problema de exibição, reinicie o Visual Studio no modo sem reconhecimento de DPI ou adicione o valor do Registro DPIUNWARE.

• Com base no fato de você estar trabalhando em um fluxo de trabalho de aplicativo lógico Consumo ou Padrão, você precisará de um recurso de conta de integração. Normalmente, você precisa desse recurso quando deseja definir e armazenar artefatos para uso em integração empresarial e fluxos de trabalho B2B.

  Importante

  Para trabalhar em conjunto, sua conta de integração e o recurso do aplicativo lógico devem existir na mesma assinatura do Azure e na mesma região do Azure.

  • Se você estiver trabalhando em um fluxo de trabalho de aplicativo lógico de consumo, precisará de uma conta de integração vinculada ao recurso do aplicativo lógico.

  • Se você estiver trabalhando em um fluxo de trabalho de aplicativo lógico padrão, poderá vincular sua conta de integração ao recurso do aplicativo lógico, carregar esquemas diretamente para o recurso do aplicativo lógico ou ambos, com base nos seguintes cenários:

    • Se você já tiver uma conta de integração com os artefatos que precisa ou deseja usar, poderá vincular sua conta de integração a vários recursos do aplicativo lógico padrão onde deseja usar os artefatos. Dessa forma, você não precisa carregar esquemas para cada aplicativo lógico individual. Para obter mais informações, consulte Vincular seu recurso de aplicativo lógico à sua conta de integração.

    • O conector interno de arquivo simples permite selecionar um esquema que você carregou anteriormente para o recurso do aplicativo lógico ou para uma conta de integração vinculada, mas não ambos. Em seguida, você pode usar esse artefato em todos os fluxos de trabalho filho dentro do mesmo recurso de aplicativo lógico.

    Então, se você não tem ou precisa de uma conta de integração, você pode usar a opção de upload. Caso contrário, você pode usar a opção de vinculação. De qualquer forma, você pode usar esses artefatos em todos os fluxos de trabalho filho dentro do mesmo recurso de aplicativo lógico.

Limitações

• Os limites se aplicam ao número de artefatos, como esquemas, por conta de integração. Para obter mais informações, consulte Limites e informações de configuração para Aplicativos Lógicos do Azure.

• Com base no fato de você estar trabalhando em um fluxo de trabalho de aplicativo lógico Consumo ou Padrão, limites de tamanho de arquivo de esquema podem ser aplicados.

  • Se você estiver trabalhando com fluxos de trabalho padrão, nenhum limite se aplica aos tamanhos de arquivo de esquema.

  • Se você estiver trabalhando com fluxos de trabalho de Consumo, os seguintes limites se aplicam:

    • Se o esquema for de 2 MB ou menos, você poderá adicionar o esquema à sua conta de integração diretamente do portal do Azure.

    • Se o esquema for maior que 2 MB, mas não maior do que o limite de tamanho para esquemas, você precisará de uma conta de armazenamento do Azure e um contêiner de blob onde possa carregar seu esquema. Em seguida, para adicionar esse esquema à sua conta de integração, você pode vincular à sua conta de armazenamento a partir da sua conta de integração. Para esta tarefa, a tabela a seguir descreve os itens necessários:

      Item	Description
      Conta de armazenamento do Azure	Nessa conta, crie um contêiner de blob do Azure para seu esquema. Saiba como criar uma conta de armazenamento.
      Contentor de blobs	Neste contêiner, você pode carregar seu esquema. Você também precisará do URI de conteúdo desse contêiner mais tarde quando adicionar o esquema à sua conta de integração. Saiba como criar um contêiner de blob.
      Explorador do Storage do Azure	Essa ferramenta ajuda você a gerenciar mais facilmente contas de armazenamento e contêineres de blob. Para usar o Gerenciador de Armazenamento, escolha uma etapa: - No portal do Azure, selecione sua conta de armazenamento. No menu da conta de armazenamento, selecione Gerenciador de Armazenamento. - Para a versão desktop, baixe e instale o Gerenciador de Armazenamento do Azure. Em seguida, conecte o Gerenciador de Armazenamento à sua conta de armazenamento seguindo as etapas em Introdução ao Gerenciador de Armazenamento. Para saber mais, consulte Guia de início rápido: criar um blob no armazenamento de objetos com o Gerenciador de Armazenamento do Azure.

      Para adicionar esquemas maiores, você também pode usar a API REST dos Aplicativos Lógicos do Azure - Esquemas. Para fluxos de trabalho padrão, a API REST dos Aplicativos Lógicos do Azure não está disponível no momento.

• Normalmente, quando você está usando uma conta de integração com seu fluxo de trabalho, adiciona o esquema a essa conta. No entanto, se você estiver fazendo referência ou importando um esquema que não esteja em sua conta de integração, poderá receber o seguinte erro ao usar o elemento xsd:redefine:

  An error occurred while processing the XML schemas: ''SchemaLocation' must successfully resolve if <redefine> contains any child other than <annotation>.'.

  Para resolver esse erro, você precisa usar o elemento xsd:import ou xsd:include em vez de xsd:redefine, ou usar um URI.

Considerações para adicionar esquemas

• Se você estiver trabalhando com um fluxo de trabalho de Consumo, deverá adicionar seu esquema a uma conta de integração vinculada.

• Se estiver a trabalhar com um fluxo de trabalho Padrão, tem as seguintes opções:

  • Adicione seu esquema a uma conta de integração vinculada. Você pode compartilhar o esquema e a conta de integração entre vários recursos do aplicativo lógico padrão e seus fluxos de trabalho filho.

  • Adicione seu esquema diretamente ao recurso do aplicativo lógico. No entanto, você só pode compartilhar esse esquema entre fluxos de trabalho filho no mesmo recurso de aplicativo lógico.

Adicionar esquema à conta de integração

1. No portal do Azure, entre com suas credenciais de conta do Azure.

2. Na caixa de pesquisa principal do Azure, insira contas de integração e selecione Contas de integração.

3. Selecione a conta de integração onde você deseja adicionar seu esquema.

4. No menu da sua conta de integração, em Configurações, selecione Esquemas.

5. Na barra de ferramentas do painel Esquemas, selecione Adicionar.

Adicionar esquemas ao aplicativo lógico

Consumo

Para fluxos de trabalho de Consumo, com base no tamanho do arquivo do esquema, siga as etapas para carregar um esquema de até 2 MB ou mais de 2 MB, até 8 MB.

Adicionar esquemas de até 2 MB

1. No painel Adicionar esquema, insira um nome para o esquema. Mantenha o arquivo Pequeno selecionado. Ao lado da caixa Esquema , selecione o ícone da pasta. Localize e selecione o esquema que você está carregando.

2. Quando tiver terminado, selecione OK.

   Depois que o carregamento do esquema terminar, o esquema aparecerá na lista Esquemas .

Adicionar esquemas com mais de 2 MB

Para adicionar esquemas maiores para fluxos de trabalho de Consumo usarem, você pode usar a API REST dos Aplicativos Lógicos do Azure - Esquemas ou carregar seu esquema em um contêiner de blob do Azure em sua conta de armazenamento do Azure. Suas etapas para adicionar esquemas diferem com base no fato de seu contêiner de blob ter acesso público de leitura. Portanto, primeiro, verifique se seu contêiner de blob tem ou não acesso de leitura pública seguindo estas etapas: Definir nível de acesso público para contêiner de blob

Verificar o nível de acesso ao contêiner

1. Abra o Explorador de Armazenamento do Azure. Na janela Explorer, expanda sua assinatura do Azure se ainda não estiver expandida.

2. Expanda Contas de armazenamento> {sua-conta-de-armazenamento} >Contêineres de Blob. Selecione seu contêiner de blob.

3. No menu de atalho do contêiner de blob, selecione Definir Nível de Acesso Público.

   • Se o contêiner de blob tiver pelo menos acesso público, selecione Cancelar e siga estas etapas mais adiante nesta página: Carregar para contêineres com acesso público

     

   • Se o contêiner de blob não tiver acesso público, selecione Cancelar e siga estas etapas mais adiante nesta página: Carregar para contêineres sem acesso público

     

Carregar para contentores com acesso público

1. Carregue o esquema para sua conta de armazenamento. Na janela da direita, selecione Carregar.

2. Depois de concluir o upload, selecione o esquema carregado. Na barra de ferramentas, selecione Copiar URL para copiar a URL do esquema.

3. Retorne ao portal do Azure onde o painel Adicionar Esquema está aberto. Insira um nome para o assembly. Selecione Arquivo grande (maior que 2 MB).

   A caixa URI de conteúdo agora é exibida, em vez da caixa Esquema .

4. Na caixa URI de conteúdo, cole a URL do esquema. Termine de adicionar seu esquema.

Depois que o carregamento do esquema terminar, o esquema aparecerá na lista Esquemas . Na página Visão geral da sua conta de integração, em Artefatos, o esquema carregado é exibido.

Carregar para contentores sem acesso público

1. Carregue o esquema para sua conta de armazenamento. Na janela da direita, selecione Carregar.

2. Depois de concluir o carregamento, gere uma assinatura de acesso compartilhado (SAS) para seu esquema. No menu de atalho do esquema, selecione Obter assinatura de acesso compartilhado.

3. No painel Assinatura de Acesso Compartilhado, selecione Criar URI> de assinatura de acesso compartilhado no nível de contêiner. Depois que a URL SAS for gerada, ao lado da caixa URL , selecione Copiar.

4. Retorne ao portal do Azure onde o painel Adicionar Esquema está aberto. Selecione Arquivo grande.

   A caixa URI de conteúdo agora é exibida, em vez da caixa Esquema .

5. Na caixa URI de conteúdo, cole o URI SAS gerado anteriormente. Termine de adicionar seu esquema.

Depois que o carregamento do esquema terminar, o esquema aparecerá na lista Esquemas . Na página Visão geral da sua conta de integração, em Artefatos, o esquema carregado é exibido.

Standard

Para um recurso de aplicativo lógico padrão, as etapas a seguir se aplicam somente se você quiser adicionar um esquema diretamente ao seu recurso. Caso contrário, adicione o esquema à sua conta de integração.

Portal do Azure

1. No menu de recursos do aplicativo lógico, em Configurações, selecione Esquemas.

2. Na barra de ferramentas do painel Esquemas, selecione Adicionar.

3. No painel Adicionar esquema, insira um nome exclusivo para o esquema.

4. Ao lado da caixa Esquema , selecione o ícone da pasta. Selecione o esquema a ser carregado.

5. Quando tiver terminado, selecione OK.

   Depois que o arquivo de esquema terminar de carregar, o esquema aparecerá na lista Esquemas . Na página Visão geral da sua conta de integração, em Artefatos, o esquema carregado também aparece.

Visual Studio Code

1. Na estrutura do seu projeto de aplicativo lógico, abra a pasta Artefatos e, em seguida, a pasta Esquemas .

2. Na pasta Esquemas, adicione seu esquema.

Editar um esquema

Para atualizar um esquema existente, você precisa carregar um novo arquivo de esquema com as alterações desejadas. No entanto, você pode primeiro baixar o esquema existente para edição.

Consumo

1. No portal do Azure, abra sua conta de integração, se ainda não estiver aberta.

2. No menu da sua conta de integração, em Configurações, selecione Esquemas.

3. Depois que o painel Esquemas for aberto, selecione seu esquema. Para baixar e editar o esquema primeiro, na barra de ferramentas do painel Esquemas, selecione Baixar e salve o esquema.

4. Quando estiver pronto para carregar o esquema atualizado, no painel Esquemas , selecione o esquema que deseja atualizar. Na barra de ferramentas do painel Esquemas, selecione Atualizar.

5. Localize e selecione o esquema atualizado que deseja carregar.

6. Quando tiver terminado, selecione OK.

   Depois que o upload do arquivo de esquema terminar, o esquema atualizado aparecerá na lista Esquemas .

Standard

As etapas a seguir se aplicam somente se você estiver atualizando um esquema adicionado ao recurso do aplicativo lógico. Caso contrário, siga as etapas de Consumo para atualizar um esquema em sua conta de integração.

1. No portal do Azure, abra o recurso do aplicativo lógico, se ainda não estiver aberto.

2. No menu de recursos do aplicativo lógico, em Configurações, selecione Esquemas.

3. Depois que o painel Esquemas for aberto, selecione seu esquema. Para baixar e editar o esquema primeiro, na barra de ferramentas do painel Esquemas, selecione Baixar e salve o esquema.

4. Na barra de ferramentas do painel Esquemas, selecione Adicionar.

5. No painel Adicionar esquema, insira um nome exclusivo para o esquema.

6. Ao lado da caixa Esquema , selecione o ícone da pasta. Selecione o esquema a ser carregado.

7. Quando tiver terminado, selecione OK.

   Depois que o upload do arquivo de esquema terminar, o esquema atualizado aparecerá na lista Esquemas .

Excluir um esquema

Consumo

1. No portal do Azure, abra sua conta de integração, se ainda não estiver aberta.

2. No menu da sua conta de integração, em Configurações, selecione Esquemas.

3. Depois que o painel Esquemas for aberto, selecione seu esquema e, em seguida, selecione Excluir.

4. Para confirmar que deseja excluir o esquema, selecione Sim.

Standard

As etapas a seguir se aplicam somente se você estiver excluindo um esquema adicionado ao recurso do aplicativo lógico. Caso contrário, siga as etapas de Consumo para excluir um esquema da sua conta de integração.

1. No portal do Azure, abra o recurso do aplicativo lógico, se ainda não estiver aberto.

2. No menu de recursos do aplicativo lógico, em Configurações, selecione Esquemas.

3. Depois que o painel Esquemas for aberto, selecione seu esquema e, em seguida, selecione Excluir.

4. Para confirmar que deseja excluir o esquema, selecione Sim.

Próximos passos

• Validar XML para fluxos de trabalho nos Aplicativos Lógicos do Azure
• Transformar XML para fluxos de trabalho em Aplicativos Lógicos do Azure