Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
HTML

<div id="main-content" class="wiki-content group">
	<p>
		<span style="color: rgb(51, 51, 51);">&#160;</span>
	</p>
	<div class="aui-message problem shadowed information-macro">
		<p class="title">Warning</p>
		<span class="aui-icon icon-problem">Icon</span>
		<div class="message-content">
			<p>
				Starting with <strong>Fluig 1.2</strong>, the <em>Analysis and
					Processes Central</em> was discontinued and evolved into <strong>Fluig
					Analytics</strong>.
			</p>
		</div>
	</div>
	<p>
		<span style="color: rgb(51, 51, 51);"><br /></span>
	</p>
	<p>
		<span style="color: rgb(51, 51, 51);">Fluig has an advanced
			Analytics feature, which enables the creation of Dashboards and Views
			for monitoring information indicators that occur within the Fluig
			platform. This service is available in cloud only, which ensures that
			the entire broad processing of new information and data analysis
			occurs with great scalability.</span>
	</p>
	<div class="aui-message hint shadowed information-macro">
		<p class="title">Note</p>
		<span class="aui-icon icon-hint">Icon</span>
		<div class="message-content">
			<p>
				<span>As the Analytics service is in cloud, the server must
					be enabled for communication on port <strong>443</strong> to <strong>analytics.fluig.com</strong>;
					if it is not enabled, it will not be possible to send the data.
				</span>
			</p>
		</div>
	</div>
	<p>To enable Analytics in your environment, the following steps
		should be followed.</p>
	<a name="composition-deck-enable-analytics-steps"></a>
	<div id="enable-analytics-steps" class="deck" history="true"
		loopcards="false" effecttype="" effectduration="1.0" nextafter="0.0">
		<ul class="tab-navigation"></ul>
		<!-- // .tab-navigation -->
		<div class="deck-cards panel" style="">
			<div id="1" class="deck-card  active-pane" style="" cssclass=""
				accesskey="" label="Passo 1" title="" nextafter="0"
				effecttype="default" effectduration="-1.0">
				<p>
					Open a call via the </span><a href="http://suporte.fluig.com/"
						class="external-link" rel="nofollow"><span>Customer
							Portal</span></a><span>&#160;in "Calls > Software > Fluig" using the
						following parameters:
				</p>
				<div class="table-wrap">
					<table class="confluenceTable">
						<tbody>
							<tr>
								<td class="confluenceTd"><p>
										<span style="color: rgb(0, 51, 102);"><strong>Version</strong></span>
									</p></td>
								<td class="confluenceTd"><p>Fluig</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span style="color: rgb(0, 51, 102);"><strong>Module/Product</strong></span>
									</p></td>
								<td class="confluenceTd"><p>
										<span>Fluig</span>
									</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span style="color: rgb(0, 51, 102);"><strong>Process
												or Routine</strong></span>
									</p></td>
								<td class="confluenceTd"><p>
										<span>Analytics</span>
									</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span style="color: rgb(0, 51, 102);"><strong>Summary</strong></span>
									</p></td>
								<td class="confluenceTd"><p>
										<span>Creating project Analytics</span>
									</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span style="color: rgb(0, 51, 102);"><strong>Incident</strong></span>
									</p></td>
								<td class="confluenceTd"><p>
										<span>Information for creating context: </span>
									</p>
									<ol>
										<li><span>Company Name</span></li>
										<li><span>CNPJ (Corporate Taxpayer's Registry)</span></li>
										<li><span>TOTVS customer code</span></li>
										<li><span>Code of context to be created (usually
												company name, may contain space, characters without
												diacritics and numbers)</span><span>&#160;</span></li>
										<li><span>Administrator’s name and last name</span></li>
										<li><span>Analytics environment administrator’s
												e-mail</span></li>
									</ol></td>
							</tr>
						</tbody>
					</table>
				</div>
				<p>
					<br class="atl-forced-newline" />
					<span>As a result of the call, two environments will be
						released: one for production and the other for testing, in which
						the administrator will receive an e-mail invitation to participate
						in the Analytics project, and will receive, in the call, the codes
						of the projects created.</span>
				</p>
			</div>
			<div id="2" class="deck-card " style="" cssclass="" accesskey=""
				label="Passo 2" title="" nextafter="0" effecttype="default"
				effectduration="-1.0">
				<p>
					<span>In the environment with Fluig that you want to connect
						the integration with Analytics, you will need to access the WCM
						administrator environment (with the WCMAdmin user). In this
						environment, go to:</span>
				</p>
				<ol>
					<li><span>&#160;</span><span>Menu option: Control panel</span></li>
					<li><span>Click on the WCM tab</span></li>
					<li><span>then go to the Companies option</span></li>
				</ol>
				<p>
					<span>In this option, select the company you want to enable
						Analytics, then click Edit. Then go to&#160;<strong>Register
							additional data</strong>&#160;and on the following screen add the
						following keys and values
					</span>
				</p>
				<div class="table-wrap">
					<table class="confluenceTable">
						<tbody>
							<tr>
								<td class="confluenceTd"><p>
										<strong>Key</strong>
									</p></td>
								<td class="confluenceTd"><p>
										<strong>Value</strong>
									</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span>analytics.gd.project.id</span>
									</p></td>
								<td class="confluenceTd"><p>
										<span style="color: rgb(255, 0, 0);">&lt;your project
											code sent by support></span>
									</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span>analytics.gd.user</span>
									</p></td>
								<td class="confluenceTd"><p>
										<span style="color: rgb(255, 0, 0);">&lt;e-mail in
											which you received the invitation from support></span>
									</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span>analytics.gd.pass</span>
									</p></td>
								<td class="confluenceTd"><p>
										<span style="color: rgb(255, 0, 0);">&lt;password
											registered after the invitation></span>
									</p></td>
							</tr>
							<tr>
								<td class="confluenceTd"><p>
										<span>analytics.gd.active</span>
									</p></td>
								<td class="confluenceTd"><p>
										<span>true</span>
									</p></td>
							</tr>
						</tbody>
					</table>
				</div>
				<p>
					<strong><img class="confluence-embedded-image"
						src="attachments/107381593/107185677.png"
						data-image-src="attachments/107381593/107185677.png"></strong>
				</p>
			</div>
			<div id="3" class="deck-card " style="" cssclass="" accesskey=""
				label="Passo 3" title="" nextafter="0" effecttype="default"
				effectduration="-1.0">
				<p>
					<span>With the invitation received by mail, complete your
						registration on Fluig</span>&#160;<span>Analytics. With this user
						and password, you will be able to monitor the data being sent.</span>
				</p>
			</div>
		</div>
	</div>
	<!-- // .deck -->
	<div class="aui-message problem shadowed information-macro">
		<p class="title">Notification</p>
		<span class="aui-icon icon-problem">Icon</span>
		<div class="message-content">
			<p>Do not disclose your project code, this is the key to access
				to your project.</p>
		</div>
	</div>
	<p>&#160;</p>
	<h1 id="GuiadeImplantaçãoFluigAnalytics-EnviodosDados">
		<span style="color: rgb(51, 51, 51);">Sending Data</span>
	</h1>
	<p>
		<span style="color: rgb(51, 51, 51);">Data is sent in <u>regular
				intervals of 15 minutes</u>. Only data that has changed over this period
			is sent. Communication is always made from the server to
			analytics.fluig.com. The firewall must be disabled for this address.
		</span>
	</p>
	<p>
		<span style="color: rgb(51, 51, 51);">To send specific Workflow
			processes data,&#160;</span><span
			style="line-height: 13.0pt; font-size: 10.0pt;">the
			event&#160;</span><em style="line-height: 13.0pt; font-size: 10.0pt;">beforeSendData
		</em>must be used for configuration of the data sent to Analytics<span
			style="line-height: 13.0pt; font-size: 10.0pt;">.&#160;</span>
	</p>
	<p>
		<span style="font-size: small;"><span
			style="line-height: 13.0pt;">The function to treat this
				process event has two&#160;</span></span>parameters<span style="font-size: small;"><span
			style="line-height: 13.0pt;">&#160;</span></span><em
			style="line-height: 13.0pt; font-size: 10.0pt;">customField and
			customFact</em><span style="font-size: small;"><span
			style="line-height: 13.0pt;">. The first parameter is an <em>array</em>
				of <em>strings</em> already instantiated, with 10 positions (0 to
				9). The second parameter is an <em>array</em> of 10 positions, but
				the data must be <em>double</em> type and its&#160;
		</span></span>content<span style="font-size: small;"><span
			style="line-height: 13.0pt;">&#160;will be treated as a
				"fact". The big difference between a&#160;<em>customField and a
					customFact</em> field is that in a <em>fact</em>&#160;field (<em>customFact</em>),
				as it is a number, operations such as sum, average, maximum and
				minimum can be calculated. These are some examples of field types
				and the value that should read:
		</span></span>
	</p>
	<div class="table-wrap">
		<table class="confluenceTable">
			<tbody>
				<tr>
					<th class="confluenceTh">Field</th>
					<th class="confluenceTh">Field to be sent</th>
					<th class="confluenceTh">Justification</th>
				</tr>
				<tr>
					<td class="confluenceTd">Purchase order region</td>
					<td class="confluenceTd"><em>customField</em></td>
					<td class="confluenceTd">Since the goal is to tell in which
						regions the applications were requested, it doesn’t have to be a
						fact field.</td>
				</tr>
				<tr>
					<td class="confluenceTd">Requester name</td>
					<td class="confluenceTd"><em>customField</em></td>
					<td class="confluenceTd">It will only be used as a cluster</td>
				</tr>
				<tr>
					<td class="confluenceTd">Total order amount</td>
					<td class="confluenceTd"><em>customFact</em></td>
					<td class="confluenceTd">To retrieve information such as
						average order amount of a region</td>
				</tr>
				<tr>
					<td class="confluenceTd">Number of items in order</td>
					<td class="confluenceTd"><em>customFact</em></td>
					<td class="confluenceTd">Add up how many items were requested
						by a requester<span
						style="line-height: 13.0pt; font-size: 10.0pt;">&#160;</span>
					</td>
				</tr>
			</tbody>
		</table>
	</div>
	<p>Below is a sample implementation of the event, with two fields
		filled out:</p>
	<div class="aui-message warning shadowed information-macro">
		<p class="title">Warning</p>
		<span class="aui-icon icon-warning">Icon</span>
		<div class="message-content">
			<p>Note the conversion of the field to Double</p>
		</div>
	</div>
	<div class="code panel pdl" style="border-width: 1px;">
		<div class="codeHeader panelHeader pdl"
			style="border-bottom-width: 1px;">
			<b>Example of Workflows Event</b>
		</div>
		<div class="codeContent panelContent pdl">
			<pre class="theme: Confluence; brush: javascript; gutter: false"
				style="font-size: 12px;">function

 

Aviso
titleAtención

A partir de la Fluig 1.2, la Central de análisis y procesos fue descontinuada y se convirtió en el Fluig Analytics.

La Fluig tiene una funcionalidad avanzada de Analytics, lo que permite la creación de Dashboards y Views para el seguimiento de indicadores de información que ocurre dentro de la plataforma Fluig. El servicio está disponible sólo en la nube, que asegura que todos los grandes procesamientos de información nueva y análisis de datos tenga lugar con gran escalabilidad.

Informações
titleNota

Como el servicio de Analytics está en la nube, el servidor debe estar habilitado para comunicación en el puerto 443 a analytics.fluig.com, si no está habilitado no serás capaz de enviar los datos.

Para habilitar Analytics en su entorno, deben seguirse los siguientes pasos.

...

idenable-analytics-steps

...

defaulttrue
id1
labelPasso 1

Abrir una llamada por medio del Portal de clientes en "Llamadas> Software > Fluig" usando los siguientes parámetros:

Versión:

Fluig.

Módulo/producto

Fluig

Proceso o rutina

Analytics

Resumen

Crear proyecto Analytics

Incidente

Información para crear el contexto: 

  1. Nombre de la empresa.
  2. CNPJ
  3. Código del cliente TOTVS
  4. Código de contexto para ser creado (generalmente nombre de la empresa, puede contener caracteres de espacio sin signos diacríticos y números) 
  5. Nombre y apellido del administrador.
  6. Correo electrónico del administrador de entorno de Analytics.

...

Card
id2
labelPasso 2

Como resultado de la llamada se liberarán dos entornos, uno para la producción y el otro para la prueba en la que el administrador recibirá por correo electrónico una invitación para participar en el proyecto de Analytics y en la llamada recibirá los códigos de los proyectos creados.

En el entorno con el Fluig al que quiere conectarse la integración con Analytics necesitará acceder al entorno del administrador del WCM (usando el usuario WCMAdmin), allí vaya a:

  1.  Opción del menú: Panel de control.
  2. Haga clic en la pestaña WCM.
  3. Después se acceder a la opción Empresas.

Seleccione la empresa en la que desea habilitar el Analytics, haga clic en editar. Ir a Registrar datos adicionales en la pantalla y agregar las siguientes claves y valores

Clave.

Valor.

analytics.gd.project.id

< su código de proyecto devuelto por el soporte>

analytics.gd.user

<correo electrónico donde recibió la invitación del soporte>

analytics.gd.pass

< contraseña registrada después de la invitación>

analytics.gd.active

true

Image Removed

Card
id3
labelPasso 3

Con la invitación recibida por correo, regístrese en Fluig Analytics. Con ese nombre de usuario y contraseña será posible seguir los datos enviados.

Aviso
titleAviso

No divulgue su código del proyecto, esto es la clave para acceder al proyecto.

 

Envío de datos.

Los datos se envían en intervalos regulares de 15 minutos, y se envían sólo los datos modificados durante el período. Comunicación se realiza siempre desde el servidor a Analytics.fluig.com, pidiendo la liberación de firewall a esta dirección.

Para enviar datos específicos de los procesos de workflow el evento beforeSendData debe ser utilizado para la configuración de los datos que se envían a Analytics

La función para controlar este evento del proceso posee dos  parámetros customField y customFact. El primer parámetro es un array de strings ya instanciado que contiene 10 posiciones (desde 0 hasta 9). El segundo parámetro también es un array de 10 posiciones, pero los datos deben ser de tipo double y a su  contenido  se lo tratará como un "hecho". La gran diferencia entre un campo customField y customFact es que el un campo hecho de (customFact) por ser un número, se pueden calcular operaciones tales como suma, promedio, máximo y mínimo, sigue algunos ejemplos de tipos de campos y el valor que debe ser:

Campo.
Campo para enviarse.
Justificación.
Nombre del solicitante.customFieldSólo se utilizará como agrupador.
Número de elementos en el pedido.customFactContar cuántos artículos fueron pedidos por un solicitante. 
Región del pedido de compra.customFieldComo sólo quiere saber en qué regiones se solicitaron los pedidos, no es necesario ser un campo hecho.
Valor total del pedido.customFactPara obtener información como el valor del pedido promedio de una región.

Abajo hay un ejemplo de implementación del evento completando dos campos:

Nota
titleAtención

Tenga en cuenta la conversión de campo a Double.

Bloco de código
languagejavascript
titleExemplo de Evento do Workflows
function beforeSendData(customField, customFact) {
    customField[0] ="1";
    customField[1] =hAPI.getCardValue("campo_do_formulario");

    customFact[0]=10.53;
    customFact[1]=java.lang.Double.parseDouble(hAPI.getCardValue("campo_valor"));
}

...

</pre>
		</div>
	</div>
	<p>
		<span style="color: rgb(51, 51, 51);"><br />
		<span class="confluence-anchor-link"
			id="GuiadeImplantaçãoFluigAnalytics-_GoBack"></span></span>
	</p>
</div>