Adicione esquemas para usar com fluxos de trabalho com apps Azure Logic

Ações de fluxo de trabalho como o Ficheiro Plano e a Validação XML requerem um esquema para executar as suas tarefas. Por exemplo, a ação de validação XML requer um esquema XML para verificar se os documentos utilizam XML válido e têm os dados esperados no formato predefinido. Este esquema é um documento XML que utiliza a linguagem XML Schema Definition (XSD) e tem a extensão do nome do ficheiro .xsd. As ações do Ficheiro Plano utilizam um esquema para codificar e descodificar o conteúdo XML.

Este artigo mostra como adicionar um esquema à sua conta de integração. Se estiver a trabalhar com um fluxo de trabalho de aplicações lógica padrão, também pode adicionar um esquema diretamente ao seu recurso de aplicação lógica.

Pré-requisitos

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

  • O ficheiro de esquema que pretende adicionar. Para criar esquemas, pode utilizar as seguintes ferramentas:

    Nota

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

    Em monitores de alta resolução, você pode experimentar um problema de exibição com o designer de mapas em Visual Studio. Para resolver este problema de exibição, reinicie o Visual Studio no modo DPI-unaware ou adicione o valor do registo DPIUNAWARE.

  • Com base no facto de estar a trabalhar num fluxo de trabalho de aplicações lógicas de Consumo ou Padrão, vai precisar de um recurso de conta de integração. Normalmente, você precisa deste recurso quando você quer definir e armazenar artefactos para uso na integração empresarial e fluxos de trabalho B2B.

    Importante

    Para trabalhar em conjunto, tanto a sua conta de integração como o recurso de aplicação lógica devem existir na mesma subscrição Azure e na região de Azure.

    • Se estiver a trabalhar num fluxo de trabalho de aplicações lógicas de Consumo, precisará de uma conta de integração ligada ao recurso da sua aplicação lógica.

    • Se estiver a trabalhar num fluxo de trabalho de aplicações lógica padrão, pode ligar a sua conta de integração ao seu recurso de aplicação lógica, enviar esquemas diretamente para o seu recurso de aplicação lógica, ou ambos, com base nos seguintes cenários:

      • Se já tem uma conta de integração com os artefactos que precisa ou quer usar, pode ligar a sua conta de integração a vários recursos de aplicações lógicas Standard onde pretende utilizar os artefactos. Dessa forma, não é preciso carregar esquemas para cada aplicação lógica individual. Para mais informações, reveja Link o seu recurso de aplicação lógica para a sua conta de integração.

      • O conector incorporado flat File permite-lhe selecionar um esquema que já carregou para o seu recurso de aplicação lógica ou para uma conta de integração ligada, mas não ambos. Em seguida, pode utilizar este artefacto em todos os fluxos de trabalho das crianças dentro do mesmo recurso de aplicação lógica.

      Portanto, se não tiver ou precisar de uma conta de integração, pode usar a opção de upload. Caso contrário, pode utilizar a opção de ligação. De qualquer forma, você pode usar estes artefactos em todos os fluxos de trabalho de criança dentro do mesmo recurso de aplicação lógica.

Limitações

  • Os limites aplicam-se ao número de artefactos, tais como esquemas, por conta de integração. Para mais informações, reveja limites e informações de configuração para Azure Logic Apps.

  • Com base no facto de estar a trabalhar num fluxo de trabalho de aplicações lógicas de Consumo ou padrão, podem aplicar-se limites de tamanho de ficheiros de esquema.

    • Se estiver a trabalhar com fluxos de trabalho standard, não se aplicam limites aos tamanhos dos ficheiros de esquema.

    • Se estiver a trabalhar com fluxos de trabalho de consumo, aplicam-se os seguintes limites:

  • Normalmente, quando se usa uma conta de integração com o seu fluxo de trabalho, adiciona-se o esquema a essa conta. No entanto, se estiver a fazer referência ou a importar um esquema que não esteja na sua conta de integração, poderá receber o seguinte erro quando utilizar 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 este erro, é necessário utilizar o elemento xsd:import ou xsd:include em vez de xsd:redefine, ou utilizar um URI.

Adicionar esquemas

  • Se estiver a trabalhar com um fluxo de trabalho de consumo, deve adicionar o seu esquema a uma conta de integração ligada.

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

    • Adicione o seu esquema a uma conta de integração ligada. Você pode compartilhar o esquema e a conta de integração através de vários recursos de aplicativos lógicos Standard e seus fluxos de trabalho infantil.

    • Adicione o seu esquema diretamente ao seu recurso de aplicação lógica. No entanto, só é possível partilhar esse esquema através de fluxos de trabalho infantis no mesmo recurso de aplicação lógica.

Adicionar esquema à conta de integração

  1. Na portal do Azure, inscreva-se com as suas credenciais de conta 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 pretende adicionar o seu esquema.

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

  5. Na barra de ferramentas do painel de esquemas , selecione Add.

Para consumo fluxos de trabalho, com base no tamanho do ficheiro do seu esquema, siga agora os passos para o upload de um esquema que seja até 2 MB ou mais de 2 MB, até 8 MB.

