Criar mapas para transformar dados em fluxos de trabalho de aplicativos lógicos com o Visual Studio Code

Aplica-se a: Aplicativos Lógicos do Azure (Standard)

Quando você troca mensagens que usam diferentes formatos XML ou JSON em um fluxo de trabalho de aplicativo lógico, é necessário especificar como transformar ou converter os dados do formato de origem para o formato de destino, por exemplo, entre documentos XML ou documentos JSON. Essa tarefa é importante quando há discrepâncias entre as estruturas de dados nos esquemas de origem e destino. Um esquema descreve os elementos de dados, atributos e tipos de dados em um documento XML ou JSON.

Para definir transformações entre as estruturas de dados e preencher lacunas entre elas, você pode criar um mapa (.xslt) que define os relacionamentos entre os elementos de dados nos esquemas de origem e destino. Você criar e editar visualmente um mapa usando o Visual Studio Code com a extensão Aplicativos Lógicos do Azure (Standard) no contexto de um projeto de aplicativo lógico Standard. A ferramenta Mapeador de Dados fornece uma experiência unificada para mapeamento e transformação de dados por meio de gestos de arrastar e soltar, funções predefinidas para construir expressões e uma maneira de testar mapas manualmente antes de usá-los nos fluxos de trabalho.

Depois de criar seu mapa, você poderá chamá-lo diretamente de um fluxo de trabalho no seu projeto de aplicativo lógico ou de um fluxo de trabalho de aplicativo lógico Standard no portal do Azure. Para essa tarefa, você pode usar a ação Operações do Mapeador de Dados denominada Transformar usando o Mapeador de Dados XSLT no seu fluxo de trabalho.

Essa guia de instruções mostra como criar um mapa de dados vazio, escolher seus esquemas de origem e destino, criar vários tipos de mapeamentos entre elementos de esquema, salvar e testar seu mapa e, em seguida, chamar o mapa a partir de um fluxo de trabalho no seu projeto de aplicativo lógico.

Limitações e problemas conhecidos

• No momento, o Mapeador de Dados está disponível apenas no Visual Studio Code, não no portal do Azure, e somente em projetos de aplicativo lógico padrão, não em projetos de aplicativo lógico de consumo.

  A experiência de front-end do Mapeador de Dados está disponível como software livre no repositório público do GitHub para a equipe de Aplicativos Lógicos do Azure. Para obter mais informações, consulte os seguintes recursos:

  • Bem-vindo ao UX dos Aplicativos Lógicos do Azure

  • Novas e aprimoradas UX do Mapeador de Dados no Azure Logic Apps

• Atualmente, o Mapeador de Dados funciona apenas no Visual Studio Code em execução em sistemas operacionais Windows.

• No momento, o Mapeador de Dados não oferece suporte a esquemas que usam o formato de arquivo .csv (valores separados por vírgula).

• No momento, o painel Código no Mapeador de Dados é somente leitura.

• Na superfície do mapeador de dados, o layout e as posições das funções são móveis, mas os nós de esquema são estáticos.

• A função Filtrar processa corretamente condições numéricas que estão entre aspas duplas, por exemplo, ">=10". Entretanto, essa função atualmente não se comporta de forma padronizada para comparações de cadeia de caracteres, como uma verificação sobre se um nome do item é "= 'Pen'".

• Quando você cria um mapeamento entre os elementos da matriz pai nos esquemas de origem e destino, o mapeador adiciona automaticamente um loop para iterar pelos elementos da matriz. No entanto, você ainda tem que criar explicitamente os mapeamentos entre os elementos individuais da matriz nos esquemas de origem e destino.

• Para chamar os mapas criados com o Mapeador de Dados, você só pode usar a ação Operações do Mapeador de Dados chamada Transformar usando o Mapeador de Dados XSLT. Para os mapas criados por qualquer outra ferramenta, utilize a ação Operações XML chamada Transformar XML.

