Importar actividades en Maintain

Maintain admite tres métodos para importar actividades:

Carga de CSV: Importar actividades utilizando la interfaz de usuario (solo modo APM).
Cognite Toolkit: Ingiera actividades utilizando el modelado de datos Cognite Toolkit (modos APM e IDM/CDM).
Transformaciones: Convierta datos de tablas RAW u otras fuentes utilizando CDF Transformaciones (modos APM e IDM/CDM).

Importar a través de subida de CSV (modo APM)

Disponibilidad del modo: Solo modo APM. El modo IDM/CDM no admite la importación de CSV en la interfaz de usuario.

Las actividades importadas mediante CSV se pueden visualizar y modificar como actividades creadas en Maintain.

Descargue la plantilla del archivo CSV

El archivo CSV importado debe ajustarse a la plantilla específica de su proyecto. Para descargar maintain-import-template.csv:

Navegue a Actividades y seleccione Añadir actividad.
Seleccione Importar actividades.
Seleccione Descargar plantilla.

Complete la plantilla del archivo CSV

La plantilla CSV solo contendrá una única fila de valores que representan los posibles valores que puede proporcionar para una actividad importada. Esta fila se llama la fila de encabezado y no debe ser eliminada al completar la plantilla.

Aunque la fila de encabezado no debe eliminarse, puede eliminar valores específicos del encabezado o cambiar el orden de los valores. Por ejemplo, si un campo determinado no es relevante para importar en un escenario específico, puedes eliminarlo del encabezado y de las filas subsiguientes. Esto resultará en que el campo quede en blanco en todas las actividades importadas.

Para importar una sola actividad, añade una nueva fila a la plantilla e ingresa los valores apropiados separados por comas. Cada valor en la nueva fila debe contener el valor que deseas completar en la respectiva fila de encabezado que fue proporcionada en la plantilla. Por ejemplo, si su plantilla contiene la siguiente fila de encabezado: title,status,department, cree un archivo CSV con una fila adicional:

title,status,department
Erect scaffolding,Done,Rigging

Crearás una actividad con el título “Montar andamios”, estado “Hecho” y departamento “Montaje” al importarla.

Formatear campos de fecha

Algunos campos de actividad en Maintain representan fechas y deben tener un formato específico para importarse correctamente. Los campos de fecha se pueden identificar en la plantilla CSV mediante un valor de encabezado especial con el formato startTime (DD/MM/YYYY). En este ejemplo, startTime es el nombre del campo, mientras que DD/MM/YYYY es el formato de fecha que debe utilizarse en las filas siguientes del archivo CSV. Por ejemplo, importar el siguiente archivo dará como resultado que la actividad se cree con startTime establecido en el 10 de diciembre de 2023.

title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023

Formatear campos booleanos

Algunos campos de actividad en Maintain representan valores booleanos, como true o false. Los campos booleanos se pueden identificar en la plantilla CSV mediante un valor de encabezado especial con el formato isActive (true/false). Estos campos solo tienen dos valores válidos, true o false. Por ejemplo, importar el siguiente archivo resultará en que la actividad se cree con isActive establecido en false.

title,isActive (true/false)
Erect scaffolding,false

Formatear valores que contengan comas

Debido a que el formato CSV separa los valores mediante comas, tenga cuidado cuando un campo de actividad también deba contener una coma. Maintain procesa archivos CSV de acuerdo con el estándar RFC 4180, el cual requiere que los valores que contienen comas se encierren entre comillas dobles. Por ejemplo, importar el siguiente archivo resultará en que la actividad se cree con city establecido en Boston, MA.

title,city
Erect scaffolding,"Boston, MA"

Valores no establecidos

Puede dejar el campo en blanco en los campos de actividad no requeridos para representar valores faltantes o irrelevantes para la actividad específica. Por ejemplo, importar el siguiente archivo resultará en que la actividad se cree con state establecido en New York, pero no tendrá ningún valor en el campo city.

title,city,state
Erect scaffolding,New York

Conectar una actividad a un activo

Maintain admite vincular actividades a activos CDF, lo cual se utiliza para contextualizar la actividad en modelos 3D, documentos, PSN y más. Para que Maintain cree el vínculo apropiado a un activo en CDF, debe proporcionar el ID externo del activo CDF en la plantilla de importación. Si tiene contextualización de activos en su proyecto, habrá un campo assetExternalId especial en la plantilla que debe completar con el ID externo del activo de la actividad. Por ejemplo, al importar el siguiente archivo y suponiendo que existe un activo CDF con ID externo NY_BUILDING_23, la actividad se contextualizará a este activo cuando se ingiera en Maintain.

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

Si el ID externo proporcionado no se exporta, el usuario verá un error durante la importación.

Los usuarios finales pueden no conocer el ID externo del activo al que está vinculada la actividad. Si es necesario proporcionar a los usuarios finales una lista de los posibles activos y sus IDs externos, recomendamos recuperar estos datos utilizando la API de activos de CDF u otros extractores de datos.

Importe un archivo CSV completado

Una vez que tenga una plantilla CSV completada, puede importarla a Maintain:

Navegue a Actividades > Añadir actividad.
Seleccione Importar actividades.
Seleccione el campo Haga clic para seleccionar el archivo CSV a importar.
Selecciona y sube el archivo CSV poblado desde tu computadora.
Verifique que importó el archivo comprobando la sección Inspector de archivos. Un mensaje verde debería mostrar el número de filas a importar y si tienes advertencias o errores.
Si no hay errores, seleccione Importar para iniciar el proceso de importación.
Cuando la importación tenga éxito, verá un mensaje de éxito verde con el botón Mostrar actividades.
Opcional. Seleccione Mostrar actividades para navegar a las actividades importadas y comprobar que se ven correctamente según el archivo CSV.