Adicione esquemas até 2 MB

  1. No painel Add Schema , insira um nome para o seu esquema. Mantenha o ficheiro Small selecionado. Ao lado da caixa Schema , selecione o ícone da pasta. Encontre e selecione o esquema que está a carregar.

  2. Quando tiver terminado, selecione OK.

    Depois do seu esquema terminar o upload, o esquema aparece na lista de Schemas .

Adicionar esquemas mais de 2 MB

Para adicionar esquemas maiores para consumo de fluxos de trabalho a utilizar, pode utilizar as aplicações AZure Logic REST API - Schemas ou fazer o upload do seu esquema para um recipiente de bolhas Azure na sua conta de armazenamento Azure. Os seus passos para adicionar esquemas diferem com base no facto de o seu recipiente de bolhas ter acesso público. Primeiro, verifique se o seu recipiente de bolhas tem ou não acesso ao público, seguindo estes passos: Definir o nível de acesso público para o recipiente blob

Verifique o nível de acesso ao contentor

  1. Abra Explorador de Armazenamento do Azure. Na janela Explorer, expanda a subscrição do Azure se não for já expandida.

  2. Expandir contas> de armazenamento {sua conta de armazenamento} >Recipientes blob. Selecione o seu recipiente blob.

  3. No menu de atalho do seu recipiente blob, selecione Definir o Nível de Acesso Público.

Upload para contentores com acesso público

  1. Faça o upload do esquema para a sua conta de armazenamento. Na janela da direita, selecione Upload.

  2. Depois de terminar o upload, selecione o seu esquema carregado. Na barra de ferramentas, selecione Copy URL para que copie o URL do esquema.

  3. Volte ao portal do Azure onde está aberto o painel Add Schema. Insira um nome para a sua assembleia. Selecione Ficheiro Grande (superior a 2 MB).

    A caixa Content URI aparece agora, em vez da caixa Schema .

  4. Na caixa Content URI , cole o URL do seu esquema. Termine de adicionar o seu esquema.

Depois do seu esquema terminar o upload, o esquema aparece na lista de Schemas . Na página geral da sua conta de integração, em Artefactos, o seu esquema carregado aparece.

Upload para contentores sem acesso público

  1. Faça o upload do esquema para a sua conta de armazenamento. Na janela da direita, selecione Upload.

  2. Depois de terminar o upload, gere uma assinatura de acesso partilhado (SAS) para o seu esquema. No menu de atalho do seu esquema, selecione Obter Assinatura de Acesso Partilhado.

  3. No painel assinatura de acesso partilhado , selecione Gerar assinatura de acesso partilhado ao nível do contentor URI>Create. Depois de o URL SAS ser gerado, junto à caixa URL , selecione Copy.

  4. Volte ao portal do Azure onde está aberto o painel Add Schema. Selecione Ficheiro Grande.

    A caixa Content URI aparece agora, em vez da caixa Schema .

  5. Na caixa Content URI , cole o SAS URI que gerou anteriormente. Termine de adicionar o seu esquema.

Depois do seu esquema terminar o upload, o esquema aparece na lista de Schemas . Na página geral da sua conta de integração, em Artefactos, o seu esquema carregado aparece.


Adicione esquema ao recurso de aplicação lógica Standard

Os seguintes passos aplicam-se apenas se pretender adicionar um esquema diretamente ao seu recurso de aplicação lógica Standard. Caso contrário, adicione o esquema à sua conta de integração.

Portal do Azure

  1. No menu do recurso da sua aplicação lógica, em Definições, selecione Schemas.

  2. Na barra de ferramentas do painel de esquemas , selecione Add.

  3. No painel de esquemas Add , insira um nome único para o seu esquema.

  4. Ao lado da caixa Schema , selecione o ícone da pasta. Selecione o esquema para carregar.

  5. Quando tiver terminado, selecione OK.

    Depois de o seu ficheiro de esquema terminar o upload, o esquema aparece na lista de Schemas . Na página geral da sua conta de integração, em Artefactos, o seu esquema carregado também aparece.

Visual Studio Code

  1. Na estrutura do seu projeto de aplicação lógica, abra a pasta Artefactos e, em seguida, a pasta Schemas .

  2. Na pasta Schemas , adicione o seu esquema.


Editar um esquema

Para atualizar um esquema existente, tem de carregar um novo ficheiro de esquema que tenha as alterações que pretende. No entanto, pode primeiro descarregar o esquema existente para edição.

  1. No portal do Azure, abra a sua conta de integração, se não já aberta.

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

  3. Depois de abrir o painel de schemas , selecione o seu esquema. Para baixar e editar o esquema primeiro, na barra de ferramentas do painel Schemas , selecione Baixar e guardar o esquema.

  4. Quando estiver pronto para carregar o esquema atualizado, no painel Schemas , selecione o esquema que pretende atualizar. Na barra de ferramentas do painel de esquemas , selecione Update.

  5. Encontre e selecione o esquema atualizado que pretende carregar.

  6. Quando tiver terminado, selecione OK.

    Depois de o seu ficheiro de esquema terminar o upload, o esquema atualizado aparece na lista de Schemas .

Apagar um esquema

  1. No portal do Azure, abra a sua conta de integração, se não já aberta.

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

  3. Depois de abrir o painel de esquemas , selecione o seu esquema e, em seguida, selecione Delete.

  4. Para confirmar que pretende eliminar o esquema, selecione Sim.

Passos seguintes