Partilhar via


Contribuir para a documentação do Dynamics 365

Pode contribuir para a documentação da Microsoft sobre o Dynamics 365 de duas formas. Se um artigo contiver informações incorretas ou confusas, ou se souber uma boa solução para um problema recorrente, pode usar o link de feedback no artigo para nos informar.

Para a maior parte da nossa documentação, também pode editar um artigo diretamente para iniciar um processo de revisão.

Fornecer comentários

No site learn.microsoft.com , cada artigo do Learn oferece a oportunidade de fornecer feedback. Pode escolher a ação de Feedback que está por debaixo do título do artigo no canto superior direito ou uma das opções de feedback na parte inferior do artigo, na secção de Feedback. Dê uma classificação ao artigo, selecione o motivo do seu feedback e considere deixar um comentário. O feedback vai para o autor do artigo e para a equipa que detém a documentação.

Se um artigo não puder ser editado diretamente, ou se não se sentir confortável a editar, encorajamo-lo a usar o mecanismo de feedback para nos dizer o que pensa sobre o artigo ou o produto.

Contribuições externas para a documentação Microsoft

Os ficheiros fonte do nosso conteúdo principal são armazenados em repositórios públicos do GitHub. Qualquer pessoa pode rever e, em muitos casos, editá-la. Agradecemos as vossas sugestões e correções, seja sob a forma de contribuições diretas ou como edições do GitHub para reportar um bug ou colocar uma questão. Só podemos aceitar feedback e contribuições para o conteúdo de origem em inglês.

A maioria dos artigos tem um ícone de lápis com a dica de ferramenta Editar Este Documento. Selecione o ícone para abrir o artigo no GitHub e depois comece a editar. Comece como colaborador com o guia para colaboradores do Microsoft Learn.

Se quiser ser completo e contribuir com novos artigos conceptuais, use os modelos em https://github.com/MicrosoftDocs/dynamics365-docs-templates.

Conteúdo de orientação do Dynamics 365

O conteúdo das orientações do Dynamics 365 utiliza os mesmos processos que a maior parte da documentação no Microsoft Learn. Nesta secção, destacamos ferramentas e processos que pode usar para ajudar a acrescentar à orientação de implementação.

O termo conteúdo de orientação abrange o guia de implementação do Dynamics 365, descrições de processos de negócio, novos padrões, melhores práticas e arquiteturas de referência. Publicámos o primeiro conteúdo de orientação em abril de 2023 e adicionamos atualizações de duas em duas semanas. Navegue pelo centro de orientação e diga-nos o que é ótimo e o que está em falta.

Parte do conteúdo das orientações é fornecido por colaboradores internos. Incentivamos especialistas em toda a comunidade a ajudarem-nos a estabelecer as melhores práticas. Continue a ler se tiver uma boa prática ou outro insight que ache que deveria fazer parte do Microsoft Learn.

Porquê contribuir?

Acreditamos que o conteúdo das orientações ajuda a acelerar os projetos de implementação do Dynamics 365. Os nossos parceiros e clientes podem usar a orientação para se preparar para a implementação e para se qualificar em novas áreas ou para capacitar novos colaboradores. Os programadores de software podem usar o conteúdo como plataforma para promover a sua propriedade intelectual ou a sua experiência no setor.

Mas nós, na Microsoft, não somos os únicos especialistas em como implementar soluções com o Dynamics 365. A comunidade inclui pessoas que são especialistas em vários aspetos da implementação. Tem um padrão, uma boa prática, uma configuração ou uma arquitetura de integração que funcione bem em várias implementações? Considere partilhá-lo aqui no Microsoft Learn para tornar toda a comunidade ainda mais produtiva e eficiente nos seus projetos de implementação.

Esperamos poder oferecer recompensas ou outros reconhecimentos pelas contribuições. Por agora, reconhecemos os colaboradores nos artigos de duas formas diferentes. Saiba mais na secção de reconhecimento dos Colaboradores .

Como contribuir