• Para usar os mapas criados com o Mapeador de Dados em fluxos de trabalho no portal do Azure, você deve adicioná-los diretamente ao recurso de aplicativo lógico Standard.

Para bugs sem bloqueio ou solicitações de recursos, abra um item com o rótulo Mapeador de Dados no repositório GitHub para a equipe de Aplicativos Lógicos do Azure.

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.

• Visual Studio Code e a extensão Aplicativos Lógicos do Azure (Standard) para criar fluxos de trabalho de aplicativo lógico padrão.

  Observação

  A extensão do Mapeador de Dados, que anteriormente era separada, agora está mesclada com a extensão de Aplicativos Lógicos do Azure (Standard). Para evitar conflitos, qualquer versão existente da extensão do Mapeador de Dados é removida quando você instala ou atualiza a extensão dos Aplicativos Lógicos do Azure (Padrão). Após a instalação ou atualização da extensão, reinicie o Visual Studio Code.

• Os arquivos do esquema de origem e destino que descrevem os tipos de dados a serem transformados. Esses arquivos podem ter os seguintes formatos:

  • Um arquivo de definição do esquema XML com a extensão de arquivo.xsd

  • Um arquivo JavaScript Object Notation com a extensão .json

• Um projeto de aplicativo lógico Standard que inclui um fluxo de trabalho com ou sem estado com pelo menos um gatilho. Se você não tiver um projeto, siga estas etapas no Visual Studio Code:

  1. Conecte-se à sua conta do Azure , se você ainda não o fez.

  2. Crie uma pasta local, um workspace e um projeto de aplicativo lógico Standard e um fluxo de trabalho com ou sem estado. Durante a criação do fluxo de trabalho, selecione Abrir na janela atual.

• Faça uma amostra de dados de entrada se quiser testar o mapa e verificar se a transformação funciona conforme o esperado.

Criar um mapa de dados

1. No Visual Studio Code, abra a pasta do seu projeto de aplicativo lógico Standard.

2. No menu esquerdo do Visual Studio Code, selecione o ícone Azure.

3. Na janela Azure, em Mapeador de Dados, selecione Criar mapa de dados.

   

   Na barra de título do Visual Studio Code, uma caixa de solicitação será aberta para que você forneça um nome para o seu mapa.

4. Na caixa de prompt, insira um nome para o mapa.

   Para este guia, essas etapas usam o nome Example-data-map.

   

   O Mapeador de Dados cria e abre um mapa de dados em branco.

5. Escolha seus esquemas de origem e destino seguindo estas etapas:

   1. No painel Origem, selecione Adicionar>Procurar para localizar e carregar o esquema de origem.

      

      Depois que você adiciona o esquema de origem, o painel Origem será preenchido com os nós de elementos XML para os tipos de dados no esquema de origem, por exemplo:

      

   2. No painel Destino, selecione Adicionar>Procurar para localizar e carregar o esquema de destino.

      

      Depois que você adiciona o esquema de destino, o painel Destino será preenchido com os nós de elementos XML para os tipos de dados no esquema de destino, por exemplo:

      

Tipos de dados de esquema

A tabela a seguir descreve os tipos de dados possíveis que podem aparecer em um esquema:

Símbolo	Tipo	Obter mais informações
	Complexo (matriz)	Contém itens ou nós de itens repetidos. Um elemento de matriz também exibe o seguinte ponto de conexão:
	Bool	Apenas verdadeiro ou falso
	Complexo	Um objeto XML com propriedades filho, semelhante ao tipo JSON Object
	Datetime
	Decimal
	Integer	Somente números inteiros
	fio

Criar um mapeamento direto entre elementos

Para especificar uma transformação direta entre elementos com o mesmo tipo nos esquemas de origem e destino, siga estas etapas:

1. Para visualizar o que acontece no código enquanto cria o mapeamento, no canto superior direito do mapeador, selecione Exibir código.

