Compartir vía

Contribuir a la documentación de Dynamics 365

Puedes 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 conoces una buena solución para un problema recurrente, puedes usar el enlace de comentarios en el artículo para informarnos.

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

Enviar comentario

En la web de learn.microsoft.com , cada artículo de Learn ofrece la oportunidad de dar su opinión. Puedes elegir la acción de Feedback que está bajo el título del artículo en la esquina superior derecha o una de las opciones de feedback en la parte inferior del artículo en la sección de Feedback . Dale una valoración al artículo, selecciona el motivo de tu comentario y considera dejar un comentario. La retroalimentación va al autor del artículo y al equipo propietario de los documentos.

Si un artículo no puede ser editado directamente, o si no te sientes cómodo editando, te animamos a utilizar el mecanismo de retroalimentación para decirnos qué opinas sobre el artículo o el producto.

Contribuciones externas a la documentación de Microsoft

Los archivos fuente de nuestro contenido principal se almacenan en repositorios públicos de GitHub. Cualquiera puede revisarlos y, en muchos casos, editarlos. Agradecemos vuestras sugerencias y correcciones, ya sea en forma de contribuciones directas o en GitHub para reportar un error o hacer una pregunta. Solo podemos aceptar comentarios y contribuciones al contenido original en inglés.

La mayoría de los artículos tienen un icono de lápiz con la descripción Editar este documento. Selecciona el icono para abrir el artículo en GitHub y luego empieza a editar. Empieza como colaborador con la guía para colaboradores de Microsoft Learn.

Si quieres ser exhaustivo y contribuir con nuevos artículos conceptuales, utiliza 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 utiliza los mismos procesos que la mayoría de la documentación de Microsoft Learn. En esta sección, señalamos herramientas y procesos que puedes utilizar para ayudar a añadir a la guía de implementación.

El término contenido de orientación abarca la guía de implementación de Dynamics 365, descripciones de procesos empresariales, nuevos patrones, mejores prácticas y arquitecturas de referencia. Publicamos el primer contenido de orientación en abril de 2023, y añadimos actualizaciones cada dos semanas. Consulta el centro de orientación y cuéntanos qué te parece bueno y qué falta.

Parte del contenido de la guía es proporcionado por colaboradores internos. Animamos a expertos en la materia de toda la comunidad a ayudarnos a establecer buenas prácticas. Sigue leyendo si tienes alguna buena práctica u otra opinión que creas que debería formar parte de Microsoft Learn.

¿Por qué contribuir?

Creemos que el contenido de orientación ayuda a que los proyectos de implementación de Dynamics 365 funcionen más rápido. Nuestros socios y clientes pueden utilizar la orientación para prepararse para la implementación y para mejorar habilidades en nuevas áreas o para formar a nuevo personal. Los desarrolladores de software pueden utilizar el contenido como plataforma para promocionar 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 expertas en diversos aspectos de la implementación. ¿Tienes un patrón, una buena práctica, una configuración o una arquitectura de integración que funcione bien entre varias implementaciones? Considera 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 otros reconocimientos por las contribuciones. Por ahora, reconocemos a los colaboradores en los artículos de dos maneras diferentes. Más información en la sección de reconocimiento de colaboradores .

Cómo contribuir

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

Recomendamos que envíes correcciones de la misma manera que las envías a otras áreas de Microsoft Learn. Sin embargo, para enviar contenido nuevo , te pedimos que subas tus archivos Markdown para el contenido de orientación nuevo a otro repositorio, Dynamics 365 Patterns and Practices. De este modo, podemos asegurarnos de que tu arquitectura o patrón de referencia sea revisado por otros expertos en la materia. Hay diferentes plantillas para elegir, y si quieres contribuir al contenido del proceso de negocio, hay un proceso completamente distinto.

Plantillas

Microsoft ofrece plantillas en dos ubicaciones, dependiendo del tipo de plantilla:

Iremos añadiendo más plantillas y orientaciones con el tiempo. Recomendamos que sigas los repositorios o los guardes con una estrella, para que te avisen cuando algo cambie.

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

Si aún no tienes una cuenta en GitHub, empieza con la guía de colaboradores de Microsoft Learn.

