Compartir a través de

Contribución a la documentación de Dynamics 365

Puede contribuir a la documentación de Microsoft para Dynamics 365 de dos maneras. Si un artículo contiene información incorrecta o confusa, o si conoce una buena solución alternativa para un problema recurrente, puede usar el vínculo de comentarios del artículo para informarnos.

Para la mayoría de nuestra documentación, también puede editar un artículo directamente para iniciar un proceso de revisión.

Proporcionar comentarios

En el sitio web de learn.microsoft.com , cada artículo de Learn ofrece la oportunidad de proporcionar comentarios. Puede elegir la acción Comentarios que se encuentra en el título del artículo en la parte superior derecha o una de las opciones de comentarios en la parte inferior del artículo de la sección Comentarios . Asigne una clasificación al artículo, seleccione el motivo de sus comentarios y considere la posibilidad de dejar un comentario. Los comentarios van al autor del artículo y al equipo que posee los documentos.

Si un artículo no se puede editar directamente o si no está cómodo editarlo, le recomendamos que use el mecanismo de comentarios para indicarnos lo que piensa sobre el artículo o el producto.

Contribuciones externas a la documentación de Microsoft

Los archivos de origen de nuestro contenido principal se almacenan en repositorios públicos de GitHub. Cualquier persona puede revisarlas y, en muchos casos, editarlas. Agradecemos sus sugerencias y correcciones, ya sea en forma de contribuciones directas o como problemas de GitHub para notificar un error o formular una pregunta. Solo podemos aceptar comentarios y contribuciones al contenido de origen en inglés.

La mayoría de los artículos tienen un icono de lápiz con la información sobre herramientas Editar este documento. Seleccione el icono para abrir el artículo en GitHub y, a continuación, empiece a editarlo. Empiece a trabajar como colaborador con la guía de colaboradores de Microsoft Learn.

Si desea obtener artículos conceptuales completos y contribuir con nuevos, use las plantillas en https://github.com/MicrosoftDocs/dynamics365-docs-templates.

Contenido de la guía de Dynamics 365

El contenido de la guía de Dynamics 365 usa los mismos procesos que la mayoría de la documentación de Microsoft Learn. En esta sección, destacamos herramientas y procesos que puede usar para contribuir a la guía de implementación.

El contenido de la guía de términos abarca la guía de implementación de Dynamics 365, las descripciones de los procesos empresariales, los nuevos patrones, los procedimientos recomendados y las arquitecturas de referencia. Publicamos el primer contenido de instrucciones en abril de 2023 y agregamos actualizaciones cada dos semanas. Examine el centro de instrucciones y háganos saber qué es genial y qué falta.

Algunos de los colaboradores internos proporcionan parte del contenido de la guía. Animamos a expertos en la materia en toda la comunidad para ayudarnos a establecer procedimientos recomendados. Lea si tiene un procedimiento recomendado u otra información que cree que debe formar parte de Microsoft Learn.

¿Por qué contribuir?

Creemos que el contenido de la guía ayuda a que los proyectos de implementación de Dynamics 365 se ejecuten más rápido. Nuestros asociados y clientes pueden usar las instrucciones para prepararse para la implementación y para mejorar la aptitud en nuevas áreas o habilidades para el personal nuevo. Los desarrolladores de software pueden usar el contenido como plataforma para promover su propiedad intelectual o experiencia en el sector.

Pero en Microsoft no somos los únicos expertos en cómo implementar soluciones con Dynamics 365. La comunidad incluye personas que son expertos en diversos aspectos de la implementación. ¿Tiene un patrón, un procedimiento recomendado, una configuración o una arquitectura de integración que funcione bien en varias implementaciones? Considere la posibilidad de compartirlo aquí en Microsoft Learn para que toda la comunidad sea aún más productiva y eficiente en sus proyectos de implementación.

Esperamos poder ofrecer recompensas u otras confirmaciones de contribuciones. Por ahora, reconocemos colaboradores en los artículos de dos maneras diferentes. Obtenga más información en la sección Reconocimiento de colaboradores .