2. Na superfície do mapeador, no painel Origem, localize o elemento de origem que deseja mapear.

   • Por padrão, os elementos pai são automaticamente expandidos para exibir os elementos filho.

   • Este exemplo inicia o mapeamento a partir do elemento de origem, mas você pode optar por começar pelo elemento de destino.

3. Mova o ponteiro do mouse sobre o círculo ao lado do nome do elemento de origem até que o ponteiro mude para um sinal de mais (+).

   Neste exemplo, o mapeamento começa a partir do elemento de origem ID de Funcionário.

   

4. Arraste e desenhe uma linha para conectar o elemento de origem ao círculo do elemento de destino no painel Destino.

   Este exemplo conclui o mapeamento com o elemento de destino ID, que tem o mesmo tipo de dados que o elemento de origem.

   

   Agora você criou um mapeamento direto entre os dois elementos que têm os mesmos tipos de dados.

   

   O painel Código mostra o relacionamento de mapeamento que você criou:

   

   Dica

   Para verificar se existem problemas no mapeamento, selecione Exibir problemas. Por exemplo, se você criar um mapeamento entre elementos nos quais os tipos de dados não correspondem, um aviso aparecerá na lista Problemas, na guia Avisos:

   

Criar um mapeamento complexo entre elementos

Para especificar uma transformação mais complexa entre elementos nos esquemas de origem e destino, como combinar elementos ou lidar com tipos de dados diferentes, você pode usar uma ou mais funções para realizar a transformação desejada no mapeamento.

Na superfície do mapeador, o rótulo da função tem uma cor específica de acordo com o grupo da função. Ao lado do nome da função, aparece o símbolo correspondente, por exemplo:

A tabela a seguir lista alguns grupos de funções e exemplos de funções que você pode usar. Para ver a lista completa, acesse a lista Funções no Mapeador de Dados.

Adicionar uma função sem mapeamento

O exemplo nesta seção transforma os dados no elemento de origem de String (Cadeia de caracteres) para DateTime (Data/Hora), que é o tipo do elemento de destino. O exemplo começa sem criar primeiro um mapeamento e usa a função To Date , que aceita uma única entrada.

1. Para visualizar o que acontece no código enquanto cria o mapeamento, no canto superior direito do mapeador, selecione Exibir código.

2. Na lista Funções, localize e selecione a função que deseja usar. Isso adiciona a função à superfície do mapeador. Se a lista Funções estiver recolhida, no canto superior esquerdo do mapeador, clique no ícone da função ().

   Neste exemplo, selecione a função To Date, que pertence ao grupo de funções de Conversão.

   

   Observação

   Se não existir nenhum mapeamento ou se um mapeamento estiver selecionado ao adicionar uma função, ela aparecerá, mas não ficará conectada a outros elementos ou funções, por exemplo:

   

3. Conectar a função aos elementos de origem e de destino.

   1. Arraste e desenhe uma linha entre o elemento de origem e o círculo na borda esquerda da função. Você pode começar pelo elemento de origem ou pela função.

      

   2. Arraste e desenhe uma linha entre a borda direita da função e o elemento de destino. Você pode começar pelo elemento de destino ou pela função.

      

   O painel Código mostra o relacionamento de mapeamento que você criou:

   

4. Na superfície do mapeador, selecione a forma da função para visualizar os detalhes dela.

5. Na guia Entrada, confirme ou edite a entrada a ser usada.

   

   Alguns cenários exigem a definição de uma transformação além do par direto de elementos de origem e destino. Por exemplo, para definir uma transformação entre duas matrizes e seus itens, você precisa criar um loop entre as matrizes. Ou, para executar uma ação quando o valor de um elemento atender a uma condição, você precisa adicionar uma condição entre os elementos.

Adicionar uma função que usa várias entradas