Sugerencia

Explora nuestros archivos fuente en el https://github.com/MicrosoftDocs/dynamics365-guidance repositorio. Aprende de cómo estructuramos los diferentes tipos de artículos para que tus artículos sigan la misma estructura. Así, el proceso de revisión es más rápido.

Arquitecturas

Agradecemos contribuciones de orientación arquitectónica, incluyendo ideas de soluciones y patrones de diseño. Si tienes una implementación de buenas prácticas o referencia, envía tu propuesta al equipo de Azure o a nosotros en Dynamics 365.

Para contribuir con nuevos artículos a la guía arquitectónica de Dynamics 365, sigue 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 una introducción general al contenido de orientación en Microsoft, consulta el Centro de Arquitectura de Azure. Para la guía de colaboradores, consulte las contribuciones de Azure Architecture Center.

El repositorio de GitHub dynamics365-docs-templates contiene las siguientes plantillas de Markdown para orientación arquitectónica en la carpeta guidance-templates :

  • Patrón de arquitectura generalizado: Un patrón de arquitectura generalizado actúa como una arquitectura central 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 ofrecer una perspectiva a una industria concreta o solución de un socio y enlazar con la arquitectura de cada idea. La plantilla se basa en la plantilla de la Guía de Arquitectura de Azure. Úsalo para diferentes tipos de arquitecturas, incluidas las de referencia.

  • Idea de solución: Las ideas de solución son arquitecturas "pequeñas" de implementaciones de Dynamics 365. Ofrecen breves resúmenes de soluciones con servicios de Dynamics 365 y Azure. Cada idea de solución contiene los siguientes elementos:

    • Un diagrama arquitectónico
    • Un flujo de datos
    • Componentes, es decir, una lista de los servicios utilizados
    • Créditos de los colaboradores
    • Enlaces a los siguientes pasos 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 "medias". Guían a los lectores en el proceso de diseño de soluciones para problemas específicos en implementaciones de Dynamics 365. Las soluciones de ejemplo proporcionan orientación accionable de arquitectura basada en ejemplos reales de clientes. El objetivo es acortar la curva de aprendizaje de los clientes contándoles la historia de otro cliente que ha tenido el mismo recorrido. Incluyen las secciones de la plantilla de Ideas de Solución y añaden las siguientes secciones:

    • Alternativas, otros servicios que puedas conectar a la arquitectura en su lugar
    • Consideraciones, directrices que se corresponden con nuestro marco de Éxito por Diseño y, opcionalmente, incluyen un despliegue

  • 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 o buenas prácticas concretas. Utiliza esta plantilla para capturar un patrón de proceso empresarial. Alternativamente, utiliza la plantilla de Word en dynamics365patternspractices/templates/business-processes.

Contribuciones a procesos empresariales

El término proceso empresarial abarca una amplia gama de actividades o tareas estructuradas, a menudo secuenciadas, para lograr un objetivo organizativo predeterminado. El término también puede referirse a los efectos acumulativos de todos los pasos que avanzan hacia un objetivo empresarial. Los procesos empresariales son particulares de soluciones que incluyen Dynamics 365. Creemos que este nuevo tipo de contenido crea una estructura que ayuda a clientes y socios a estar mejor preparados para adoptar Dynamics 365. Cada proceso de negocio incluye un diagrama de un flujo estándar de procesos de negocio. Las secciones del documento describen los pasos de configuración y las entidades de datos utilizadas en cada uno. Cada paso enlaza con la página relevante en la documentación del producto, y todos los documentos tienen enlaces a los siguientes pasos y recursos relacionados para ayudar a los lectores en su proceso de aprendizaje.

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

Descarga la última versión del catálogo desde https://aka.ms/BusinessProcessCatalog.

Nota

Si quieres contribuir a los procesos empresariales, registra tu trabajo antes de empezar para reducir el riesgo de que otra persona trabaje en el mismo proceso empresarial. Para registrar tu trabajo, envía un número en GitHub en https://github.com/microsoft/dynamics365patternspractices/issues.

Lo que contiene el catálogo

