{"id":722,"date":"2021-03-10T21:01:51","date_gmt":"2021-03-10T21:01:51","guid":{"rendered":"https:\/\/docs.tellya.ai\/?page_id=722"},"modified":"2021-03-17T11:11:28","modified_gmt":"2021-03-17T11:11:28","slug":"custom-kpi","status":"publish","type":"page","link":"https:\/\/docs.tellya.ai\/index.php\/custom-kpi\/","title":{"rendered":"Custom Report"},"content":{"rendered":"\n<p>L&#8217;API Custom KPI permette di popolare con dati esterni una &#8220;tabella di appoggio&#8221; che permette successivamente di andare a creare grafici personalizzati tramite dei Custom Report, al fine di analizzare e tracciare KPI specifici della progettualit\u00e0.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">La funzionalit\u00e0 Custom Report \u00e8 disponibile solo se la propria licenza contiene il modulo aggiuntivo &#8220;Advanced Analytics.<\/p>\n\n\n\n<h2>Method<\/h2>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--noicon is-style-info\"><strong>POST\u200b<\/strong>: \/analysis\/api\/v1\/customkpi\/insertRows<\/p>\n\n\n\n<h3>Path Parameters<\/h3>\n\n\n\n<div class=\"table-responsive\">\n<table class=\"table api-table\">\n  <thead>\n    <tr>\n      <th scope=\"col\" colspan=\"2\">Parameters<\/th>\n    <\/tr>\n  <\/thead>\n  <tbody>\n    <tr>\n      <th scope=\"row\">journeyApiKey<\/th>\n      <td>\n        <p class=\"api-parameter-type\">String<\/p>\n        <p>Obbligatorio. ApiKey della journey Tellya.<\/p>\n      <\/td>\n    <\/tr>\n    <tr>\n      <th scope=\"row\">reportName<\/th>\n      <td>\n        <p class=\"api-parameter-type\">String<\/p>\n        <p>Obbligatorio. Nome del Custom Report creato e in cui si voglio andare ad utilizzati i dati che popoleranno la tabella.<\/p>\n      <\/td>\n    <\/tr>\n  <\/tbody>\n<\/table>\n<\/div>\n\n\n\n<h3>Request body<\/h3>\n\n\n\n<p>Il corpo della richiesta POST conterr\u00e0 i record che si desidera inserire all&#8217;interno della tabella di appoggio. \u00c8 importante che il formato e i campi degli oggetti inseriti coincidano, nel nome e nel tipo, con quelli definiti nel &#8220;Data model&#8221; del Custom Report creato.<\/p>\n\n\n\n<p>Se \u00e8 si vuole inserire un valore di tipo <em>date<\/em> \u00e8 necessario utilizzare il seguente formato:<\/p>\n\n\n\n<ul><li>Data: <em>yyyy-mm-dd<\/em><\/li><li>Data e ora: <em>yyyy-mm-ddThh:mm:ss<\/em><\/li><\/ul>\n\n\n\n<h3>Esempio<\/h3>\n\n\n\n<div class=\"table-responsive\">\n<table class=\"table api-table\">\n  <thead>\n    <tr>\n      <th scope=\"col\">JSON representation<\/th>\n    <\/tr>\n  <\/thead>\n  <tbody>\n    <tr class=\"json-example\">\n      <td>\n        <pre><code>[\n  {\n    <span class=\"str\">\"Field-name-1\"<\/span>: <span class=\"str\">\"value-field-1a\"<\/span>,\n    <span class=\"str\">\"Field-name-2\"<\/span>: <span class=\"str\">\"value-field-2a\"<\/span>,\n    <span class=\"str\">\"Field-name-3\"<\/span>: <span class=\"str\">\"value-field-3a\"<\/span>,\n    <span class=\"str\">\"Field-name-4\"<\/span>: <span class=\"str\">\"value-field-4a\"<\/span>,\n    <span class=\"str\">\"Field-name-5\"<\/span>: <span class=\"str\">\"value-field-5a\"<\/span>\n  },\n  {\n    <span class=\"str\">\"Field-name-1\"<\/span>: <span class=\"str\">\"value-field-1b\"<\/span>,\n    <span class=\"str\">\"Field-name-2\"<\/span>: <span class=\"str\">\"value-field-2b\"<\/span>,\n    <span class=\"str\">\"Field-name-3\"<\/span>: <span class=\"str\">\"value-field-3b\"<\/span>,\n    <span class=\"str\">\"Field-name-4\"<\/span>: <span class=\"str\">\"value-field-4b\"<\/span>,\n    <span class=\"str\">\"Field-name-5\"<\/span>: <span class=\"str\">\"value-field-5b\"<\/span>\n  }\n]\n<\/code><\/pre>\n      <\/td>\n    <\/tr>\n  <\/tbody>\n<\/table>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>L&#8217;API Custom KPI permette di popolare con dati esterni una &#8220;tabella di appoggio&#8221; che permette successivamente di andare a creare grafici personalizzati tramite dei Custom Report, al fine di analizzare e tracciare KPI specifici della progettualit\u00e0. Method Path Parameters Parameters journeyApiKey String Obbligatorio. ApiKey della journey Tellya. reportName String Obbligatorio&#8230;.<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/pages\/722"}],"collection":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/comments?post=722"}],"version-history":[{"count":10,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/pages\/722\/revisions"}],"predecessor-version":[{"id":779,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/pages\/722\/revisions\/779"}],"wp:attachment":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/media?parent=722"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}