O exemplo nesta seção concatena vários elementos de origem como entradas e mapeia uma única saída para o elemento de destino. O exemplo usa a função Concat, que aceita várias entradas.

1. Para visualizar o que acontece no código enquanto cria o mapeamento, no canto superior direito do mapeador, selecione Exibir código.

2. Na lista Funções, localize e selecione a função que deseja usar. Isso adiciona a função à superfície do mapeador.

   Se a lista Funções estiver recolhida, no canto superior esquerdo do mapeador, clique no ícone da função ().

   Neste exemplo, selecione a função Concat, que pertence ao grupo de funções String (Cadeia de caracteres).

   

   Observação

   Se não existir nenhum mapeamento ou se um mapeamento estiver selecionado ao adicionar uma função, ela aparecerá, mas não ficará conectada a outros elementos ou funções, por exemplo:

   

3. Na superfície do mapeador, selecione a forma da função para visualizar os detalhes dela.

4. Na guia Entrada, selecione os elementos do esquema de origem a serem usados como entradas.

   Neste exemplo, selecione os elementos do esquema de origem FirstName (nome) e LastName (sobrenome) como entradas da função. O mapeador adiciona automaticamente os respectivos mapeamentos entre os elementos de origem e a função.

   

5. Para concluir o mapeamento, arraste e desenhe uma linha entre a borda direita da função e o elemento de destino. Você pode começar pelo elemento de destino ou pela função.

   

   O painel Código exibe os relacionamentos de mapeamento que você criou:

   

Iterar por meio de matrizes

Se os esquemas de origem e destino contiverem matrizes, você pode criar um loop para iterar pelos itens dessas matrizes. O exemplo a seguir cria um loop através da matriz de origem Funcionário (Employee) e da matriz de destino Pessoa (Person), além de mapear os itens entre essas matrizes.

1. Para visualizar o que acontece no código enquanto cria o mapeamento, no canto superior direito do mapeador, selecione Exibir código.

2. Na superfície do mapeador, nos painéis Origem e Destino, localize as matrizes que deseja mapear.

3. Arraste e desenhe uma linha entre os itens do par de matrizes. Você pode começar pelo painel Origem ou pelo painel Destino.

   O exemplo a seguir começa no painel Origem e mapeia os itens Nome na matriz de origem Funcionário e na matriz de destino Pessoa:

   

   Depois de concluir o mapeamento do primeiro par de itens da matriz, o mapeador adiciona automaticamente um loop entre os elementos pai das matrizes de origem e de destino, que possuem o seguinte tipo de ponto de conexão:

   O exemplo a seguir destaca o loop adicionado automaticamente entre as matrizes pai Funcionário (origem) e Pessoa (destino):

   

   O painel Código mostra o mapeamento e o loop que você criou:

   

4. Continue mapeando os outros elementos da matriz, por exemplo:

   

Avaliar uma condição para executar uma tarefa

Imagine que você quer adicionar um mapeamento que avalia uma condição e executa uma tarefa quando essa condição for atendida. Para este cenário, é possível usar várias funções.

No exemplo a seguir, quando a quantidade de compra ultrapassa 20 itens, o mapeamento calcula um desconto aplicável usando as seguintes funções:

1. Nos painéis Origem e Destino, localize os elementos necessários para mapear neste cenário.

   Este exemplo usa os seguintes elementos:

   • Painel Origem: ItemPrice (preço do item) e ItemQuantity (quantidade de itens)

   • Painel Destino: ItemPrice (preço do item), ItemQuantity (quantidade de itens) e ItemDiscount (desconto do item)

     

2. Na lista Funções, localize e selecione as funções que deseja usar. Isso adiciona as funções à superfície do mapeador.

   • Se a lista Funções estiver recolhida, no canto superior esquerdo do mapeador, clique no ícone da função ().

   • Se necessário, mova as formas das funções na superfície do mapeador para facilitar a seleção.

   Este exemplo adiciona as seguintes funções à superfície do mapeador: Greater, If e Multiply

   

