Wiki

Options

New Case Case Status
Log In

Wiki

Options

 
KBS100006 - EtaPRO AssetTool
  • RSS Feed

Last modified on 12/5/2018 10:52 PM by User.

KBS100006 - EtaPRO AssetTool

Descripción General

EtaPRO APR AssetTool es un servicio de línea de comandos interno que se puede usar para manipular Activos EtaPRO APR. Está destinado a ser utilizado por los administradores de sistemas con un conocimiento experto de EtaPRO APR. AssetTool no está destinado a usuarios casuales que no estén familiarizados con el funcionamiento de EtaPRO o el uso de servicios de línea de comandos.

Uso

To use the tool, open a command prompt window and navigate to the directory where the tool is located.  Type the name of the tool followed by the command and options to be executed. List of available commands are:

Para usar la herramienta, abra una ventana del símbolo del sistema y navegue hasta el directorio donde está ubicada la herramienta. Escriba el nombre de la herramienta seguido del comando y las opciones que se ejecutarán. La lista de comandos disponibles es:

Comando

Descripción

list

Lista los activos en una base de datos de servidor EtaPRO.

convert

Convierte archivos de activos de terceros a activos EtaPRO APR.

download

Descarga un activo de APR de EtaPRO a un archivo de activos de APR.

upload

Carga un archivo de activos de APR a EtaPRO.

adddata

Agrega datos a un activo de APR.

deletedata

Elimina datos de un activo APR.

excludedata

Excluye los datos contenidos en un activo de APR.

importdata

Importa los datos contenidos en un archivo CSV en un activo APR.

retrievedata Recupera datos existentes contenidos dentro de un activo APR.

 

Se puede obtener una lista de comandos al pasar por la herramienta el argumento "-?" tal como se muestra en la siguiente figura.

Se pueden obtener argumentos para un comando pasando el comando junto con el argumento "-?" Como se muestra a continuación. También se mostrarán argumentos siempre que se use sintaxis inválida.

 

Los argumentos de acceso rápido de una letra se especifican con un solo guion ("-"). Los argumentos de palabra completa se especifican con un doble guión ("-"). Si se pasa un clic a la herramienta que contiene espacios, la cadena debe colocarse entre comillas dobles.

Comandos

Comando List 

El comando list se puede usar para recuperar una lista de activos contenidos en una base de datos EtaPRO. Los argumentos para el comando list son:

 

Argumento

Descripción

-d or --unit

Especifica la designación de la unidad asociada con los activos

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se utiliza un valor predeterminado de 5575.

--online

Switch que limita las opciones mostradas a los activos en línea. No se puede combinar con --all, --public, u -user.

--all

Switch que obliga a todos los activos a aparecer en la lista. No se puede combinar con -online, --user, o -public.

--public

Switch que obliga a mostrar únicamente los activos públicos. No se puede combinar con -online, --all u -user.

 

Ejemplo 1: Listar todos los activos de APR

 

Ejemplo 2:  Liste todos los activos de APR en línea

 

Comando Convert

El comando convert convierte archivos Smart Signal de Microsoft Access en activos EtaPRO APR. La herramienta agrega automáticamente puntos que faltan del servidor EtaPRO. Este comando se encuentra actualmente en desarrollo y debe considerarse experimental. Por lo tanto, no se proporcionan ejemplos en este documento. Los argumentos para el comando convert son:

 

Argumento

Descripción

-d or –unit

Especifica la designación de la unidad asociada con los activos

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

--source

TEl archivo de origen de Microsoft Access que contiene datos de activos de Smart Signal.

 

Comando Download

El comando download descarga uno o más activos de APR y los guarda en archivos. Los argumentos para el comando download son:

Argumento

Descripción

-d or --unit

Especifica la designación de la unidad asociada con los activos

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

--dir

Especifica un directorio donde deben colocarse los archivos descargados. Si no se proporciona, los archivos se colocan en el mismo directorio que el servicio AssetTool.

--all

Descarga la última revisión de todos los activos APR en la base de datos EtaPRO. No proporcione un número de unidad si usa este comando. Advertencia: este comando puede tomar un tiempo extremadamente largo para ejecutarse y consumirá un ancho de banda significativo mientras se ejecuta.

--d or –unit

Designaciones de unidades asociadas con los activos que se están descargando. Si se proporciona sin un nombre de activo, se descargan todos los activos de la unidad. Advertencia: descargar todo el activo de una unidad puede llevar mucho tiempo y consumirá un ancho de banda significativo mientras se ejecuta.

-n or –name

Limita la descarga a un activo con un nombre específico. Se debe proporcionar una unidad junto con el nombre del activo.

 

Ejemplo 3 –  Descarga un único Activo

Ejemplo  4 – Descargar todos los activos para una unidad

 

Ejemplo 5 – Descargar todos los activos en una base de datos de activos EtaPRO

 

Comando Upload 

El comando upload carga un archivo de activos a la base de datos de EtaPRO. Los argumentos para el comando de carga son:

