Cuando se integran con un Workspace conectado, los proyectos de Altium Designer permiten que un equipo de diseño distribuido trabaje de forma colaborativa en proyectos almacenados y gestionados centralmente. La interfaz de diseño admite comentarios en varios documentos de diseño para mejorar el proceso de colaboración en el diseño. Los comentarios, es decir, notas agregadas por el usuario, pueden colocarse en los documentos y otros usuarios pueden responderlos.
El panel Comments and Tasks
Los comentarios colocados están disponibles en tiempo real para los usuarios que colaboran (aquellos que tienen acceso compartido al documento) y se guardan en el servidor de manera independiente del proyecto, sin alterar de ninguna forma sus documentos constituyentes. La función de comentarios se gestiona mediante el panel Comments and Tasks . Cuando se selecciona una entrada de comentario en el panel Comments and Tasks , el sistema abrirá (y cargará, si es necesario) el documento de diseño asociado.
El panel Comments and Tasks le permite agregar comentarios a un área o punto definido en el documento activo de un proyecto de Workspace y asignar estos comentarios a miembros del Workspace, creando esencialmente tareas para ellos. El panel permite que todos los usuarios que trabajan en el documento agreguen comentarios y vean todos los comentarios sin modificar realmente el propio documento. Esta función facilita procesos de colaboración sólidos y es invaluable cuando es necesario señalar problemas dentro del documento sin realizar físicamente una fusión ni recibir conflictos. El panel Comments and Tasks puede utilizarse esencialmente para crear una lista de tareas pendientes y, a medida que el diseño madura, los comentarios pueden resolverse y cerrarse. Los comentarios colocados están disponibles en tiempo real para los usuarios que colaboran –aquellos que tienen acceso compartido al documento– y se guardan en el Workspace de manera independiente del proyecto, sin alterar de ninguna forma sus documentos constituyentes.
Si no tiene acceso a la funcionalidad para crear y gestionar tareas, esta funcionalidad no estará disponible y el panel se llamará Comments .
Tenga en cuenta que los comentarios y las tareas pueden agregarse y gestionarse tanto en Altium Designer como en el Workspace relacionado a través de la vista de diseño de su interfaz de navegador. La funcionalidad de ambos sistemas de comentarios es esencialmente la misma y, dado que tanto el proyecto como los datos de comentarios se almacenan en el Workspace, los sistemas funcionan juntos en tiempo real.
Consulte Commenting in the Web Viewer (Altium 365 Workspace , Enterprise Server Workspace ) para obtener información detallada sobre el sistema de comentarios en la interfaz de navegador de un Workspace.
Dónde se admite Comentarios
Esquemático
Se puede aplicar un comentario a un objeto, a un punto específico o a un área en un documento esquemático.
PCB
Se puede aplicar un comentario a un objeto, a un punto específico o a un área en un documento PCB (en modo de diseño 2D) – .
Tenga en cuenta que, al enfocar un comentario en un documento PCB, se cambiará automáticamente a la misma vista que tenía el revisor (capas visibles, capa activa, vista superior/inferior). A continuación se muestra un ejemplo de cambio de configuración de vista al enfocar un comentario.
❯ ❮
1
Javascript ID: PCB_Support1
La configuración de vista antes de enfocar un comentario: todas las capas de señal están habilitadas, Bottom es la capa activa y la placa se muestra desde el lado inferior.
La placa después de enfocar un comentario (se aplica la misma vista que estaba activa cuando se agregó el comentario): Top es la única capa de señal habilitada, Top es la capa activa y la placa se muestra desde el lado superior.
Draftsman
Se puede aplicar un comentario a un punto específico o a un área en un documento Draftsman de un proyecto PCB, Multi-board o Harness Design – .
Esquemático Multi-board
Los comentarios en documentos Multi-board Schematic están disponibles cuando la opción MBS.Comments está habilitada en el cuadro de diálogo Advanced Settings .
Se puede aplicar un comentario a un objeto o a un punto específico en un documento Multi-board Schematic – .
Ensamblaje Multi-board
Los comentarios en documentos Multi-board Assembly están disponibles cuando la opción MBA.Comments está habilitada en el cuadro de diálogo Advanced Settings .
Se puede aplicar un comentario a un punto específico en el documento Multi-board Assembly – .
Harness Wiring Diagram y Layout Drawing
Los comentarios en documentos Harness Wiring Diagram y Layout Drawing están disponibles cuando la opción Harness.Comments está habilitada en el cuadro de diálogo Advanced Settings .
Se puede aplicar un comentario a un objeto, a un punto específico o a un área en un documento Wiring Diagram o Layout Drawing de un proyecto de diseño de arnés .
ActiveBOM
Los comentarios en documentos ActiveBOM están disponibles cuando la opción BOM.Comments está habilitada en el cuadro de diálogo Advanced Settings .
Se puede aplicar un comentario a una fila en un documento ActiveBOM – .
Acceso al panel Comments and Tasks
Se accede al panel desde un proyecto de Workspace de las siguientes maneras:
Haga clic en el botón Panels en la parte inferior derecha del espacio de diseño y luego seleccione Comments and Tasks .
El icono de Workspace junto al nombre de un panel en el menú situado en la parte inferior derecha del espacio de diseño indica que se requiere una conexión a un Workspace para ver los datos del panel asociado. Un icono azul ( ) significa que actualmente hay una conexión a un Workspace. Un icono gris ( ) indica que actualmente no hay conexión a un Workspace y se le pedirá que se conecte a un Workspace antes de poder acceder a los datos del panel.
Seleccione el comando View » Panels » Comments and Tasks en los menús principales.
Haga doble clic en el pin marcador de un comentario colocado en el espacio de diseño.
Para acceder al panel Comments and Tasks , el documento activo debe ser un documento esquemático, PCB, ActiveBOM, esquemático Multi-board o Draftsman de un proyecto de Workspace abierto. Solo estarán disponibles para su selección aquellos proyectos que se hayan compartido actualmente con usted.
Agregar un comentario cuando no está conectado a un Workspace
Antes de usar la función de comentarios, asegúrese de estar conectado a su Workspace y de haber abierto un proyecto y uno de los tipos de documento que admiten comentarios (incluidos esquemático, PCB 2D, Draftsman y ActiveBOM). Use el comando File » Open Project para elegir un proyecto de Workspace entre aquellos que se han compartido con usted. El panel Comments and Tasks proporcionará indicaciones sobre estos requisitos previos.
Si disfruta de los beneficios de su suscripción pero aún no ha creado un Altium 365 Workspace para su empresa, puede probar las funciones de comentarios en modo de demostración. Cuando haya iniciado sesión en su cuenta de Altium desde Altium Designer y trabaje con un proyecto local, podrá colocar hasta tres comentarios. Para usar la función de comentarios con funcionalidad completa y para guardar los comentarios colocados, el proyecto debe ponerse a disposición del Workspace; para ello se proporcionará un control apropiado en el cuadro de mensaje situado debajo del cuadro de diálogo emergente de comentarios en el espacio de diseño.
Pruebe la función de comentarios en su modo de demostración cuando aún no tenga activado un Altium 365 Workspace.
Opciones del panel Comments and Tasks
Use los botones de la parte superior del panel Comments and Tasks para establecer la disponibilidad de los comentarios en el panel y en el espacio del editor, y para especificar si se notifica a los usuarios mencionados.
El botón del panel alterna la visibilidad de los pines marcadores de comentarios en el documento. Las entradas de comentarios en la lista del panel Comments and Tasks aún pueden seleccionarse como de costumbre.
Utilice el menú desplegable de filtro en el panel Comments and Tasks ( ) para configurar el filtrado de comentarios y el botón asociado para alternar entre la vista filtrada y la no filtrada.
Tasks only - habilite esta opción para mostrar solo los comentarios que están asignados a un usuario.
ASSIGNED TO - de forma predeterminada, todas las opciones están deshabilitadas. En consecuencia, se muestran todas las tareas/comentarios y se ordenan por nombre (la primera entrada de la lista es el usuario actual). Cuando se habilitan las casillas de verificación para uno o varios usuarios, se mostrarán las entradas de los usuarios habilitados.
Use las opciones del menú del botón para configurar la visibilidad y las notificaciones de los comentarios:
Unresolved Only – los comentarios que se han resuelto no se incluyen en la lista.
Current document only – mostrar solo los comentarios que se han colocado en el documento activo actualmente.
Notification settings – haga clic para abrir el cuadro de diálogo Notification Settings y configurar la recepción de alertas por correo electrónico para toda la actividad de comentarios en este diseño (All ), solo para aquellos comentarios en los que se le menciona o asigna (My ), o para no recibir alertas por correo electrónico en absoluto (None ). ► Ejemplo de contenido del correo electrónico .
Export Comments – haga clic para abrir el cuadro de diálogo Comment Export Configuration y configurar la exportación de comentarios a un archivo PDF.
El PDF generado incluirá información sobre los comentarios en el diseño: ID del comentario, autor, fecha y hora de creación, texto del comentario, asignado (para tareas) y estado (para un comentario, si está Resolved; para una tarea, su estado To Do / In Progress / Resolved). Puede elegir exportar todos los comentarios asociados con el diseño, independientemente de cuándo se hayan realizado, o solo los comentarios hechos entre versiones específicas del diseño. También hay algunas opciones para definir qué capturas de pantalla incluir en el documento PDF generado. En conjunto, ambas proporcionan información sobre dónde está un comentario y a qué se aplica (punto, componente, área). Si deja ambas sin marcar, obtendrá solo los comentarios. Una vez configurado, haga clic en Export para generar el PDF, usando el cuadro de diálogo posterior para determinar dónde guardarlo y con qué nombre (de forma predeterminada, el del proyecto).
Entire designs snapshots - incluir una instantánea de cada documento fuente con un comentario dentro del Period tiempo designado. Esto proporciona una confirmación visual de dónde se encuentra el comentario en el documento mediante un marcador de comentario numerado.
Original design screenshots - incluir la Instantánea original tomada cuando se creó un comentario (y que es la instantánea disponible desde la ventana Contextual Commenting cuando se hace clic en un marcador de comentario en el espacio principal de diseño). Esto muestra el punto, área o componente al que se aplica el comentario.
La exportación de comentarios a PDF también puede configurarse y generarse mediante un archivo Output Job como parte de la liberación del proyecto. Agregue un generador de salida Export Comments como parte de la categoría Report Outputs .
Tenga en cuenta que la función de exportación de comentarios solo está disponible para los miembros del Workspace donde reside el proyecto. No está disponible para usuarios con quienes se haya compartido el proyecto fuera del Workspace.
Colocación
Para colocar un comentario en el espacio de diseño de un editor gráfico basado en objetos, como esquemático, PCB 2D o Draftsman, ejecute primero el comando correspondiente. Esto puede hacerse realizando una de las siguientes acciones:
Haga clic en el botón disponible en el panel Comments and Tasks .
Haga clic en cerca de la esquina superior derecha del espacio de diseño.
Haga clic en Place » Comment desde los menús principales.
Usando el atajo de teclado Ctrl+Alt+C .
Haga clic con el botón derecho y luego seleccione Comment en el espacio de diseño.
Según el tipo de documento (ver arriba ), los comentarios pueden asignarse a un objeto, a un punto específico o a un área del documento activo. El comando invoca el modo de colocación de comentarios y el cursor cambia a una cruz con un círculo azul que detecta y resalta objetos para su selección:
Haga clic en un objeto resaltado para adjuntar (anclar) un comentario a ese objeto.
Haga clic en un área no resaltada para adjuntar un comentario a ese punto específico del documento.
Haga clic fuera de un objeto y arrastre el cursor para crear un área rectangular resaltada y adjuntar un comentario al área especificada ( ).
En un documento ActiveBOM, haga clic en una celda del documento ActiveBOM para agregar un comentario a esa fila de la BOM. Haga clic con el botón derecho en una fila y luego seleccione el comando Comment para agregar un comentario a esta fila.
La acción de colocación abre entonces un cuadro de diálogo de entrada de comentarios que ofrece un campo para introducir el texto del comentario y, para documentos gráficos, también una opción adicional para añadir un dibujo a mano alzada al comentario cuando corresponda ( ). Seleccione la opción Assign a task to para asignarse una tarea a sí mismo o a uno de los usuarios mencionados en el comentario (consulte los detalles más abajo). Haga clic en para confirmar la creación del comentario, lo que asociará el comentario con un marcador de anclaje numerado en el documento y también añadirá una entrada de resumen del comentario al panel Comments and Tasks .
Colocación de un comentario sobre un objeto, mención de otro usuario registrado en el comentario, movimiento del indicador de anclaje del comentario y adición de un dibujo a mano alzada al comentario.
Un comentario colocado está disponible de inmediato para todos los usuarios con acceso al proyecto y también estará disponible en la vista del proyecto basada en navegador del Workspace conectado.
La cantidad de caracteres que se puede introducir en un comentario estándar y en una tarea está limitada a 2000.
Menciones y asignaciones de tareas
Junto con el texto en el cuadro de diálogo de entrada de comentarios, se puede añadir una referencia de 'mención' para cualquier otro usuario o rol registrado en el Workspace conectado introduciendo el carácter @ . Seleccione un nombre/correo electrónico de la lista desplegable para agregar la referencia del usuario (miembro del Workspace) al comentario, y también como una entrada Assign a task to ; en esencia, se asignará una task al usuario. Desmarque esta última opción si no desea que el comentario se considere específicamente asignado a ese usuario. También puede añadirse como mención un grupo de roles (por ejemplo, 'Engineers') y, por tanto, sus usuarios integrantes.
Si un usuario mencionado no tiene acceso al proyecto actual, se le invitará a compartirlo con ese usuario. Esta opción está disponible si usted es el propietario del proyecto o un administrador del Workspace. Los derechos de acceso del usuario se conceden mediante el cuadro de diálogo Share dialog ; el usuario recibirá un correo electrónico notificándole del acceso compartido. Si cancela el cuadro de diálogo Share, el proyecto no se compartirá, pero el comentario se colocará como de costumbre.
► Vea más información sobre cómo compartir un diseño .
Cuando se asigna una tarea a un usuario, la imagen/foto de este usuario se mostrará en la parte superior izquierda del cuadro de diálogo del comentario y en el mosaico del comentario en el panel Comments and Tasks . Además, la tarea se nombrará con el nombre del proyecto y el número de secuencia (por ejemplo, Kame_FMU-1) en lugar de un número simple, como se hace con los comentarios normales. Este nombre también se muestra en el cuadro de diálogo del comentario y en el mosaico del comentario. Haga clic en él para abrir la página Tasks del proyecto en la interfaz del navegador del Workspace con la tarea seleccionada enfocada en la lista de tareas.
Se puede hacer referencia a una tarea en una confirmación del proyecto al guardar el proyecto en el Workspace conectado. Como indica la sugerencia en el cuadro de diálogo Save to Server dialog , agregue el ID de la tarea al campo Comment (tal como aparece en el panel Comments and Tasks ); la tarea quedará vinculada a la confirmación del proyecto que se creará después de hacer clic en OK en el cuadro de diálogo.
El enlace a la confirmación se mostrará en el panel de detalles de la tarea cuando se seleccione el mosaico de la tarea en la página Tasks de la interfaz del navegador del Workspace (Altium 365 Workspace , Enterprise Server Workspace ) o en la vista Tasks de la página de administración detallada del proyecto (Altium 365 Workspace , Enterprise Server Workspace ). Haga clic en el enlace para abrir la vista History del proyecto con la confirmación relacionada resaltada en la línea de tiempo.
El enlace a la confirmación conectada se mostrará en el panel de detalles de la tarea. Pase el cursor sobre la imagen para ver la página History que se abre después de hacer clic en el enlace y la confirmación relacionada resaltada en la línea de tiempo.
Posicionamiento
La ubicación de un comentario en el espacio del editor se cambia arrastrando su 'anclaje' asociado a una nueva posición, durante o después de su colocación. Cuando se selecciona, el anclaje del comentario incluye una línea de conexión hacia su objeto o área asociada.
Aunque puede mover (arrastrar) el anclaje de un comentario por el editor de documentos, el punto o área definidos inicialmente no pueden modificarse.
Tenga en cuenta que un comentario también puede posicionarse durante su colocación inicial haciendo clic y arrastrando cuando se está en modo de colocación ( ).
Pegar imágenes
Puede agregar una imagen a un comentario copiando primero la imagen desde una ventana Explorer o una página del navegador haciendo clic con el botón derecho sobre la imagen, lo que la copia al portapapeles. Para adjuntar la imagen, use clic derecho Paste (o el atajo Ctrl+V ) en el propio comentario (en el campo que indica Add others with @ or paste images).
Cada imagen puede tener un tamaño máximo de 2 MB. Después de pegarla en el comentario, haga clic en la imagen para mostrarla completa, como se muestra en la imagen de la derecha.
También puede publicar un comentario si incluye solo una imagen pegada sin ningún texto, como se muestra a continuación.
Dibujo
Al colocar o editar un comentario, seleccione el botón de opción para añadir un dibujo a mano alzada con el cursor de lápiz resultante. Haga clic y arrastre para crear líneas, y luego haga clic con el botón derecho para finalizar y asociar el dibujo con el comentario actualmente seleccionado.
Para acceder al modo Freehand Drawing del panel Properties , pulse la tecla Tab cuando el modo de dibujo a mano alzada esté activo (esto se indica mediante el icono en el espacio de diseño). Estas opciones le permiten deshacer y rehacer comentarios en el desplegable Commands y cambiar el ancho, tamaño y color en el desplegable Properties .
Tareas generales
Las tareas generales (tareas aplicadas al proyecto actual pero que no están asociadas con un comentario o documento del proyecto) se muestran en el panel en un grupo separado bajo la entrada del proyecto. En el panel se muestran el mismo contenido y los mismos atributos para las tareas generales (asignado, prioridad, etc.).
Las tareas generales se muestran en el panel Comments and Tasks .
Haga clic en una entrada de Tarea General en el panel para acceder a sus cuadros de diálogo de comentarios. Use el cuadro de diálogo para publicar comentarios (incluidos aquellos con imágenes pegadas ) para la Tarea General seleccionada.
Se puede crear una tarea general para un proyecto desde la página Tasks de la interfaz del navegador del Workspace al acceder a la página detallada de administración del proyecto. Para obtener más información, consulte Management of a Specific Project ( Altium 365 Workspace , Enterprise Server Workspace ).
Comentarios desvinculados
Cuando se elimina un documento del proyecto, o su UniqueID ha cambiado, los comentarios del documento pueden quedar "desvinculados". Esos comentarios todavía pueden consultarse desde la región desplegable Detached Comments del panel. Haga clic en el mosaico de un comentario desvinculado en el panel Comments and Tasks para mostrar su cuadro de diálogo en el espacio de diseño del documento actualmente abierto.
Trabajar con comentarios
Los comentarios colocados en un documento de diseño se registran tanto en el panel Comments and Tasks (como una secuencia de entradas numeradas) como en el editor de documentos correspondiente (como gráficos de pin numerados). Cada entrada del panel representa un hilo de comentarios y proporciona información resumida, incluido quién colocó el comentario y cuándo, el texto del comentario inicial, cualquier mención/asignación aplicada y la cantidad de respuestas del hilo.
Un hilo de comentarios se abre seleccionando su entrada en el panel Comments and Tasks o haciendo clic en su pin asociado en el espacio de diseño. Esto resalta el comentario en el editor de documentos y abre el cuadro de diálogo de entrada del comentario, que incluye el comentario inicial y cualquier respuesta de los usuarios. Si un comentario seleccionado está asociado con otro documento de diseño, el sistema abrirá (y cargará, si es necesario) ese documento.
Navegación por los comentarios seleccionando marcadores de pin en el espacio de diseño y seleccionando entradas en el panel Comments and Tasks .
Cuadro de diálogo Comentarios
La interacción con un comentario colocado se realiza mediante el cuadro de diálogo emergente de comentarios, que muestra todas las entradas del hilo de comentarios seleccionado e incluye opciones para previsualizar, responder, editar, resolver y eliminar una entrada. El cuadro de diálogo se abre al colocar inicialmente un comentario o cuando se selecciona un comentario colocado en el panel Comments and Tasks o en el espacio de diseño. Presione Esc o haga clic en el espacio de diseño para cerrar el cuadro de diálogo de comentarios.
Recorra secuencialmente todos los comentarios disponibles usando los botones anterior/siguiente
( ) en el encabezado del cuadro de diálogo.
Vista previa
Seleccione la opción Original Snapshot en el comentario inicial para ver una captura gráfica del área del editor cuando se colocó el comentario. Haga clic en el icono en la esquina superior derecha de la captura o en la propia captura para abrir una vista previa a tamaño completo (haga clic en el icono en la esquina superior derecha de esta vista previa o en la propia imagen para cerrarla).
Responder
Introduzca texto y, opcionalmente, una mención a un usuario ('@') en el campo Reply para añadir una nueva entrada al hilo de comentarios. Seleccione la opción Assign a task to para crear una tarea asignada a un usuario especificado en la lista desplegable. Haga clic en para confirmar la entrada.
Editar y eliminar
Un comentario existente puede ser editado por el autor de ese comentario usando la opción Edit disponible en el menú del comentario. Haga clic en el botón para confirmar la edición del comentario.
Use la opción Delete para eliminar el comentario actualmente seleccionado. Tenga en cuenta que se eliminará todo el hilo si se elimina el comentario inicial (en lugar de una Respuesta).
Use la opción Convert to Task para convertir el comentario en una tarea asignada a usted mismo.
Use la opción Copy Link para copiar la URL del hilo de comentarios. Este enlace puede utilizarse para abrir este proyecto en el Web Viewer de la interfaz del navegador del Workspace, con un objeto, punto o área del comentario ampliado y centrado.
Resolver
Haga clic en el botón / para alternar el estado del comentario entre Resolved y Unresolved (el valor predeterminado). Un comentario resuelto (cerrado como completado) está inactivo y no se puede editar, y tanto su entrada en el panel Comments and Tasks como su marcador de pin en el documento aparecen atenuados.
Establecer prioridades y estados de tareas
Si un comentario de tarea ha sido asignado a un usuario, se pueden establecer su prioridad y su estado. Una tarea se establece inicialmente de inmediato con prioridad Medium y estado To Do, pero pueden cambiarse haciendo clic en un control asociado en la parte superior del cuadro de diálogo de comentarios.
Etiqueta de commit, ID de revisión de versión e información de revisión de diseño
Las etiquetas de commit y los ID de revisión de versión se muestran al ver los comentarios/tareas aplicables tanto en el panel Comments and Tasks como en el cuadro de diálogo de comentarios en Altium Designer.
Los comentarios creados en el Web Viewer al ver la instantánea de diseño de un commit etiquetado incluirán el nombre de la etiqueta asociada. Haga clic en el enlace del nombre de la etiqueta para abrir la instantánea del commit relacionado en el Web Viewer.
Los comentarios creados en el Web Viewer al ver una versión específica incluirán el ID de revisión de la versión. Haga clic en el enlace del ID de revisión de la versión para abrir el Manufacturing Portal de esta versión.
Los comentarios creados en el Web Viewer al ver una instantánea de Design Review incluirán la entrada de revisión de diseño. Haga clic en el enlace de la revisión de diseño para abrir la página de la revisión.
Trabajar con tareas de Jira
Si la integración con Jira está habilitada y configurada para su Altium 365 Workspace, entonces un comentario colocado incluirá la opción adicional de crear y vincular una incidencia de Jira en su servicio Atlassian Jira®. Al igual que los comentarios convencionales y sus tareas asociadas, las incidencias de Jira colocadas pueden verse, editarse y comentarse desde dentro de los documentos de diseño, y verse/seleccionarse mediante el panel Comments and Tasks .
Una instancia de tarea de Jira colocada se sincroniza con su incidencia correspondiente en el espacio de Jira. La sincronización bidireccional de datos entre las incidencias de Jira y las tareas del Workspace permite que la gestión de proyectos de diseño se lleve a cabo a través del espacio de Jira junto con Altium 365.
Consulte la página Jira Integration para obtener una descripción general de la funcionalidad.
Consulte la página Exploring the Browser-based Interface para obtener detalles sobre cómo configurar Jira Integration para su Altium 365 Workspace.
Consulte la página Web Viewer para obtener detalles sobre cómo trabajar con tareas de Jira en el Web Viewer de la interfaz del navegador de Altium 365 Workspace.
Crear una incidencia de Jira
Para colocar una tarea de incidencia de Jira para un proyecto de diseño, primero coloque una instancia de comentario de la forma habitual y luego seleccione la opción Jira Issue en el cuadro de diálogo de comentarios. Después, elija un tipo de incidencia y añada un resumen para crear la tarea de incidencia de Jira sincronizada.
❯ ❮
1
Javascript ID: CreateJiraIssue
Coloque una tarea de Jira en el documento actual del proyecto primero colocando una instancia de comentario . El modo alternativo de Jira está disponible en el menú desplegable Comment .
Invoque la colocación de la tarea de Jira seleccionando la opción Jira Issue del menú Comment del cuadro de diálogo.
Haga clic en la opción Create Issue si aún no está seleccionada.
Seleccione el tipo de incidencia que se va a crear en la lista desplegable Issue Type , que incluye las disponibles en su servicio de Jira.
Introduzca un Summary de la incidencia y una descripción/asignado opcionales. La lista desplegable Assignee incluirá solo aquellos usuarios que sean miembros registrados de su cuenta de Jira. Seleccione Post para confirmar.
La incidencia de Jira se coloca en la posición inicial del comentario del documento, se incluye en el panel Comments and Tasks , proporciona un enlace a la incidencia en el espacio de Jira e incluye acceso interactivo a la prioridad de su tarea (Medium, High, etc.) y a la configuración de su estado (To Do, In Progress, etc.).
La cantidad de caracteres que se pueden introducir al publicar/responder a un comentario relacionado con Jira está limitada a 20.000.
Al crear una tarea de Jira a través de Altium Designer, se admiten los siguientes campos:
Texto
Número
Campo URL
Lista desplegable
Lista desplegable con búsqueda (para usuario (asignado), búsqueda de incidencia de Jira y búsqueda de una tarea principal al crear una subtarea)
Campo de selección múltiple (se presentan casillas de verificación con una "advertencia" para seleccionar al menos una opción y continuar – ).
Seleccione el Task ID de la incidencia de Jira del Workspace en el cuadro de diálogo de comentarios o en el panel Comments and Tasks para abrir directamente esa incidencia en el espacio de Jira en una nueva pestaña de su navegador predeterminado. El Task ID del Workspace se asigna al Issue Key en el espacio de Jira, y los parámetros principales de Jira, como Resumen, Descripción, Asignado y Comentarios, se asignan entre ambas instancias. El usuario del Workspace que creó la incidencia de Jira es el Informador de la incidencia en el lado de Jira. Tenga en cuenta que se incluye una imagen de instantánea del documento actual del Workspace como archivo adjunto de Jira si se seleccionó la opción Attach original snapshot al crear la incidencia de Jira del Workspace (consulte más arriba).
Una tarea de Jira colocada en el Workspace creará una incidencia de Jira sincronizada en el espacio de Jira. Ambas quedan vinculadas mediante la asignación del Workspace Task ID con el de Jira Issue Key .
Junto con los parámetros asignados entre el Workspace y las incidencias de Jira, también se sincronizan la Priority relacionada con la tarea y la configuración de estado de Progress . Por ejemplo, mover la tarea de incidencia del Workspace de un estado de prioridad Medium a High se reflejará inmediatamente en la incidencia del lado de Jira, y cambiar el estado de progreso de To Do a In Progress en el lado de Jira cambiará de igual manera el estado de la incidencia de Jira del Workspace. Puede ser necesaria una actualización de datos (ejecutada haciendo clic en el botón en la parte superior del panel Comments and Tasks ) para ver los datos actualizados.
Vincular a una incidencia de Jira
Altium 365 Jira Integration también permite vincular una tarea del Workspace a una incidencia de Jira existente en su servicio Atlassian Jira mediante el modo Jira Issue del cuadro de diálogo de comentarios. Puede vincularse a cualquier incidencia del proyecto de Jira especificado, que luego se sincroniza con la tarea de Jira del Workspace.
❯ ❮
1
Javascript ID: LinkJiraIssue
Coloque una instancia de comentario en el área del documento o en el objeto que desee asociar con una incidencia de Jira existente, y luego seleccione el modo Jira Issue y la opción Link Issue en el cuadro de diálogo de comentarios.
Use la lista desplegable Select or search issues para seleccionar la incidencia de Jira (mostrada como un texto Summary) que se vinculará con la nueva instancia de tarea de Jira colocada. Empiece a escribir en el campo de texto para buscar la incidencia de Jira requerida.
La lista desplegable Jira Issue del cuadro de diálogo mostrará la incidencia seleccionada del espacio de Jira. Si es necesario, marque la opción Attach original snapshot para transferir a Jira una imagen de la vista actual del documento.
Haga clic en el botón Post para establecer el vínculo entre la tarea de Jira del Workspace y la incidencia de Jira seleccionada.
La nueva tarea de incidencia de Jira se muestra en el panel Comments and Tasks y en el cuadro de diálogo de comentarios, que incluirá cualquier comentario existente (o agregado); seleccione la opción Show all Replies del cuadro de diálogo para ver la lista completa.
La incidencia de Jira vinculada ahora está sincronizada con la tarea de Jira del Workspace, lo que incluye la Comments de la incidencia y queda establecida en los estados Progress y Priority definidos por la incidencia de Jira: In Progress y High en este ejemplo. Tenga en cuenta que las entradas de la incidencia de Jira Web links ahora indicarán que una tarea de Jira de Altium 365 Workspace ha sido vinculada (o revinculada) a esta incidencia.
Una incidencia de Jira existente se vincula a una tarea del Workspace especificando su entrada Jira Issue en el modo Link Issue del cuadro de diálogo de comentarios del Workspace.
Panel To-Do
El panel To-Do está disponible cuando la opción UI.PanelToDoList está habilitada en el cuadro de diálogo Advanced Settings dialog .
Aunque su Workspace conectado proporciona un conjunto completo de funciones para comentarios y asignación de tareas descritas anteriormente, también puede acceder al panel To-Do para realizar el seguimiento de sus tareas. El panel To-Do enumera todos los elementos To-Do que están definidos actualmente para el proyecto activo. Un elemento To-Do se utiliza como recordatorio de una tarea que debe realizarse más adelante en relación con un documento.
El panel To-Do
To-Do Panel Content and Use
El panel To-Do puede listar dos tipos de elementos "to-do" para el proyecto activo:
Un elemento To-Do a nivel de proyecto.
Un elemento To-Do a nivel de documento, agregado a un documento basado en texto dentro del proyecto.
Para cada elemento To-Do, se muestra la siguiente información:
Done - esta casilla de verificación le permite marcar el elemento cuando la tarea definida se haya completado.
Action Item - la tarea real que debe realizarse.
Priority - la importancia de la tarea que debe realizarse (Lowest , Low , Normal (predeterminado), High , Highest ).
Document - una referencia al documento fuente al que se ha agregado un elemento To-Do a nivel de documento.
Owner - este podría ser el nombre de la persona que introduce la tarea o de quien realmente debe realizarla.
Category - esta podría ser el área concreta dentro del proyecto a la que corresponde la tarea a realizar (p. ej., esquemáticos, reglas de diseño, enrutado, restricciones, etc.).
Agregar elementos To-Do a nivel de proyecto
Los elementos To-Do a nivel de proyecto se agregan desde el propio panel. Antes de agregar cualquier elemento, asegúrese de que el documento activo en la ventana del editor de diseño sea uno de los documentos de diseño del proyecto para el que desea definir elementos To-Do.
Para agregar un nuevo elemento To-Do, haga clic con el botón derecho dentro del panel y elija la entrada Add Project To-Do Item en el menú contextual que aparece a continuación. Se abrirá el cuadro de diálogo Edit To-Do Item .
Use este cuadro de diálogo para introducir un texto adecuado para la tarea que debe realizarse en el proyecto. Use los campos disponibles en el cuadro de diálogo para definir una task's Priority, Owner, and Category . Después de definir el elemento según sea necesario, haga clic en OK para agregar el nuevo elemento al panel.
Agregar elementos To-Do a nivel de documento
Category Los elementos To-Do a nivel de documento se agregan a un documento fuente basado en texto (p. ej., archivo VHDL, archivo de restricciones, documento de código fuente embebido, etc.). Antes de agregar cualquier elemento, asegúrese de que el documento requerido esté activo en la ventana del editor de diseño y que este documento pertenezca al proyecto cuyos elementos To-Do generales está definiendo actualmente.
Para agregar un nuevo elemento To-Do, coloque el cursor de texto en la posición requerida dentro del documento donde desee colocar un elemento To-Do, haga clic con el botón derecho y elija la entrada Add To-Do Item en el menú emergente que aparece a continuación. Aparecerá el cuadro de diálogo Edit To-Do Item . Use este cuadro de diálogo para introducir un texto adecuado relativo a la tarea que debe realizarse en el documento. Use los campos disponibles en el cuadro de diálogo para definir una Priority , Owner y Category para la tarea (p. ej., pasada de formato, pasada de revisión de código, etc.). Después de definir el elemento To-Do según sea necesario, haga clic en OK para cerrar el cuadro de diálogo y devolver el foco al documento actual. Aparecerá una entrada para el elemento To-Do en el panel To-Do y también en el punto marcado por la posición actual del cursor de texto. La entrada aparecerá como un comentario (entre los delimitadores de comentario definidos para ese tipo de documento), incluyendo el texto real del elemento y un identificador único, como se muestra en la imagen siguiente.
Menú del botón derecho
El menú del botón derecho ofrece los siguientes comandos:
Goto Source - este comando está disponible cuando el elemento seleccionado en el panel es un elemento To-Do a nivel de documento. Use este comando para abrir (si aún no está abierto) el documento fuente asociado al que se hace referencia en el campo Document del elemento y convertirlo en el documento activo en la ventana del editor de diseño. El cursor de texto se colocará al principio del texto del elemento To-Do.
Add Project To-Do Item - agregue un elemento To-Do a nivel de proyecto al panel para el proyecto activo.
Edit - edite el elemento To-Do seleccionado. Aparecerá el cuadro de diálogo Edit To-Do Item , que le permitirá realizar los cambios necesarios.
Delete - elimine el elemento To-Do seleccionado del panel.
Show Completed Items - con esta opción habilitada, solo los elementos To-Do que se hayan marcado como completados (opción Done habilitada) permanecerán visibles en el panel.
Report - genere un informe que contenga todos los elementos To-Do mostrados actualmente en el panel. Después de iniciar el comando, se abrirá el cuadro de diálogo Report Preview , en el que podrá configurar, imprimir y exportar el informe en varios formatos de archivo.
Notas
Si se ha definido un elemento To-Do a nivel de documento en el panel y el documento fuente correspondiente es el documento activo en la ventana del editor de diseño, el texto de toda la entrada To-Do en el panel aparecerá en negrita.
Al hacer doble clic en una entrada de elemento To-Do en el panel, se abrirá el cuadro de diálogo Edit To-Do Item , lo que le permitirá modificar la definición de la tarea.
Las entradas del panel pueden ordenarse por cualquier columna haciendo clic en el encabezado de esa columna. Haga clic una vez para ordenar en orden ascendente; haga clic de nuevo para ordenar en orden descendente.
El filtrado directo le permite saltar rápidamente a una entrada de elemento To-Do escribiendo directamente dentro del panel. Puede filtrar según cualquier columna de datos del panel. Use las teclas Right Arrow y Left Arrow para cambiar entre columnas para el filtrado, o haga clic directamente en un campo dentro de una columna. Para usar esta función de filtrado, haga clic dentro de una columna de datos y escriba la primera letra de la entrada a la que desea saltar. La primera entrada de esa columna que comience con la letra que escriba quedará seleccionada, y la letra se resaltará para mostrar que el filtrado del contenido de la columna se basa en la letra escrita.