3. Para visualizar o que acontece no código enquanto cria os mapeamentos, no canto superior direito do mapeador, clique em Exibir código.

4. Conecte os elementos de origem, as funções e os elementos de destino na ordem específica exigida pelo seu cenário.

   Este exemplo conecta os seguintes itens na ordem especificada para criar corretamente os mapeamentos:

   Iniciar	participante
   Elemento de origem ItemPrice	Elemento de destino ItemPrice
   Elemento de origem ItemQuantity	Entrada da função Greater na borda esquerda da forma. Esta entrada fornece os dados para o campo Value 1 nos detalhes da função.
   Saída da função Greater na borda direita da forma	Entrada da função If na borda esquerda da forma. Essa entrada fornece os dados para o campo Condition nos detalhes da função.
   Elemento de origem ItemPrice	Entrada da função Multiply na borda esquerda da forma. Essa entrada fornece os dados para o campo Multiplicand nos detalhes da função.
   Saída da função Multiply na borda direita da forma.	Entrada da função If na borda esquerda da forma. Essa entrada fornece os dados para o campo Value nos detalhes da função.
   Saída da função If na borda direita da forma.	Elemento de destino ItemDiscount

   O exemplo a seguir mostra os mapeamentos neste momento:

   

5. Nos detalhes da função a seguir, na guia Entrada, confirme ou forneça os seguintes valores:

   Função	Campo de entrada e valor
   Maior	- Valor 1: elemento de origem ItemQuantity - Valor 2: 20 como um valor personalizado
   Multiplicar	- Multiplicando 1: elemento de origem ItemPrice - Multiplicando 2: .10 como um valor personalizado
   If	- Condição: é maior que(ItemQuantity, 20) - Valor: multiplique(ItemPrice, .10)

   O mapa a seguir mostra o exemplo concluído:

   

   O painel Código mostra o mapeamento que você criou:

   

Salvar seu mapa

Quando terminar, na barra de ferramentas do mapa, selecione Salvar.

O Visual Studio Code salva seu mapa de dados como os seguintes artefatos:

• Um arquivo (<your-map-name>.lml) mapeador de dados na pasta do projeto Artifacts>MapDefinitions
• Um arquivo (<your-map-name>.xslt) na pasta do projeto Artifacts>Mapas

Testar seu mapa

Para confirmar que a transformação funciona como você espera, você precisará dos dados de entrada de amostra.

1. Antes de testar o mapeamento, salve o mapa para gerar a versão mais recente do arquivo <your-map-name>.xslt.

2. Na barra de ferramentas do mapeamento, clique em Abrir painel de teste.

3. No painel Testar mapeamento, na caixa Dados de amostra, cole os dados de entrada de amostra e clique em Testar.

   A caixa Resultado exibirá os resultados do teste.

Chama seu mapa de um fluxo de trabalho no seu projeto

1. Na barra de atividades do Visual Studio Code, selecione Explorer (ícone de arquivos) para exibir a estrutura do projeto do aplicativo lógico.

2. Expanda a pasta que tem o nome do fluxo de trabalho. No menu de atalho do arquivo workflow.json , selecione Abrir Designer.

3. No designer de fluxo de trabalho, siga estas etapas gerais para adicionar a ação interna Operações do Mapeador de Dados denominada Transformação usando o XSLT do Mapeador de Dados.

4. No designer, selecione a ação Transformar usando XSLT do Mapeador de Dados.

5. No painel de informações da ação, especifique o valor Conteúdo e deixe Origem do Mapa definido como LogicApp.

6. Abra a lista Nome do Mapa e selecione o seu mapa ( arquivo .xslt).

   

   Para usar a mesma ação Transformar usando XSLT do Mapeador de Dados no portal do Azure, você deve adicionar o mapa ao recurso de aplicativo lógico padrão.

