Cartera y hoja de ruta
Conector de cartera y hoja de ruta
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - China Cloud operado por 21Vianet |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - China Cloud operado por 21Vianet |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - China Cloud operado por 21Vianet |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
Cartera y hoja de ruta
Referencia
En este artículo
- Acciones
- Definiciones
Conector de cartera y hoja de ruta
Este conector se conocía anteriormente como conector de Project Roadmap. Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: |
| - Gobierno de EE. UU. (GCC) | ||
| - China Cloud operado por 21Vianet | ||
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: |
| - Gobierno de EE. UU. (GCC) | ||
| - China Cloud operado por 21Vianet |
Metadatos del conector
| Publicador | Microsoft |
Acciones
Obtener PortfolioLink
Esta operación se usa para recuperar portfolioLink asociado a una cartera en una hoja de ruta. Este objeto contiene información sobre el proyecto externo al que está vinculada esta cartera.
Obtener RoadmapItemLinks para una cartera
Esta operación se usa para recuperar todos los RoadmapItemLinks asociados a una cartera en una hoja de ruta. RoadmapItemLinks contiene información sobre las tareas externas que se importan en esta cartera.
Actualizar PortfolioLink
Esta operación se usa para actualizar portfolioLink asociado a una cartera en una hoja de ruta.
Actualizar RoadmapItemLink
Esta operación se usa para actualizar un RoadmapItemLink.
Obtener PortfolioLink
Identificador de la operación: GetPortfolioLink
Esta operación se usa para recuperar portfolioLink asociado a una cartera en una hoja de ruta. Este objeto contiene información sobre el proyecto externo al que está vinculada esta cartera.
Parámetros
| Nombre | Key | Obligatorio | Tipo | Description |
|---|---|---|---|---|
| Nombre de la organización | organización | Cierto | cuerda / cadena | Nombre de la organización de Dynamics 365, como Contoso |
| Id. de cartera | portfolioid | Cierto | guid | Identificador de la cartera conectada a un proyecto externo |
Devoluciones
Objeto que describe la información de vinculación de proyectos externos para una cartera
Body
PortfolioLink
Obtener RoadmapItemLinks para una cartera
Identificador de la operación: GetRoadmapItemLinksForPortfolio
Esta operación se usa para recuperar todos los RoadmapItemLinks asociados a una cartera en una hoja de ruta. RoadmapItemLinks contiene información sobre las tareas externas que se importan en esta cartera.
Parámetros
| Nombre | Key | Obligatorio | Tipo | Description |
|---|---|---|---|---|
| Nombre de la organización | organización | Cierto | cuerda / cadena | Nombre de la organización de Dynamics 365, como Contoso |
| Id. de cartera | portfolioid | Cierto | guid | Identificador de la cartera conectada a un proyecto externo |
Devoluciones
Lista de RoadmapItemLinks
Body
RoadmapItemLinks
Actualizar PortfolioLink
Identificador de la operación: UpdatePortfolioLink
Esta operación se usa para actualizar portfolioLink asociado a una cartera en una hoja de ruta.
Parámetros
| Nombre | Key | Obligatorio | Tipo | Description |
|---|---|---|---|---|
| Nombre de la organización | organización | Cierto | cuerda / cadena | Nombre de la organización de Dynamics 365, como Contoso |
| Id. de cartera | portfolioid | Cierto | guid | Identificador de la cartera conectada a un proyecto externo |
| id | id | cuerda / cadena | Identificador de PortfolioLink | |
| portfolioItemId | portfolioItemId | guid | Identificador del elemento de cartera asociado a este vínculo | |
| externalProjectId | externalProjectId | cuerda / cadena | Identificador del proyecto en la herramienta externa | |
| externalProjectName | externalProjectName | cuerda / cadena | Nombre del proyecto en la herramienta externa | |
| externalUrl | externalUrl | cuerda / cadena | Dirección URL del proyecto en la herramienta externa | |
| refreshErrorCode | refreshErrorCode | entero | Código de error para errores de actualización que se producen durante la actualización programada | |
| refreshError | refreshError | cuerda / cadena | Descripción del error que se produce durante la actualización programada | |
| refreshStartDate | refreshStartDate | date-time | Hora de inicio de actualización más reciente | |
| refreshEndDate | refreshEndDate | date-time | Hora de finalización de la actualización más reciente | |
| refreshStatus | refreshStatus | entero | Estado de la última operación de actualización |
Devoluciones
Objeto que describe la información de vinculación de proyectos externos para una cartera
Body
PortfolioLink
Actualizar RoadmapItemLink
Identificador de la operación: UpdateRoadmapItemLink
Esta operación se usa para actualizar un RoadmapItemLink.
Parámetros
| Nombre | Key | Obligatorio | Tipo | Description |
|---|---|---|---|---|
| Nombre de la organización | organización | Cierto | cuerda / cadena | Nombre de la organización de Dynamics 365, como Contoso |
| Id. de cartera | portfolioid | Cierto | guid | Identificador de la cartera conectada a un proyecto externo |
| RoadmapItem Id | roadmapitemid | Cierto | guid | Identificador del elemento primario RoadmapItem del vínculo del elemento de hoja de ruta que se va a actualizar |
| id | id | cuerda / cadena | Identificador de RoadmapItemLink | |
| roadmapItemId | roadmapItemId | cuerda / cadena | Identificador del elemento primario de la hoja de ruta con el que está asociado este vínculo | |
| externalProjectId | externalProjectId | cuerda / cadena | Identificador del proyecto en la herramienta externa que está vinculada con la cartera primaria de este vínculo | |
| externalTaskId | externalTaskId | cuerda / cadena | Identificador de la tarea en la herramienta externa asociada a este vínculo | |
| externalName | externalName | cuerda / cadena | Nombre de la tarea en la herramienta externa | |
| externalUrl | externalUrl | cuerda / cadena | Dirección URL de la tarea en la herramienta externa | |
| externalStartDate | externalStartDate | date-time | Fecha de inicio de la tarea en la herramienta externa | |
| externalDueDate | externalDueDate | date-time | Fecha de vencimiento de la tarea en la herramienta externa | |
| refreshErrorCode | refreshErrorCode | entero | Código de error para errores de actualización que se producen durante la actualización programada | |
| refreshError | refreshError | cuerda / cadena | Descripción del error que se produce durante la actualización programada |
Devoluciones
Objeto que describe la vinculación de tareas externas para un único elemento de una cartera.
Body
RoadmapItemLink
Definiciones
PortfolioLink
Objeto que describe la información de vinculación de proyectos externos para una cartera
| Nombre | Ruta | Tipo | Description |
|---|---|---|---|
| id | id | cuerda / cadena | Identificador de PortfolioLink |
| portfolioItemId | portfolioItemId | guid | Identificador del elemento de cartera asociado a este vínculo |
| externalProjectId | externalProjectId | cuerda / cadena | Identificador del proyecto en la herramienta externa |
| externalProjectName | externalProjectName | cuerda / cadena | Nombre del proyecto en la herramienta externa |
| externalUrl | externalUrl | cuerda / cadena | Dirección URL del proyecto en la herramienta externa |
| refreshErrorCode | refreshErrorCode | entero | Código de error para errores de actualización que se producen durante la actualización programada |
| refreshError | refreshError | cuerda / cadena | Descripción del error que se produce durante la actualización programada |
| refreshStartDate | refreshStartDate | date-time | Hora de inicio de actualización más reciente |
| refreshEndDate | refreshEndDate | date-time | Hora de finalización de la actualización más reciente |
| refreshStatus | refreshStatus | entero | Estado de la última operación de actualización |
RoadmapItemLink
Objeto que describe la vinculación de tareas externas para un único elemento de una cartera.
| Nombre | Ruta | Tipo | Description |
|---|---|---|---|
| id | id | cuerda / cadena | Identificador de RoadmapItemLink |
| roadmapItemId | roadmapItemId | cuerda / cadena | Identificador del elemento primario de la hoja de ruta con el que está asociado este vínculo |
| externalProjectId | externalProjectId | cuerda / cadena | Identificador del proyecto en la herramienta externa que está vinculada con la cartera primaria de este vínculo |
| externalTaskId | externalTaskId | cuerda / cadena | Identificador de la tarea en la herramienta externa asociada a este vínculo |
| externalName | externalName | cuerda / cadena | Nombre de la tarea en la herramienta externa |
| externalUrl | externalUrl | cuerda / cadena | Dirección URL de la tarea en la herramienta externa |
| externalStartDate | externalStartDate | date-time | Fecha de inicio de la tarea en la herramienta externa |
| externalDueDate | externalDueDate | date-time | Fecha de vencimiento de la tarea en la herramienta externa |
| refreshErrorCode | refreshErrorCode | entero | Código de error para errores de actualización que se producen durante la actualización programada |
| refreshError | refreshError | cuerda / cadena | Descripción del error que se produce durante la actualización programada |
RoadmapItemLinks
Lista de RoadmapItemLinks
| Nombre | Ruta | Tipo | Description |
|---|---|---|---|
| value | value | matriz de RoadmapItemLink | Matriz de RoadmapItemLinks |
Acciones
|
Actualizar Portfolio |
Esta operación se usa para actualizar portfolioLink asociado a una cartera en una hoja de ruta. |
|
Actualizar Roadmap |
Esta operación se usa para actualizar un RoadmapItemLink. |
|
Obtener Portfolio |
Esta operación se usa para recuperar portfolioLink asociado a una cartera en una hoja de ruta. Este objeto contiene información sobre el proyecto externo al que está vinculada esta cartera. |
|
Obtener Roadmap |
Esta operación se usa para recuperar todos los RoadmapItemLinks asociados a una cartera en una hoja de ruta. RoadmapItemLinks contiene información sobre las tareas externas que se importan en esta cartera. |
Actualizar PortfolioLink
Esta operación se usa para actualizar portfolioLink asociado a una cartera en una hoja de ruta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de la organización
|
organization | True | string |
Nombre de la organización de Dynamics 365, como Contoso |
|
Id. de cartera
|
portfolioid | True | guid |
Identificador de la cartera conectada a un proyecto externo |
|
id
|
id | string |
Identificador de PortfolioLink |
|
|
portfolioItemId
|
portfolioItemId | guid |
Identificador del elemento de cartera asociado a este vínculo |
|
|
externalProjectId
|
externalProjectId | string |
Identificador del proyecto en la herramienta externa |
|
|
externalProjectName
|
externalProjectName | string |
Nombre del proyecto en la herramienta externa |
|
|
externalUrl
|
externalUrl | string |
Dirección URL del proyecto en la herramienta externa |
|
|
refreshErrorCode
|
refreshErrorCode | integer |
Código de error para errores de actualización que se producen durante la actualización programada |
|
|
refreshError
|
refreshError | string |
Descripción del error que se produce durante la actualización programada |
|
|
refreshStartDate
|
refreshStartDate | date-time |
Hora de inicio de actualización más reciente |
|
|
refreshEndDate
|
refreshEndDate | date-time |
Hora de finalización de la actualización más reciente |
|
|
refreshStatus
|
refreshStatus | integer |
Estado de la última operación de actualización |
Devoluciones
Objeto que describe la información de vinculación de proyectos externos para una cartera
- Body
- PortfolioLink
Actualizar RoadmapItemLink
Esta operación se usa para actualizar un RoadmapItemLink.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de la organización
|
organization | True | string |
Nombre de la organización de Dynamics 365, como Contoso |
|
Id. de cartera
|
portfolioid | True | guid |
Identificador de la cartera conectada a un proyecto externo |
|
RoadmapItem Id
|
roadmapitemid | True | guid |
Identificador del elemento primario RoadmapItem del vínculo del elemento de hoja de ruta que se va a actualizar |
|
id
|
id | string |
Identificador de RoadmapItemLink |
|
|
roadmapItemId
|
roadmapItemId | string |
Identificador del elemento primario de la hoja de ruta con el que está asociado este vínculo |
|
|
externalProjectId
|
externalProjectId | string |
Identificador del proyecto en la herramienta externa que está vinculada con la cartera primaria de este vínculo |
|
|
externalTaskId
|
externalTaskId | string |
Identificador de la tarea en la herramienta externa asociada a este vínculo |
|
|
externalName
|
externalName | string |
Nombre de la tarea en la herramienta externa |
|
|
externalUrl
|
externalUrl | string |
Dirección URL de la tarea en la herramienta externa |
|
|
externalStartDate
|
externalStartDate | date-time |
Fecha de inicio de la tarea en la herramienta externa |
|
|
externalDueDate
|
externalDueDate | date-time |
Fecha de vencimiento de la tarea en la herramienta externa |
|
|
refreshErrorCode
|
refreshErrorCode | integer |
Código de error para errores de actualización que se producen durante la actualización programada |
|
|
refreshError
|
refreshError | string |
Descripción del error que se produce durante la actualización programada |
Devoluciones
Objeto que describe la vinculación de tareas externas para un único elemento de una cartera.
- Body
- RoadmapItemLink
Obtener PortfolioLink
Esta operación se usa para recuperar portfolioLink asociado a una cartera en una hoja de ruta. Este objeto contiene información sobre el proyecto externo al que está vinculada esta cartera.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de la organización
|
organization | True | string |
Nombre de la organización de Dynamics 365, como Contoso |
|
Id. de cartera
|
portfolioid | True | guid |
Identificador de la cartera conectada a un proyecto externo |
Devoluciones
Objeto que describe la información de vinculación de proyectos externos para una cartera
- Body
- PortfolioLink
Obtener RoadmapItemLinks para una cartera
Esta operación se usa para recuperar todos los RoadmapItemLinks asociados a una cartera en una hoja de ruta. RoadmapItemLinks contiene información sobre las tareas externas que se importan en esta cartera.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de la organización
|
organization | True | string |
Nombre de la organización de Dynamics 365, como Contoso |
|
Id. de cartera
|
portfolioid | True | guid |
Identificador de la cartera conectada a un proyecto externo |
Devoluciones
Lista de RoadmapItemLinks
- Body
- RoadmapItemLinks
Definiciones
PortfolioLink
Objeto que describe la información de vinculación de proyectos externos para una cartera
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Identificador de PortfolioLink |
|
portfolioItemId
|
portfolioItemId | guid |
Identificador del elemento de cartera asociado a este vínculo |
|
externalProjectId
|
externalProjectId | string |
Identificador del proyecto en la herramienta externa |
|
externalProjectName
|
externalProjectName | string |
Nombre del proyecto en la herramienta externa |
|
externalUrl
|
externalUrl | string |
Dirección URL del proyecto en la herramienta externa |
|
refreshErrorCode
|
refreshErrorCode | integer |
Código de error para errores de actualización que se producen durante la actualización programada |
|
refreshError
|
refreshError | string |
Descripción del error que se produce durante la actualización programada |
|
refreshStartDate
|
refreshStartDate | date-time |
Hora de inicio de actualización más reciente |
|
refreshEndDate
|
refreshEndDate | date-time |
Hora de finalización de la actualización más reciente |
|
refreshStatus
|
refreshStatus | integer |
Estado de la última operación de actualización |
RoadmapItemLink
Objeto que describe la vinculación de tareas externas para un único elemento de una cartera.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Identificador de RoadmapItemLink |
|
roadmapItemId
|
roadmapItemId | string |
Identificador del elemento primario de la hoja de ruta con el que está asociado este vínculo |
|
externalProjectId
|
externalProjectId | string |
Identificador del proyecto en la herramienta externa que está vinculada con la cartera primaria de este vínculo |
|
externalTaskId
|
externalTaskId | string |
Identificador de la tarea en la herramienta externa asociada a este vínculo |
|
externalName
|
externalName | string |
Nombre de la tarea en la herramienta externa |
|
externalUrl
|
externalUrl | string |
Dirección URL de la tarea en la herramienta externa |
|
externalStartDate
|
externalStartDate | date-time |
Fecha de inicio de la tarea en la herramienta externa |
|
externalDueDate
|
externalDueDate | date-time |
Fecha de vencimiento de la tarea en la herramienta externa |
|
refreshErrorCode
|
refreshErrorCode | integer |
Código de error para errores de actualización que se producen durante la actualización programada |
|
refreshError
|
refreshError | string |
Descripción del error que se produce durante la actualización programada |
RoadmapItemLinks
Lista de RoadmapItemLinks
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of RoadmapItemLink |
Matriz de RoadmapItemLinks |