Pode encontrar os ficheiros-fonte do conteúdo de orientação Dynamics 365 da Microsoft num repositório público do GitHub. Também pode editar os artigos no site learn.microsoft.com/dynamics365/guidance conforme descrito no guia de colaboradores do Microsoft Learn.

Recomendamos que submeta correções da mesma forma que submete correções a outras áreas do Microsoft Learn. No entanto, para submeter novo conteúdo, pedimos que carregue os seus ficheiros Markdown para novos conteúdos de orientação para um repositório diferente, o Dynamics 365 Patterns and Practices. Desta forma, podemos garantir que a sua arquitetura ou padrão de referência seja revisto por outros especialistas na área. Existem diferentes modelos para escolher, e se quiser contribuir para o conteúdo do processo de negócio, há um processo completamente diferente.

Modelos

A Microsoft fornece modelos em dois locais, dependendo do tipo de modelo:

Vamos adicionar mais modelos e orientações ao longo do tempo. Recomendamos que acompanhes os repositórios, ou os marcares com uma estrela, para que sejas notificado quando algo mudar.

Partilhe o seu feedback no https://github.com/microsoft/dynamics365patternspractices/discussions separador do repositório Dynamics 365 Patterns and Practices.

Se ainda não tens uma conta no GitHub, começa com o guia de colaboradores do Microsoft Learn.

Sugestão

Navegue pelos nossos ficheiros fonte no https://github.com/MicrosoftDocs/dynamics365-guidance repositório. Aprenda com a forma como estruturamos os diferentes tipos de artigos para que os seus artigos sigam a mesma estrutura. Assim, o processo de revisão é mais rápido.

Arquiteturas

Agradecemos contribuições de orientação arquitetónica, incluindo ideias de soluções e padrões de design. Se tiver uma implementação de boas práticas ou referência, submeta a sua proposta à equipa Azure ou a nós no Dynamics 365.

Para contribuir com novos artigos para a orientação arquitetónica Dynamics 365, siga estes passos principais:

A Microsoft processa o artigo e publica-o como parte da documentação de orientação do Dynamics 365 .

Para uma introdução geral ao conteúdo de orientação na Microsoft, consulte o Azure Architecture Center. Para o guia de colaboradores, consulte as contribuições do Azure Architecture Center.

O repositório GitHub dynamics365-docs-templates contém os seguintes modelos Markdown para orientação arquitetónica na pasta guidance-templates :

  • Padrão de arquitetura generalizado: Um padrão de arquitetura generalizado atua como uma arquitetura central com uma solução comum que se aplica a muitos cenários. Por exemplo, as ideias de soluções podem basear-se num artigo de arquitetura para fornecer uma perspetiva para uma solução para uma determinada indústria ou parceiro e estabelecer uma ligação com a arquitetura de cada ideia de solução. O modelo baseia-se no modelo Azure Architecture Guide. Use-o para diferentes tipos de arquiteturas, incluindo arquiteturas de referência.

  • Ideia de solução: As ideias de solução são arquiteturas "pequenas" de implementações do Dynamics 365. Fornecem breves visões gerais das soluções com os serviços Dynamics 365 e Azure. Cada ideia de solução contém os seguintes elementos:

    • Um diagrama de arquitetura
    • Um fluxo de dados
    • Componentes, significando uma lista dos serviços utilizados
    • Créditos dos colaboradores
    • Ligações para os próximos passos e recursos relacionados, como guias e arquiteturas relacionadas
  • Solução de exemplo: Soluções de exemplo são cargas de trabalho de exemplo com arquiteturas "médias". Orientam os leitores no processo de conceção de soluções para problemas específicos em implementações do Dynamics 365. Soluções de exemplo fornecem orientações acionáveis de arquitetura baseadas em exemplos reais de clientes. O objetivo é encurtar a curva de aprendizagem dos clientes, contando-lhes a história de outro cliente que teve a mesma jornada. Incluem as secções do modelo de Ideia de Solução e acrescentam as seguintes secções:

    • Alternativas, outros serviços que podes ligar à arquitetura em vez disso
    • Considerações e orientações que se alinham com a nossa estrutura Success by Design e, opcionalmente, incluem uma implementação
  • Padrão de design: Os padrões de design do Dynamics 365 abordam desafios específicos nas implementações e baseiam-se num cenário ou prática recomendada específica. Use este modelo para captar um padrão de processo de negócio. Em alternativa, use o modelo Word em dynamics365patternspractices/templates/business-processes.