Argumento

Descripción

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

--d or –unit

Designaciones de unidades asociadas con los activos que se suben. Si se proporciona una designación de unidad, también se debe proporcionar un nombre de activo. Si se proporciona un nombre y una unidad de activo, el activo se crea como un nuevo activo.

-n or –name

Nombre del activo que se almacenará en la base de datos EtaPRO. El nombre debe ser único y no debe existir en la base de datos. Si se proporciona un nombre y una unidad de activo, el activo se crea como un nuevo activo.

--file

Archivo de activos que se cargará en la base de datos

-description

Descripción que se almacenará en la base de datos con el activo.

-notes

Notas que se almacenarán en la base de datos con el activo.

--compact

Obliga a los datos del recurso a compactarse antes de ser cargados.

--user

Almacena el activo como un activo de usuario en lugar de un activo público. Si el usuario no es un administrador, el activo se guardará como un activo del usuario.

--addpoints

Agregue puntos que no existan en EtaPRO

 

Ejemplo 6 – Cargar un archivo de activos como una nueva revisión a un activo existente

 

Ejemplo 7 – Cargar un archivo de activos como un nuevo activo del usuario, compacto antes de cargar

Ejemplo 8 – Cargar un archivo de activos como un nuevo activo de usuario, agregar puntos de datos a EtaPRO

Comando AddData 

El comando adddata agrega datos históricos a un activo. El activo puede estar ubicado en la base de datos de EtaPRO o en un archivo. Si el activo está en un archivo, también debe existir en la base de datos EtaPRO. Los datos se recuperan de cualquier tipo de historiador que esté afiliado al servidor de EtaPRO. Si se adquieren datos de mala calidad, se excluyen del activo.

Los argumentos para el comando agregar datos son:

Argumento

Descripción

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

-f or –file

Nombre de archivo de activo, si se proporciona un nombre de archivo, no se debe proporcionar una designación de unidad y un nombre de activo.

-d or --unit

Especifica la designación de la unidad asociada con los activos. Si se proporciona una designación de unidad, también se debe proporcionar un nombre de activo. No proporcione un nombre de archivo si se refiere a un activo en la base de datos de EtaPRO.

-n or –name

El nombre del activo en la base de datos EtaPRO. Si se proporciona un nombre, también se debe proporcionar una designación de unidad.

-s or –start

Hora de inicio para el período que se recuperará.

-e or –end

Hora de finalización para el período que se recuperará.

-I or –increment

Incremento en segundos del conjuntos de datos a agregar.

 

Ejemplo 9 – Actualizar un archivo de activos con datos históricos históricos de una hora

  

 

Ejemplo 10 – Actualizar un activo en la base de datos con datos históricos de una hora

  

 

Comando DeleteData 

El comando deletedata borra datos en un activo durante un período de tiempo específico. El activo puede estar ubicado en la base de datos o en un archivo.

Los argumentos para el comando deletedata son:

Argumento

Descripción

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

-f or –file

Nombre de archivo de activo, si se proporciona un nombre de archivo, no se debe proporcionar una designación de unidad y un nombre de activo.

-d or --unit

Especifica la designación de la unidad asociada con los activos. Si se proporciona una designación de unidad, también se debe proporcionar un nombre de activo. No proporcione un nombre de archivo si se refiere a un activo en la base de datos de EtaPRO.

-n or –name

Nombre del activo en la base de datos EtaPRO. Si se proporciona un nombre, también se debe proporcionar una designación de unidad.

-s or –start

Hora de inicio para el período que se eliminará.

-e or –end

Hora de finalización para el período que se eliminará.

 

Ejemplo 11– Eliminar datos entre el 1 de diciembre de 2009 y el 15 de diciembre de 2009 para un activo en la base de datos de EtaPRO

 

 

 

Ejemplo 12 – Eliminar datos entre el 1 de diciembre de 2009 y el 15 de diciembre de 2009 de un archivo de activos

  

 

Comando ExcludeData 

 

El comando excludedata excluye los datos en un activo durante un período de tiempo específico. El activo puede estar ubicado en la base de datos o en un archivo. Los datos excluidos permanecen en el activo, pero se excluyen de su uso al generar valores esperados.

Los argumentos para el comando excludedata son:

Argumento

Descripción

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

-f or –file

Nombre de archivo de activo, si se proporciona un nombre de archivo, no se debe proporcionar una designación de unidad y un nombre de activo.

-d or --unit

Especifica la designación de la unidad asociada con los activos. Si se proporciona una designación de unidad, también se debe proporcionar un nombre de activo. No proporcione un nombre de archivo si se refiere a un activo en la base de datos de EtaPRO.

-n or –name

El nombre del activo en la base de datos EtaPRO. Si se proporciona un nombre, también se debe proporcionar una designación de unidad.

-s or –start

Hora de inicio para el período a excluir.

-e or –end

Hora de finalización para el período a excluir.

 

 