Cómo contribuir

Puede encontrar los archivos de origen para el contenido de instrucciones de Dynamics 365 de Microsoft en un repositorio público de GitHub. También puede editar los artículos del sitio de learn.microsoft.com/dynamics365/guidance como se describe en la guía de colaboradores de Microsoft Learn.

Le recomendamos que envíe correcciones de la misma manera que envíe una corrección a otras áreas de Microsoft Learn. Sin embargo, para enviar contenido nuevo , le pedimos que cargue los archivos Markdown para obtener contenido de nueva guía en un repositorio diferente, patrones y prácticas de Dynamics 365. De este modo, podemos asegurarnos de que otros expertos en la materia revisen su arquitectura o patrón de referencia. Hay diferentes plantillas entre las que elegir y, si desea contribuir al contenido del proceso de negocio, hay un proceso diferente por completo.

Plantillas

Microsoft proporciona plantillas en dos ubicaciones, según el tipo de plantilla:

Agregaremos más plantillas e instrucciones a lo largo del tiempo. Se recomienda seguir los repositorios o guardarlos con una estrella para recibir notificaciones cuando cambie algo.

Comparta sus comentarios en la https://github.com/microsoft/dynamics365patternspractices/discussions pestaña del repositorio Patrones y prácticas de Dynamics 365.

Si aún no tiene una cuenta de GitHub, empiece a trabajar con la guía de colaborador de Microsoft Learn.

Sugerencia

Examine nuestros archivos de origen en el https://github.com/MicrosoftDocs/dynamics365-guidance repositorio. Obtenga información sobre cómo estructuramos los distintos tipos de artículos para que los artículos sigan la misma estructura. De este modo, el proceso de revisión se ejecuta más rápido.

Arquitecturas

Agradecemos las contribuciones de las instrucciones arquitectónicas, incluidas las ideas de solución y los patrones de diseño. Si tiene un procedimiento recomendado o una implementación de referencia, envíe su propuesta al equipo de Azure o a nosotros en Dynamics 365.

Para aportar nuevos artículos a la guía de arquitectura de Dynamics 365, siga estos pasos principales:

Microsoft procesa el artículo y lo publica como parte de la documentación de la guía de Dynamics 365 .

Para obtener una introducción general al contenido de instrucciones en Microsoft, consulte el Centro de arquitectura de Azure. Para obtener la guía de colaboradores, consulte Contribuciones del Centro de arquitectura de Azure.

El repositorio de GitHub dynamics365-docs-templates contiene las siguientes plantillas de Markdown para obtener instrucciones arquitectónicas en la carpeta guidance-templates :

  • Patrón de arquitectura generalizada: un patrón de arquitectura generalizada actúa como una arquitectura principal con una solución común que se aplica a muchos escenarios. Por ejemplo, las ideas de solución pueden basarse en un artículo arquitectónico para proporcionar un enfoque específico para una industria o solución de asociado y vincularse con la arquitectura desde cada idea de solución. La plantilla se basa en la plantilla guía de arquitectura de Azure. Úselo para diferentes tipos de arquitecturas, incluidas las arquitecturas de referencia.

  • Idea de solución: las ideas de solución son arquitecturas "pequeñas" de implementaciones de Dynamics 365. Proporcionan breves información general sobre las soluciones con los servicios de Dynamics 365 y Azure. Cada idea de solución contiene los siguientes elementos:

    • Diagrama de arquitectura
    • Un flujo de datos
    • Componentes, lo que significa una lista de los servicios usados
    • Créditos de colaborador
    • Vínculos a los pasos siguientes y recursos relacionados, como guías y arquitecturas relacionadas

  • Solución de ejemplo: las soluciones de ejemplo son cargas de trabajo de ejemplo con arquitecturas "medianas". Guían a los lectores a través del proceso de diseño de soluciones para problemas específicos en implementaciones de Dynamics 365. Las soluciones de ejemplo proporcionan instrucciones de arquitectura accionables basadas en ejemplos reales de clientes. El objetivo es acortar la curva de aprendizaje de los clientes al contarles la historia de otro cliente que tenía el mismo recorrido. Incluyen las secciones de la plantilla Idea de solución y agregan las secciones siguientes:

    • Alternativas, otros servicios que puede conectar en su lugar a la arquitectura.
    • Consideraciones, orientaciones que se corresponden con nuestro marco Success by Design y, opcionalmente, incluye una implementación.

  • Patrón de diseño: los patrones de diseño de Dynamics 365 abordan desafíos específicos en las implementaciones y se basan en un escenario específico o procedimiento recomendado. Use esta plantilla para capturar un patrón de proceso de negocio. Como alternativa, use la plantilla de Word en dynamics365patternspractices/templates/business-processes.