Contribuições para processos empresariais

O termo processo de negócio abrange uma vasta gama de atividades ou tarefas estruturadas, muitas vezes sequenciadas, para alcançar um objetivo organizacional pré-determinado. O termo pode também referir-se aos efeitos cumulativos de todos os passos que avançam em direção a um objetivo empresarial. Os processos de negócio são particulares a soluções que incluem o Dynamics 365. Acreditamos que este novo tipo de conteúdo cria uma estrutura que ajuda clientes e parceiros a estarem melhor preparados para adotar o Dynamics 365. Cada processo de negócio inclui um diagrama de um fluxo padrão de processos de negócio. Secções do documento descrevem os passos de configuração e as entidades de dados utilizadas em cada um. Cada etapa liga para a página relevante na documentação do produto, e todos os documentos têm ligações para os próximos passos e recursos relacionados para ajudar os leitores ao longo da sua jornada de aprendizagem.

Estruturámos os processos de negócio num catálogo. O catálogo de processos de negócio é um livro de exercícios Excel que nós, na Microsoft, usamos para organizar e priorizar o nosso trabalho na documentação dos processos de negócio. O formato é Excel porque facilita a ordenação e filtragem das entradas. Também acreditamos que os nossos parceiros podem usar o livro de exercícios Excel para organizar as suas jornadas de integração, os seus projetos de implementação e os seus próprios processos de negócio.

Descarregue a versão mais recente do catálogo em https://aka.ms/BusinessProcessCatalog.

Observação

Se quiser contribuir para os processos de negócio, registe o seu trabalho antes de começar para reduzir o risco de que outra pessoa esteja a trabalhar no mesmo processo de negócio. Para registar o seu trabalho, submeta uma edição no GitHub em https://github.com/microsoft/dynamics365patternspractices/issues.

O que o catálogo contém

O catálogo define seis níveis de conteúdo:

  1. Processos de ponta a ponta

    Um processo de ponta a ponta representa o fluxo completo de atividades desde o gatilho inicial até ao resultado final. Abrange todos os passos intermédios e subprocessos necessários para alcançar o objetivo de negócio. Identificámos 15 cenários de ponta a ponta. Descrevemos os cenários em termos empresariais, não em termos de tecnologia de software.

    Para cada processo de ponta a ponta, o artigo introdutório descreve como pensamos sobre o processo de ponta a ponta. Listamos os principais intervenientes e como o Dynamics 365 ajuda no processo de ponta a ponta. Também fornecemos uma visão geral, juntamente com um diagrama de fluxo de processos de negócio, de como o processo de ponta a ponta interage com outros processos de ponta a ponta. A introdução lista os pré-requisitos para implementar uma solução que suporte o processo de ponta a ponta.

  2. Áreas de processos de negócio

    Cada cenário de ponta a ponta cobre duas ou mais áreas de processos de negócio. Este nível representa um agrupamento significativo de atividades relacionadas que contribuem para o objetivo global e fornece uma forma lógica de agrupar processos de negócio. Na maioria dos casos, as áreas de processos de negócio estão separadas por funções ou departamentos principais numa organização. Atualmente, o catálogo define mais de 100 áreas de processos empresariais.

  3. Processos de negócio

    O termo processo de negócio abrange uma vasta gama de atividades ou tarefas estruturadas, muitas vezes sequenciadas, para alcançar um objetivo organizacional pré-determinado. O termo pode também referir-se aos efeitos cumulativos de todos os passos que avançam em direção a um objetivo empresarial. Cada processo de negócio descreve uma função ou processo que o Dynamics 365 suporta. Até agora, identificámos mais de 800 processos empresariais. Alguns aplicam-se a uma única aplicação Dynamics 365, e a documentação da aplicação pode já descrever o processo. Ao reunir todos os processos de negócio aqui no guia, esperamos fornecer um ponto de entrada único com ligações para conteúdos específicos de produto relevantes.

  4. Cenários

    No Dynamics 365, cenários são padrões de configurações repetíveis que suportam um processo de negócio específico. Incluem os casos de uso, cenários e indústrias mais comuns. Muitas vezes, existem muitas formas de implementar o Dynamics 365 para satisfazer as necessidades do seu negócio. O nosso objetivo com os padrões é fornecer uma base para a sua implementação. Identificámos mais de 3000 cenários e padrões, e esperamos que esse número cresça ao longo do tempo.

  5. Processos do sistema

    Um processo de sistema é uma parte de um processo de negócio que utiliza um formulário, página ou elemento de interface específico no Dynamics 365.

  6. Casos de teste