El catálogo define seis niveles de contenido:

  1. Procesos de extremo a extremo

    Un proceso de extremo a extremo representa el flujo completo de actividades desde el desencadenante inicial hasta el resultado final. Incluye todos los pasos intermedios y subprocesos necesarios para alcanzar el objetivo empresarial. Hemos identificado 15 escenarios de extremo a extremo. Describimos los escenarios en términos empresariales, no en términos de tecnología de software.

    Para cada proceso de extremo a extremo, el artículo introductorio describe cómo pensamos sobre el proceso de extremo a extremo. Enumeramos a los principales interesados y cómo Dynamics 365 ayuda en el proceso de extremo a extremo. También ofrecemos una visión general, junto con un diagrama de flujo de procesos empresariales, de cómo interactúa el proceso de extremo a extremo con otros procesos de extremo a extremo. La introducción enumera los requisitos previos para implementar una solución que soporte el proceso de extremo a extremo.

  2. Áreas de procesos empresariales

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

  3. Procesos empresariales

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

  4. Escenarios

    En Dynamics 365, los escenarios son patrones de configuraciones repetibles que soportan un proceso empresarial específico. Incluyen los casos de uso, escenarios e industrias más comunes. A menudo, hay muchas formas de implementar Dynamics 365 para satisfacer los requisitos de tu empresa. Nuestro objetivo con los patrones es proporcionar una base para tu 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 empresarial que utiliza un formulario, página o elemento de interfaz de usuario específico en Dynamics 365.

  6. Casos de prueba

Un caso de prueba es un conjunto detallado de condiciones y pasos utilizados para determinar si una aplicación o sistema de software funciona correctamente. Es una parte esencial del proceso de pruebas de software, diseñada para asegurar que el software cumpla con sus requisitos y funcione como se espera. Los casos de prueba se utilizan para identificar defectos, garantizar la calidad y verificar que el software se comporte como se espera bajo diversas condiciones.

Hay plantillas de Word para cada tipo de contenido. Las instrucciones están formateadas en rojo rodeadas de corchetes, como en el siguiente ejemplo:[Text in red] Elimina estas instrucciones cuando finalices el documento. El texto resaltado en amarillo debe ser reemplazado o ajustado por ti. No cambies el texto que no está resaltado en amarillo ni formateado en rojo. Estas frases estándar ayudan a los usuarios a reconocer la plantilla para que puedan escanear y encontrar el contenido que buscan con mayor facilidad.

Obtén una introducción más detallada al catálogo de procesos empresariales en Acerca de la guía de procesos empresariales. Opcionalmente, revisa los TechTalks donde hablamos sobre cómo puedes usar el catálogo de procesos de negocio y contribuir a la biblioteca de contenido.

Envía tu contribución

Internamente, en Microsoft, trabajamos duro para convertir notas internas, años de experiencia y diversos documentos en orientación sobre procesos empresariales. Agradecemos mucho las contribuciones de la comunidad.

Existen diferentes plantillas para enviar contribuciones según el tipo de artículo. Los colaboradores deben elegir la plantilla adecuada para el tipo de artículo al que desean contribuir. Las plantillas están disponibles como archivos de Word que se nombran para explicar para qué tipo de artículo está destinada la plantilla.

Reconocimiento de colaboradores

La plataforma Microsoft Learn muestra tanto a los colaboradores internos como externos al principio de cada artículo si han enviado su contribución a través de GitHub. Algunas personas contribuyen de otras maneras, así que añadimos una sección de Colaboradores hacia el final del artículo.

La sección opcional de Colaboradores lista a los colaboradores clave con su nombre y un enlace a su perfil de LinkedIn u otro perfil si lo han proporcionado. La siguiente captura de pantalla es una versión anonimizada de la sección Colaboradores en un artículo del Azure Architecture Center.

Captura de pantalla de una sección de ejemplo de Colaboradores, mostrando al autor principal más tres colaboradores listados con enlaces a sus perfiles de LinkedIn.

Así es como se ve 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

Ser incluido como colaborador de esta forma es opcional. En Microsoft, recomendamos usar la sección de Contribuyentes si los colaboradores externos presentan contenido nuevo, como arquitecturas de referencia y patrones de diseño, por otros medios distintos a GitHub.

  • Last updated on