Importar mediante Cognite Toolkit

Disponibilidad del modo: Modos APM e IDM/CDM. Este es el enfoque recomendado para la ingestión programática de actividades.

Utilice Cognite Toolkit para ingerir actividades a través de las capacidades de modelado de datos de CDF. Este método funciona para ambos modos de implementación y proporciona control de versiones y implementaciones reproducibles.

Requisitos previos

Antes de importar actividades mediante Cognite Toolkit, asegúrese de tener:

Una vista de actividad personalizada configurada en su espacio de modelo de datos (o utilice la vista CogniteMaintenanceOrder estándar de cdf_idm)
La vista de actividad asignada en su configuración de Maintain bajo viewMappings
Acceso a Cognite Toolkit

Configura el mapeo de la vista de actividad

En su configuración de Maintain, verifique que la sección viewMappings apunte a su vista de actividad:

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "cdf_idm",
    "version": "v1",
    "externalId": "CogniteMaintenanceOrder"
  }
}

Si ha creado una vista de actividad personalizada (por ejemplo, APM_Activity o ExtendedActivity), actualice la asignación para que apunte a su vista personalizada:

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "maintain_schema_extention",
    "version": "v1",
    "externalId": "APM_Activity"
  }
}

Obtenga más información sobre cómo ampliar modelos de datos y cómo configurar asignaciones de vista.

Ingeste actividades con Cognite Toolkit

Utilice Cognite Toolkit como el enfoque recomendado para ingerir actividades en modo IDM.

Cree la estructura de datos de la actividad

Si aún no lo has hecho, crea archivos YAML de Contenedor, Vista y Nodo para tus actividades. Sigue la estructura estándar de modelado de datos:

APM_Activity.Container.yaml - Define el esquema del contenedor
APM_Activity.View.yaml - Define las propiedades y relaciones de la vista
apmActivities.Node.yaml - Contiene sus instancias de actividad Consulte la documentación de Cognite Toolkit para obtener ejemplos y plantillas detallados.

Configure los mapeos de campos

Asegúrese de que sus nodos de actividad incluyan los campos obligatorios para Maintain:

Campo	Descripción	Obligatorio
`externalId`	Identificador único para la actividad	Sí
`title`	Título de la actividad	Sí
`status`	Estado de la actividad (por ejemplo, “Abierto”, “En curso”, “Hecho”)	Recomendado
`startTime`	Fecha/hora de inicio	Recomendado
`endTime`	Fecha/hora de finalización	Recomendado
`rootLocation`	Identificador de la ubicación raíz	Recomendado
`assetExternalId`	ID externo del activo vinculado	Opcional
`mainAsset`	Relación directa con el activo	Opcional

Incluya campos adicionales según su configuración de Configuración de campos en Maintain.

Despliegue las actividades

Implemente sus datos de actividad usando Cognite Toolkit:

cdf deploy --env dev

Use la bandera --drop-data si necesita reemplazar actividades existentes:

cdf deploy --env dev --drop-data

Obtenga más información sobre las marcas de implementación de Cognite Toolkit.

Verifique en Maintain

Inicie sesión en Maintain.
Navegue a Actividades.
Verifique que sus actividades importadas aparezcan con los datos correctos.

Ingesta de actividades con Transformaciones

Disponibilidad del modo: Modos APM e IDM/CDM. Este es el enfoque recomendado para datos en masa.

Alternativamente, puede usar CDF Transformaciones para convertir datos de tablas RAW u otras fuentes en nodos de actividad.

Solución de problemas

Si encuentra problemas con las actividades después de la ingestión, consulte la tabla para causas y soluciones.

Problema	Solución
Actividades no visibles	Verifique que la configuración de `viewMappings` apunte al espacio, la vista y la versión correctos
Campos faltantes	Compruebe que su Configuración de campos incluya todos los campos que está ingiriendo
Enlaces de activos rotos	Asegúrese de que las relaciones de `assetExternalId` o `mainAsset` apunten a activos existentes
Ubicación raíz incorrecta	Verifique que `rootLocation` coincida con su configuración de ubicación

Flows

InField

Maintain

Recursos externos

Importar actividades en Maintain

Importar a través de subida de CSV (modo APM)

Formatear campos de fecha

Formatear campos booleanos

Formatear valores que contengan comas

Valores no establecidos

Conectar una actividad a un activo

Importar mediante Cognite Toolkit

Requisitos previos

Configura el mapeo de la vista de actividad

Ingeste actividades con Cognite Toolkit

Ingesta de actividades con Transformaciones

Solución de problemas

​Importar a través de subida de CSV (modo APM)

​Formatear campos de fecha

​Formatear campos booleanos

​Formatear valores que contengan comas

​Valores no establecidos

​Conectar una actividad a un activo

​Importar mediante Cognite Toolkit

​Requisitos previos

​Configura el mapeo de la vista de actividad

​Ingeste actividades con Cognite Toolkit

​Ingesta de actividades con Transformaciones

​Solución de problemas

Importar a través de subida de CSV (modo APM)

Formatear campos de fecha

Formatear campos booleanos

Formatear valores que contengan comas

Valores no establecidos

Conectar una actividad a un activo

Importar mediante Cognite Toolkit

Requisitos previos

Configura el mapeo de la vista de actividad

Ingeste actividades con Cognite Toolkit

Ingesta de actividades con Transformaciones

Solución de problemas