Um caso de teste é um conjunto detalhado de condições e passos usados para determinar se uma aplicação ou sistema de software funciona corretamente. É uma parte essencial do processo de testes de software, concebida para garantir que o software cumpre os seus requisitos e funciona conforme esperado. Os casos de teste são usados para identificar defeitos, garantir a qualidade e verificar se o software se comporta conforme previsto em várias condições.

Existem modelos Word para cada tipo de conteúdo. As instruções estão formatadas a vermelho, rodeadas por colchetes quadrados, como no seguinte exemplo:[Text in red] Apaga estas instruções quando finalizares o documento. O texto destacado a amarelo deve ser substituído ou ajustado por ti. Não mudes o texto que não está destacado a amarelo nem formatado a vermelho. Estas frases padrão ajudam os utilizadores a reconhecer o modelo, permitindo-lhes percorrer mais facilmente o conteúdo que procuram.

Obtenha uma introdução adicional ao catálogo de processos de negócio em About the business process guide. Opcionalmente, consulte os TechTalks onde falamos sobre como pode usar o catálogo de processos de negócio e contribuir para a biblioteca de conteúdos.

Submeta a sua contribuição

Internamente, na Microsoft, estamos a trabalhar arduamente para converter notas internas, anos de experiência e vários documentos em orientações para processos de negócio. Agradecemos muito as contribuições da comunidade.

Existem diferentes modelos para submeter contribuições consoante o tipo de artigo. Os colaboradores devem escolher o modelo certo para o tipo de artigo adequado ao qual pretendem contribuir. Os modelos estão disponíveis em ficheiros Word que são nomeados para explicar para que tipo de artigo o modelo se destina.

Reconhecimento do contribuidor

A plataforma Microsoft Learn mostra tanto os colaboradores internos como externos no topo de cada artigo, caso tenham submetido a sua contribuição através do GitHub. Algumas pessoas contribuem de outras formas, por isso adicionamos uma secção de Colaboradores perto do final do artigo.

A secção opcional de Colaboradores lista os principais colaboradores com o seu nome e um link para o LinkedIn ou outro perfil, caso tenham fornecido um. A captura de ecrã seguinte é uma versão anonimizada da secção Contributors num artigo do Azure Architecture Center.

Captura de ecrã de uma secção de exemplos de Colaboradores, mostrando o autor principal mais três colaboradores listados com ligações para os seus perfis no LinkedIn.

Aqui está como fica em Markdown.

## Contributors

*This article is maintained by Microsoft. It was originally written by the following contributors.*

Principal author:

* [Author's Name](https://www.linkedin.com/in/author-account/) | Author's job title or similar  

Other contributors:

* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar  
* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar  

Ser listado como colaborador desta forma é opcional. Em toda a Microsoft, recomendamos usar a secção Contributors se colaboradores externos submeterem novo conteúdo, como arquiteturas de referência e padrões de design, por meios diferentes do GitHub.