Contribuciones a procesos empresariales

El término proceso de negocio abarca una amplia gama de tareas estructuradas, a menudo secuenciadas, o tareas para lograr un objetivo organizativo predeterminado. El término también puede hacer referencia a los efectos acumulativos de todos los pasos que progresan hacia un objetivo empresarial. Los procesos empresariales son específicos de las soluciones que incluyen Dynamics 365. Creemos que este nuevo tipo de contenido crea una estructura que ayuda a los clientes y asociados a estar mejor preparados para adoptar Dynamics 365. Cada proceso de negocio incluye un diagrama de un flujo de proceso de negocio estándar. Secciones de los pasos de configuración del esquema del documento y las entidades de datos usadas en cada una. Cada paso vincula a la página pertinente de la documentación del producto y todos los documentos tienen vínculos a los pasos siguientes y recursos relacionados para ayudar a los lectores a lo largo de su recorrido de aprendizaje.

Estructuramos los procesos empresariales en un catálogo. El catálogo de procesos empresariales es un libro de Excel que usamos en Microsoft para organizar y priorizar nuestro trabajo en la documentación del proceso de negocio. El formato es Excel porque facilita la ordenación y el filtrado de las entradas. También creemos que nuestros asociados pueden usar el libro de Excel para organizar sus recorridos de incorporación, sus proyectos de implementación y sus propios procesos empresariales.

Descargue la versión más reciente del catálogo desde https://aka.ms/BusinessProcessCatalog.

Nota:

Si desea contribuir a los procesos empresariales, registre su trabajo antes de empezar a reducir el riesgo de que otra persona esté trabajando en el mismo proceso de negocio. Para registrar el trabajo, envíe un problema de GitHub en https://github.com/microsoft/dynamics365patternspractices/issues.

Qué contiene el catálogo

El catálogo define seis niveles de contenido:

  1. Procesos de principio a fin

    Un proceso de un extremo a otro representa el flujo completo de actividades desde el desencadenador inicial hasta el resultado final. Abarca todos los pasos intermedios y subprocesos necesarios para lograr el objetivo empresarial. Hemos identificado 15 escenarios de extremo a extremo. Se describen los escenarios en términos empresariales, no en términos de tecnología de software.

    Para cada proceso completo, en el artículo introductorio se describe cómo pensamos en el proceso de un extremo a otro. Enumeramos las partes interesadas clave y cómo Dynamics 365 ayuda al proceso de un extremo a otro. También se proporciona información general, junto con un diagrama de flujo de proceso de negocio, de cómo interactúa el proceso de un extremo a otro con otros procesos de un extremo a otro. En la introducción se enumeran los requisitos previos para implementar una solución para respaldar el proceso de extremo a extremo.

  2. Áreas de proceso de negocio

    Cada escenario de un extremo a otro abarca dos o más áreas de proceso de negocio. Este nivel representa una agrupación significativa de actividades relacionadas que contribuyen al objetivo general y proporciona una manera lógica de agrupar procesos empresariales. En la mayoría de los casos, las áreas de proceso de negocio están separadas por las principales funciones de trabajo o departamentos de una organización. Actualmente, el catálogo define más de 100 áreas de proceso de negocio.

  3. Procesos de negocio

    El término proceso de negocio abarca una amplia gama de tareas estructuradas, a menudo secuenciadas, o tareas para lograr un objetivo organizativo predeterminado. El término también puede hacer referencia a los efectos acumulativos de todos los pasos que progresan hacia un objetivo empresarial. Cada proceso de negocio describe una función o proceso compatible con Dynamics 365. Hasta ahora, hemos identificado más de 800 procesos empresariales. Algunos se aplican a una sola aplicación de Dynamics 365 y es posible que la documentación de la aplicación ya describa el proceso. Al recopilar todos los procesos empresariales aquí en la guía, esperamos proporcionar un único punto de entrada con vínculos a contenido específico del producto pertinente.

  4. Escenarios

    En Dynamics 365, los escenarios son patrones de configuraciones repetibles que admiten un proceso de negocio específico. Incluyen los casos de uso, escenarios y sectores más comunes. A menudo, hay muchas maneras de implementar Dynamics 365 para satisfacer sus requisitos empresariales. Nuestro objetivo con patrones es proporcionar una línea base para su implementación. Hemos identificado más de 3000 escenarios y patrones, y esperamos que ese número crezca con el tiempo.

  5. Procesos del sistema

    Un proceso del sistema es una parte de un proceso de negocio que usa un elemento de interfaz de usuario, página o formulario específico en Dynamics 365.

  6. Casos de prueba

