Operación | Descripción |
---|---|
Read Dashboard Data |
Obtiene valores de datos globales de todos los proyectos incluidos en los informes del panel y todas las ideas de flujo de trabajo. |
Create File |
Crea una nueva idea de proyecto o un proyecto que no es de flujo de trabajo.
NotaRecomendado sobre |
Create Idea |
Crea una nueva idea de proyecto.
NotaPara ampliar la funcionalidad, utilice |
Get Job Status |
Obtiene la información de estado de un trabajo en segundo plano especificado. |
La Read Dashboard Data
operación recupera los datos globales del proyecto para todos los proyectos incluidos en los informes del panel y todas las ideas de flujo de trabajo. Este punto de conexión usa el OData estándar para consultar datos.
$filter
$apply
$orderby
$select
$expand
$count
$skip
$top
Read Dashboard Data
solicitud puede interpretarse de la siguiente manera. Reemplácelo subscription-id con el ID de su suscripción.
Método | URL de solicitud |
---|---|
GET |
https://engage.minitab.com/api/v1/subscription-id/export/odata |
Header | Descripción |
---|---|
Authorization |
Obligatorio. Proporcione un token de API a través del Bearer esquema de autorización. |
Request: GET https://engage.minitab.com/api/v1/4906fcd496d94f738304dfcde754000a/export/odata HTTP/1.1 Headers: Authorization: Bearer token
La respuesta incluye un HTTP código de estado, un conjunto de encabezados de respuesta y un cuerpo.
Header | Descripción |
---|---|
Content-Type |
Indica el tipo de medio del cuerpo de la respuesta. |
{ "value": [ { "ProjectId": "12345", "ProjectName": "Project A", "Status": "Active", "StartDate": "2025-01-01", "EndDate": "2025-12-31" }, { "ProjectId": "67890", "ProjectName": "Project B", "Status": "Completed", "StartDate": "2024-01-01", "EndDate": "2024-12-31" } ] }
Response Status: HTTP/1.1 200 OK Response headers: Content-Type: application/json Response Body: { "value": [ { "ProjectId": "12345", "ProjectName": "Project A", "Status": "Active", "StartDate": "2025-01-01", "EndDate": "2025-12-31" }, { "ProjectId": "67890", "ProjectName": "Project B", "Status": "Completed", "StartDate": "2024-01-01", "EndDate": "2024-12-31" } ] }
La operación Create File
inicia un trabajo para crear una nueva idea de proyecto o un proyecto que no sea de flujo de trabajo en la suscripción.
Create File
como se muestra aquí. Reemplace subscription-id por el identificador de su suscripción.
Método | URL de solicitud |
---|---|
POST |
https://engage.minitab.com/api/v2/subscription-id/Item |
Header | Descripción |
---|---|
Authorization |
Obligatorio. Proporcione un token de API a través del esquema de autorización del Bearer . Se requiere que el token tenga el Create Idea permiso. |
Content-Type |
Obligatorio. Debe ser application/json . |
FileName
, ProjectTemplateName
y
CreateFileType
.{ "NombreDeArchivo": "nombre de la idea" "ProjectTemplateName":"nombre de la plantilla de proyecto que se utilizará para el proyecto", #Only necesario para proyectos que no son de flujo de trabajo. El nombre debe coincidir con una plantilla de proyecto de la suscripción. "CreateFileType": 0, #(0 idea, 1 proyecto sin flujo de trabajo) }
Puede
incluir cualquiera de las siguientes opciones. OwnerEmail
: La dirección de correo electrónico
del usuario que será el propietario de este nuevo archivo.IncludeInDashboard
: Un valor verdadero o falso
para invalidar el valor predeterminado en la configuración de la
suscripción.Data
: Objeto para establecer los valores de los
campos de datos en el archivo. Data
constan de
nombres de código de categoría de un solo valor asignados a
objetos de nombres de código y valores de campo.TableData
: Objeto para establecer los valores
de los datos de la tabla en el archivo.
TableData
consta de nombres de código de
categoría de tabla de datos asignados a objetos de nombres de
código de campo y conjuntos de valores. null
para obtener un valor en
blanco.[teammember / name]
. Cuando los
campos obligatorios están vacíos, no se crea un
proyecto.NotificationRecipients
: Direcciones de correo
electrónico para recibir un mensaje cuando la operación
Create File
se realiza correctamente o se
produce un error.{ "NombreDeArchivo": "nombre de la idea", "ProjectTemplateName":"Simplemente hazlo", "CreateFileType":1, "OwnerEmail":"user@company.com", "IncludeInDashboard":false, "NotificationRecipients": ["fmae@mortgage.gov", "user@domain.com"], "Datos": { "Resumen del proyecto": { "belt_level": "Cinturón Verde", "critical_to": "Texto largo\r\ncon\r\nnewlines" }, "annualized_financial": { "annualized_actual_hard_savings": 100 } } "TableData":{ "miembro del equipo":{ "nombre":["John Q. Public","Fannie Mae","Freddie Mac"], "role":["Líder del proyecto",null,"Agente hipotecario"], "email":[null,"fmae@mortgage.gov"] }, "tarea":{ "asunto":["refinanciamiento","originación"] "fecha de inicio":["2025-04-24"] } } } }
Para ver la lista de campos de datos válidos y nombres de categorías disponibles para compartir, los arquitectos de datos pueden descargar un archivo CSV desde la Configuración pestaña del archivo Engage web app.
Para establecer el nombre de un miembro del
equipo en un rol de equipo (Patrocinador
,
Campeón
, Analista financiero
,
etc.), conecte el campo Miembro del equipo/Rol
con
el campo Rol
. En el ejemplo anterior, el
Team Role / Project Leader
se establecerá en
"John Q. Public".
La operación
Create File
no admite la configuración de
valores de datos para todos los campos. Si se intenta proporcionar
datos para fórmulas, texto enriquecido o campos internos, se
producirá un error.
Request: POST https://engage.minitab.com/api/v2/4906fcd496d94f738304dfcde754000a/Item HTTP/1.1 Headers: Authorization: Bearer token Content-Type: application/json Content-Length: 785 Body: { "FileName": "file name", "ProjectTemplateName":"DMAIC Project", "CreateFileType": 1, "OwnerEmail":"user@yourcompany.com", "IncludeInDaashboard":true, "Data": { "_category1": { "_text_field": "text value", "_date_field": "2025-03-20", "_number_field": 3.1415 }, "_category2": { "_text_field": "text value", "_date_field": "2025-03-20", "_number_field": 3.1415 } }, "TableData": { "_tableCategory1": { "_text_field": ["text value","text_value2","text_value"], "_date_field": ["2025-03-20","2025-04-21","2024-03-20"], "_number_field": [3.1415,2.73,1.414] }, "_tableCategory2": { "_text_field": ["text value",null,"text_3"], "_date_field": ["2025-03-20","2025-08-23"], "_number_field": [3.1415,null] } } }
La respuesta incluye un HTTP código de estado, un conjunto de encabezados de respuesta y un cuerpo.
Header | Descripción |
---|---|
Location |
Una dirección URL que se puede utilizar para recuperar el estado del trabajo. |
Create File
operación contiene el identificador del trabajo que creará el proyecto o la idea. El JSON formato se muestra a continuación: { "JobId": "479f6bea-360f-40ba-be0a-bd06c032c4fb" }
Create Idea
operación inicia un trabajo para crear una idea de proyecto en la suscripción.
Al crear una nueva idea de proyecto, puede usar Create Idea
, pero se recomienda Create File
.
Create Idea
como se muestra aquí. Reemplácelo subscription-id con el ID de su suscripción.
Método | URL de solicitud |
---|---|
POST |
https://engage.minitab.com/api/v1/subscription-id/Item |
Header | Descripción |
---|---|
Authorization |
Obligatorio. Proporcione un token de API a través del Bearer esquema de autorización. Se requiere que el token tenga el Create Idea permiso. |
Content-Type |
Obligatorio. Debe ser application/json . |
FileName
.{ "FileName": "name of idea" }
Opcionalmente,
puede incluir un Data
objeto para
establecer los valores de los campos de datos en la idea. Los datos
constan de nombres de código de categoría de un solo valor asignados a
objetos de nombres de código y valores de campo. { "FileName": "name of idea", "Data": { "projectsummary": { "belt_level": "Green Belt", "critical_to": "Long text\r\nwith\r\nnewlines" }, "annualized_financial": { "annualized_actual_hard_savings": 100 } } }
Para ver la lista de campos de datos válidos y nombres de categorías disponibles para compartir, los arquitectos de datos pueden descargar un archivo CSV desde la Configuración pestaña del archivo Engage web app.
Solo se pueden especificar en la solicitud
de Create Idea
operación los campos
de datos que se comparten con los controles del formulario de idea.
Además, no se admite la especificación de campos de texto
enriquecido, fórmula, solo lectura o tabla de datos. Si se intenta
proporcionar datos para los campos no compartidos con los controles
de los campos de formulario de idea o texto enriquecido, fórmula,
solo lectura o tabla de datos, se producirá un error.
Request: POST https://engage.minitab.com/api/v1/4906fcd496d94f738304dfcde754000a/Item HTTP/1.1 Headers: Authorization: Bearer token Content-Type: application/json Content-Length: 287 Body: { "FileName": "idea name", "Data": { "_category1": { "_text_field": "text value", "_date_field": "2025-03-20", "_number_field": 3.1415 }, "_category2": { "_text_field": "text value", "_date_field": "2025-03-20", "_number_field": 3.1415 } } }
La respuesta incluye un HTTP código de estado, un conjunto de encabezados de respuesta y un cuerpo.
Header | Descripción |
---|---|
Location |
Una dirección URL que se puede utilizar para recuperar el estado del trabajo. |
Create Idea
operación contiene el identificador del trabajo que creará la idea de proyecto. El JSON formato se muestra a continuación: { "JobId": "479f6bea-360f-40ba-be0a-bd06c032c4fb" }
Response Status: HTTP/1.1 202 ACCEPTED Response headers: Location: /api/v1/4906fcd496d94f738304dfcde754000a/job/479f6bea-360f-40ba-be0a-bd06c032c4fb Content-Type: application/json Response Body: { "JobId": "479f6bea-360f-40ba-be0a-bd06c032c4fb" }
La Get Job Status
operación recupera el estado del trabajo especificado.
Obtener estado del trabajo
se puede construir de la siguiente manera. Reemplácelo subscription-id por el identificador de su suscripción y job-id por un identificador de trabajo válido.
Método | URL de solicitud |
---|---|
GET |
https://engage.minitab.com/api/v1/subscription-id/job/job-id |
Header | Descripción |
---|---|
Authorization |
Obligatorio. Proporcione un token de API a través del Bearer esquema de autorización. |
Request: GET https://engage.minitab.com/api/v1/4906fcd496d94f738304dfcde754000a/job/479f6bea-360f-40ba-be0a-bd06c032c4fb HTTP/1.1 Headers: Authorization: Bearer token
La respuesta incluye un código de HTTP estado y un cuerpo.
Get Job Status
operación contiene una Status
propiedad entera que representa los distintos estados posibles de un trabajo, como se muestra en el ejemplo siguiente.{ "Status": 1 }
Estado del trabajo | Descripción |
---|---|
0 | El trabajo aún no ha comenzado |
1 | El trabajo ha comenzado; en curso |
2 | El trabajo se ha completado |
3 | El trabajo ha fallado |
4 | No se pudo encontrar el trabajo |
5 | El trabajo se ha cancelado |
Response Status: HTTP/1.1 200 OK Response headers: Content-Type: application/json Response Body: { "Status": 2 }