Executar XSLT em um mapa de dados

Você pode executar snippets XSLT executáveis em um arquivo de mapa de dados (.xslt) usando a função Executar XSLT . Ao usar essa função, você obtém um arquivo de mapa de dados que contém o XSLT executável real. O arquivo Data Mapper (.lml) contém uma referência ao arquivo XSLT (.xslt ou .xml) executável.

Para concluir esta tarefa, siga estas etapas:

1. Crie um novo arquivo de mapa de dados (.xslt ou .xml) que contenha o snippet XSLT executável que você deseja executar.

2. Coloque ou mova o arquivo de snippet XSLT para a seguinte pasta de projeto:

   Artefatos>DataMapper\Extensions>InlineXSLT

   

   Observação

   Se você criar ou salvar esse arquivo XSLT executável no Visual Studio Code, o arquivo aparecerá automaticamente na pastade projeto>. Certifique-se de mover arquivos de snippet XSLT para a pasta InlineXslt .

3. Abra o mapa de dados de onde você deseja executar o XSLT.

4. No painel Funções , em Utilitário, selecione Executar XSLT para adicionar a função à superfície do mapeador.

5. Na superfície do mapeador, selecione Executar XSLT.

6. Na lista suspensa Arquivo , selecione o arquivo .xslt executável que você adicionou à pasta InlineXSLT , por exemplo:

   

7. Conecte a função Executar XSLT ao nó de destino em que você deseja aplicar a lógica XSLT, por exemplo:

   

   Como a lógica XSLT se aplica somente ao nó de destino, você não precisa conectar a função Executar XSLT a um nó de origem.

8. Teste seu mapa para confirmar se os resultados esperados aparecem no esquema de destino.

Para implantação, você só precisa do mapa de dados resultante com o XSLT executável embutido.

Acessar nós em XML aninhado

Suponha que você tenha um esquema que tenha nós XML aninhados e queira trabalhar com esses nós das seguintes maneiras:

• Acessar atributos ou elementos aninhados.
• Aplique a lógica com base na estrutura ou no conteúdo dos dados de entrada.

Para concluir essas tarefas, use a função Executar XPath :

1. Abra o mapa de dados no qual você deseja trabalhar.

2. No painel Funções , em Utilitário, selecione Executar XPath para adicionar a função à superfície do mapeador.

3. Na superfície do mapeador, selecione Executar XPath.

