Como validar sua carga de trabalho para publicação

Este artigo explica como usar o Validador do Fabric Extensibility Toolkit para garantir que sua carga de trabalho atenda a todos os requisitos de publicação antes de enviar o formulário de solicitação de publicação. O validador ajuda a identificar problemas de conformidade no início do processo de desenvolvimento, reduzindo o tempo de revisão e melhorando as taxas de sucesso de aprovação.

Visão geral

O Validador do Kit de Ferramentas de Extensibilidade do Fabric é uma ferramenta de linha de comando projetada para ajudar os parceiros a validar suas cargas de trabalho em relação aos requisitos de publicação do Microsoft Fabric. A ferramenta combina testes automatizados com testes guiados manuais para fornecer cobertura de validação abrangente.

Tipos de validação

O validador fornece dois tipos de validação:

• Testes automatizados: verificações programáticas que verificam sua carga de trabalho em busca de problemas de conformidade automaticamente
• Testes Guiados Manuais: instruções passo a passo para tarefas de validação que exigem verificação humana

Pré-requisitos

Antes de usar a ferramenta de validação, verifique se você tem:

• Uma carga de trabalho concluída pronta para validação
• Acesso ao repositório do Validador do Kit de Ferramentas de Extensibilidade do Fabric
• Acesso à interface de linha de comando em seu computador de desenvolvimento
• Sua carga de trabalho corretamente configurada e implantável

Acessando o validador

O Validador do Kit de Ferramentas de Extensibilidade do Fabric está disponível por meio do GitHub:

🔗 Repositório: https://github.com/microsoft/fabric-extensibility-toolkit-validator

Para obter instruções detalhadas de instalação e uso, consulte o Validador do Kit de Ferramentas de Extensibilidade do Microsoft Fabric.

Visite o repositório para:

• Baixar a versão mais recente do validador
• Examinar os parâmetros de linha de comando disponíveis
• Documentação do Access para uso de ferramentas
• Verificar os requisitos do sistema e as instruções de instalação

Usando o validador

Interface de Linha de Comando

O validador opera como uma ferramenta de linha de comando que você executa em relação à sua carga de trabalho. Os parâmetros específicos e as instruções de uso estão disponíveis no repositório do validador.

Consulte a documentação do repositório para:

• Referência de parâmetro completa
• Sintaxe de linha de comando
• Opções de configuração
• Detalhes do formato de saída

Fluxo de trabalho de validação

Siga este fluxo de trabalho geral ao usar o validador:

1. Preparar sua carga de trabalho: verifique se sua carga de trabalho está criada e pronta para teste
2. Executar testes automatizados: executar as verificações de conformidade automatizadas do validador
3. Concluir testes manuais: siga as instruções guiadas para tarefas de verificação manual
4. Examinar resultados: analisar o relatório de validação e identificar quaisquer problemas
5. Descobertas de Endereço: corrigir quaisquer lacunas de conformidade identificadas pelo validador
6. Validar novamente: execute o validador novamente para confirmar se todos os problemas foram resolvidos
7. Enviar para Publicação: prossiga com sua solicitação de publicação depois que a validação for aprovada

Cobertura de validação

O validador verifica sua carga de trabalho em relação a:

• Requisitos de publicação para cargas de trabalho: padrões de infraestrutura, segurança e conformidade
• Requisitos de publicação para itens: experiência do usuário e requisitos de funcionalidade
• Manifest compliance: configuração adequada e propriedades necessárias
• Integração de plataforma: implementação correta dos recursos da plataforma Fabric

Interpretando resultados

Resultados de teste automatizados

O validador fornece relatórios detalhados sobre resultados de teste automatizados, incluindo:

• Status de aprovação/falha: indicação clara dos resultados do teste
• Descrições do problema: explicações específicas de quaisquer lacunas de conformidade
• Diretrizes de correção: sugestões para corrigir problemas identificados
• Níveis de severidade: indicadores prioritários para lidar com diferentes tipos de problemas

Diretrizes de teste manual

Para tarefas de validação manual, a ferramenta fornece:

• Instruções passo a passo: orientações claras para processos de verificação manual
• Critérios de verificação: padrões específicos para verificar
• Requisitos de documentação: evidências necessárias para demonstrar a conformidade
• Práticas recomendadas: Recomendações para implementação ideal

Práticas recomendadas

Preparação de pré-validação

• Desenvolvimento completo: verifique se a carga de trabalho está concluída antes da validação
• Teste minuciosamente: realize seus próprios testes antes de executar o validador
• Requisitos de revisão: familiarize-se com os requisitos de publicação com antecedência
• Preparar a documentação: verifique se toda a documentação necessária está pronta e acessível

Execução de validação

• Executar regularmente: use o validador durante todo o desenvolvimento, não apenas no final
• Resolver problemas imediatamente: corrigir problemas identificados o mais rápido possível
• Alterações de documento: acompanhe as modificações feitas com base nos comentários de validação
• Verificar correções: executar novamente a validação após fazer alterações para confirmar a resolução

Resolução de problemas

Problemas comuns

• Problemas de instalação da ferramenta: consulte a documentação do repositório para obter diretrizes de instalação
• Problemas de permissão: verifique se você tem direitos de acesso apropriados para executar o validador
• Erros de configuração: verifique se a configuração da carga de trabalho corresponde aos formatos esperados
• Problemas de ambiente: verifique se o ambiente de desenvolvimento atende aos requisitos da ferramenta

Obtendo ajuda

• Documentação do repositório: verifique o repositório do validador para obter diretrizes detalhadas
• Relatório de Problemas: use o rastreador de problemas do repositório para relatar problemas ou fazer perguntas
• Suporte à comunidade: entre em contato com outros desenvolvedores usando o validador
• Suporte da Microsoft: entre em contato com seu representante de parceiro da Microsoft para obter assistência adicional

Conteúdo relacionado

• Requisitos de publicação – Visão geral dos requisitos gerais
• Requisitos de publicação entre locatários
• Requisitos de publicação para cargas de trabalho – padrões específicos da carga de trabalho
• Requisitos de publicação para itens - Requisitos específicos do item
• Visão geral da publicação – Processo de publicação de alto nível
• Visão geral do manifesto – Configuração do manifesto da carga de trabalho