Ejemplo 13 – Excluir datos entre el 1 de diciembre de 2009 y el 15 de diciembre de 2009 para un activo en la base de datos de EtaPRO

 

 

Ejemplo 14 – Excluir datos entre el 1 de diciembre de 2009 y el 15 de diciembre de 2009 de un archivo de activos

  

 

Comando ImportData 

El comando importdata permite que los datos contenidos en un archivo CSV (comma separated values) se importen a un activo. El activo puede ubicarse en la base de datos de activos de EtaPRO o en un archivo.

Los argumentos para el comando importdata son:

Argumento

Descripción

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

-f or –file

Nombre de archivo de activo, si se proporciona un nombre de archivo, no se debe proporcionar una designación de unidad y un nombre de activo.

-d or --unit

Especifica la designación de la unidad asociada con los activos. Si se proporciona una designación de unidad, también se debe proporcionar un nombre de activo. No proporcione un nombre de archivo si se refiere a un activo en la base de datos de EtaPRO.

-n or –name

El nombre del activo en la base de datos EtaPRO. Si se proporciona un nombre, también se debe proporcionar una designación de unidad.

--delimiter

El delimitador utilizado para separar las columnas en el archivo csv. Si se omite, se usa una coma.

-c or –csvfile

El nombre / ruta del archivo CSV que contiene los datos históricos que se agregarán al activo.

--header

Bandera utilizada para generar un encabezado para el archivo CSV.

 

Se debe crear un archivo CSV en blanco usando el argumento --header. Después de crear un archivo en blanco, el usuario debe rellenar el archivo con datos. A continuación, se muestra una creación de ejemplo de un archivo de encabezado.

 

Ejemplo 15 – Crear un archivo de encabezado CSV en blanco

  

 

El archivo de encabezado creado por el comando anterior aparece de la siguiente manera cuando se abre en Microsoft Excel.

 

El “Unit/Quality” delimiter se usa para separar el número de unidad y los ID de punto. También se usa para separar el valor y la calidad si un punto es malo. El d“Unit/Quality” delimiter debe cambiarse a otro carácter individual si entra en conflicto con los caracteres utilizados en los ID de punto de EtaPRO.

Cualquier número que no sea cero se tratará como de mala calidad. Un ejemplo del archivo anterior lleno de datos aparece como se muestra a continuación. Los valores que contienen "\ -1" son considerados de mala calidad.

 

Ejemplo 16 Un ejemplo de como agregar los datos en el archivo anterior se proporciona a continuación.

  

 

Ejemplo 17A continuación, se muestra un ejemplo de cómo agregar los datos anteriores a un archivo de activos.

 

 

 

Comando RetrieveData 
 
El comando retrievedata recupera datos de un activo en un archivo CSV (comma separated value). El activo puede ubicarse en la base de datos de activos de EtaPRO o en un archivo.
 

Argumento

Descripción

-d or --unit

Especifica la designación de la unidad asociada con los activos

-u or –username

Especifica el nombre de usuario que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-p or –password

Especifica la contraseña que se utilizará al conectarse a EtaPRO (no es necesario para la autenticación de Windows).

-a or –address

Dirección del servidor para conectarse. Si se omite, se usa 127.0.0.1 (localhost).

--port

Puerto TCP para el servidor. Si se omite, se usa 5575.

--dir

Especifica un directorio donde deben colocarse los archivos descargados. Si no se proporciona, los archivos se colocan en el mismo directorio que la utilidad AssetTool.

--d or –unit

Designaciones de unidades asociadas con los activos que se están descargando. Si se proporciona sin un nombre de activo, se descargan todos los activos de la unidad. Advertencia: descargar todo el activo de una unidad puede llevar mucho tiempo y consumirá un ancho de banda significativo mientras se ejecuta.

-n or –name

Limita la descarga a un activo con un nombre específico. Se debe proporcionar una unidad junto con el nombre del activo.

-c or –csvfile Ruta del archivo CSV donde se guardarán los datos de activos recuperados. Si no se proporciona, el archivo se coloca en el mismo directorio que la herramienta AssetTool.
--delimiter Delimitador utilizado para separar las columnas en el archivo csv. Si se omite, se usa una coma.
-s or –start Hora de inicio para el período que se recuperará. Se deben especificar los tiempos de inicio y finalización. Si se omiten las horas de inicio y fin, se recuperan todos los datos.
-e or –end Hora de finalización para el período que se va a recuperar. Se deben especificar los tiempos de inicio y finalización. Si se omiten las horas de inicio y fin, se recuperan todos los datos
--excluded Especifica si se recuperan los datos Excluidos o Incluidos. Si se establece en True Excluded data, solo se recupera. Si se omite, se utiliza un valor predeterminado de False y los datos incluidos solo se recuperan.

 

Ejemplo 18 – Recuperar datos entre el 2 de noviembre de 2015 y el 13 de noviembre de 2015 para un activo en la base de datos de EtaPRO.

 

Ejemplo 19 – Recuperar todos los datos excluidos de un archivo de activos.