4. Na caixa de expressão XPATH , insira uma expressão que execute o trabalho desejado.

   Para obter informações sobre a sintaxe de expressão, consulte Sintaxe XPath.

   Este exemplo usa a //Address expressão junto com um conteúdo de teste:

   

   Observação

   As barras duplas (//) selecionam os nós do nó atual que correspondem à seleção, independentemente de onde os nós existam.

5. Conecte a função Executar XPath ao nó de destino em que você deseja executar a função.

   Esse exemplo conecta a função ao nó Endereço no esquema de destino:

   

   Observação

   Os nomes de nós são colocados automaticamente entre aspas duplas (" ").

6. Teste seu mapa para confirmar se os resultados esperados aparecem no esquema de destino.

   Este exemplo usa uma carga de teste e produz resultados corretamente com vários nós Address porque o nó Address de origem existe em um array Employee, enquanto o nó Address de destino existe em um array Person.

   

   Observação

   Se você criar um mapeamento entre matrizes nos esquemas de origem e destino, um loop aparecerá automaticamente na superfície do mapeador para iterar os elementos da matriz. No entanto, você ainda precisa criar mapeamentos entre os elementos de matriz de origem e de destino. Para obter informações sobre como percorrer matrizes, consulte Percorrer matrizes.

Criar funções XML personalizadas

Para definir a lógica reutilizável em seu mapa, você pode criar funções XML personalizadas, que fornecem os seguintes benefícios:

• Reduza a duplicação e dê suporte a transformações específicas do esquema.
• Encapsular lógica complexa em componentes gerenciáveis.
• Lidar com casos extremos específicos do esquema.

Para criar uma função XML personalizada, siga estas etapas:

1. Crie um arquivo XML (.xml) com um nome significativo que descreva a finalidade da função.

   Seu arquivo XML deve usar um esquema específico para definições de função. Se você tiver várias funções relacionadas, poderá usar um único arquivo para essas funções. Embora você possa usar qualquer nome de arquivo, um nome de arquivo ou categoria significativo torna suas funções mais fáceis de identificar, localizar e descobrir.

2. Adicione este arquivo XML ao seu projeto de aplicativo lógico na seguinte pasta:

   Artefatos>DataMapper\Extensions>Funções

3. Abra o mapa de dados onde você deseja usar sua função.

4. No painel Funções , em Utilitário, selecione sua função personalizada, que agora aparece na superfície do mapeador.

5. Na superfície do mapeador, selecione sua função. Forneça a entrada de que a função precisa para funcionar.

6. Conecte a função aos pontos de extremidade necessários.

   O exemplo a seguir mostra uma função personalizada chamada Idade que retorna a idade da data de nascimento fornecida. A função se conecta ao nó de origem Dat_of_Birth e ao nó de destino Other. Para examinar a definição dessa função personalizada, consulte Examinar a definição de função de exemplo.

   

7. Teste seu mapa para confirmar se os resultados esperados aparecem no esquema de destino, por exemplo:

   

Examinar o esquema de uma definição de função

Seu arquivo XML deve usar o esquema a seguir para uma definição de função. Cada elemento XML que tem o "function" nome implementa uma função de estilo XSLT 3.0 com mais alguns atributos. A lista de funções do Mapeador de Dados inclui o nome da função, a descrição, os nomes dos parâmetros e os tipos de parâmetros.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <xs:element name="customfunctions">
      <xs:complexType>
         <xs:sequence>
            <xs:element maxOccurs="unbounded" name="function">
               <xs:complexType>
                  <xs:sequence>
                     <xs:element maxOccurs="unbounded" name="param">
                        <xs:complexType>
                           <xs:attribute name="name" type="xs:string" use="required" />
                           <xs:attribute name="as" type="xs:string" use="required" />
                        </xs:complexType>
                     </xs:element>
                     <xs:any minOccurs="0" />
                  </xs:sequence>
                  <xs:attribute name="name" type="xs:string" use="required" />
                  <xs:attribute name="as" type="xs:string" use="required" />
                  <xs:attribute name="description" type="xs:string" use="required" />
               </xs:complexType>
            </xs:element>
         </xs:sequence>
      </xs:complexType>
   </xs:element>
</xs:schema>

Examinar as definições de função de exemplo

O seguinte arquivo SampleFunctions.xml mostra a implementação para as seguintes funções:

• "age"
• "custom-if-then-else"

<?xml version="1.0" encoding="utf-8" ?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<customfunctions>
   <function name="age" as="xs:float" description="Returns the current age.">
      <param name="inputDate" as="xs:date"/> 
      <value-of select="round(days-from-duration(current-date() - xs:date($inputDate)) div 365.25, 1)"/>
   </function> 
   <function name="custom-if-then-else" as="xs:string" description="Evaluates the condition and returns corresponding value.">
      <param name="condition" as="xs:boolean"/>
      <param name="thenResult" as="xs:anyAtomicType"/>
      <param name="elseResult" as="xs:anyAtomicType"/>
      <choose>
         <when test="$condition">
            <value-of select="$thenResult"></value-of>
         </when>
         <otherwise>
            <value-of select="$elseResult"></value-of>
         </otherwise>
      </choose>
   </function>
</customfunctions>

Conteúdo relacionado

• Adicionar mapas para transformações em fluxos de trabalho com os Aplicativos Lógicos do Azure