Importar actividades desde archivo CSV
Puede importar varias actividades desde una fuente externa a Maintain cargando un archivo de texto en formato CSV que contenga datos de actividad e incorporándolo a las actividades. Las actividades se pueden visualizar y modificar como actividades creadas en Maintain.
Descargar la plantilla de archivo CSV
El archivo CSV importado debe ajustarse a la plantilla específica del proyecto. Para descargar maintain-import-template.csv:
- Vaya a Actividades y seleccione Añadir actividad.
- Seleccione importar las actividades.
- Seleccione Descargar plantilla.
Rellenar la plantilla de archivo CSV
La plantilla CSV solo contendrá una fila de valores que representen los posibles valores que puede proporcionar para una actividad importada. Esta fila se llama fila de encabezado y no debe eliminarse al rellenar 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, puede eliminarlo del encabezado y las filas posteriores. Esto hará que el campo se deje en blanco en todas las actividades importadas.
Para importar una sola actividad, añada una nueva fila a la plantilla e introduzca los valores adecuados separados por comas. Cada valor de la nueva fila debe contener el valor que desea rellenar en la fila de encabezado respectiva que se proporcionó 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
Al importar, creará una actividad con el título “Constucción de andamios”, el estado “Terminada” y el departamento “Equipamiento”.
Formato de los 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 por un valor de encabezado especial en el formato startTime (DD/MM/AAAA). En este ejemplo, startTime es el nombre del campo, mientras que DD/MM/AAAA es el formato de fecha que debe utilizarse en las filas posteriores del archivo CSV.
Por ejemplo, la importación del siguiente archivo dará como resultado que la actividad se cree con la hora startTime establecida para el 10 de diciembre de 2023.
title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023
Campos con formato booleano
Algunos campos de actividad en Maintain representan valores booleanos, como verdadero o falso. Los campos de fecha se pueden identificar en la plantilla CSV por un valor de encabezado especial en la forma isActive (true/false). Estos campos solo tienen dos valores válidos, true o false.
Por ejemplo, la importación del siguiente archivo dará como resultado que la actividad se cree con isActive configurado como false.
title,isActive (true/false)
Erect scaffolding,false
Valores de formato que contienen comas
Debido a que el formato CSV separa los valores con comas, tenga cuidado cuando un campo de actividad también deba contener una coma. Maintain procesa archivos CSV de acuerdo con la norma RFC 4180, que requiere que los valores que contienen comas se envuelvan en comillas dobles.
Por ejemplo, al importar el siguiente archivo, se creará la actividad con la city establecida como Boston, MA.
title,city
Erect scaffolding,"Boston, MA"
Restablecer valores
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, al importar el siguiente archivo, se creará la actividad con el state establecido en New York, pero no tendrá ningún valor en el campo de city.
title,city,state
Erect scaffolding,New York
Conectar una actividad a un activo
Maintain admite el enlace de actividades a activos CDF, que se utiliza para contextualizar la actividad en modelos 3D, documentos, PSN y más. Para que Maintain cree el enlace adecuado 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 especial assetExternalId en la plantilla que debe rellenar con el ID externo del activo de la actividad.
Por ejemplo, cuando se importa el siguiente archivo y se asume que existe un activo CDF con el ID externo NY_BUILDING_23, la actividad se contextualizará con este activo cuando se incorpora en Maintain.
assetExternalId
Erect scaffolding,NY_BUILDING_23
Si el ID externo proporcionado no se exporta, el usuario verá un error durante la importación.
Es posible que los usuarios finales no conozcan 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 identificadores externos, recomendamos recuperar estos datos utilizando la API de activos de CDF u otros extractores de datos.
Importar un archivo CSV rellenado
Una vez que tenga una plantilla CSV rellenada, puede importarla a Maintain:
- Vaya a Actividades > Añadir actividad.
- Seleccione importar las actividades.
- Seleccione el campo Haga clic para seleccionar el archivo CSV que desea importar.
- Seleccione y cargue el archivo CSV rellenado desde su computadora.
- Verifique que ha importado el archivo marcando la sección Inspector de archivos. Un mensaje verde debe mostrar el número de filas que se van a importar y si tiene alguna advertencia o error.
- Si no hay errores, seleccione Importar para iniciar el proceso de importación.
- Cuando la importación se haya realizado correctamente, verá un mensaje de éxito verde con el botón Mostrar actividades.
- Opcional. Seleccione Mostrar actividades para navegar hasta las actividades importadas y comprobar si son correctas de acuerdo con el archivo CSV.