From 5b6ae931b59d526e961f6ebeed031760db918abb Mon Sep 17 00:00:00 2001 From: felipe Date: Tue, 5 Jul 2022 12:30:59 -0500 Subject: [PATCH 01/24] administrator-guide to spanish I have read the CLA Document and I hereby sign the CLA --- administrator-guide/analytical-model.es.rst | 117 ++++++ administrator-guide/behavioural-model.es.rst | 184 +++++++++ .../configure-data-sources.es.rst | 279 +++++++++++++ administrator-guide/index.es.rst | 81 ++++ .../knowage-at-a-glance.es.rst | 136 +++++++ .../operational-engines.es.rst | 317 +++++++++++++++ administrator-guide/scheduler.es.rst | 339 ++++++++++++++++ administrator-guide/server-manager.es.rst | 379 ++++++++++++++++++ administrator-guide/server-settings.es.rst | 86 ++++ administrator-guide/timespan.es.rst | 33 ++ administrator-guide/user-interface.es.rst | 90 +++++ 11 files changed, 2041 insertions(+) create mode 100644 administrator-guide/analytical-model.es.rst create mode 100644 administrator-guide/behavioural-model.es.rst create mode 100644 administrator-guide/configure-data-sources.es.rst create mode 100644 administrator-guide/index.es.rst create mode 100644 administrator-guide/knowage-at-a-glance.es.rst create mode 100644 administrator-guide/operational-engines.es.rst create mode 100644 administrator-guide/scheduler.es.rst create mode 100644 administrator-guide/server-manager.es.rst create mode 100644 administrator-guide/server-settings.es.rst create mode 100644 administrator-guide/timespan.es.rst create mode 100644 administrator-guide/user-interface.es.rst diff --git a/administrator-guide/analytical-model.es.rst b/administrator-guide/analytical-model.es.rst new file mode 100644 index 00000000..cebe5c57 --- /dev/null +++ b/administrator-guide/analytical-model.es.rst @@ -0,0 +1,117 @@ +# Modelo analítico + +El *modelo analítico* le permite organizar documentos analíticos en jerarquías y carpetas. Echemos un vistazo a su estructura. + +## Estructura y derechos del repositorio + +Knowage adopta una estructura de carpetas virtuales para organizar documentos analíticos en jerarquías y carpetas. Esta estructura se denomina árbol de funcionalidades y es accesible a través de **Gestión de perfiles** > **Gestión de funcionalidades**. + +Hay dos razones principales para organizar los documentos en carpetas y jerarquías: para facilitar su búsqueda y accesibilidad, y para administrar eficazmente la visibilidad de los documentos de acuerdo con los roles de usuario. + +Por defecto *Los permisos se establecen en el nivel de carpeta*. Esto garantiza que un usuario no pueda ver nada fuera de esa carpeta (a menos que también tenga permisos en otras carpetas). También es posible restringir aún más el alcance de visibilidad de un usuario asociando derechos a valores específicos de los atributos del perfil. + +Además de las limitaciones de visibilidad heredadas por las carpetas que las contienen, el desarrollador puede agregar más restricciones a un solo documento. + +Para crear una nueva carpeta, seleccione **Gestión de perfiles** > **Gestión de funcionalidades**. Se muestra el árbol de funcionalidades. Al hacer clic en un elemento, puede seleccionar una de las siguientes opciones: + +* Insertar: para agregar un nuevo hijo al árbol. Seleccione esta opción para crear una nueva carpeta y vaya al siguiente paso. +* Detalle: para ver detalles de un artículo. +* Borrar: para eliminar un elemento. Esta opción sólo está disponible si la carpeta no tiene ningún nodo secundario en el árbol. +* Subir: para mover el elemento hacia arriba en la jerarquía. +* Mover hacia abajo: para mover el elemento hacia abajo en la jerarquía. + +Una vez que seleccione **Insertar**, se abren los detalles de la funcionalidad. + +.. \_createnewfolder: +.. figura:: media/image34.png + +Cree una nueva carpeta y asigne permisos. + +Introduzca una etiqueta y un nombre para la nueva carpeta (funcionalidad). En la tabla, asigne permisos a los roles. +Hay cuatro tipos de permiso: + +* **Desarrollo**: para crear, editar y eliminar documentos analíticos; +* **Prueba**: para ejecutar el documento y modificar su estado desde la prueba hasta la publicación; +* **Ejecución**: para ejecutar el documento; +* **Creación**: para crear documentos de informes ad-hoc como hojas de trabajo y cabinas (para el usuario final). + +Para asignar permisos a los roles, marque las casillas relacionadas. Cada usuario con ese rol tendrá permisos en esa carpeta, excepto en caso de restricciones específicas en el documento único. + + .. warning:: + **Permission Inheritance** + A subfolder inherits the permissions assigned to the parent folder. While it is possible to further restrict inherited permissions, the opposite is not allowed: rights cannot be extended going down the hierarchy. + +## Configuración del menú + +Knowage permite la definición de un menú para el usuario final. Este menú se mostrará en la barra izquierda de la página de inicio de Knowage, debajo del icono de Knowage. Es posible asociar a cada nodo una página estática, un documento, una funcionalidad (como carpeta) o nada (nodo vacío). Cada nodo se puede asociar a diferentes roles. Esta estructura de menú puede ser creada y modificada exclusivamente por el administrador en el **Herramientas** área. Para acceder al área de configuración del menú, vaya a **Gestión de perfiles** > **Configuración del menú** desde el Menú Principal. + +Basta con hacer clic en el "Más" de la página Configuración del menú para agregar una nueva carpeta al **Árbol de menú**. Al seleccionar un nodo del árbol y hacer clic en el icono "Más", el usuario puede agregar una nueva carpeta como hija de la anterior. + +.. figura:: media/image35.png + +Acciones del árbol de menús. + +En general puedes: + +* definir un nombre: el nombre es un campo obligatorio y tiene que ser único; +* definir una descripción: la descripción es un campo obligatorio y se muestra en el menú principal; +* elegir un icono para asociarlo al menú y que se muestre en el menú principal; +* definir el contenido del elemento de menú; +* elija los roles elegibles para ver ese elemento de menú en particular. Solo los usuarios asociados con los roles seleccionados verán este elemento de menú. + +Observe que cuando uno inserta un elemento de menú como un niño, esto heredará los detalles generales de un nodo de menú. + +Icono de menú de configuración + +``` + +Creating a menu, you can choose an icon to be shown in the main menu. **This feature is available only for first level menu**. + +.. figure:: media/image106.png + + Menu choose icon feature + +To associate an icon to the menu, click on "*CHOOSE ICON*" and then you can: + +- choose icon from the predefined icons included in Knowage; +- upload a new file containing a custom icon (*File type allowed are .ico, .svg, .png and the maximum size allowed is 50 KB*). + +To remove the menu icon, click on the trash basket. + +Dialog shown in figure below allows you to select an icon or click on "Browse..." to choose the image on your pc and upload it. After choose is completed, click on "*CHOOSE*" button to apply the changes. If no errors occurred, you'll come back to menu configuration and see the icon you choose. If you want to filter predefined icons, you can start writing in the text field on the top of the dialog. + +.. figure:: media/image107.png + + Menu choose icon dialog + +If you decide to choose a predefined icon, select it click on "CHOOSE" to apply the changes. + +.. figure:: media/image108.png + + Menu choose selected icon + +If you decide to upload a new image, click on "*Browse...*" and select your file. After that, the icon will be displayed as in the image below. Click on "*CHOOSE*" and apply the changes. + +.. figure:: media/image109.png + + Menu choose uploaded icon + +There are four types of menu item content: empty, document, static page and functionality. + +.. figure:: media/image3637.PNG + + **Empty** (left) and **document** (right) content type. + +The **empty** content type corresponds to a blank page, and it is typically chosen for father nodes. + +The **document** content type runs directly a document. For this type you have to choose a related document through the +lookup button and define the list of parameters in the standard URL (i.e.: ``par1=val1&par2=val2&...``). You can also choose to hide the toolbar or the slider panel. + +The **static page** content type shows a static HTML page. In this case, the administrator must define the static page that he wants to load. The HTML page combo is loaded with all HTML pages found in a folder called **static-menu** that must be located under the path defined in the system variable called ``knowage_resource_path``. + +Finally, the **external application** content type, see Figure below, runs a URL address. + +.. figure:: media/image39.png + + External application content type. +``` diff --git a/administrator-guide/behavioural-model.es.rst b/administrator-guide/behavioural-model.es.rst new file mode 100644 index 00000000..d65114b3 --- /dev/null +++ b/administrator-guide/behavioural-model.es.rst @@ -0,0 +1,184 @@ +# Modelo de comportamiento + +Un tema importante a explorar antes de iniciar un nuevo proyecto es la creación y gestión de los llamados *modelo conductual*. + +Regula la visibilidad sobre documentos y datos según los roles y perfiles de los usuarios finales. Ofrece muchas ventajas en un proyecto de BI, incluyendo: reducir el número requerido de documentos analíticos a desarrollar y mantener; codificar reglas de visibilidad una sola vez y aplicarlas a varios documentos, cada uno con sus propias lógicas analíticas; asegurar un crecimiento uniforme del proyecto a lo largo del tiempo; garantizando el respeto de las normas de visibilidad a lo largo del tiempo, sin limitación en el número de motores y documentos analíticos que se pueden añadir a lo largo del tiempo. + +El modelo de comportamiento se basa en cuatro conceptos principales: + +* *perfil de usuario*, definiendo los roles y atributos del usuario; +* *derechos de repositorio*, definir los derechos de los usuarios en términos de accesibilidad de los documentos; +* *controladores analíticos*, definiendo qué datos de un documento se pueden mostrar al usuario; +* *entorno de presentación* configuración, definiendo cómo el usuario puede acceder y ejecutar sus propios documentos. + +En otras palabras, el modelo de comportamiento responde principalmente a lo siguiente: +Preguntas: + +* *QUIÉN* utiliza la solución de inteligencia empresarial (perfil de usuario); +* *QUÉ* es visible para los usuarios, en términos de documentos y datos (derechos de repositorio e impulsores analíticos); +* *CÓMO* los usuarios trabajan con sus documentos (controladores analíticos y configuración del entorno de presentación). + +## Roles, usuarios y atributos + +Los usuarios de Knowage se definen por: + +* Identidades +* Papeles +* Perfiles. + +El *identidad* de un usuario consiste en todos los datos utilizados para identificar a ese usuario, es decir, un nombre de usuario y una contraseña, así como un nombre completo legible por humanos. + +El *perfil* de un usuario consiste en un conjunto de propiedades llamadas atributos, que describen información general sobre el usuario, por ejemplo, edad y sexo, pero también propiedades específicas del dominio, como la unidad organizativa a la que pertenece. Algunos atributos, como el nombre y el correo electrónico, se definen de forma predeterminada en Knowage. Otros pueden ser agregados por el administrador del modelo, como se explica en las siguientes secciones. + +El *rol* de un usuario representa una categorización de un grupo de usuarios. Estos roles pueden corresponder a puestos específicos en la empresa, por ejemplo, "gerente general" o un "director de ventas", o a un puesto con respecto al proyecto de BI, por ejemplo, "administrador de datos" y "desarrollador de BI". Diferentes usuarios pueden tener el mismo rol, así como el mismo usuario puede tener múltiples roles. + +.. \_knowageroletype: +.. tabla:: Tipos de roles de knowage. +:widths: automático + + +-----------------------+-----------------------+-----------------------+ + | Role Type | Description | Standard User | + +=======================+=======================+=======================+ + | ADMIN | General | biadmin | + | | administrator. | | + | | | | + | | Manages all Knowage | | + | | functionalities. | | + +-----------------------+-----------------------+-----------------------+ + | MODEL_ADMIN | Model administrator. | bimodel | + | | | | + | | Manages the | | + | | Behavioural Model and | | + | | its associated | | + | | functionalities. | | + +-----------------------+-----------------------+-----------------------+ + | DEV_ROLE | Developer. | bidev | + | | | | + | | Creates and modifies | | + | | datasets and | | + | | documents. | | + +-----------------------+-----------------------+-----------------------+ + | TEST_ROLE | Test user. | bitest | + | | | | + | | Tests analytical | | + | | documents. | | + +-----------------------+-----------------------+-----------------------+ + | USER | End user. | biuser | + | | | | + | | Executes documents | | + | | visible to him and | | + | | creates ad-hoc | | + | | reporting analysis. | | + +-----------------------+-----------------------+-----------------------+ + +Knowage le permite crear varios roles, de acuerdo con las necesidades de su proyecto. Sin embargo, todos los roles deben pertenecer a un *tipo de rol*. Un tipo de rol es una categorización de nivel superior utilizada por Knowage, con el fin de asignar roles para las diferentes características de la suite. + +Los roles predefinidos se resumen en la Tabla 5.1. Los primeros cuatro roles son roles técnicos, mientras que el último, el usuario, es el usuario final real. Cada tipo de rol tiene asociado un usuario predeterminado. Se pueden crear otros usuarios y asociarlos a un tipo de rol. + +Cuando un usuario inicia sesión en Knowage, su perfil se carga automáticamente. El nombre completo es visible haciendo clic en el botón de información en la esquina inferior izquierda de la página. + +La autenticación puede ser manejada internamente por Knowage o delegada a un sistema externo de inicio de sesión único (SSO). + +.. indirecta:: +**Administración de autenticación**: +La elección de manejar la autenticación internamente o delegarla en un sistema SSO externo generalmente depende de la presencia de un sistema de autenticación ya implementado. Si este es el caso, Knowage puede integrarse perfectamente con la infraestructura de autenticación existente. + +Una vez que el usuario ha iniciado sesión, se carga su rol. Los roles se administran internamente. En caso de que el usuario esté asociado con varios roles, se le pedirá que elija uno. + +Alternativamente, haciendo clic en el icono que se muestra a continuación, puede seleccionar un rol predeterminado que se mantendrá válido hasta que cierre la sesión. + +.. figura:: medios/image28\_bis.png + +Roles de usuario en Knowage. + +Los pasos para crear un modelo de comportamiento siguen: + +* Crear atributos de perfil; +* Crear roles; +* Cree usuarios y asígneles valores y roles de atributos. + +Knowage apoya la gestión de perfiles de usuario y roles a través de la **Gestión de perfiles** sección de menú. Este menú solo es visible para el administrador de Knowage y para el administrador del modelo, ya que la administración de usuarios y roles es una operación crítica que requiere un nivel adecuado de responsabilidad. + +El **Gestión de perfiles** La sección de menú contiene tres elementos de submenú: + +* **Administración de atributos de perfil**: para definir nuevos atributos de perfil y gestionar los existentes. + +* **Gestión de roles**: para crear nuevos roles y administrar permisos para cada rol. + +* **Gestión de usuarios**: para crear usuarios, administrar sus identidades, asignar valores a sus atributos de perfil y asociarlos con roles. + +A continuación, mostramos cómo el administrador del modelo puede definir perfiles de usuario y roles utilizando estas funcionalidades. Recuerde que la gestión de perfiles de Knowage también se puede integrar con sistemas de perfiles externos. + +Haciendo clic en **Administración de atributos de perfil**, se muestra la lista de atributos definidos actualmente. Para agregar un nuevo atributo, haga clic en el botón **Botón Agregar**: se agrega una nueva fila a la lista, donde puede insertar el nombre y la descripción del nuevo atributo. Para eliminar un atributo, seleccione la fila correspondiente y haga clic en **Borrar**. + +Los atributos definidos en esta sección estarán disponibles para todos los perfiles de usuario. No es obligatorio asignar un valor a cada atributo para cada usuario, ya que los atributos de perfil sin valores no se considerarán en la definición del perfil de usuario. + +Además de los atributos de perfil creados por el administrador, de forma predeterminada Knowage proporciona los siguientes atributos de perfil: + +* **user_id**: establecer con el identificador único del usuario; + +* **user_roles**: establecer con roles de usuario seleccionados en la ficha ROLES del menú Administración de usuarios; + +* **TENANT_ID**: establecer con el identificador único del inquilino; + +* **user_session_roles**: establecer como *user_roles* , si no se establece ningún rol predeterminado. Establecer con el rol predeterminado seleccionado, de lo contrario. + +* **Idioma**: establecido con el idioma seleccionado por el usuario + +.. figura:: media/image29.png + +Gestión de atributos de perfil. + +Una vez definidos los atributos, el administrador del modelo puede definir roles, utilizando el **Gestión de roles** funcionalidad. La herramienta de administración de roles tiene dos caras: a la izquierda puede ver la lista de roles ya definidos. Al principio de un proyecto, solo se ven los roles predeterminados. Para agregar un nuevo rol, haga clic en el icono **Agregar** y desplazarse al panel derecho. Para eliminar un rol, simplemente haga clic en el botón **Borrar** al final de la fila del rol. + +.. indirecta:: +**Gestión de roles**: +El modelo de comportamiento debe construirse teniendo en cuenta la especificidad de cada organización y las necesidades del proyecto de BI. Por lo tanto, es una buena práctica definir roles específicos para el proyecto de BI y evitar usar solo roles técnicos de Knowage. + +En el panel derecho hay tres pestañas. El **Detalle** permite al administrador definir el nombre y el tipo de rol (obligatorio). El tipo de rol regula la visibilidad de ese rol en función de los tipos ya descritos. También se puede agregar un código y una descripción, como se muestra a continuación. + +.. figura:: media/image3031.png + +Gestión de roles. + +El **Autorizaciones** le permite asignar permisos a cada rol. Los derechos están predefinidos y agrupados en categorías, como se muestra arriba. + +El **Modelos de Negocio**, **Conjuntos de datos** y **Categorías de KPI** tabs está destinado a asignar categorías específicas a cada rol, de manera que cada usuario solo pueda ver los modelos de negocio, conjuntos de datos o KPI que pertenecen a las categorías asociadas con su rol. + +El **Modelos de Negocio** la ficha sólo está disponible para KnowageBD y KnowageSI, mientras que la ficha **Categorías de KPI** uno solo está disponible para KnowagePM. Se pueden encontrar más detalles sobre los modelos de negocio y los KPI en los capítulos correspondientes. + +Puede crear nuevas categorías para modelos de negocio y conjuntos de datos mediante el **Configuración del servidor** > **Gestión de dominios** elemento de menú. + +*** + +## Gestión de usuarios + +Por último, pero no menos importante, el **Gestión de usuarios** incluye un panel izquierdo que permite al administrador crear y eliminar usuarios, y un panel derecho que le permite administrar los detalles, roles y atributos del usuario. + +.. figura:: media/image32.png + +Gestión de usuarios. + +Desbloqueo de usuario +^^^^^^^^^^^ + +Si el usuario alcanza el número máximo de intentos de inicio de sesión fallidos (editable en configuraciones avanzadas), Será bloqueado por Knowage y se denegará el acceso. Al acceder a Knowage con un usuario que tiene privilegios de administración de usuarios, el usuario bloqueado se mostrará con una señal de advertencia roja y será posible desbloquearlo utilizando el botón "desbloquear usuario". Después de eso, el usuario podrá iniciar sesión con el último conjunto de credenciales. + +.. figura:: media/image115.png + + Users Management - Roles settings example + +Configuración de roles +^^^^^^^^^^^^^^^^^^ + +Al hacer clic en la pestaña ROLES, debe seleccionar uno o más roles para asociar con el usuario. +Después de eso, si hay más de un rol asociado al usuario, puede elegir el rol predeterminado seleccionándolo en el cuadro combinado en la parte superior de la página. + +El rol predeterminado es opcional: si no selecciona un rol predeterminado, en el momento del inicio de sesión se cargarán todos los roles disponibles para el usuario. Si selecciona un rol, en el momento del inicio de sesión +será el rol de sesión seleccionado. + +.. figura:: media/image100.png + + Users Management - Roles settings example + +En el ejemplo anterior, para el usuario "*mordedor*" puede elegir entre "admin" y "*kte_dev*" como rol predeterminado. diff --git a/administrator-guide/configure-data-sources.es.rst b/administrator-guide/configure-data-sources.es.rst new file mode 100644 index 00000000..49f3e7d6 --- /dev/null +++ b/administrator-guide/configure-data-sources.es.rst @@ -0,0 +1,279 @@ +# Configurar orígenes de datos + +Para que todas las herramientas de BI funcionen correctamente, debe configurar la conexión de base de datos. Hay dos opciones diferentes disponibles para la configuración **JNDI** (recomendado) y **JDBC**. + +## Conéctese a sus datos + +Para conectarse a sus datos, debe definir una nueva conexión de origen de datos. + +Knowage administra dos tipos de conexiones de origen de datos: + +* conexiones recuperadas como recursos JNDI, que son administrados por el servidor de aplicaciones en el que knowage está trabajando. Esto permite al servidor de aplicaciones optimizar el acceso a los datos (por ejemplo, definiendo grupos de conexiones) y, por lo tanto, son los preferidos. Aquí puede encontrar información sobre cómo crear un grupo de conexiones en Tomcat: https://tomcat.apache.org/tomcat-8.0-doc/jndi-datasource-examples-howto.html +* conexiones JDBC directas, que son administradas directamente por Knowage; + +.. importante:: +**Cómo crear JNDI de conexión en Tomcat** + + - Create connection pool on ``TOMCAT_HOME/conf/server.xml`` + - Add ResourceLink on context.xml + +Para agregar una nueva conexión, primero agregue el controlador JDBC relativo a la carpeta `TOMCAT_HOME/lib` y reinicie Knowage. Luego, inicie sesión como administrador (usuario: *biadmin*contraseña: *biadmin* son la credencial predeterminada) y seleccione la opción **Origen de datos** del elemento del **Proveedor de datos** en el menú del administrador. + +Haciendo clic en el botón **Agregar** en la esquina superior derecha del panel izquierdo, se mostrará un formulario vacío a la derecha. + +.. figura:: media/image25.png + + Add a new data source + +.. figura:: media/image26.png + + Data source details. + +La página de detalles de cada origen de datos (en el lado derecho, como se muestra en las figuras anteriores) incluye las siguientes propiedades: + +Etiqueta +Identificador obligatorio del origen de datos. +Descripción +Descripción del origen de datos. +Dialecto +El dialecto utilizado para acceder a la base de datos. Los dialectos admitidos son: + + .. table:: Certified Data Sources + :widths: auto + + +-----------------------+-------------------+ + | Certified Data Sources | + +=======================+===================+ + | Oracle | 11, 12 | + +-----------------------+-------------------+ + | MySQL | 5.7, 8 | + +-----------------------+-------------------+ + | PostgreSQL | 8.2, 9.1, 12.3 | + +-----------------------+-------------------+ + | Maria DB | 10.1, 10.2, 10.3 | + +-----------------------+-------------------+ + | Teradata | 15.10.0.7 | + +-----------------------+-------------------+ + | Vertica | 9.0.1-0 | + +-----------------------+-------------------+ + | Cloudera | 5.8.9 | + +-----------------------+-------------------+ + | Apache Hive 1 | 1.1.0 | + +-----------------------+-------------------+ + | Apache Hive 2 | 2.3.2 | + +-----------------------+-------------------+ + | Apache Impala | 2.6.0 | + +-----------------------+-------------------+ + | Apache Spark SQL | 2.3.0 | + +-----------------------+-------------------+ + | Apache Cassandra | 2.1.3 | + +-----------------------+-------------------+ + | Mongo DB | 3.2.9 | + +-----------------------+-------------------+ + | Orient DB | 3.0.2 | + +-----------------------+-------------------+ + | Google Big Query | - | + +-----------------------+-------------------+ + | Amazon RedShift | (JDBC driver v1) | + +-----------------------+-------------------+ + | Azure Synapse | - | + +-----------------------+-------------------+ + +Sólo lectura +Las opciones disponibles son: *Sólo lectura* y *Lectura y escritura*. En caso de que el origen de datos se defina como lectura y escritura, Knowage puede utilizarlo para escribir tablas temporales. +Escribir +Valor predeterminado Si un origen de datos se establece como *Escritura predeterminada* luego es utilizado por Knowage para escribir tablas temporales que también provienen de otros *Sólo lectura* fuentes de datos. Tenga en cuenta que cada instalación de Knowage solo puede tener una *Escritura predeterminada* origen de datos. +Tipo +Las opciones disponibles son + + + If you want to define a direct **JDBC** connection, then you have to also set the following fields: + + - **URL** Database URL. An example for MySQL databases is ``jdbc:mysql://localhost:3306/foodmart_key`` + - **User** Database username. + - **Password** Database password. + - **Driver** Driver class name. An example for MySQL databases is ``com.mysql.jdbc.Driver``. + + If instead you want to define a **JNDI** connection, fill in the following fields: + + - **Multischema** Available options are *Yes* or *No*. If *Yes*, the JNDI resource full name is calculated at runtime by appending a user’s profile attribute (specified in the *Multischema attribute* field) to the JNDI base name defined in the server.xml, we suppose it has been told at the end of installation or during server configuration. + - **Schema attribute** The name of the profile attribute that determines the schema name. + - **JNDI NAME** It depends on the application server. For instance, for Tomcat 7 it has the format ``java:comp/env/jdbc/``. If the data source is multischema, then the string is ``java:comp/env/jdbc/``. + +Una vez que haya completado el formulario, puede probar la nueva fuente de datos haciendo clic en el botón *Prueba* en la esquina superior derecha de la página y luego guárdelo. + +¡Ahora está conectado a sus datos y puede comenzar un nuevo proyecto de Business Intelligence con Knowage! + +## Big Data y NoSQL + +En esta sección describimos cómo puede conectar Knowage a diferentes fuentes de datos de Big Data. + +.. importante:: +**Solo Enterprise Edition** + + Please note that these connections are available for products KnowageBD and KnowagePM only. + +Colmena + +``` + +Apache Hive is a data warehouse infrastructure built on top of Hadoop for providing data summarization, query, and analysis. Apache Hive supports analysis of large datasets stored in Hadoop’s HDFS and compatible file systems such as Amazon S3 filesystem. It provides an SQL-like language called HiveQL with schema on read and transparently converts queries to map/reduce, Apache Tez and Spark. All three execution engines can run in Hadoop YARN. + +Every distribution of Hadoop provides its JDBC driver for Hive. We suggest you to use or the Apache one or the one specific of your distribution. In general the JDBC driver for Hive is composed by different .jars, and so you should deploy the JDBC driver with all dependencies in your application server. If you are creating a model you should create a new *Data Source Connection* and import the JDBC driver and all the dependencies. + +For example suppose you want to connect to Hive using Apache driver you should include these libraries (according to your Hive version) shown in Figure below. + +.. figure:: media/image27.png + + Libraries to include in the apache driver. + +If you forget to add one or more libraries, you will likely get a ``NoClassDefFoundError`` or ``ClassNofFoundException``. + +The parameters for the Hive connection are: + +- **Dialect:** Hive QL; + +- **Driver Class:** ``org.apache.hive.jdbc.HiveDriver`` (if you are not using some specific driver of some distribution. In this case search in the documentation of the distribution); +- **Connection URL:** ``jdbc:\hive2:\//:,:/dbName;sess\\_var_list?hive_conf_list#hive_var_list``. + +Here ``:,:`` is a server instance or a comma separated list of server instances to connect to (if dynamic service discovery is enabled). If empty, the embedded server will be used. + +A simple example of connection URL is ``jdbc:\hive2://192.168.0.125:10000``. + +Spark SQL +``` + +Spark SQL reutiliza el front-end y el metaalmacén de Hive, lo que le brinda compatibilidad total con los datos, consultas y UDF de Hive existentes. Simplemente instálelo junto a Hive. Para la instalación de Spark le sugerimos que consulte el sitio web de spark `http://spark.apache.org/. `\__ Para crear una conexión con el servidor Spark SQL Apache Thrift debe utilizar el mismo controlador JDBC de Hive. + +* **Clase de conductor:** `org.apache.hive.jdbc.HiveDriver` (si no está utilizando algún controlador específico de alguna distribución. En este caso buscar en la documentación de la distribución); + +* **URL de conexión:** `jdbc:\hive2://:,:/dbName;sess\\_var_list?hive_conf_list#hive_var_list`. + +Consulte la sección Hive para obtener detalles sobre los parámetros. El puerto en este caso no es el puerto de Hive sino el del servidor de ahorro Spark SQL (normalmente `10001`). + +Impala + +``` + +Impala (currently an Apache Incubator project) is the open source, analytic MPP database for Apache Hadoop. To create a connection to Impala you should download the jdbc driver from the Cloudera web site and deploy it, with all dependencies, on the application server. The definition of the URL can be different between versions of the driver, please check on the Cloudera web site. + +Example parameters for Impala connection are: + +- **Dialect:** Hive SQL; +- **Driver Class:** ``com.cloudera.impala.jdbc4.Driver``; +- **Connection URL:** ``jdbc:\impala://dn03:21050/default``. + +MongoDB +``` + +MongoDB es una base de datos de documentos de código abierto que proporciona alto rendimiento, alta disponibilidad y escalado automático. MongoDB evita la necesidad de un Mapeo Relacional de Objetos (ORM) para facilitar el desarrollo. + +MongoDB es diferente de los otros dbs que Knowage puede manejar, porque no proporciona un controlador JDBC, sino un conector Java. El controlador Java de MongoDB (en este momento se incluye la versión 3.5.0) ya está incluido dentro de Knowage, por lo que no es necesario descargarlo y agregarlo al servidor de aplicaciones. + +Los parámetros de ejemplo para la conexión son: + +* **Dialecto:** MongoDB; +* **Clase de conductor:** mongo; +* **URL de conexión:** mongodb://localhost:27017/foodmart (no incluya el usuario y la contraseña en esta URL). + +También preste atención a que el usuario debe tener los privilegios correctos para acceder a la base de datos especificada. Entonces, por ejemplo, en MongoDB puede crear un usuario con este comando en el shell de Mongo: + +.. code-block:: javascript +:linenos: +:caption: Creación de usuarios. + + db.createUser( + { + user: "user", + pwd: "user", + roles: [ { role: "readWrite", db: "foodmart" } ] + } + ) + +A continuación, debe crear un rol que sea capaz de ejecutar funciones (esta es la forma utilizada por Knowage para ejecutar el código escrito en la definición del conjunto de datos de MongoDB) y asignarlo al usuario: + +.. code-block:: javascript +:linenos: +:caption: Asignación de roles . + + use admin + db.createRole( { role: "executeFunctions", privileges: [ { resource: { anyResource: true }, actions: [ "anyAction" ] } ], roles: [] } ) + use foodmart + db.grantRolesToUser("user", [ { role: "executeFunctions", db: "admin" } ]) + +Vea también estos enlaces útiles: + +* (`https://docs.mongodb.com/manual/tutorial/enable-authentication/) `\__ +* (`https://www.claudiokuenzler.com/blog/555/allow-mongodb-user-execute-command-eval-mongodb-3.x#.W59wiaYzaUl) `\__ + +Casandra + +``` + +Apache Cassandra is an open source distributed database management system designed to handle large amounts of data across many commodity servers, providing high availability with no single point of failure. Cassandra offers robust support for clusters spanning multiple datacenters, with asynchronous masterless replication allowing low latency operations for all clients. + +There are different ways to connect Knowage to Cassandra. + +If you are using DataStax Enterprise you can use Spark SQL connector and query Cassandra using pseudo standard SQL (`https://github.com/datastax/spark-cassandra-connector/blob/master/doc/2_loading.md) `__ + +Another solution is to download the JDBC Driver suitable for your Cassandra distribution and query Cassandra using the CQL language. You must deploy the JDBC driver with all dependencies in your application server (copy them into ``TOMCAT_HOME/lib`` folder and restart). + +Refer to the JDBC driver documentation in order to see how to configure the JDBC connection parameters. + +Unless you are using Spark SQL to read from Cassandra, the definition of a business model over Cassandra data using Knowage Meta will be available in the next releases. + +Google Big Query +``` + +Knowage admite fuentes de datos de Google Big Query a través del controlador JDBC de Simba: consulte `official documentation `\_. + +Por ejemplo, para crear una conexión JDBC a un conjunto de datos de Google Big Query mediante una cuenta de servicio, puede agregar la siguiente configurtaion a `TOMCAT_HOME/conf/server.xml`: + +.. code-block:: xml + + + +Google Cloud Spanner + +``` + +Knowage supports Google Cloud Spanner datasources via the official open source JDBC driver: see `official documentation `_. + +For example, to create a JDBC connection to a Google Cloud Spanner dataset using a service account you can add the following configurtaion to ``TOMCAT_HOME/conf/server.xml``: + +.. code-block:: xml + + + + +Amazon RedShift +~~~~~~~~~~~~~~~~ + +Knowage supports Amazon RedShift datasources via Official v1 JDBC Driver: see `official reference `_. +According to documentation using JDBC drivers v1 a RedShift connection configuration can be done exactly like a PostgreSQL configuration. +You can test it creating an example db like this one: `official sample testing db `_. +To create a JDBC connection to an Amazon RedShift dataset using a RedShift-only connection you can add the following configuration to ``TOMCAT_HOME/conf/server.xml``: + +.. code-block:: xml + + + +Azure Synapse +~~~~~~~~~~~~~ + +Knowage supports connections to Azure Synapse datasources via SQL Server JDBC Driver (`official documentation `_). + +The following example shows how to create a JDBC connection to an Azure Synapse dataset, by adding the following configuration to ``TOMCAT_HOME/conf/server.xml``: + +.. code-block:: xml + + + +``` diff --git a/administrator-guide/index.es.rst b/administrator-guide/index.es.rst new file mode 100644 index 00000000..3c5845eb --- /dev/null +++ b/administrator-guide/index.es.rst @@ -0,0 +1,81 @@ +Manual de administración +\######################### + +.. toctree:: +:caption: Tabla de contenido + + knowage-at-a-glance.rst + user-interface.rst + configure-data-sources.rst + behavioural-model.rst + analytical-model.rst + operational-engines.rst + timespan.rst + scheduler.rst + server-manager.rst + server-settings.rst + +.. |imagen11| imagen:: media/image11.png +:ancho: 0.27561in +:altura: 0.27561in +.. |imagen12| imagen:: media/image12.png +:ancho: 0.2756in +:altura: 0.2756in +.. |imagen13| imagen:: media/image13.png +:ancho: 0.2756in +:altura: 0.2756in +.. |imagen14| imagen:: media/image14.png +:ancho: 0.2756in +:altura: 0.27559in +.. |imagen15| imagen:: media/image15.png +:ancho: 0.2756in +:altura: 0.27559in +.. |imagen18| imagen:: media/image16.png +:ancho: 0.2756in +:altura: 0.2756in +.. |image19| imagen:: media/image17.png +:ancho: 0.2756in +:altura: 0.2756in +.. |image27| imagen:: media/image18.png +:ancho: 0.2756in +:altura: 0.2756in +.. |image28| imagen:: media/image19.png +:ancho: 0.2756in +:altura: 0.2756in +.. |image29| imagen:: media/image20.png +:ancho: 0.2756in +:altura: 0.27561in +.. |image30| imagen:: media/image21.png +:ancho: 0.27561in +:altura: 0.2756in +.. |image31| imagen:: media/image22.png +:ancho: 0.27561in +:altura: 0.27561in +.. |image32| imagen:: media/image23.png +:ancho: 0.2756in +:altura: 0.27561in +.. |image33| imagen:: media/image24.png +:ancho: 0.27559in +:altura: 0.2756in +.. |image50| imagen:: media/image44.png +:ancho: 0.39371in +:altura: 0.25131in + +.. |imagen0| imagen:: media/image1.png +:ancho: 8.25in +:altura: 10.97333in +.. |imagen1| imagen:: media/image2.png +:ancho: 5.0075in +:altura: 4.14184in +.. |imagen36| imagen:: media/image4.png +:ancho: 5.0075in +:altura: 1.41271in +.. |image39| imagen:: media/image4.png +:ancho: 5.0075in +:altura: 1.25635in +.. |imagen43| imagen:: media/image3.png +:ancho: 5.78738in +:altura: 1.58376in +.. |image93| imagen:: media/image99.png +:ancho: 8.25in +:altura: 8.28333in diff --git a/administrator-guide/knowage-at-a-glance.es.rst b/administrator-guide/knowage-at-a-glance.es.rst new file mode 100644 index 00000000..dbbecd21 --- /dev/null +++ b/administrator-guide/knowage-at-a-glance.es.rst @@ -0,0 +1,136 @@ +# Conocimiento de un vistazo + +## Descubriendo Knowage + +Knowage es la suite de inteligencia de negocios desarrollada y administrada por Engineering Group. El conocimiento es *flexible*, ya que se basa en una arquitectura modular y estándares abiertos con el fin de facilitar su personalización e integración según las necesidades de los usuarios. También proporciona un *comprensivo* conjunto de características y capacidades analíticas que van desde herramientas tradicionales de informes y gráficos, hasta análisis más avanzados. + +.. importante:: +**Solo Enterprise Edition** + + KnowageER and KnowageSI, as submodules of Knowage Enterprise Edition, also supports **multi-tenancy** (i.e. a single Knowage instance serving multiple organizations, called tenants). In a multi-tenancy architecture, each tenant owns and manages his own users, documents, configuration and parameters, which are completely independent from those owned by other tenants. + +## Módulos + +.. figura:: media/image6.png + +Módulos de conocimiento. + +Servidor Knowage +El núcleo de la suite, que incluye todas las características analíticas. Este es el entorno de referencia para el usuario final y el administrador; +Knowage Meta +El entorno que soporta la creación y gestión de modelos de metadatos. Este módulo está concebido para desarrolladores de BI. +Estudio Knowage +El entorno que permite a los desarrolladores de BI configurar el análisis y las características analíticas relacionadas que luego se publican y se ponen a disposición del usuario final en el servidor. +Knowage SDK +Un conjunto de API compatibles con la arquitectura SOA, lo que permite que las aplicaciones externas interactúen con Knowage Server y sus metadatos. +Aplicaciones de Knowage +Un conjunto de modelos analíticos listos para usar en dominios de negocio específicos. + +Aquí nos centramos en Knowage Server teniendo en cuenta la perspectiva del administrador. + +Es el módulo principal de la suite, que proporciona, como veremos, todo el poder analítico del producto y todo lo administrativo +Funcionalidades. + +Representa una solución de nivel empresarial para BI, soportando todo el ciclo de vida del proyecto, gestionando la seguridad y garantizando la escalabilidad, el clustering y las arquitecturas de alta disponibilidad. Además, es la principal referencia para todos los usuarios y usos potenciales; lidera la tendencia de desarrollo en términos de características, servicios y modelos de entrega. + +## Capas + +La arquitectura de Knowage Server está funcionalmente en capas en tres niveles principales. + +.. figura:: media/image7.png + +Estructura de la arquitectura de Knowage Server. + +Capa de entrega +Gestiona todos los usos posibles del servidor por parte de los usuarios finales o de aplicaciones externas. +Capa analítica +Proporciona todas las funcionalidades analíticas del producto. +Capa de datos +Regula la carga de datos a través de muchas estrategias de acceso. + +Cada capa de la arquitectura funcional se compone de diferentes módulos de aplicación. + +.. figura:: media/image8.png + +Detalle de la arquitectura de Knowage Server. + +Capa de entrega + +``` + +The delivery layer covers all publication requirements. It can be accessed by third-party applications, and it offers end users all features and services needed to perform their BI analysis. + +It can be accessed in different ways: + +BI Webapp + It is the default use mode. Knowage suite provides a web application, working on a standard application server A customizable web application is provided, working on a standard application server (e.g. Tomcat, JBoss, WAS). The administrator can define the layout and specific views for each end user type. +BI Mobile + Thanks to the interaction between Knowage Server and the remote client interface, users’ reports, charts or cockpits can also be accessed and displayed on mobile devices, such as tablets and smartphones. +BI Service + Web services allowing Knowage components to interact with external applications or to collect the results of static documents (report, image of a chart, etc.). +BI Tag + Tag libraries allowing you to encapsulate a dynamic document (OLAP, GEO, etc.) into a different context. +BI API + For the integration of enterprise applications behind or without the end user GUI. + +Analytical layer +``` + +La capa analítica es el núcleo del servidor. Proporciona todas las características y capacidades analíticas, en un acceso seguro y basado en roles. +modo. Sus principales componentes son: + +Motores analíticos +cubriendo todos los requisitos analíticos, proporciona diferentes herramientas para cada tipo de análisis (por ejemplo, informes, gráficos, cabinas), con el fin de garantizar una alta flexibilidad y la satisfacción de los usuarios finales. +Motores operativos +interactuar con sistemas OLTP mediante ETL o procesos, y gestionar registros básicos de BI como datos maestros o dominios de búsqueda; +Modelo de comportamiento +que regula la visibilidad sobre documentos y datos, según los roles de los usuarios finales. + +Al ofrecer múltiples soluciones para el mismo requerimiento analítico y/o múltiples instancias para el mismo motor, la lógica y arquitectura de Knowage proporcionan diversos beneficios, tales como: carga de trabajo limitada en cada motor, garantizando altos rendimientos; apertura para mejorar o ampliar la suite y sus capacidades, minimizando el impacto en los entornos salientes; alta flexibilidad y modularidad; alta escalabilidad, con un mínimo impacto económico, de infraestructura y a nivel de aplicación. + +Capa de datos + +``` + +The data layer allows data and metadata storage and usage. BI data is often located in a data warehouse, whose design is out of the BI product scope and strictly related to the specific customer’s world. Most of Knowage products offer a specific ETL tool allowing to load data at this level, covering the whole BI stack. + +Knowage can directly access the data warehouse through JDBC connections (for instance, using SQL queries) or, on a higher level, it can use a specific access strategy based on metamodels, built through Knowage Meta. + +As described in the next chapters, Knowage can also access less traditional data sources, like Big Data and NoSQL data sources. + +All Knowage metadata are stored in a private repository hosted on a generic RDBMS and accessed by means of a generic description based on Hibernate technology. Knowage metadata contains technical information, business metadata and metamodels registry. + +What you can do with Knowage +---------------------------- + +This section focuses on Knowage analytical and operational functionalities, administration tools and cross services. + +It is important to point out that Knowage adopts an evolutionary approach, allowing you to use and adapt the different features provided +by the suite according to your specific needs, and adapt them over time. The Server reflects this strategy, guaranteeing security and +consistency, thanks to the independence of the behavioural model that regulates visibility over documents and data. + +Moreover, Knowage has a distributed logic and handles more instances of a same engine. This allows the workload distribution on several servers, ensuring the linear system scalability. + +Analytical and operational functionalities +``` + +Knowage server proporciona una amplia gama de funcionalidades analíticas, +cubierto por los diferentes productos de la suite. + +En cuanto al nivel operativo, Knowage Server trabaja con: + +* **ETL**, no solo para la carga continua de datos de origen en el DWH, sino incluso para el movimiento interno de datos, consolidaciones de alto nivel o devolución de la información producida a los sistemas operativos. +* **Procesos externos**, para una interacción bidireccional con sistemas operativos y externos. +* **Datos maestros**, para administrar manualmente los datos del dominio. + +Herramientas administrativas y servicios cruzados + +``` + +Besides its analytical, delivery and data access capabilities, Knowage Server provides all the administration tool needed to handle your +Knowage instance, as well as several cross-product services to make its features even more powerful. + +The **administrative tools** support developers, testers and administrators in their daily work, providing various functionalities, such as: scheduler, profiling system, import/export capabilities, menu designer, map catalogue, management of repository, analytical model, behavioural model and engines, configuration of data sources and data sets, audit & monitoring analysis, subscriptions, management of value domains, configuration settings and metadata, management of user data, hierarchies editor and community management. + +The **cross services** include the common features of the product, shared by all analytical engines and documents. They are: single sign on, alert and notification, workflow, search engine, collaborative tools, sending e-mails, ranking, multiformat exporter, RT events, document browser, personal folders, cross navigation, subscription service, hot link, metadata view. +``` diff --git a/administrator-guide/operational-engines.es.rst b/administrator-guide/operational-engines.es.rst new file mode 100644 index 00000000..9367f77b --- /dev/null +++ b/administrator-guide/operational-engines.es.rst @@ -0,0 +1,317 @@ +# Motores operativos + +## ETL + +El knowage permite la carga de datos de los sistemas de origen de acuerdo con una lógica ETL común, así como el monitoreo de los flujos de datos que alimentan continuamente el almacén de datos. Con este fin, Knowage proporciona el ETL **Knowage Talend Engine**. + +.. importante:: +**Solo Enterprise Edition** + + Please note that in the Enterprise Edition, **KnowageTalendEngine** is shipped with KnowageBD and KnowageSI only. + +KnowageTalendEngine + +``` + +Knowage Talend Engine integrates the open source tool Talent Open Studio (TOS). Talend Open Studio (TOS) is a graphical designer for defining ETL flows. Each designed flow produces a self-alone Java or Perl package. TOS is based on Eclipse and offers a complete environment including test, debug and support for documentation. + +The integration between Talend and Knowage is twofold. TOS includes Knowage as a possible execution target for its job, while Knowage implements the standard context interface for communicating with Talend. Jobs can be directly executed from Knowage web interface or possibly scheduled. + +Furthermore, the analytical model for monitoring ETL flows can be successfully applied to the analysis of audit and monitoring data generated by a running job. Note that this is not a standard functionality of Knowage suite, but it can be easily realized within a project with Knowage. To create an ETL document, you should perform the following steps: + +- Job design (on Talend); +- Job deploy; +- Template building; +- Analytical document building; +- Job execution. + +In the remainder of the section, we discuss in detail all steps by providing examples. + +Job design +~~~~~~~~~~~~ + +The job is designed directly using Talend. + +Designing an ETL job requires to select the proper components from Talend tool palette and connect them to obtain the logic of the ETL flow. Talend will map to appropriate metadata both the structure of any RDBMS and the structure of any possible flow (e.g., TXT, XLS, XML) acting as input or output in the designed ETL. + +To design the ETL, several tools are available: from interaction with most RDBMS engines (both proprietary and open source) to support for different file formats; from logging and auditing features to support for several communication and transport protocols (FTP, POP, code, mail); from ETL process control management to data transformation functionalities. + +Talend also supports data quality management. Furthermore, it enables the execution of external processes and can interact with other applications, e.g., open source CRM applications, OLAP and reporting tools. + +The tMap tool allows the association of sources to targets according to defined rules. The main input is the source table in the data warehouse, while secondary (or lookup) inputs are dimensions to be linked to data. The output (target) is the data structure used for aggregation. + +It is also possible to design parametric ETL jobs. We will see how to manage them in the next steps. + +Once you have designed the ETL job, you should deploy it on Knowage Server. First of all, configure connections properties to Knowage Server. Select **Preferences** > **Talend** > **Import/export** from within Talend. Then set connection options as described below. + +.. _connectionsettings: +.. table:: Connection Settings. + :widths: auto + + +-----------------------------------+-----------------------------------+ + | Parameter | Value | + +===================================+===================================+ + | Engine name | KnowageTalendEngine | + +-----------------------------------+-----------------------------------+ + | Short description | Logical name that will be used by | + | | Talend | + +-----------------------------------+-----------------------------------+ + | Host | Host name or IP address of the | + | | connection URL to Knowage | + +-----------------------------------+-----------------------------------+ + | Port | Port of the connection URL to | + | | Knowage | + +-----------------------------------+-----------------------------------+ + | Host | Host name or IP address of the | + | | connection URL to Knowage | + +-----------------------------------+-----------------------------------+ + | Password | Password of the user that will | + | | perform the deploy | + +-----------------------------------+-----------------------------------+ + +Once you have set the connection, you can right click on a job and select **Deploy on Knowage**. This will produce the Java code implementing the ETL and make a copy of the corresponding jar file at ``\\resources\\talend\\RuntimeRepository\\java\\Talend`` project name of Knowage Server. It is possible to deploy multiple jobs at the same time. Exported code is consistent and self-standing. It may include libraries referenced by ETL operators and default values of job parameters, for each context defined in the job. On its side, Knowage manages Talend jobs from an internal repository at ``resources/talend/RuntimeRepository``, under the installation root folder. + +Template building +~~~~~~~~~~~~~~~~~~ + +As with any other Knowage document, you need to define a template for the ETL document that you wish to create. The ETL template has a very simple structure, as shown in the example below: + +.. code-block:: xml + :linenos: + :caption: ETL template. + + + + + +Where the tag job includes all the following configuration attributes: + +- project is the name of the Talend project +- jobName is the label assigned to the job in Talends repository. +- context is the name of the context grouping all job parameters. Typically it is the standard context, denoted with the name **Default**. +- version is the job version +- language is the chosen language for code generation. The two possible options are: Java and Perl. + +Values in the template must be consistent with those defined in Talend, in order to ensure the proper execution of the ETL document on Knowage Server. + +Creating the analytical document +``` + +Una vez que hemos creado la plantilla, podemos crear un nuevo documento analítico. + +Antes de comenzar a crear el documento, se recomienda verificar si el motor está instalado y configurado correctamente. En caso de que el motor no esté visible en la lista Configuración del motor (**Proveedores de datos** > **Gestión del motor**), debe comprobar que la aplicación web está activa invocando la dirección URL `http://myhost:myport/KnowageTalendEngine`. + +Ahora puede crear el documento analítico en el servidor, siguiendo el procedimiento estándar. La plantilla para este documento es la que acabamos de crear. +Si el trabajo tiene parámetros, deben asociarse a los controladores analíticos correspondientes, como suele ser habitual. En otras palabras, debe crear un controlador analítico para cada variable de contexto definida en el trabajo de Talend. + +Ejecución de trabajos + +``` + +A Talend job can be executed directly from the web interface of Knowage Server and of course from a Talend client. +To execute the job on Knowage, click on the document icon in the document browser, like with any other analytical document. The execution page will show a message to inform that the process was started. + +Job scheduling +``` + +La mayoría de las veces es útil programar la ejecución de trabajos ETL en lugar de ejecutarlos directamente. Puede confiar en la funcionalidad de programación de Knowage para planificar la ejecución de los trabajos de Talend. +Al definir una ejecución programada, puede establecer una opción de notificación que enviará un correo electrónico a un conjunto de destinatarios o una lista de correo una vez que el trabajo haya completado su ejecución. Para habilitar esta opción, marque el indicador **Enviar correo**. + +## Procesos externos + +El knowage apoya la ejecución de procesos externos a su propia actividad. Al analizar datos, por ejemplo a través de la consola en tiempo real, puede ser útil realizar actividades como enviar correos electrónicos de notificación o realizar acciones sobre los componentes del sistema monitoreado (por ejemplo, procesos comerciales, nodos de red). + +Estos productos proporcionan el KnowageProcessEngine, que soporta la ejecución y gestión de procesos externos. + +Con el término *proceso* nos referimos a una instrucción Java, por compleja que sea. Los procesos se pueden ejecutar en segundo plano o a través de la interfaz del motor de consola. También es posible programar su inicio y parada. + +Para habilitar la gestión de un proceso externo, se requieren los siguientes pasos: + +* Crear una clase Java que defina la lógica de ejecución; +* Si es necesario, cree una clase Java que defina la lógica del proceso, es decir, qué tareas se supone que debe realizar el proceso (opcional); +* Cree una plantilla que se asociará al documento knowage; +* Crear el documento analítico de Knowage CommonJ; + +En las siguientes secciones, proporcionamos detalles sobre la creación de clases y plantillas, y la creación de documentos. + +Definición de clase + +``` + +First of all, the developer should write a Java class that defines the desired logics for processing start and stop. In particular, this class must extend one of these two classes of the engine: + +KnowageWork + In this case the class to be defined only needs to reimplement the ``run()`` method. This class is the base case: the logic of the external process will be contained in the run() method. + +CmdExecWork + In this case, the class to be defined must implement the method ``execCommand()``. The logic of the external process can be delegated to an external class, which will be invoked by the ``execCommand()`` method. To stop the process, the developer is in charge of checking programmatically whether the process is still running, using the method ``isRunning()``, or not. + + .. code-block:: java + :linenos: + :caption: Class template + + package it.eng.spagobi.job; + + import java.util.Iterator; + import it.eng.spagobi.engines.commonj.process.SpagoBIWork; + + public class CommandJob extends SpagoBIWork { + @Override + public boolean isDaemon() { + return true; + } + + @Override + public void release() { + System.out.println("Release!!"); + super.release(); + } + + @Override public void run() { + super.run(); + System.out.println("Job started! "); + java.util.Map parameters = getSbiParameters(); + for (Iterator iterator = parameters.keySet().iterator(); iterator.hasNext();) { + String type = (String) iterator.next(); + Object o = parameters.get(type); + System.out.println("Parameter " + type + " value" + o.toString()); + } + for(int i = 0; i < 50 && isRunning(); i++) { + System.out.println("job is running!"); + try { + Thread.sleep(2000); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } + System.out.println("Job finished!"); + } + } + + + Note that the class ``CmdExecWork`` extends ``SpagoBIWork`` by providing additional methods. To better understand the difference between the two options, let us have a look at some code snippets. Here you can see a class implemented as an extension of ``SpagoBIWork``: + + Note also that we only implement the ``run()`` method, embedding the logic of the process in it. Below you can see an example extension of ``CmdExecWork``, called ``CommandJob``: + +.. code-block:: java + :linenos: + :caption: Example extension of CmdExecWork. + + package it.eng.spagobi.job; + import it.eng.spagobi.engines.commonj.process.CmdExecWork; + import java.io.IOException; + public class CommandJob extends CmdExecWork{ + public boolean isDaemon() { + return true;} + public void release() { + super.release();} + public void run() { + super.run(); + if(isRunning()){ + try { + execCommand(); + } catch (InterruptedException e) { + } catch (IOException e) {}}}} + +Note that this class implements the ``execCommand()`` method and uses the ``isRunning()`` method. No logic is directly embedded in this class. +Therefore, we also define an external class, called ``ProcessTest``, which contains the actual logic (in our example printing the content of a file): + +.. code-block:: java + :linenos: + :caption: ProcessTest + + package it.eng.test; + import java.io.FileNotFoundException; + import java.io.FileOutputStream; + import java.io.PrintStream; + public class ProcessTest { + public static void main(String[] args) { + FileOutputStream file=null; + try { + file = new FileOutputStream("C:/file.txt"); + } catch (FileNotFoundException e) { + // TODO Auto-generated catch block + e.printStackTrace();} + PrintStream output = new PrintStream(file); + while (true){ + output.println("New row"); + output.flush(); + try { + Thread.currentThread().sleep(5000l); + } catch (InterruptedException e) { + // TODO Auto-generated catch block + e.printStackTrace(); + output.close();}}}} + +Now that classes are ready, we pack them in .jar file containing all classes and their paths. Then we copy the jar file under the resource folder of Knowage at ``RESOURCE_PATH]/commonj/ CommonjRepository/[JAR\\_NAME``. In the next section we will explain how to define the template, based on the class definition chosen above. + +Template definition +``` + +Al igual que con cualquier otro documento de Knowage, necesitamos definir una plantilla para un documento de proceso externo. En el ejemplo siguiente se muestra una plantilla que corresponde a las clases `CommandJob` y `ProcessTest` definido en los ejemplos anteriores. Observemos que esta plantilla corresponde a la opción de implementar una extensión de `CmdExecWork`. + +.. code-block:: xml +:linenos: +:caption: Definición de plantilla + + + + + + + + + + + + + +Dónde: + +* `` es la etiqueta principal e incluye todo el documento. +* La etiqueta `` especifica el proceso. En particular: + + * `workName` es el identificador del proceso + * `className` contiene el nombre de la clase que implementa el proceso (como se definió anteriormente). +* La etiqueta `` contiene todos los parámetros. Cada `` incluye un parámetro. Algunos de ellos son obligatorios + +.. tabla:: Parámetros de la plantilla de documento CommonJ. +:widths: automático + + +-----------------------------------+-----------------------------------+ + | Parameter | Value | + +===================================+===================================+ + | cmd | Specifies the java command that | + | | will be launched, with its | + | | complete path | + +-----------------------------------+-----------------------------------+ + | classpath | Specifies the classpath | + | | containing the jar file. This | + | | path will be added to the | + | | classpath for the process to run | + | | correctly. | + +-----------------------------------+-----------------------------------+ + | cmd_par | Optional. In case it is defined, | + | | its value contains the Java class | + | | that will be launched instead of | + | | the job (i.e., the extension of | + | | CmdWorkExec or KnowageWork). | + +-----------------------------------+-----------------------------------+ + | sbi_analytical_driver | Optional and repeatable. Each line| + | | with this attribute defines an | + | | analytical driver that should be | + | | associated with the process. | + +-----------------------------------+-----------------------------------+ + +La clase `CmdExecWork` (y sus extensiones) permite la ejecución del comando especificado en la plantilla. En particular, la plantilla anterior produciría el siguiente comando en tiempo de ejecución: + +.. code-block:: bash +:linenos: +:caption: Línea de comandos en tiempo de ejecución + + C:/Programmi/Java/jdk1.5.0_16/bin/java 'it.eng.test.ProcessTest' update={val} level={val} diff --git a/administrator-guide/scheduler.es.rst b/administrator-guide/scheduler.es.rst new file mode 100644 index 00000000..b0e3ba87 --- /dev/null +++ b/administrator-guide/scheduler.es.rst @@ -0,0 +1,339 @@ +# Programador + +Knowage scheduler permite programar la ejecución de uno o más documentos analíticos publicados en el Servidor. Los documentos ejecutados por el programador se pueden distribuir a lo largo de diferentes canales de despacho. A continuación describimos cómo crear una actividad, programarla y despachar los resultados. + +## Crear una actividad + +Para definir una nueva actividad programada, el administrador debe especificar qué documentos componen la actividad y cómo ejecutarlos. La lista de todas las actividades programadas se puede ver seleccionando **Herramientas** > **Programador**. Para crear una nueva actividad, haga clic en el icono "Más" en la parte superior de la página en el área izquierda. En la siguiente figura puede ver la página principal del programador y la nueva GUI de actividad. + +.. figura:: media/image4041.PNG + +Izquierda: página principal del programador. Derecha: Nueva GUI de actividad + +Asigne un nombre y una descripción a la nueva actividad. Luego seleccione los documentos que lo componen haciendo clic en el icono "Más" y seleccionándolos del asistente emergente, consulte la Figura a continuación. + +.. figura:: media/image42.png + +Agregar un documento a una actividad. + +Ahora debe especificar cómo el programador debe manejar los controladores analíticos de cada documento seleccionado que tenga parámetros. + +.. \_manageparameters: +.. figura:: media/image43.png + +Administrar parámetros. + +Hay dos posibilidades: + +* seleccionar un valor de los disponibles para el controlador analítico específico en el momento de la definición; +* ejecutando el informe una vez para cada posible valor del controlador analítico. + +Una actividad programada puede estar compuesta por más de un informe. También es posible añadir el mismo informe a una actividad programada más veces. Puede utilizar el icono |image50| para duplicar fácilmente un documento. Una vez que se hayan agregado todos los documentos deseados y se haya configurado la configuración de administración de sus parámetros, guarde la actividad haciendo clic en el botón Guardar. La nueva actividad se muestra en la lista y se puede modificar o eliminar utilizando los iconos específicos previstos. + +.. |image50| imagen:: media/image44.png +:ancho: 30 + +Puede administrar su actividad en cualquier momento simplemente haciendo clic en el nombre del elemento de programación (lado izquierdo de la ventana) y todas sus características se mostrarán a un lado (mitad derecha de la ventana). + +Para ver y modificar la lista de los horarios asociados a una actividad, haga clic en el icono "Más" que se encuentra en el área de schedulation en la parte inferior derecha. Del mismo modo, haga clic en el mismo botón para asociar horarios +a actividades de nueva creación. + +Se abren los detalles de la schedulación (Figura a continuación). + +.. figura:: media/image45.png + + Schedulation detail panel. + +Está compuesto por dos áreas: **Detalle** y **Gestión de documentos**. +La pestaña de detalles le permite establecer todas las propiedades de su schedulation. De hecho, aquí usted decide su nombre, descripción y momento. +Se puede hacer una schedulation en una fecha y hora elegidas si usted elige **Ejecución única** como tipo. +De lo contrario, se puede realizar por períodos fijos o comenzar en un evento fijo. + +Puede decidirlo, eligiendo el tipo de schedulation. + +Los tipos de schedulation disponibles son: + +* Ejecución única; +* Ejecución personalizada; +* Ejecución de eventos. + +Un **Ejecución única** es una ejecución fija para una fecha y una hora que ocurre solo una vez. Un **Ejecución personalizada** repite su programación periódicamente de acuerdo con su configuración. El **Ejecución de eventos** inicia la programación cuando ocurre un evento. + +Puede elegir entre estos tipos de eventos: + +* Servicio REST, +* Cola JMS, +* Mensaje de ContextBroker, +* Verificación de conjuntos de datos. + +Si eliges **Verificación del conjunto de datos**, debe seleccionar un conjunto de datos estructurado a la derecha. Tiene que dar como resultados sólo verdadero o falso. A continuación, establezca la frecuencia en segundos. Esta es la frecuencia con la que se verificará el conjunto de datos. Por ejemplo, si lo establece en 10 segundos, significa que cada 10 segundos se ejecuta el conjunto de datos. Si el resultado de su ejecución es verdadero, la schedulation se triza de lo contrario no lo es. + +Una vez que haya terminado, cambie al **Gestión Documental** pestaña. + +.. figura:: media/image46.png + + Document management. + +Aquí puede encontrar las configuraciones de despacho, que pueden ser diferentes para todos los documentos que componen la actividad programada. Todos los documentos que componen la actividad tienen su propia configuración de despacho y el mismo documento se puede distribuir a lo largo de múltiples canales de despacho. Puede cambiar entre los documentos incluidos en su actividad haciendo clic en su nombre en la barra de herramientas superior. Hay muchos canales de despacho posibles diferentes que se pueden utilizar para distribuir los resultados de la ejecución de una actividad programada: + +* Guardar como instantánea, +* Guardar como archivo, +* Guardar como documento, +* Enviar a la clase Java, +* Enviar correo + +En los siguientes apartados los explicamos en detalle. + +Guardar como instantánea + +``` + +The executed document can be saved as snapshots in cyclic buffers of configurable size. For example, it is possible to store in the buffer the last 12 snapshots (the **History Length** field) of one report, scheduled to be executed one per month, in order to have a one-year long history. + +The list of all snapshots contained in the buffer can be accessed from the **Show scheduled executions** contained in the **Shortcuts** menu. You can find it in the document toolbar at the top right corner. Each snapshot can be opened or deleted from this panel. These steps are shown in the following figure. A snapshot contains data queried from the database at the moment of its execution performed by the scheduler. + +.. figure:: media/image47.png + + Steps to open saved snapshots + +Save as file +~~~~~~~~~~~~ + +The executed document can be saved as file on the filesystem in the path /knowage- /resources (if no destination folder is specified). Otherwise, you can create the relative path of this subfolder by writing your subfolder name. For instance, if you write “MyFirstScheduler” as file name and “Schedulation” as destination folder, after the schedulation execution a subfolder Schedulation containing the file “MyFirstScheduler” is created in /knowage- /resources. If the subfolder Schedulation already exist your file is added to this subfolder. You can have a look at the form in Figure below. + +.. figure:: media/image51.png + + Save as File form. + +If you prefer to generate a .zip file containing the scheduled documents, you can check the dedicated mark. + +Save as document +``` + +El documento ejecutado se puede guardar como un **Informes ad hoc** en el árbol de funcionalidades de Knowage. La ejecución del documento se guardará en la carpeta especificada y será visible para todos los que puedan acceder a esa carpeta en particular. Para aquellos documentos cuya ejecución se repite sobre un valor de parámetro, también es posible utilizar el valor del parámetro para decidir a qué carpeta se enviará el documento. Para ello, defina un conjunto de datos de asignación compuesto por dos columnas: + +* el primero contiene un valor de parámetro específico; +* el segundo que contenga la etiqueta de la carpeta donde se expedirá el documento cuando se ejecute el documento con el valor de parámetro correspondiente. + +Una vez que haya definido el conjunto de datos de asignación, puede usarlo en las opciones de configuración del despachador de documentos. Al igual que en el caso anterior, el programador ejecutará el informe una vez para cada valor posible del parámetro. Esta vez, sin embargo, los resultados de la ejecución se distribuirán en diferentes carpetas, de acuerdo con la asignación definida en el conjunto de datos. + +Enviar a la clase Java + +``` + +The executed document can be sent to a Java class implementing a custom dispatch logic. The custom class must extend the abstract class JavaClassDestination that implements the method execute. This method is called by the scheduler after document execution. Below an example of Java class. + +.. code-block:: java + :linenos: + :caption: Java Class Code Example. + + package it.eng.spagobi.tools; + import it.eng.spagobi.analiticalmodel.document.bo.BIObject + public abstract class JavaClassDestination + implements IJavaClassDestination { + BIObject biObj=null; + byte[] documentByte=null; + public abstract void execute(); + public byte[] getDocumentByte() { + return documentByte; + } public void setDocumentByte(byte[] documentByte) { + this.documentByte = documentByte; + } + public BIObject getBiObj() { + return biObj; + } + public void setBiObj(BIObject biObj) { + this.biObj = biObj; + } + } + + +The method getDocumentByte can be used to get the executed document, while the method getBiObj can be used to get all metadata related to the executed document. The following code snippet shows an example of a possible extension of class JavaClassDestination. + +.. code-block:: java + :linenos: + :caption: JavaClassDestination example. + + public class FileDestination extends JavaClassDestination { + public static final String OUTPUT_FILE_DIR = "D:\\ScheduledRpts\\"; + public static final String OUTPUT_FILE_NAME = "output.dat"; + private static transient Logger logger = Logger.getLogger(FileDestination.class); + public void execute() { + File outputDir; + File outputFile; + OutputStream out; + byte[] content = this.getDocumentByte(); + String outputFileName; + logger.debug("IN"); + outputFile = null; + out = null; + try { + outputFileName = getFileName(); + logger.debug("Output dir [" + OUTPUT_FILE_DIR + "]"); + logger.debug("Output filename [" + outputFileName + "]"); + outputDir = new File(OUTPUT_FILE_DIR); + outputFile = new File(outputDir, outputFileName); + if(!outputDir.exists()) { + logger.debug("Creating output dir [" + OUTPUT_FILE_DIR + "] ..."); + if(outputDir.mkdirs()) { + logger.debug("Output dir [" + OUTPUT_FILE_DIR + "] succesfully created"); + } else { + throw new SpagoBIRuntimeException( "Impossible to create outputd dir + [" + OUTPUT_FILE_DIR + "]"); + } + } else { + if(!outputDir.isDirectory()) { + throw new SpagoBIRuntimeException( "Outputd dir [" + OUTPUT_FILE_DIR + "] + is not a valid directory"); + } + } + try { + out = new BufferedOutputStream( new FileOutputStream(outputFile)); + } catch (FileNotFoundException e) { + throw new SpagoBIRuntimeException( + "Impossible to open a byte stream to file + [" + outputFile.getName() + "]", e); + } try { + out.write(content); + } catch (IOException e) { + throw new SpagoBIRuntimeException( "Impossible to write on file + [" + outputFile.getName() + "]", e); + } + } catch(Throwable t) { + throw new SpagoBIRuntimeException( "An unexpected error occurs while saving + document" + " to file [" + outputFile.getName() + "]", t); + } finally { + if(out != null) { + try { + out.flush(); out.close(); + } catch (IOException e) { + throw new SpagoBIRuntimeException( "Impossible to properly close file + [" + outputFile.getName() + "]", e); + } + } + logger.debug("OUT"); + } + } + private String getFileName() { + String filename = ""; + BIObject analyticalDoc; + List analyticalDrivers; + BIObjectParameter analyticalDriver; + String extension = "pdf"; + analyticalDoc = getBiObj(); + analyticalDrivers = analyticalDoc.getBiObjectParameters(); + for(int i = 0; i < analyticalDrivers.size(); i++) { + analyticalDriver = (BIObjectParameter)analyticalDrivers.get(i); + String parameterUrlName = analyticalDriver.getParameterUrlName(); + List values = analyticalDriver.getParameterValues(); + if(!parameterUrlName.equalsIgnoreCase("outputType")){ + filename += values.get(0); + } else { + extension = "" + values.get(0); + } + } + filename = filename.replaceAll("[^a-zA-Z0-9]", "_"); + filename += "." + extension; + return filename; + } + } + +The class FileDestination copies the executed documents to the local filesystem in a folder named D:\\textbackslashScheduledRpts . The name of the report file is generated concatenating all the parameter values used by the scheduler during execution. Once implemented and properly compiled, the Java class must be exposed to the classpath of Knowage web application. For example, you can pack the compiled class into a .jar file, copy it into the lib folder of Knowage web application and restart the server. As a last step, it is necessary to assign the fully qualified name of the new class, e.g., it.eng.spagobi.tools.DestinationFile., to the configuration property classpath. + +Send mail +~~~~~~~~~ + +.. important:: + **Enterprise Edition only** + + This feature is available only with KnowageER and KnowageSI, submodules of Knowage Enterprise Edition + +The executed document can be sent to one or more mail recipients. The list of mail addresses to be used to forward the executed document can be defined in three different ways: + +- statically; +- dynamically, using a mapping dataset; +- dynamically, using a script. + +In Figure below you can have a look at the mail form. In the following we will focus on each typology, clicking on the info icon you get detailed information. + +.. figure:: media/image52.png + + Sending mail form. + +Static list +^^^^^^^^^^^^ + +If you want to choose a static list, check the option **Fixed list of recipients** and fill the configuration property **Mail to** with the list of desired mail addresses separated by a comma. An mail for each executed document will be sent to all the mail addresses contained in the list. + +Dynamic list with mapping dataset +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +In this case, you have to define a two-column dataset: + +- the first containing a specific parameter value; +- the second containing each mail address the executed document should be dispatched to. + + You can see an example of dataset in the following Figure. + +.. figure:: media/image54.png + +Example of mapping dataset for dynamic distribution list + +Basically, when the parameter has a given value, the document will be sent to the corresponding email address. Once you have defined the mapping dataset, you can use it in the configuration settings of the document dispatcher. With this configuration, the scheduler will execute the report one time for each possible value of the parameter **Position**, then dispatching the results to different recipients. Specifically, all execution results passing a value of the **Position** parameter to the report starting with VP will be sent to ``name1surname1@gmail.com``, the ones starting with HQ will sent to ``name2surname2@gmail.com`` and the ones starting with President will be sent to ``namesurname@gmail.com``. + +Dynamic List with script +^^^^^^^^^^^^^^^^^^^^^^^^ + +Check the option **Use an expression** and assign a value to the configuration property **Expression** with a parameter-dependent expression like the following: + +.. code-block:: bash + :linenos: + + $P{dealer}@eng.it + +Here dealer is a document parameter label (``$P{dealer}`` will be replaced by the parameter value of the scheduled execution). + +Schedulation panel +------------------ + +To conclude our overview on the scheduler features, save your settings and go back to the main scheduler page. + +Here you can select one of the available scheduled activities to explore details. + +.. figure:: media/image55a.png + + Exploring the detailed of a scheduled activity. + +A general overview of the selected schedulation is given in the right side of the page. You can inspect two tabs: **Overview activity** and **Detail**. In the Overview activity tab the main details of the schedulation are displayed summed up. Namely it is showed the documents involved, the related parameters and their eventually default values, what kind of scheduling has been chosen (Single Execution, Customized Execution or Event Exectution), the start date and so on. Note that at the end of the row you have the possibilities to explore more details by clicking on the “three dots” icon. + +Here you find the following information: + +- **Schedulation informations**, it give some extra information about your schedulation concerning sending emails + +- **Schedulation detail**, it opens the scheduling configuration and let you change them. + + .. figure:: media/image57.png + + Schedulation information pop up example + +- **Execute now**, by clicking it you immediately start the execution of your schedulation. +- **Pause schedulation**, it lets you pause your schedulation. +- **Resume schedulation**, it appears after having paused a schedulation, it enables you to resume it. +- **Delete Schedulation**, it lets you delete a schedulation. + +In the **Detail** tab you can analyze the settings on document, that is which parameters are associated to it and how to manage them. + +.. _scheduldettab: +.. figure:: media/image58.png + + Schedulation detail tab + +Scheduler Monitor +---------------------- + +You can monitor the whole scheduling situation by entering the **Scheduler Monitor** item from the Knowage Menu. This feature allows you to check which schedulations are active in a certain future time interval and, eventually, to be redirected to the schedulation area in order to modify the selected schedulation. + +.. figure:: media/image59.png + + Schedulation detail tab +``` diff --git a/administrator-guide/server-manager.es.rst b/administrator-guide/server-manager.es.rst new file mode 100644 index 00000000..fdd8b928 --- /dev/null +++ b/administrator-guide/server-manager.es.rst @@ -0,0 +1,379 @@ +# Administrador del servidor + +.. importante:: +**Solo Enterprise Edition** + + All the functionalities shipped within the Server Manager are available only with Knowage Enterprise Edition + +En **Administrador del servidor** en el panel de menú encontrará algunas funcionalidades de administración. + +.. figura:: medios/image60\_bis.png + + Server Manager Panel + +Aquellos sobre **Importación/Exportación** permite exportar algunas configuraciones o elementos de una instalación a otra. Esto puede ser útil, por ejemplo, en la gestión de una prueba y una zona de producción. Vamos a dar la descripción completa de estas funcionalidades a continuación. + +## Gestión de inquilinos + +Comenzamos esta sección subrayando que solo aquellos usuarios que tienen el rol de superadministrador pueden usar esta funcionalidad. **Gestión de inquilinos** solo está disponible para usuarios que posean la licencia de Knowage Enterprise Reporting (ER). Un **arrendatario** es generalmente un usuario que puede o no puede emplear tipos de productos específicos o acceder a algunas (o todas) las fuentes de datos dentro del mismo entorno. Luego, esta funcionalidad le permite crear nuevos inquilinos o administrar los antiguos. + +.. figura:: media/image61.png + + Tenants Management window. + +En la imagen de arriba, a la izquierda tiene la lista de inquilinos existentes. En la parte superior de dicha lista está disponible el **Buscar** para ayudar a los usuarios a explorar los inquilinos. Al hacer clic en el icono "Más", puede crear un nuevo inquilino. Se abre un formulario en el área derecha. Insertar un **Nombre** y un **Tema**. A continuación, cambie las pestañas para establecer el acceso a los tipos de producto y seleccione qué fuentes de datos se pueden lograr. + +.. figura:: media/image6465.PNG + + Product types tab (Left) Datasources tab (Right). + +Tenga en cuenta que, en un entorno de un solo inquilino, el administrador y el superadmin coinciden. En un entorno multiinquilino (desarrollado entonces a través de la funcionalidad del Administrador del servidor), solo *Uno* el usuario tiene el rol de superadministrador para cada inquilino, mientras que puede haber uno o más usuarios con el rol de administrador. En particular, en comparación con el caso de administración, la superadministración tiene la posibilidad de administrar el multi-tenancy. Además, es el único que puede configurar las fuentes de datos JNDI y acceder a la configuración de caché (a través del elemento de menú del administrador de caché). + +## Gestión de plantillas + +Cada documento de Knowage está asociado a un *plantilla*. La plantilla define el diseño estándar de un documento, incluyendo información específica sobre su apariencia y la forma en que se debe mostrar el contenido. Las plantillas se pueden codificar a mano o utilizando diseñadores de Knowage Studio, cuando estén disponibles. Para cada documento analítico se mantiene el historial de plantillas. Las plantillas antiguas se pueden restaurar si es necesario. Se guarda una nueva versión en cada implementación, ya sea manual o desde Knowage Studio. + +El **Gestión de plantillas** le permite elegir una fecha de inicio antes de la cual eliminar las versiones de las plantillas. Esto podría ser muy útil porque permite al administrador limpiar el entorno y ahorrar espacio en la base de datos de metadatos de Knowage una vez que se completa el ciclo de vida de un documento. + +En primer lugar, se le pide que inserte una fecha haciendo clic en el icono del calendario. Luego haga clic en el icono de la lupa y seleccione los documentos que le interesan. La lista que se muestra contiene sólo documentos creados antes de la fecha seleccionada. Al hacer clic en el icono de la papelera, se elimina la plantilla de los documentos seleccionados que se cargaron antes de la fecha elegida. Si todas las plantillas de un documento preceden a la fecha elegida, se conservará la última plantilla cargada, de modo que ningún documento se elimine accidentalmente. Resumimos los pasos descritos en la Figura a continuación. + +.. figura:: media/image66.png + + Deleting templates + +## Importación/Exportación + +Estas opciones son sobre Importación\Exportación de Galería, Documentos, Menú, Usuarios, KPI y Catálogos. Centrémonos en cada una de estas características. + +Galería + +``` + +This feature let you create and download a .zip of whole or a part of the functions and widgets gallery existing in your Knowage installation. In this way you can upload it in another installation or keep it as backup. + + +**Export Gallery** + +Below we show the export editor openable through the EXPORT button on the toolbar. Consists in two sections: Gallery and Functions. Both of them show a list with all widgets and functions existing within the Knowage installation. Details about Type and Tags/Keyword are given. + +.. figure:: media/impexp_gallery1.png + + Gallery Export + +You are able to select interested elements to export. Is it possible to choose a subset or all and/or a mix between widgets and functions: + +.. figure:: media/impexp_gallery2.png + + Gallery Export - Items selection + +After the selection, is just necessary set a name for the export file and the operation will done. + +.. figure:: media/impexp_gallery3.png + + Gallery Export - setting name for zip file + +**Import Gallery** + +To use the import functionality is necessary to select the IMPORT button on the toolbar. A new popup window is so opened to choose the exported zip file obtained previously: + +.. figure:: media/impexp_gallery4.png + + Gallery Import - Export file selection #1 + + +.. figure:: media/impexp_gallery5.png + + Gallery Import - Export file selection #2 + +At this point, selecting the NEXT button is possible review all elements available and choose which of them you want really import in the target Knowage environment: + +.. figure:: media/impexp_gallery6.png + + Gallery Import - items selection + + +For last, is necessary click on the IMPORT button to start the real import activity. + +At this point, widgets and functions will be available too in the target environment as you can see directly opening their specific guis: + +.. figure:: media/impexp_gallery7.png + + Gallery Management Gui +.. figure:: media/impexp_gallery8.png + + Functions Management Gui + + +Documents +``` + +Esta función le permite crear y descargar una .zip de la totalidad o una parte de los documentos existentes en su instalación de Knowage. De esta manera puedes subirlo en otra instalación o guardarlo como copia de seguridad. + +Al importar, se crean todos los "objetos" asociados a esos documentos (como conjuntos de datos, lovs, controladores, roles y carpetas). En cambio, los usuarios, las configuraciones de menú, KPI, catálogo, glosario y alerta no se exportan con esta herramienta. + +Echemos un vistazo a los pasos para crear el .zip. + +A continuación mostramos el editor de exportación. + +.. figura:: media/image67.png + + Document Export + +En primer lugar, elija el nombre que desea dar a su exportación (es decir, si elige MyFirstExport, creará el `MyFirstExport.zip`). + +A continuación, seleccione los documentos que desea exportar. Puede examinar la carpeta haciendo clic en el icono de carpeta. Elija los elementos o carpetas que desea incluir marcando la casilla de verificación relacionada. Una verificación en una carpeta principal seleccionará / anulará automáticamente la selección de todas sus carpetas / hojas secundarias. + +Cuando haya elegido un nombre y seleccionado algunos documentos, el icono de exportación cambiará de color de gris a rosa. Esto significa que todos los elementos están configurados para comenzar a exportar. + +Antes de continuar decide si quieres exportar **Vista personalizada de Olap** y/o **Documentos programados** y/o **Traducción BIRT** y/o **Programar configuraciones** y/o **Documentar sólo en la funcionalidad seleccionada**. + +* **Vista personalizada de Olap** + Al comprobar esta propiedad, la exportación incluirá todas las vistas personalizadas guardadas en los documentos OLAP elegidos. Puede encontrar la Vista personalizada en el menú del documento OLAP y hacer clic en *Mostrar vista personalizada OLAP*. Vea la siguiente figura: + +.. figura:: media/OCW.PNG + + Olap customized view + +* **Documentos programados** + Comprobando esta propiedad, la exportación incluirá toda la ejecución programada guardada en los documentos elegidos. Puede encontrar la ejecución programada en el menú del documento y haciendo clic en *Mostrar ejecución programada*. Vea la siguiente figura: + +.. figura:: media/SDOC.png + + Scheduled documents + +* **Traducción BIRT** + Al comprobar esta propiedad, la exportación incluirá toda la traducción agregada a las funcionalidades de 'Localización' de las plantillas BIRT. +* **Programar configuraciones** + Comprobando esta propiedad la exportación incluirá toda la programación asociada a los documentos elegidos. Al final de la importación, debe tener la programación guardada en la sección Programador en el área Herramientas. +* **Exportar el documento sólo en la funcionalidad seleccionada** + Al comprobar esta propiedad, la exportación incluirá documentos solo si están dentro de una funcionalidad seleccionada. +* **Documentos relacionados** + Comprobando esta propiedad la exportación incluirá documentos enlazados por navegación cruzada a los seleccionados. + +Ahora está listo para hacer clic en el icono de exportación para generar y descargar el .zip. +Supongamos que desea cargar MyFirstExport.zip en otra instalación. Inicie sesión y muévase a **Administrador del servidor** > **Importar\Exportar documentos** área Cambie al **Importación** y haga clic en **Hojear** para acceder a sus carpetas personales. En la siguiente figura mostramos la interfaz de importación de documentos. + +.. figura:: media/image68.png + + Document Import + +Elija el .zip obtenido en el **Exportar** y haga clic en el icono de importación. Pocos pasos lo guían a través de la importación. +Se le pedirá que asigne de origen a destino: roles, motores, orígenes de datos y metadatos. + +.. figura:: media/image110.png + +Asistente para importación de documentos + +Si un rol no asigna ninguno de los existentes en el de destino, se creará. **Preste atención antes de iniciar la importación porque los metadatos de destino se sobrescribirán**: documentos, lov, controlador, etc. que tiene la misma etiqueta de los exportados tendrá metadatos sobrescritos al final del procedimiento de importación. Después de haber comprobado cuidadosamente, puede iniciar el procedimiento de importación haciendo clic en "*INICIAR IMPORTACIÓN*" + +*Faltan licencias* +Si una o más licencias no son válidas o faltan, durante el procedimiento de exportación se le informará con una alerta. Los documentos relacionados no se pueden exportar ni se exportarán. + +.. figura:: media/image113.png + +Exportación de documentos Licencias faltantes + +Las licencias también se comprueban durante el procedimiento de importación y, si faltan uno o más o no son válidos, no se importarán los documentos relacionados. Estos documentos se enumerarán en la última fase antes del inicio del procedimiento de importación y para cada uno se mostrará la licencia no válida o faltante. + +.. figura:: media/image114.png + +Importación de documentos Licencias faltantes + +Menú + +``` + +This feature let you export the menu structure. + +.. figure:: media/image71.png + + Menu Export + +To start the export you need only to insert the Export name. Once inserted the name, the export icon changes color from grey to pink to let you understand all mandatory fields to start the export were filled. Click on this icon and the related .zip is downloaded. + +To upload it in another installation, accede to the **Import\\Export** Menu area and switch to the tab **import**. Here click on **Browse** to search in your folders the .zip previously created, see the following Figure. + +.. figure:: media/image72.png + + Menu Import + +After clicking on "*START IMPORT*" menu items which match with existing ones will be override by the exported ones and menu items which don’t match with the existing ones will be added. You are asked to map roles from source to target. If a role doesn’t map any of the existing in the target one, it will be created. + +.. figure:: media/image111.png + + Menu Import Wizard + +In the first step of import procedure you'll see source-target comparison. In particular source tree contains menu that are in the package you are importing and target tree contains the menu already present in the target system. + +.. figure:: media/image112.png + + Menu Import Wizard Tree comparison + +Users +``` + +En esta área puede exportar los usuarios de una instalación a otra, consulte la siguiente figura. + +.. figura:: media/image73.png + + User Export + +Para generar el .zip hay que marcar el usuario a incluir en la exportación e insertar un nombre de exportación. Guarde la exportación en las carpetas de su PC y muévase a la otra instalación. Tiene la oportunidad de incluir la carpeta personal de los usuarios elegidos en la Exportación. Poner una marca en el **Exportar carpeta personal** y elija si desea incluir instantáneas y subvistas también. + +Para importar el .zip en otra instalación, inicie sesión y abra el **Administrador del servidor** > **Importar\Exportar usuarios**, cambiar a **Importación** área. Aquí haga clic en **Hojear** para elegir el .zip creado por exportación. Luego haga clic en el icono de importación. Los usuarios contenidos en el archivo se cargan y los catálogos se muestran en el lado izquierdo de la pantalla. Elige entre los usuarios que se muestran el que quieres importar, márcalos y haz clic en la flecha para moverlos por el otro lado. Ahora haga clic en **Iniciar importación** y los usuarios también se crean correctamente en esta instalación. Preste atención al marcar la casilla de verificación carpeta personal si desea que se importen carpetas personales. En la siguiente figura puedes ver **Importación de usuarios** interfaz. + +.. figura:: media/image74.png + + User Import + +.. importante:: + + All users involved into import procedure will have his password changed with the value set in advanced configuration. + +Catálogos + +``` + +In this area you can export the different catalogs (such as datasets catalogs, business models catalogs and so on) from one installation to another, see the following Figure. + +.. figure:: media/image75.png + + Catalogs Export + +To generate the .zip you have to mark the elements to include in the export and insert an export name. Save the export somewhere in your local system and move to the other installation. You have the chance to include the personal folder of the chosen users in the Export. Put a mark in the **Export Personal folder** checkbox and choose if you want to include snapshots and subviews too. + +To import the .zip in another instance, log in and open the **Server Manager** > **Import\\ Export Catalogs**, switching to **Import** area. Here click **Browse** to choose the .zip created through exportation. Uploading the file, the available exported catalogs are displayed in the bottom area. Selecting a catalogs (for instance, the **Dataset** one), all the catalogs exported elements are displayed in the left side of the screen. Choose the ones that you want to import, decide if you want to override or to just add the missing ones and then click **Start import**. Your catalogs are successfully created in this environment. In Figure below you can see **User Import** interface. + +.. figure:: media/image76.png + + Catalogs Import + +KPIs +~~~~ + +In this section we describe how to manage the import/export of KPIs between two tenants. + +The user must enter Knowage as administrator of source tenant and click on **Import/Export KPIs** from Server Manager menu panel. + +.. figure:: media/image77.png + + KPIs Import/Export from menu + +The page contains the **Export** and the **Import** tab, where the user can select the KPIs for the export/import respectively. + +.. figure:: media/image78.png + + KPIs Import window + +Let’s start from the export feature. The user must check the KPIs for the export using the tab interface. He/she can add some more functionalities to the export action, namely: + +- to include targets, +- to include those scorecards related to the selected KPIs, +- to include schedulations. + +Finally click on the red download button to get a zipped folder that will be used to conclude the export. + +.. figure:: media/image79.png + + Start export button + +Once the .zip file is downloaded, the user has to switch tenant (the one on which he/she wants to do the import). As admin of the destination tenant, enter the Import/Export KPIs functionality and move to the Import tab. + +The user must therefore browse the personal folder to catch the zipped folder and click on the red upload button just aside, as shown in the following figure. + +.. figure:: media/image82.png + + Import tab + +Referring to the following image, the user has to specify if: + +- to overwrite the existing KPIs and their related formulas +- to import targets, +- to import scorecards, +- to import schedulations. + +.. figure:: media/image83.png + + Import KPIs settings + +Once the import is started, the GUI leads the user to finalize the import procedure. In particular, the user is asked to map data sources correctly (Figure below). + +.. figure:: media/image84.png + + Mapping data sources + +The process ends successfully when the wizard shows up as following. + +.. figure:: media/image85.png + + Import KPIs ended successfully + +Analytical Drivers +``` + +Esta opción permite importar/exportar los controladores analíticos y su LOV relacionado. + +.. figura:: media/image86.png + + Import/Export of analytical drivers + +Como se muestra en la figura anterior, la ventana contiene la pestaña Exportar e Importar. Utilice la ficha Exportar para descargar el archivo de .zip que se utilizará en el proceso de importación. + +Para producir un archivo de este tipo, el usuario debe iniciar sesión como administrador del tentant de origen. Luego tiene que asignar un nombre a la exportación, verificar los controladores analíticos de interés y hacer clic en el botón rojo de descarga disponible en la esquina superior derecha de la página. Tenga en cuenta que es posible adelgazar la investigación de los controladores analíticos filtrando sus datos de creación. + +Cambie de inquilino e inicie sesión como administrador. Utilice la pestaña Importar para cargar la carpeta comprimida y finalizar la importación. + +Utilice la GUI para cargar la carpeta comprimida, para especificar si desea sobrescribir en los controladores analíticos existentes o agregar los que faltan. Luego haga clic en siguiente y continúe asignando roles entre inquilinos y fuentes de datos. + +.. figura:: media/image87.png + + Import of analytical drivers + +.. figura:: media/image88.png + + Import of analytical drivers + +.. figura:: media/image89.png + + Import of analytical drivers + +El proceso termina con un mensaje que contiene la información sobre la importación. + +Glosario + +``` + +The export/import of glossary allows the user to align glossaries among tenants. + +.. figure:: media/image90.png + + Export/Import of glossaries window + +There are the two tabs of Export and Import. The user is asked to select the glossaries to export and to type a name that will be assigned to the zipped folder. The user can help himself/herself by using the filter on data (of creation of the glossary). + +Once the user has got the zipped folder he/she must switch tenant and enter as its admin. Then select the import tab from the Export/Import main window. + +.. figure:: media/image91.png + + Import of glossaries + +The user must use the arrows to indicate the glossaries he/she wants to import in the target tenant. No further information are needed to end the process. Then the user has to enter the target tenant as administrator and use the import tab to finalize the import. + +Catalog +``` + +Esta funcionalidad permite Exportar/Importar los siguientes elementos + +* Conjuntos de datos, +* Modelos de negocio, +* Catálogos Mondrian, +* Capas +* Archivos SVG. + +Los pasos para realizar la Exportación/Importación son iguales a los vistos en las secciones anteriores. Es decir, el usuario tiene que entrar en el **Catálogo de importación/exportación** del panel de menús del Administrador del servidor. La ventana contendrá las pestañas Importar y Exportar. La ficha exportar se utiliza para producir la carpeta zip que se va a importar en el inquilino de interés. Tenga en cuenta que el usuario puede aplicar un filtro temporal para ayudarle a buscar elementos en la lista. + +.. figura:: media/image92.png + + Import of catalog + +La importación requiere que se cargue la carpeta comprimida, que se comprueben los elementos que se van a importar, que se asignen roles entre inquilinos y que se asignen orígenes de datos. diff --git a/administrator-guide/server-settings.es.rst b/administrator-guide/server-settings.es.rst new file mode 100644 index 00000000..c8390e58 --- /dev/null +++ b/administrator-guide/server-settings.es.rst @@ -0,0 +1,86 @@ +# Configuración del servidor + +En este capítulo describimos todas las funcionalidades disponibles en el panel Configuración del servidor del menú Administrador que se muestra a continuación. + +.. figura:: media/image93.png + +Panel de configuración del servidor. + +Editores similares le dan acceso a configuraciones y dominios. Vamos a proporcionar un ejemplo de ambos casos para que entiendas cómo funciona su gestión. Una visión general completa de la creación, edición y gestión de metadatos concluye este capítulo. + +## Gestión de la configuración + +Haciendo clic en el botón **Configuración del servidor** > **Gestión de la configuración**, puede administrar muchos elementos de configuración. Por ejemplo, aquí puede establecer el idioma predeterminado, así como la configuración de correo. Empieza a escribir `DEFAULT` en el formulario de búsqueda, como se muestra a continuación, para filtrar entre los artículos disponibles y encontrar lo que le interesa. + +.. figura:: media/image94.png + +Lista de categorías de configuración. + +Proporcionamos un ejemplo para que pueda comprender el uso de la interfaz. Supongamos que desea establecer el italiano como idioma predeterminado. Seleccione la fila con `SPAGOBI.LANGUAGE_SUPPORTED.LANGUAGE`. predeterminado como etiqueta y haga clic en el icono del lápiz al final de la fila para editar el elemento. Insertar `it,IT` como **Comprobación de valor** como clic **Salvar**. + +Puede ver los idiomas disponibles y su código (**Columna Comprobación de valor)** en la fila SPAGOBI. LANGUAGE_SUPPORTED. IDIOMAS. + + .. warning:: + **Warning** + + Knowage Server may take up to 1 minute to apply the configuration changes. + +## Gestión de dominios + +Haciendo clic en **Gestión de dominios** menú de elementos, puede administrar categorías. En la siguiente figura mostramos el editor de Gestión de Dominios. Puede agregar, por ejemplo, nuevas categorías para un modelo de negocio, para un conjunto de datos y para todos los dominios que puede ver en el **Columna de nombre de dominio**. + +.. figura:: media/image95.png + +Editor de gestión de dominios. + +Proporcionamos un ejemplo para describir cómo funciona. Supongamos que desea agregar una nueva categoría entre los conjuntos de datos, denominada "Costos". A continuación puedes ver las categorías ya existentes. + +.. figura:: media/image96.png + +Categorías de modelos de negocio ya existentes. + +Haga clic en el botón rojo más en la esquina superior derecha y, por defecto, se abrirá una nueva página con el formulario que debe completar. Un ejemplo se muestra en la figura a continuación. Rellene las columnas de la siguiente manera: + +.. figura:: media/image97.png + +Formulario a rellenar para crear una nueva categoría. + +* **Código de valor**: Costos +* **Valor name_image**: Costos +* **Código de dominio**: CATEGORY_TYPE +* **name_image de dominio**: Conjuntos de datos de costos +* **Descripción del valor**: Conjuntos de datos de costos + +Todos los valores excepto el **Código de dominio** a ti. estos últimos son obligatorios para una correcta configuración. Ahora haga clic en Guardar. Ha creado correctamente la nueva categoría de conjunto de datos. + +También puede modificar un dominio existente seleccionando su fila dedicada y haciendo clic en el botón de edición. + +## Menú Exportadores + +El menú Exportadores es la nueva característica de Knowage. Esta característica permite al administrador configurar los exportadores de los documentos. Al abrir este catálogo, en el lado izquierdo puede ver la lista de exportadores creados y si desea ver los detalles de uno de ellos o cambiarlo, puede hacerlo seleccionándolo en la lista. Puede agregar un nuevo exportador haciendo clic en un icono más. Vea la figura a continuación. + +.. figura:: media/image101.png + +Adición de un nuevo exportador. + +En el lado derecho del catálogo tiene dos menús desplegables donde puede elegir motor y exportador para vincularlo con el motor. Después de seleccionar el motor y el exportador, puede guardarlo haciendo clic en un botón Guardar en la esquina superior derecha. En la siguiente figura puede ver el ejemplo de creación de un nuevo exportador. + +.. figura:: media/image102.png + +Creación de un nuevo exportador. + +También tiene la posibilidad de cambiar el exportador existente y eliminarlo. + +## Metadatos + +Knowage ofrece la posibilidad de definir categorías de metadatos y luego darles un valor para cada documento analítico y para cada subobjeto. + +En la página de metadatos, que se muestra a continuación, puede ver la lista de metadatos existentes. Aquí también puede definir un nuevo metadato utilizando el botón dedicado. + +.. figura:: media/image98.png + +Lista de metadatos existentes. + +Para definir un nuevo metadato, asígnele un **Etiqueta**un **Nombre**un **Descripción** y un **Tipo**. El **Etiqueta** es un identificador único, el **Nombre** es lo que se mostrará al usuario final y el **Tipo** puede ser `SHORT TEXT` o `LONG TEXT`. + +Recordamos que la visibilidad de los metadatos es una de las autorizaciones que puede establecer al crear roles. Solo los usuarios asociados a roles que tienen esta autorización verán los metadatos. Además, para editar metadatos, los roles de usuario deben tener otra autorización llamada **Guardar metadatos**. diff --git a/administrator-guide/timespan.es.rst b/administrator-guide/timespan.es.rst new file mode 100644 index 00000000..1015166e --- /dev/null +++ b/administrator-guide/timespan.es.rst @@ -0,0 +1,33 @@ +# Intervalo de tiempo + +La mayoría de las veces un usuario técnico desarrolla una solución empresarial para el uso y consumo de un tercer usuario final no cualificado. En el concurso de la capacidad de autoservicio de Knowage, cuando los modelos de negocio están disponibles para permitir a los usuarios finales consultar datos, es posible organizar intervalos de tiempo o temporales para que los usuarios finales puedan usar esos períodos de tiempo para filtrar datos cuando se utiliza la interfaz QbE. + +## Crear un nuevo intervalo de tiempo + +La funcionalidad Timespan está disponible en la sección Catálogo del menú principal de Knowage. + +.. figura:: media/imageTS001.png + +Intervalo de tiempo + +Al hacer clic en el elemento de menú "Intervalo de tiempo", Knowage redirige al usuario a la lista de períodos, si alguno ya estaba configurado. Es posible abrir un intervalo de tiempo existente simplemente haciendo clic en el elemento de la lista, buscar uno usando el cuadro de búsqueda, eliminar un elemento o clonarlo. El botón de eliminación y clonación está disponible aparte del nombre del elemento de intervalo de tiempo. + +.. figura:: media/imageTS002.png + +Página de lista de intervalo de tiempo + +Para configurar un nuevo período, el usuario debe hacer clic en el icono rojo más en la esquina superior derecha del área de lista Timespan. Después de hacer clic en el botón, la mitad derecha de la página mostrará el formulario para completar toda la información necesaria. + +En particular, se solicita al usuario técnico que asigne un nombre al nuevo intervalo de tiempo, para especificar si se trata de un período de tiempo o de tipo temporal. Asociar una categoría para problemas de generación de perfiles y, finalmente, definir la hora de inicio y finalización o la fecha de inicio y finalización, si es un intervalo de tiempo o temporal respectivamente, como podemos ver en la Figura a continuación. + +.. figura:: media/imageTS003.png + +Tiempo y tipo temporal + +En ambos casos, el usuario técnico define el inicio y el final del intervalo y luego hace clic en el botón agregar para insertarlo. recuerde clcik en el botón Guardar para validar la configuración. Tenga en cuenta que es posible, para cada tipo, agregar más de un intervalo. + +.. figura:: media/imageTS004.png + +Agregar más de un intervalo temporal en un intervalo de tiempo + +Una vez definidos esos intervalos, se pueden usar dentro de la interfaz QbE para filtrar el tiempo o los atributos temporales. Para esta parte nos referimos al capítulo de Investigación Libre, en particular al párrafo Filtros. diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst new file mode 100644 index 00000000..49147ad7 --- /dev/null +++ b/administrator-guide/user-interface.es.rst @@ -0,0 +1,90 @@ +# Interfaz de usuario + +Este capítulo se centra en la interfaz de usuario de Knowage, proporcionando información detallada sobre el menú principal. + +## Menú principal + +El menú Knowage te da acceso a todas sus funcionalidades. De forma predeterminada, encontrará el botón de menú en la esquina inferior izquierda de la página de inicio, haga clic en él para abrir el menú. + +.. figura:: medios/image9\_bis.png + +Página principal + +Puede minimizarlo haciendo clic en el mismo icono principal. + +El menú principal de Knowage se divide en tres submenús: el menú de usuario, el menú de funcionalidades de BI y el de administrador. El panel izquierdo contiene el menú de usuario, que está contraído, y el menú de funcionalidades de BI, mientras que el menú de administrador está en el panel derecho. + +.. figura:: media/image10.png + +Menú + +El menú de usuario (ver más abajo) se identifica con el primer icono de la tabla anterior y una etiqueta que contiene su nombre de usuario. Al abrir el menú de usuario tienes los siguientes botones extra: + +* **Mis roles** Si el usuario está asociado a más de un rol, Knowage le solicita que especifique el predeterminado. Puede seleccionarlo al ejecutar un documento o inmediatamente después de la autenticación haciendo clic en este icono y eligiendo un rol predeterminado. +* **Idiomas** Para seleccionar el idioma del entorno de Knowage. +* **Accesibilidad** Para activar o desactivar el modo de accesibilidad. +* **Información** Para ver los detalles de la versión actual de Knowage. +* **Cerrar sesión** Para volver a la página de inicio de sesión. + +El menú de funcionalidades de BI consiste en un conjunto de iconos asociados con características básicas: + +* **Desarrollo de documentos** Esta es una funcionalidad estándar de Knowage Server. Le permite crear el documento analítico, así como acceder y ejecutarlos. +* **Área de trabajo** Desde esta sección se puede acceder a la **Modelos** y crear conjuntos de datos y federaciones. + +.. table:: Componentes de menú - Menú de funcionalidades de BI. +:widths: automático + +\+--------------------------------+-----------------------+-----------------------+ +| | de iconos Nombre | Descripción | +\+================================+=======================+=======================+ +| .. figura:: media/image16.png | | de desarrollo de documentos Creación y | de documentos +| | | acceso al archivo | +| | | Carpetas. | +\+--------------------------------+-----------------------+-----------------------+ +| .. figura:: media/image17.png | espacio de trabajo | Consulta el | de tu negocio +| | | modelos, navegación y | +| | | crear los conjuntos de datos. | +\+--------------------------------+-----------------------+-----------------------+ +| .. figura:: media/image103.png | Descargar | Abrir un cuadro de diálogo que | +| | | mostrar los | disponibles +| | | descarga asincrónica. | +\+--------------------------------+-----------------------+-----------------------+ + +El menú del administrador está dividido en subpaneles que mapean las diferentes áreas de gestión: + +* **Proveedores de datos** Aquí puede establecer y administrar orígenes de datos. +* **Gestión de perfiles** En este panel puede organizar la profanación de usuarios, autorizaciones y atributos, pero también organizar el modelo analítico. Significa que puede crear / administrar roles, usuarios y atributos, así como configurar el árbol de funcionalidades y el menú, es decir, la lista de enlaces de acceso rápido al documento analítico u otros recursos proporcionados a los usuarios. +* **Modelo de comportamiento** Aquí se gestiona todo el modelo de comportamiento, lo que significa crear controladores analíticos y lov. En esta área también puede acceder a la configuración de restricciones. +* **Catálogos** En esta área se gestionan diferentes catálogos, que pueden variar de un producto a otro: el **Modelo de Negocio** catálogos utilizados para QbE; el **Catálogos de capas** para la creación de documentos analíticos SIG, etc. +* **Herramientas** En esta área puede acceder a las diferentes opciones del programador. +* **Configuración del servidor** En este panel tiene acceso a todas las opciones de configuración de configuración del servidor, como la configuración o la administración de dominios. +* **Administrador del servidor** Este es un paquete opcional. Le da acceso a diferentes funcionalidades del servidor, como la gestión de plantillas y todas las funciones de importación / exportación. + +.. table:: Componentes del menú - Menú del administrador. +:widths: automático + +\+--------------------------------+-----------------------+------------------------+ +| | de iconos Nombre | Áreas de gestión | +\+================================+=======================+========================+ +| .. figura:: media/image18.png | Proveedores de datos | Configuración del origen de datos. | +\+--------------------------------+-----------------------+------------------------+ +| .. figura:: media/image19.png | | de perfil Atributos de perfil, | +| | Gestión | Roles, usuario y | de menú +| | | | de configuración +\+--------------------------------+-----------------------+------------------------+ +| .. figura:: media/image20.png | Modelo de comportamiento | Lovs, | analíticos +| | | | de controladores y restricciones +\+--------------------------------+-----------------------+------------------------+ +| .. figura:: media/image21.png | Catálogos | Modelos de Negocio y | +| | | Capas | +\+--------------------------------+-----------------------+------------------------+ +| .. figura:: media/image22.png | Herramientas | | del programador +\+--------------------------------+-----------------------+------------------------+ +| .. figura:: media/image23.png | Configuración del servidor | Propiedades de datos de usuario, | +| | | Configuración, | +| | | Dominios y metadatos | +\+--------------------------------+-----------------------+------------------------+ +| .. figura:: media/image24.png | Administrador del servidor | Administrador de plantillas y | +| | | | de Importación-Exportación +| | | opciones | +\+--------------------------------+-----------------------+------------------------+ From 3bf37384cb09ae895ac2a26136d427be975ef7ca Mon Sep 17 00:00:00 2001 From: felipe Date: Thu, 14 Jul 2022 15:17:54 -0500 Subject: [PATCH 02/24] Update analytical-model.es.rst --- administrator-guide/analytical-model.es.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/administrator-guide/analytical-model.es.rst b/administrator-guide/analytical-model.es.rst index cebe5c57..0d0084d5 100644 --- a/administrator-guide/analytical-model.es.rst +++ b/administrator-guide/analytical-model.es.rst @@ -23,7 +23,7 @@ Para crear una nueva carpeta, seleccione **Gestión de perfiles** > **Gestión d Una vez que seleccione **Insertar**, se abren los detalles de la funcionalidad. .. \_createnewfolder: -.. figura:: media/image34.png +.. figure:: media/image34.png Cree una nueva carpeta y asigne permisos. @@ -47,7 +47,7 @@ Knowage permite la definición de un menú para el usuario final. Este menú se Basta con hacer clic en el "Más" de la página Configuración del menú para agregar una nueva carpeta al **Árbol de menú**. Al seleccionar un nodo del árbol y hacer clic en el icono "Más", el usuario puede agregar una nueva carpeta como hija de la anterior. -.. figura:: media/image35.png +.. figure:: media/image35.png Acciones del árbol de menús. From 8f35a12b1def198568afb71e0f0569b54e312f38 Mon Sep 17 00:00:00 2001 From: felipe Date: Thu, 14 Jul 2022 15:18:34 -0500 Subject: [PATCH 03/24] Update behavioural-model.es.rst --- administrator-guide/behavioural-model.es.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/administrator-guide/behavioural-model.es.rst b/administrator-guide/behavioural-model.es.rst index d65114b3..d1f67869 100644 --- a/administrator-guide/behavioural-model.es.rst +++ b/administrator-guide/behavioural-model.es.rst @@ -87,7 +87,7 @@ Una vez que el usuario ha iniciado sesión, se carga su rol. Los roles se admini Alternativamente, haciendo clic en el icono que se muestra a continuación, puede seleccionar un rol predeterminado que se mantendrá válido hasta que cierre la sesión. -.. figura:: medios/image28\_bis.png +.. figure:: medios/image28\_bis.png Roles de usuario en Knowage. @@ -125,7 +125,7 @@ Además de los atributos de perfil creados por el administrador, de forma predet * **Idioma**: establecido con el idioma seleccionado por el usuario -.. figura:: media/image29.png +.. figure:: media/image29.png Gestión de atributos de perfil. @@ -137,7 +137,7 @@ El modelo de comportamiento debe construirse teniendo en cuenta la especificidad En el panel derecho hay tres pestañas. El **Detalle** permite al administrador definir el nombre y el tipo de rol (obligatorio). El tipo de rol regula la visibilidad de ese rol en función de los tipos ya descritos. También se puede agregar un código y una descripción, como se muestra a continuación. -.. figura:: media/image3031.png +.. figure:: media/image3031.png Gestión de roles. @@ -155,7 +155,7 @@ Puede crear nuevas categorías para modelos de negocio y conjuntos de datos medi Por último, pero no menos importante, el **Gestión de usuarios** incluye un panel izquierdo que permite al administrador crear y eliminar usuarios, y un panel derecho que le permite administrar los detalles, roles y atributos del usuario. -.. figura:: media/image32.png +.. figure:: media/image32.png Gestión de usuarios. @@ -164,7 +164,7 @@ Desbloqueo de usuario Si el usuario alcanza el número máximo de intentos de inicio de sesión fallidos (editable en configuraciones avanzadas), Será bloqueado por Knowage y se denegará el acceso. Al acceder a Knowage con un usuario que tiene privilegios de administración de usuarios, el usuario bloqueado se mostrará con una señal de advertencia roja y será posible desbloquearlo utilizando el botón "desbloquear usuario". Después de eso, el usuario podrá iniciar sesión con el último conjunto de credenciales. -.. figura:: media/image115.png +.. figure:: media/image115.png Users Management - Roles settings example @@ -177,7 +177,7 @@ Después de eso, si hay más de un rol asociado al usuario, puede elegir el rol El rol predeterminado es opcional: si no selecciona un rol predeterminado, en el momento del inicio de sesión se cargarán todos los roles disponibles para el usuario. Si selecciona un rol, en el momento del inicio de sesión será el rol de sesión seleccionado. -.. figura:: media/image100.png +.. figure:: media/image100.png Users Management - Roles settings example From 9d56c0a4448aef30cddc3522602c56be9719eeb3 Mon Sep 17 00:00:00 2001 From: felipe Date: Thu, 14 Jul 2022 15:19:50 -0500 Subject: [PATCH 04/24] Update behavioural-model.es.rst --- administrator-guide/behavioural-model.es.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/administrator-guide/behavioural-model.es.rst b/administrator-guide/behavioural-model.es.rst index d1f67869..245741d2 100644 --- a/administrator-guide/behavioural-model.es.rst +++ b/administrator-guide/behavioural-model.es.rst @@ -33,7 +33,7 @@ El *perfil* de un usuario consiste en un conjunto de propiedades llamadas atribu El *rol* de un usuario representa una categorización de un grupo de usuarios. Estos roles pueden corresponder a puestos específicos en la empresa, por ejemplo, "gerente general" o un "director de ventas", o a un puesto con respecto al proyecto de BI, por ejemplo, "administrador de datos" y "desarrollador de BI". Diferentes usuarios pueden tener el mismo rol, así como el mismo usuario puede tener múltiples roles. .. \_knowageroletype: -.. tabla:: Tipos de roles de knowage. +.. table:: Tipos de roles de knowage. :widths: automático +-----------------------+-----------------------+-----------------------+ @@ -79,7 +79,7 @@ Cuando un usuario inicia sesión en Knowage, su perfil se carga automáticamente La autenticación puede ser manejada internamente por Knowage o delegada a un sistema externo de inicio de sesión único (SSO). -.. indirecta:: +.. hint:: **Administración de autenticación**: La elección de manejar la autenticación internamente o delegarla en un sistema SSO externo generalmente depende de la presencia de un sistema de autenticación ya implementado. Si este es el caso, Knowage puede integrarse perfectamente con la infraestructura de autenticación existente. @@ -131,7 +131,7 @@ Gestión de atributos de perfil. Una vez definidos los atributos, el administrador del modelo puede definir roles, utilizando el **Gestión de roles** funcionalidad. La herramienta de administración de roles tiene dos caras: a la izquierda puede ver la lista de roles ya definidos. Al principio de un proyecto, solo se ven los roles predeterminados. Para agregar un nuevo rol, haga clic en el icono **Agregar** y desplazarse al panel derecho. Para eliminar un rol, simplemente haga clic en el botón **Borrar** al final de la fila del rol. -.. indirecta:: +.. hint:: **Gestión de roles**: El modelo de comportamiento debe construirse teniendo en cuenta la especificidad de cada organización y las necesidades del proyecto de BI. Por lo tanto, es una buena práctica definir roles específicos para el proyecto de BI y evitar usar solo roles técnicos de Knowage. From 771968899e56cc931bff2dbcf8658f512b84224b Mon Sep 17 00:00:00 2001 From: felipe Date: Thu, 14 Jul 2022 15:21:09 -0500 Subject: [PATCH 05/24] Update behavioural-model.es.rst --- administrator-guide/behavioural-model.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/behavioural-model.es.rst b/administrator-guide/behavioural-model.es.rst index 245741d2..e2dda0b1 100644 --- a/administrator-guide/behavioural-model.es.rst +++ b/administrator-guide/behavioural-model.es.rst @@ -34,7 +34,7 @@ El *rol* de un usuario representa una categorización de un grupo de usuarios. E .. \_knowageroletype: .. table:: Tipos de roles de knowage. -:widths: automático + :widths: auto +-----------------------+-----------------------+-----------------------+ | Role Type | Description | Standard User | From a95b746b3a67f626519a508fca663a97aab4186c Mon Sep 17 00:00:00 2001 From: felipe Date: Thu, 14 Jul 2022 15:23:04 -0500 Subject: [PATCH 06/24] Update behavioural-model.es.rst --- administrator-guide/behavioural-model.es.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/administrator-guide/behavioural-model.es.rst b/administrator-guide/behavioural-model.es.rst index e2dda0b1..bcc0afdd 100644 --- a/administrator-guide/behavioural-model.es.rst +++ b/administrator-guide/behavioural-model.es.rst @@ -79,15 +79,15 @@ Cuando un usuario inicia sesión en Knowage, su perfil se carga automáticamente La autenticación puede ser manejada internamente por Knowage o delegada a un sistema externo de inicio de sesión único (SSO). -.. hint:: -**Administración de autenticación**: -La elección de manejar la autenticación internamente o delegarla en un sistema SSO externo generalmente depende de la presencia de un sistema de autenticación ya implementado. Si este es el caso, Knowage puede integrarse perfectamente con la infraestructura de autenticación existente. + .. hint:: + **Authentication Management**: + La elección de manejar la autenticación internamente o delegarla en un sistema SSO externo generalmente depende de la presencia de un sistema de autenticación ya implementado. Si este es el caso, Knowage puede integrarse perfectamente con la infraestructura de autenticación existente. Una vez que el usuario ha iniciado sesión, se carga su rol. Los roles se administran internamente. En caso de que el usuario esté asociado con varios roles, se le pedirá que elija uno. Alternativamente, haciendo clic en el icono que se muestra a continuación, puede seleccionar un rol predeterminado que se mantendrá válido hasta que cierre la sesión. -.. figure:: medios/image28\_bis.png +.. figure:: media/image28_bis.png Roles de usuario en Knowage. From cfe2dae5e1d703cc5f0de887238f23acf1251cb8 Mon Sep 17 00:00:00 2001 From: felipe Date: Thu, 14 Jul 2022 15:24:56 -0500 Subject: [PATCH 07/24] Update configure-data-sources.es.rst --- administrator-guide/configure-data-sources.es.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/administrator-guide/configure-data-sources.es.rst b/administrator-guide/configure-data-sources.es.rst index 49f3e7d6..cea06f48 100644 --- a/administrator-guide/configure-data-sources.es.rst +++ b/administrator-guide/configure-data-sources.es.rst @@ -11,8 +11,8 @@ Knowage administra dos tipos de conexiones de origen de datos: * conexiones recuperadas como recursos JNDI, que son administrados por el servidor de aplicaciones en el que knowage está trabajando. Esto permite al servidor de aplicaciones optimizar el acceso a los datos (por ejemplo, definiendo grupos de conexiones) y, por lo tanto, son los preferidos. Aquí puede encontrar información sobre cómo crear un grupo de conexiones en Tomcat: https://tomcat.apache.org/tomcat-8.0-doc/jndi-datasource-examples-howto.html * conexiones JDBC directas, que son administradas directamente por Knowage; -.. importante:: -**Cómo crear JNDI de conexión en Tomcat** +.. important:: + **Cómo crear JNDI de conexión en Tomcat** - Create connection pool on ``TOMCAT_HOME/conf/server.xml`` - Add ResourceLink on context.xml @@ -21,11 +21,11 @@ Para agregar una nueva conexión, primero agregue el controlador JDBC relativo a Haciendo clic en el botón **Agregar** en la esquina superior derecha del panel izquierdo, se mostrará un formulario vacío a la derecha. -.. figura:: media/image25.png +.. figure:: media/image25.png Add a new data source -.. figura:: media/image26.png +.. figure:: media/image26.png Data source details. @@ -106,8 +106,8 @@ Una vez que haya completado el formulario, puede probar la nueva fuente de datos En esta sección describimos cómo puede conectar Knowage a diferentes fuentes de datos de Big Data. -.. importante:: -**Solo Enterprise Edition** +.. important:: + **Solo Enterprise Edition** Please note that these connections are available for products KnowageBD and KnowagePM only. From c31f1e5f1b875fdb84b61a4b7f4d4d04a3449cf5 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:38:57 -0500 Subject: [PATCH 08/24] Update user-interface.es.rst --- administrator-guide/user-interface.es.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst index 49147ad7..13bbaa50 100644 --- a/administrator-guide/user-interface.es.rst +++ b/administrator-guide/user-interface.es.rst @@ -6,7 +6,7 @@ Este capítulo se centra en la interfaz de usuario de Knowage, proporcionando in El menú Knowage te da acceso a todas sus funcionalidades. De forma predeterminada, encontrará el botón de menú en la esquina inferior izquierda de la página de inicio, haga clic en él para abrir el menú. -.. figura:: medios/image9\_bis.png +.. figure:: medios/image9\_bis.png Página principal @@ -14,7 +14,7 @@ Puede minimizarlo haciendo clic en el mismo icono principal. El menú principal de Knowage se divide en tres submenús: el menú de usuario, el menú de funcionalidades de BI y el de administrador. El panel izquierdo contiene el menú de usuario, que está contraído, y el menú de funcionalidades de BI, mientras que el menú de administrador está en el panel derecho. -.. figura:: media/image10.png +.. figure:: media/image10.png Menú @@ -32,7 +32,7 @@ El menú de funcionalidades de BI consiste en un conjunto de iconos asociados co * **Área de trabajo** Desde esta sección se puede acceder a la **Modelos** y crear conjuntos de datos y federaciones. .. table:: Componentes de menú - Menú de funcionalidades de BI. -:widths: automático +:widths: auto \+--------------------------------+-----------------------+-----------------------+ | | de iconos Nombre | Descripción | @@ -61,7 +61,7 @@ El menú del administrador está dividido en subpaneles que mapean las diferente * **Administrador del servidor** Este es un paquete opcional. Le da acceso a diferentes funcionalidades del servidor, como la gestión de plantillas y todas las funciones de importación / exportación. .. table:: Componentes del menú - Menú del administrador. -:widths: automático +:widths: automo \+--------------------------------+-----------------------+------------------------+ | | de iconos Nombre | Áreas de gestión | From bd5b15f9ef066fb76ded0332c4276a89d3b04fba Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:39:15 -0500 Subject: [PATCH 09/24] Update user-interface.es.rst --- administrator-guide/user-interface.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst index 13bbaa50..c38122c4 100644 --- a/administrator-guide/user-interface.es.rst +++ b/administrator-guide/user-interface.es.rst @@ -6,7 +6,7 @@ Este capítulo se centra en la interfaz de usuario de Knowage, proporcionando in El menú Knowage te da acceso a todas sus funcionalidades. De forma predeterminada, encontrará el botón de menú en la esquina inferior izquierda de la página de inicio, haga clic en él para abrir el menú. -.. figure:: medios/image9\_bis.png +.. figure:: medios/image9bis.png Página principal From 769505a42fa9c59d9091d98b31080c2a5ecfe02f Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:39:31 -0500 Subject: [PATCH 10/24] Update user-interface.es.rst --- administrator-guide/user-interface.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst index c38122c4..6146b248 100644 --- a/administrator-guide/user-interface.es.rst +++ b/administrator-guide/user-interface.es.rst @@ -6,7 +6,7 @@ Este capítulo se centra en la interfaz de usuario de Knowage, proporcionando in El menú Knowage te da acceso a todas sus funcionalidades. De forma predeterminada, encontrará el botón de menú en la esquina inferior izquierda de la página de inicio, haga clic en él para abrir el menú. -.. figure:: medios/image9bis.png +.. figure:: media/image9_bis.png Página principal From e678903bbb80e0d1d706df89e81165842375e424 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:41:18 -0500 Subject: [PATCH 11/24] Update user-interface.es.rst --- administrator-guide/user-interface.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst index 6146b248..e0414b5e 100644 --- a/administrator-guide/user-interface.es.rst +++ b/administrator-guide/user-interface.es.rst @@ -32,7 +32,7 @@ El menú de funcionalidades de BI consiste en un conjunto de iconos asociados co * **Área de trabajo** Desde esta sección se puede acceder a la **Modelos** y crear conjuntos de datos y federaciones. .. table:: Componentes de menú - Menú de funcionalidades de BI. -:widths: auto + :widths: auto \+--------------------------------+-----------------------+-----------------------+ | | de iconos Nombre | Descripción | From 94f2a7db414604b387e6961d7d0a373409018c38 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:41:52 -0500 Subject: [PATCH 12/24] Update user-interface.es.rst --- administrator-guide/user-interface.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst index e0414b5e..c7232d1f 100644 --- a/administrator-guide/user-interface.es.rst +++ b/administrator-guide/user-interface.es.rst @@ -32,7 +32,7 @@ El menú de funcionalidades de BI consiste en un conjunto de iconos asociados co * **Área de trabajo** Desde esta sección se puede acceder a la **Modelos** y crear conjuntos de datos y federaciones. .. table:: Componentes de menú - Menú de funcionalidades de BI. - :widths: auto + :widths: auto \+--------------------------------+-----------------------+-----------------------+ | | de iconos Nombre | Descripción | From d80178365f7280f26c3133dc4d7c9810155261ac Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:42:54 -0500 Subject: [PATCH 13/24] Update user-interface.es.rst --- administrator-guide/user-interface.es.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst index c7232d1f..0035a552 100644 --- a/administrator-guide/user-interface.es.rst +++ b/administrator-guide/user-interface.es.rst @@ -37,15 +37,15 @@ El menú de funcionalidades de BI consiste en un conjunto de iconos asociados co \+--------------------------------+-----------------------+-----------------------+ | | de iconos Nombre | Descripción | \+================================+=======================+=======================+ -| .. figura:: media/image16.png | | de desarrollo de documentos Creación y | de documentos +| .. figure:: media/image16.png | | de desarrollo de documentos Creación y | de documentos | | | acceso al archivo | | | | Carpetas. | \+--------------------------------+-----------------------+-----------------------+ -| .. figura:: media/image17.png | espacio de trabajo | Consulta el | de tu negocio +| .. figure:: media/image17.png | espacio de trabajo | Consulta el | de tu negocio | | | modelos, navegación y | | | | crear los conjuntos de datos. | \+--------------------------------+-----------------------+-----------------------+ -| .. figura:: media/image103.png | Descargar | Abrir un cuadro de diálogo que | +| .. figure:: media/image103.png | Descargar | Abrir un cuadro de diálogo que | | | | mostrar los | disponibles | | | descarga asincrónica. | \+--------------------------------+-----------------------+-----------------------+ @@ -66,25 +66,25 @@ El menú del administrador está dividido en subpaneles que mapean las diferente \+--------------------------------+-----------------------+------------------------+ | | de iconos Nombre | Áreas de gestión | \+================================+=======================+========================+ -| .. figura:: media/image18.png | Proveedores de datos | Configuración del origen de datos. | +| .. figure:: media/image18.png | Proveedores de datos | Configuración del origen de datos. | \+--------------------------------+-----------------------+------------------------+ -| .. figura:: media/image19.png | | de perfil Atributos de perfil, | +| .. figure:: media/image19.png | | de perfil Atributos de perfil, | | | Gestión | Roles, usuario y | de menú | | | | de configuración \+--------------------------------+-----------------------+------------------------+ -| .. figura:: media/image20.png | Modelo de comportamiento | Lovs, | analíticos +| .. figure:: media/image20.png | Modelo de comportamiento | Lovs, | analíticos | | | | de controladores y restricciones \+--------------------------------+-----------------------+------------------------+ -| .. figura:: media/image21.png | Catálogos | Modelos de Negocio y | +| .. figure:: media/image21.png | Catálogos | Modelos de Negocio y | | | | Capas | \+--------------------------------+-----------------------+------------------------+ -| .. figura:: media/image22.png | Herramientas | | del programador +| .. figure:: media/image22.png | Herramientas | | del programador \+--------------------------------+-----------------------+------------------------+ -| .. figura:: media/image23.png | Configuración del servidor | Propiedades de datos de usuario, | +| .. figure:: media/image23.png | Configuración del servidor | Propiedades de datos de usuario, | | | | Configuración, | | | | Dominios y metadatos | \+--------------------------------+-----------------------+------------------------+ -| .. figura:: media/image24.png | Administrador del servidor | Administrador de plantillas y | +| .. figure:: media/image24.png | Administrador del servidor | Administrador de plantillas y | | | | | de Importación-Exportación | | | opciones | \+--------------------------------+-----------------------+------------------------+ From cc1e7ba0da64c1b7dc654ae40ada8bd4f9741646 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:43:34 -0500 Subject: [PATCH 14/24] Update user-interface.es.rst --- administrator-guide/user-interface.es.rst | 88 +++++++++++------------ 1 file changed, 44 insertions(+), 44 deletions(-) diff --git a/administrator-guide/user-interface.es.rst b/administrator-guide/user-interface.es.rst index 0035a552..540c521e 100644 --- a/administrator-guide/user-interface.es.rst +++ b/administrator-guide/user-interface.es.rst @@ -31,24 +31,24 @@ El menú de funcionalidades de BI consiste en un conjunto de iconos asociados co * **Desarrollo de documentos** Esta es una funcionalidad estándar de Knowage Server. Le permite crear el documento analítico, así como acceder y ejecutarlos. * **Área de trabajo** Desde esta sección se puede acceder a la **Modelos** y crear conjuntos de datos y federaciones. -.. table:: Componentes de menú - Menú de funcionalidades de BI. +.. table:: Menu components - BI Functionalities Menu. :widths: auto -\+--------------------------------+-----------------------+-----------------------+ -| | de iconos Nombre | Descripción | -\+================================+=======================+=======================+ -| .. figure:: media/image16.png | | de desarrollo de documentos Creación y | de documentos -| | | acceso al archivo | -| | | Carpetas. | -\+--------------------------------+-----------------------+-----------------------+ -| .. figure:: media/image17.png | espacio de trabajo | Consulta el | de tu negocio -| | | modelos, navegación y | -| | | crear los conjuntos de datos. | -\+--------------------------------+-----------------------+-----------------------+ -| .. figure:: media/image103.png | Descargar | Abrir un cuadro de diálogo que | -| | | mostrar los | disponibles -| | | descarga asincrónica. | -\+--------------------------------+-----------------------+-----------------------+ + +--------------------------------+-----------------------+-----------------------+ + | Icon | Name | Description | + +================================+=======================+=======================+ + | .. figure:: media/image16.png | Documents development | Document creation and | + | | | acces to the archive | + | | | folders. | + +--------------------------------+-----------------------+-----------------------+ + | .. figure:: media/image17.png | Workspace | Inquiry your business | + | | | models, navigate and | + | | | create your datasets. | + +--------------------------------+-----------------------+-----------------------+ + | .. figure:: media/image103.png | Download | Open a dialog that | + | | | show the available | + | | | async download. | + +--------------------------------+-----------------------+-----------------------+ El menú del administrador está dividido en subpaneles que mapean las diferentes áreas de gestión: @@ -60,31 +60,31 @@ El menú del administrador está dividido en subpaneles que mapean las diferente * **Configuración del servidor** En este panel tiene acceso a todas las opciones de configuración de configuración del servidor, como la configuración o la administración de dominios. * **Administrador del servidor** Este es un paquete opcional. Le da acceso a diferentes funcionalidades del servidor, como la gestión de plantillas y todas las funciones de importación / exportación. -.. table:: Componentes del menú - Menú del administrador. -:widths: automo - -\+--------------------------------+-----------------------+------------------------+ -| | de iconos Nombre | Áreas de gestión | -\+================================+=======================+========================+ -| .. figure:: media/image18.png | Proveedores de datos | Configuración del origen de datos. | -\+--------------------------------+-----------------------+------------------------+ -| .. figure:: media/image19.png | | de perfil Atributos de perfil, | -| | Gestión | Roles, usuario y | de menú -| | | | de configuración -\+--------------------------------+-----------------------+------------------------+ -| .. figure:: media/image20.png | Modelo de comportamiento | Lovs, | analíticos -| | | | de controladores y restricciones -\+--------------------------------+-----------------------+------------------------+ -| .. figure:: media/image21.png | Catálogos | Modelos de Negocio y | -| | | Capas | -\+--------------------------------+-----------------------+------------------------+ -| .. figure:: media/image22.png | Herramientas | | del programador -\+--------------------------------+-----------------------+------------------------+ -| .. figure:: media/image23.png | Configuración del servidor | Propiedades de datos de usuario, | -| | | Configuración, | -| | | Dominios y metadatos | -\+--------------------------------+-----------------------+------------------------+ -| .. figure:: media/image24.png | Administrador del servidor | Administrador de plantillas y | -| | | | de Importación-Exportación -| | | opciones | -\+--------------------------------+-----------------------+------------------------+ +.. table:: Menu components - Administrator Menu. + :widths: auto + + +--------------------------------+-----------------------+------------------------+ + | Icon | Name | Management areas | + +================================+=======================+========================+ + | .. figure:: media/image18.png | Data Providers | Data source settings. | + +--------------------------------+-----------------------+------------------------+ + | .. figure:: media/image19.png | Profile | Profile Attributes, | + | | Management | Roles, User and Menu | + | | | configuration | + +--------------------------------+-----------------------+------------------------+ + | .. figure:: media/image20.png | Behavioural model | Lovs, Analytical | + | | | Driver and Constraints | + +--------------------------------+-----------------------+------------------------+ + | .. figure:: media/image21.png | Catalogs | Business Models and | + | | | Layers | + +--------------------------------+-----------------------+------------------------+ + | .. figure:: media/image22.png | Tools | Scheduler | + +--------------------------------+-----------------------+------------------------+ + | .. figure:: media/image23.png | Server Settings | User Data Properties, | + | | | Configuration, | + | | | Domains and Metadata | + +--------------------------------+-----------------------+------------------------+ + | .. figure:: media/image24.png | Server Manager | Template manager and | + | | | Import-Export | + | | | options | + +--------------------------------+-----------------------+------------------------+ From be906df4f5db9bbdbbc40b08a76f66aff37c8276 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:47:10 -0500 Subject: [PATCH 15/24] Update index.es.rst --- administrator-guide/index.es.rst | 154 ++++++++++++++++--------------- 1 file changed, 78 insertions(+), 76 deletions(-) diff --git a/administrator-guide/index.es.rst b/administrator-guide/index.es.rst index 3c5845eb..d77408ce 100644 --- a/administrator-guide/index.es.rst +++ b/administrator-guide/index.es.rst @@ -1,81 +1,83 @@ -Manual de administración -\######################### +Administration Manual +######################### .. toctree:: -:caption: Tabla de contenido + :caption: Table of Contents - knowage-at-a-glance.rst - user-interface.rst - configure-data-sources.rst - behavioural-model.rst - analytical-model.rst - operational-engines.rst - timespan.rst - scheduler.rst - server-manager.rst - server-settings.rst + knowage-at-a-glance.rst + user-interface.rst + configure-data-sources.rst + behavioural-model.rst + analytical-model.rst + operational-engines.rst + timespan.rst + scheduler.rst + server-manager.rst + server-settings.rst -.. |imagen11| imagen:: media/image11.png -:ancho: 0.27561in -:altura: 0.27561in -.. |imagen12| imagen:: media/image12.png -:ancho: 0.2756in -:altura: 0.2756in -.. |imagen13| imagen:: media/image13.png -:ancho: 0.2756in -:altura: 0.2756in -.. |imagen14| imagen:: media/image14.png -:ancho: 0.2756in -:altura: 0.27559in -.. |imagen15| imagen:: media/image15.png -:ancho: 0.2756in -:altura: 0.27559in -.. |imagen18| imagen:: media/image16.png -:ancho: 0.2756in -:altura: 0.2756in -.. |image19| imagen:: media/image17.png -:ancho: 0.2756in -:altura: 0.2756in -.. |image27| imagen:: media/image18.png -:ancho: 0.2756in -:altura: 0.2756in -.. |image28| imagen:: media/image19.png -:ancho: 0.2756in -:altura: 0.2756in -.. |image29| imagen:: media/image20.png -:ancho: 0.2756in -:altura: 0.27561in -.. |image30| imagen:: media/image21.png -:ancho: 0.27561in -:altura: 0.2756in -.. |image31| imagen:: media/image22.png -:ancho: 0.27561in -:altura: 0.27561in -.. |image32| imagen:: media/image23.png -:ancho: 0.2756in -:altura: 0.27561in -.. |image33| imagen:: media/image24.png -:ancho: 0.27559in -:altura: 0.2756in -.. |image50| imagen:: media/image44.png -:ancho: 0.39371in -:altura: 0.25131in +.. |image11| image:: media/image11.png + :width: 0.27561in + :height: 0.27561in +.. |image12| image:: media/image12.png + :width: 0.2756in + :height: 0.2756in +.. |image13| image:: media/image13.png + :width: 0.2756in + :height: 0.2756in +.. |image14| image:: media/image14.png + :width: 0.2756in + :height: 0.27559in +.. |image15| image:: media/image15.png + :width: 0.2756in + :height: 0.27559in +.. |image18| image:: media/image16.png + :width: 0.2756in + :height: 0.2756in +.. |image19| image:: media/image17.png + :width: 0.2756in + :height: 0.2756in +.. |image27| image:: media/image18.png + :width: 0.2756in + :height: 0.2756in +.. |image28| image:: media/image19.png + :width: 0.2756in + :height: 0.2756in +.. |image29| image:: media/image20.png + :width: 0.2756in + :height: 0.27561in +.. |image30| image:: media/image21.png + :width: 0.27561in + :height: 0.2756in +.. |image31| image:: media/image22.png + :width: 0.27561in + :height: 0.27561in +.. |image32| image:: media/image23.png + :width: 0.2756in + :height: 0.27561in +.. |image33| image:: media/image24.png + :width: 0.27559in + :height: 0.2756in +.. |image50| image:: media/image44.png + :width: 0.39371in + :height: 0.25131in + -.. |imagen0| imagen:: media/image1.png -:ancho: 8.25in -:altura: 10.97333in -.. |imagen1| imagen:: media/image2.png -:ancho: 5.0075in -:altura: 4.14184in -.. |imagen36| imagen:: media/image4.png -:ancho: 5.0075in -:altura: 1.41271in -.. |image39| imagen:: media/image4.png -:ancho: 5.0075in -:altura: 1.25635in -.. |imagen43| imagen:: media/image3.png -:ancho: 5.78738in -:altura: 1.58376in -.. |image93| imagen:: media/image99.png -:ancho: 8.25in -:altura: 8.28333in + +.. |image0| image:: media/image1.png + :width: 8.25in + :height: 10.97333in +.. |image1| image:: media/image2.png + :width: 5.0075in + :height: 4.14184in +.. |image36| image:: media/image4.png + :width: 5.0075in + :height: 1.41271in +.. |image39| image:: media/image4.png + :width: 5.0075in + :height: 1.25635in +.. |image43| image:: media/image3.png + :width: 5.78738in + :height: 1.58376in +.. |image93| image:: media/image99.png + :width: 8.25in + :height: 8.28333in From 977813269baa5a894d303e025133cb62d58e0fe0 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:48:01 -0500 Subject: [PATCH 16/24] Update knowage-at-a-glance.es.rst --- administrator-guide/knowage-at-a-glance.es.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/administrator-guide/knowage-at-a-glance.es.rst b/administrator-guide/knowage-at-a-glance.es.rst index dbbecd21..98c0f1e4 100644 --- a/administrator-guide/knowage-at-a-glance.es.rst +++ b/administrator-guide/knowage-at-a-glance.es.rst @@ -11,7 +11,7 @@ Knowage es la suite de inteligencia de negocios desarrollada y administrada por ## Módulos -.. figura:: media/image6.png +.. figure:: media/image6.png Módulos de conocimiento. @@ -37,7 +37,7 @@ Representa una solución de nivel empresarial para BI, soportando todo el ciclo La arquitectura de Knowage Server está funcionalmente en capas en tres niveles principales. -.. figura:: media/image7.png +.. figure:: media/image7.png Estructura de la arquitectura de Knowage Server. @@ -50,7 +50,7 @@ Regula la carga de datos a través de muchas estrategias de acceso. Cada capa de la arquitectura funcional se compone de diferentes módulos de aplicación. -.. figura:: media/image8.png +.. figure:: media/image8.png Detalle de la arquitectura de Knowage Server. From 57bc7ce0103d1429c8a90bb63f64c3d8c168afb8 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:49:46 -0500 Subject: [PATCH 17/24] Update scheduler.es.rst --- administrator-guide/scheduler.es.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/administrator-guide/scheduler.es.rst b/administrator-guide/scheduler.es.rst index b0e3ba87..42b58bd4 100644 --- a/administrator-guide/scheduler.es.rst +++ b/administrator-guide/scheduler.es.rst @@ -6,20 +6,20 @@ Knowage scheduler permite programar la ejecución de uno o más documentos anal Para definir una nueva actividad programada, el administrador debe especificar qué documentos componen la actividad y cómo ejecutarlos. La lista de todas las actividades programadas se puede ver seleccionando **Herramientas** > **Programador**. Para crear una nueva actividad, haga clic en el icono "Más" en la parte superior de la página en el área izquierda. En la siguiente figura puede ver la página principal del programador y la nueva GUI de actividad. -.. figura:: media/image4041.PNG +.. figure:: media/image4041.PNG Izquierda: página principal del programador. Derecha: Nueva GUI de actividad Asigne un nombre y una descripción a la nueva actividad. Luego seleccione los documentos que lo componen haciendo clic en el icono "Más" y seleccionándolos del asistente emergente, consulte la Figura a continuación. -.. figura:: media/image42.png +.. figure:: media/image42.png Agregar un documento a una actividad. Ahora debe especificar cómo el programador debe manejar los controladores analíticos de cada documento seleccionado que tenga parámetros. .. \_manageparameters: -.. figura:: media/image43.png +.. figure:: media/image43.png Administrar parámetros. @@ -30,8 +30,8 @@ Hay dos posibilidades: Una actividad programada puede estar compuesta por más de un informe. También es posible añadir el mismo informe a una actividad programada más veces. Puede utilizar el icono |image50| para duplicar fácilmente un documento. Una vez que se hayan agregado todos los documentos deseados y se haya configurado la configuración de administración de sus parámetros, guarde la actividad haciendo clic en el botón Guardar. La nueva actividad se muestra en la lista y se puede modificar o eliminar utilizando los iconos específicos previstos. -.. |image50| imagen:: media/image44.png -:ancho: 30 +.. |image50| image:: media/image44.png + :width: 30 Puede administrar su actividad en cualquier momento simplemente haciendo clic en el nombre del elemento de programación (lado izquierdo de la ventana) y todas sus características se mostrarán a un lado (mitad derecha de la ventana). @@ -40,7 +40,7 @@ a actividades de nueva creación. Se abren los detalles de la schedulación (Figura a continuación). -.. figura:: media/image45.png +.. figure:: media/image45.png Schedulation detail panel. @@ -70,7 +70,7 @@ Si eliges **Verificación del conjunto de datos**, debe seleccionar un conjunto Una vez que haya terminado, cambie al **Gestión Documental** pestaña. -.. figura:: media/image46.png +.. figure:: media/image46.png Document management. From ed88cee3a9eab60f13ad1f9d7ae6aef9bdcf991b Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:51:42 -0500 Subject: [PATCH 18/24] Update server-manager.es.rst --- administrator-guide/server-manager.es.rst | 36 +++++++++++------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/administrator-guide/server-manager.es.rst b/administrator-guide/server-manager.es.rst index fdd8b928..601be3a5 100644 --- a/administrator-guide/server-manager.es.rst +++ b/administrator-guide/server-manager.es.rst @@ -7,7 +7,7 @@ En **Administrador del servidor** en el panel de menú encontrará algunas funcionalidades de administración. -.. figura:: medios/image60\_bis.png +.. figure:: medios/image60\_bis.png Server Manager Panel @@ -17,13 +17,13 @@ Aquellos sobre **Importación/Exportación** permite exportar algunas configurac Comenzamos esta sección subrayando que solo aquellos usuarios que tienen el rol de superadministrador pueden usar esta funcionalidad. **Gestión de inquilinos** solo está disponible para usuarios que posean la licencia de Knowage Enterprise Reporting (ER). Un **arrendatario** es generalmente un usuario que puede o no puede emplear tipos de productos específicos o acceder a algunas (o todas) las fuentes de datos dentro del mismo entorno. Luego, esta funcionalidad le permite crear nuevos inquilinos o administrar los antiguos. -.. figura:: media/image61.png +.. figure:: media/image61.png Tenants Management window. En la imagen de arriba, a la izquierda tiene la lista de inquilinos existentes. En la parte superior de dicha lista está disponible el **Buscar** para ayudar a los usuarios a explorar los inquilinos. Al hacer clic en el icono "Más", puede crear un nuevo inquilino. Se abre un formulario en el área derecha. Insertar un **Nombre** y un **Tema**. A continuación, cambie las pestañas para establecer el acceso a los tipos de producto y seleccione qué fuentes de datos se pueden lograr. -.. figura:: media/image6465.PNG +.. figure:: media/image6465.PNG Product types tab (Left) Datasources tab (Right). @@ -37,7 +37,7 @@ El **Gestión de plantillas** le permite elegir una fecha de inicio antes de la En primer lugar, se le pide que inserte una fecha haciendo clic en el icono del calendario. Luego haga clic en el icono de la lupa y seleccione los documentos que le interesan. La lista que se muestra contiene sólo documentos creados antes de la fecha seleccionada. Al hacer clic en el icono de la papelera, se elimina la plantilla de los documentos seleccionados que se cargaron antes de la fecha elegida. Si todas las plantillas de un documento preceden a la fecha elegida, se conservará la última plantilla cargada, de modo que ningún documento se elimine accidentalmente. Resumimos los pasos descritos en la Figura a continuación. -.. figura:: media/image66.png +.. figure:: media/image66.png Deleting templates @@ -115,7 +115,7 @@ Echemos un vistazo a los pasos para crear el .zip. A continuación mostramos el editor de exportación. -.. figura:: media/image67.png +.. figure:: media/image67.png Document Export @@ -130,14 +130,14 @@ Antes de continuar decide si quieres exportar **Vista personalizada de Olap** y/ * **Vista personalizada de Olap** Al comprobar esta propiedad, la exportación incluirá todas las vistas personalizadas guardadas en los documentos OLAP elegidos. Puede encontrar la Vista personalizada en el menú del documento OLAP y hacer clic en *Mostrar vista personalizada OLAP*. Vea la siguiente figura: -.. figura:: media/OCW.PNG +.. figure:: media/OCW.PNG Olap customized view * **Documentos programados** Comprobando esta propiedad, la exportación incluirá toda la ejecución programada guardada en los documentos elegidos. Puede encontrar la ejecución programada en el menú del documento y haciendo clic en *Mostrar ejecución programada*. Vea la siguiente figura: -.. figura:: media/SDOC.png +.. figure:: media/SDOC.png Scheduled documents @@ -153,14 +153,14 @@ Antes de continuar decide si quieres exportar **Vista personalizada de Olap** y/ Ahora está listo para hacer clic en el icono de exportación para generar y descargar el .zip. Supongamos que desea cargar MyFirstExport.zip en otra instalación. Inicie sesión y muévase a **Administrador del servidor** > **Importar\Exportar documentos** área Cambie al **Importación** y haga clic en **Hojear** para acceder a sus carpetas personales. En la siguiente figura mostramos la interfaz de importación de documentos. -.. figura:: media/image68.png +.. figure:: media/image68.png Document Import Elija el .zip obtenido en el **Exportar** y haga clic en el icono de importación. Pocos pasos lo guían a través de la importación. Se le pedirá que asigne de origen a destino: roles, motores, orígenes de datos y metadatos. -.. figura:: media/image110.png +.. figure:: media/image110.png Asistente para importación de documentos @@ -169,13 +169,13 @@ Si un rol no asigna ninguno de los existentes en el de destino, se creará. **Pr *Faltan licencias* Si una o más licencias no son válidas o faltan, durante el procedimiento de exportación se le informará con una alerta. Los documentos relacionados no se pueden exportar ni se exportarán. -.. figura:: media/image113.png +.. figure:: media/image113.png Exportación de documentos Licencias faltantes Las licencias también se comprueban durante el procedimiento de importación y, si faltan uno o más o no son válidos, no se importarán los documentos relacionados. Estos documentos se enumerarán en la última fase antes del inicio del procedimiento de importación y para cada uno se mostrará la licencia no válida o faltante. -.. figura:: media/image114.png +.. figure:: media/image114.png Importación de documentos Licencias faltantes @@ -214,7 +214,7 @@ Users En esta área puede exportar los usuarios de una instalación a otra, consulte la siguiente figura. -.. figura:: media/image73.png +.. figure:: media/image73.png User Export @@ -222,7 +222,7 @@ Para generar el .zip hay que marcar el usuario a incluir en la exportación e in Para importar el .zip en otra instalación, inicie sesión y abra el **Administrador del servidor** > **Importar\Exportar usuarios**, cambiar a **Importación** área. Aquí haga clic en **Hojear** para elegir el .zip creado por exportación. Luego haga clic en el icono de importación. Los usuarios contenidos en el archivo se cargan y los catálogos se muestran en el lado izquierdo de la pantalla. Elige entre los usuarios que se muestran el que quieres importar, márcalos y haz clic en la flecha para moverlos por el otro lado. Ahora haga clic en **Iniciar importación** y los usuarios también se crean correctamente en esta instalación. Preste atención al marcar la casilla de verificación carpeta personal si desea que se importen carpetas personales. En la siguiente figura puedes ver **Importación de usuarios** interfaz. -.. figura:: media/image74.png +.. figure:: media/image74.png User Import @@ -313,7 +313,7 @@ Analytical Drivers Esta opción permite importar/exportar los controladores analíticos y su LOV relacionado. -.. figura:: media/image86.png +.. figure:: media/image86.png Import/Export of analytical drivers @@ -325,15 +325,15 @@ Cambie de inquilino e inicie sesión como administrador. Utilice la pestaña Imp Utilice la GUI para cargar la carpeta comprimida, para especificar si desea sobrescribir en los controladores analíticos existentes o agregar los que faltan. Luego haga clic en siguiente y continúe asignando roles entre inquilinos y fuentes de datos. -.. figura:: media/image87.png +.. figure:: media/image87.png Import of analytical drivers -.. figura:: media/image88.png +.. figure:: media/image88.png Import of analytical drivers -.. figura:: media/image89.png +.. figure:: media/image89.png Import of analytical drivers @@ -372,7 +372,7 @@ Esta funcionalidad permite Exportar/Importar los siguientes elementos Los pasos para realizar la Exportación/Importación son iguales a los vistos en las secciones anteriores. Es decir, el usuario tiene que entrar en el **Catálogo de importación/exportación** del panel de menús del Administrador del servidor. La ventana contendrá las pestañas Importar y Exportar. La ficha exportar se utiliza para producir la carpeta zip que se va a importar en el inquilino de interés. Tenga en cuenta que el usuario puede aplicar un filtro temporal para ayudarle a buscar elementos en la lista. -.. figura:: media/image92.png +.. figure:: media/image92.png Import of catalog From b98aa094c11a325352c0ea1979652be54fd22279 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:52:00 -0500 Subject: [PATCH 19/24] Update server-manager.es.rst --- administrator-guide/server-manager.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/server-manager.es.rst b/administrator-guide/server-manager.es.rst index 601be3a5..a3ef1bb0 100644 --- a/administrator-guide/server-manager.es.rst +++ b/administrator-guide/server-manager.es.rst @@ -7,7 +7,7 @@ En **Administrador del servidor** en el panel de menú encontrará algunas funcionalidades de administración. -.. figure:: medios/image60\_bis.png +.. figure:: medios/image60_bis.png Server Manager Panel From 1bd7f51b2d7f9c4feb1888aed1ff230c13613d80 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:52:20 -0500 Subject: [PATCH 20/24] Update server-manager.es.rst --- administrator-guide/server-manager.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/server-manager.es.rst b/administrator-guide/server-manager.es.rst index a3ef1bb0..c9c93979 100644 --- a/administrator-guide/server-manager.es.rst +++ b/administrator-guide/server-manager.es.rst @@ -7,7 +7,7 @@ En **Administrador del servidor** en el panel de menú encontrará algunas funcionalidades de administración. -.. figure:: medios/image60_bis.png +.. figure:: media/image60_bis.png Server Manager Panel From d0fe60c36dfcbccb7057b65b83a62b7008cfb103 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:52:42 -0500 Subject: [PATCH 21/24] Update server-manager.es.rst --- administrator-guide/server-manager.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/server-manager.es.rst b/administrator-guide/server-manager.es.rst index c9c93979..79d13d39 100644 --- a/administrator-guide/server-manager.es.rst +++ b/administrator-guide/server-manager.es.rst @@ -1,6 +1,6 @@ # Administrador del servidor -.. importante:: +.. important:: **Solo Enterprise Edition** All the functionalities shipped within the Server Manager are available only with Knowage Enterprise Edition From c6d595f5aff49fcb7089b93b9c952adb0dd4cd38 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:53:35 -0500 Subject: [PATCH 22/24] Update server-settings.es.rst --- administrator-guide/server-settings.es.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/administrator-guide/server-settings.es.rst b/administrator-guide/server-settings.es.rst index c8390e58..8ac71199 100644 --- a/administrator-guide/server-settings.es.rst +++ b/administrator-guide/server-settings.es.rst @@ -2,7 +2,7 @@ En este capítulo describimos todas las funcionalidades disponibles en el panel Configuración del servidor del menú Administrador que se muestra a continuación. -.. figura:: media/image93.png +.. figure:: media/image93.png Panel de configuración del servidor. @@ -12,7 +12,7 @@ Editores similares le dan acceso a configuraciones y dominios. Vamos a proporcio Haciendo clic en el botón **Configuración del servidor** > **Gestión de la configuración**, puede administrar muchos elementos de configuración. Por ejemplo, aquí puede establecer el idioma predeterminado, así como la configuración de correo. Empieza a escribir `DEFAULT` en el formulario de búsqueda, como se muestra a continuación, para filtrar entre los artículos disponibles y encontrar lo que le interesa. -.. figura:: media/image94.png +.. figure:: media/image94.png Lista de categorías de configuración. @@ -29,19 +29,19 @@ Puede ver los idiomas disponibles y su código (**Columna Comprobación de valor Haciendo clic en **Gestión de dominios** menú de elementos, puede administrar categorías. En la siguiente figura mostramos el editor de Gestión de Dominios. Puede agregar, por ejemplo, nuevas categorías para un modelo de negocio, para un conjunto de datos y para todos los dominios que puede ver en el **Columna de nombre de dominio**. -.. figura:: media/image95.png +.. figure:: media/image95.png Editor de gestión de dominios. Proporcionamos un ejemplo para describir cómo funciona. Supongamos que desea agregar una nueva categoría entre los conjuntos de datos, denominada "Costos". A continuación puedes ver las categorías ya existentes. -.. figura:: media/image96.png +.. figure:: media/image96.png Categorías de modelos de negocio ya existentes. Haga clic en el botón rojo más en la esquina superior derecha y, por defecto, se abrirá una nueva página con el formulario que debe completar. Un ejemplo se muestra en la figura a continuación. Rellene las columnas de la siguiente manera: -.. figura:: media/image97.png +.. figure:: media/image97.png Formulario a rellenar para crear una nueva categoría. @@ -59,13 +59,13 @@ También puede modificar un dominio existente seleccionando su fila dedicada y h El menú Exportadores es la nueva característica de Knowage. Esta característica permite al administrador configurar los exportadores de los documentos. Al abrir este catálogo, en el lado izquierdo puede ver la lista de exportadores creados y si desea ver los detalles de uno de ellos o cambiarlo, puede hacerlo seleccionándolo en la lista. Puede agregar un nuevo exportador haciendo clic en un icono más. Vea la figura a continuación. -.. figura:: media/image101.png +.. figure:: media/image101.png Adición de un nuevo exportador. En el lado derecho del catálogo tiene dos menús desplegables donde puede elegir motor y exportador para vincularlo con el motor. Después de seleccionar el motor y el exportador, puede guardarlo haciendo clic en un botón Guardar en la esquina superior derecha. En la siguiente figura puede ver el ejemplo de creación de un nuevo exportador. -.. figura:: media/image102.png +.. figure:: media/image102.png Creación de un nuevo exportador. @@ -77,7 +77,7 @@ Knowage ofrece la posibilidad de definir categorías de metadatos y luego darles En la página de metadatos, que se muestra a continuación, puede ver la lista de metadatos existentes. Aquí también puede definir un nuevo metadato utilizando el botón dedicado. -.. figura:: media/image98.png +.. figure:: media/image98.png Lista de metadatos existentes. From 32461253a5d7b2663d162b0fb39fef43dedfe958 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 08:54:03 -0500 Subject: [PATCH 23/24] Update timespan.es.rst --- administrator-guide/timespan.es.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/administrator-guide/timespan.es.rst b/administrator-guide/timespan.es.rst index 1015166e..10fc99a5 100644 --- a/administrator-guide/timespan.es.rst +++ b/administrator-guide/timespan.es.rst @@ -6,13 +6,13 @@ La mayoría de las veces un usuario técnico desarrolla una solución empresaria La funcionalidad Timespan está disponible en la sección Catálogo del menú principal de Knowage. -.. figura:: media/imageTS001.png +.. figure:: media/imageTS001.png Intervalo de tiempo Al hacer clic en el elemento de menú "Intervalo de tiempo", Knowage redirige al usuario a la lista de períodos, si alguno ya estaba configurado. Es posible abrir un intervalo de tiempo existente simplemente haciendo clic en el elemento de la lista, buscar uno usando el cuadro de búsqueda, eliminar un elemento o clonarlo. El botón de eliminación y clonación está disponible aparte del nombre del elemento de intervalo de tiempo. -.. figura:: media/imageTS002.png +.. figure:: media/imageTS002.png Página de lista de intervalo de tiempo @@ -20,13 +20,13 @@ Para configurar un nuevo período, el usuario debe hacer clic en el icono rojo m En particular, se solicita al usuario técnico que asigne un nombre al nuevo intervalo de tiempo, para especificar si se trata de un período de tiempo o de tipo temporal. Asociar una categoría para problemas de generación de perfiles y, finalmente, definir la hora de inicio y finalización o la fecha de inicio y finalización, si es un intervalo de tiempo o temporal respectivamente, como podemos ver en la Figura a continuación. -.. figura:: media/imageTS003.png +.. figure:: media/imageTS003.png Tiempo y tipo temporal En ambos casos, el usuario técnico define el inicio y el final del intervalo y luego hace clic en el botón agregar para insertarlo. recuerde clcik en el botón Guardar para validar la configuración. Tenga en cuenta que es posible, para cada tipo, agregar más de un intervalo. -.. figura:: media/imageTS004.png +.. figure:: media/imageTS004.png Agregar más de un intervalo temporal en un intervalo de tiempo From 969ba37806fe6da6913d41252d51765bd1ab6466 Mon Sep 17 00:00:00 2001 From: felipe Date: Fri, 15 Jul 2022 14:47:52 -0500 Subject: [PATCH 24/24] Update operational-engines.es.rst --- administrator-guide/operational-engines.es.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/administrator-guide/operational-engines.es.rst b/administrator-guide/operational-engines.es.rst index 9367f77b..a4b565ed 100644 --- a/administrator-guide/operational-engines.es.rst +++ b/administrator-guide/operational-engines.es.rst @@ -5,7 +5,7 @@ El knowage permite la carga de datos de los sistemas de origen de acuerdo con una lógica ETL común, así como el monitoreo de los flujos de datos que alimentan continuamente el almacén de datos. Con este fin, Knowage proporciona el ETL **Knowage Talend Engine**. .. importante:: -**Solo Enterprise Edition** + **Solo Enterprise Edition** Please note that in the Enterprise Edition, **KnowageTalendEngine** is shipped with KnowageBD and KnowageSI only.