Un caso de prueba es un conjunto detallado de condiciones y pasos que se usan para determinar si una aplicación de software o un sistema funciona correctamente. Es una parte esencial del proceso de prueba de software, diseñado para asegurarse de que el software cumple sus requisitos y funciona según lo previsto. Los casos de prueba se usan para identificar defectos, garantizar la calidad y comprobar que el software se comporta según lo previsto en diversas condiciones.

Hay plantillas de Word para cada tipo de contenido. Las instrucciones tienen el formato rojo entre corchetes como en el ejemplo siguiente:[Text in red] Elimine estas instrucciones al finalizar el documento. El texto resaltado en amarillo se debe reemplazar o ajustar por usted. No cambie el texto que no está resaltado en amarillo y no tenga el formato rojo. Estas frases estándar ayudan a los usuarios a reconocer la plantilla para que puedan examinar y encontrar el contenido que buscan más fácilmente.

Obtenga una introducción adicional al catálogo de procesos empresariales en La guía acerca del proceso de negocio. Opcionalmente, revise TechTalks donde hablamos sobre cómo puede usar el catálogo de procesos empresariales y contribuir a la biblioteca de contenido.

Enviar su contribución

Internamente en Microsoft, estamos trabajando duro para convertir notas internas, años de experiencia y varios documentos en orientación de procesos empresariales. Agradecemos enormemente las contribuciones de la comunidad.

Hay diferentes plantillas para enviar contribuciones en función del tipo de artículo. Los colaboradores deben elegir la plantilla adecuada para el tipo adecuado de artículo al que quieren contribuir. Las plantillas están disponibles como archivos de Word denominados para explicar a qué tipo de artículo está destinado la plantilla.

Reconocimiento a los colaboradores

La plataforma Microsoft Learn muestra tanto colaboradores internos como externos en la parte superior de cada artículo si enviaron su contribución a través de GitHub. Algunas personas contribuyen de otras maneras, por lo que agregamos una sección Colaboradores al final del artículo.

En la sección Colaboradores opcionales se enumeran los colaboradores clave con su nombre y un vínculo a su LinkedIn u otro perfil si se proporciona uno. La captura de pantalla siguiente es una versión anonimizada de la sección Colaboradores en un artículo del Centro de arquitectura de Azure.

Captura de pantalla de una sección Colaboradores de ejemplo, en la que se muestra el autor principal más tres colaboradores enumerados con vínculos a sus perfiles de LinkedIn.

Esto es lo que parece en 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

Figurar como colaborador en la lista es opcional. En Microsoft, se recomienda usar la sección Colaboradores si los colaboradores externos envían contenido nuevo, como arquitecturas de referencia y patrones de diseño, a través de otros medios que GitHub.

  • Last updated on