BI veri kümeleri

Raporlama, üzerinde anlaşılmış rakamları veri kümeleri halinde yayımlar; örneğin kişi ve gün bazında onaylı saatler. Bir iş zekâsı aracı (Power BI, Tableau, Looker Studio ya da kendi betiğiniz) bu kümeleri bir API anahtarıyla genel API üzerinden okur. Rakamlar Akollo raporlarındakilerle aynıdır. Araç yalnızca okur; Akollo'da hiçbir şeyi değiştirmez.

1. Anahtar oluşturunBaşlık bağlantısını kopyala

Yalnızca bu kapsama sahip bir anahtar projeleri, görevleri ya da kişileri okuyamaz, hiçbir şeyi de değiştiremez.

2. Veri kümelerini listeleyinBaşlık bağlantısını kopyala

curl https://<akollo-adresi>/api/public/v1/datasets \
  -H "Authorization: Bearer <api anahtarı>" \
  -H "Akollo-Version: 2026-09-24"

Yanıt, anahtarın okuyabildiği her veri kümesini sürümüyle birlikte listeler:

{ "data": [ { "key": "hours.daily", "version": 2 } ] }

Bir veri kümesinin sütunları değiştiğinde sürümü bir artar. Liste boş geliyorsa kurumunuz bu anahtarın servis hesabına henüz bir veri kümesi açmamıştır; raporlama yöneticinizden erişim isteyin.

3. Satırları sayfa sayfa okuyunBaşlık bağlantısını kopyala

curl "https://<akollo-adresi>/api/public/v1/datasets/hours.daily/rows" \
  -H "Authorization: Bearer <api anahtarı>" \
  -H "Akollo-Version: 2026-09-24"

{
  "data": [ { "person": "…", "date": "2026-09-01", "approved_hours": 7.5 } ],
  "has_more": true,
  "next_cursor": "eyJ…",
  "dataset": { "key": "hours.daily", "version": 2 }
}

• Her satır düz bir kayıttır. Bir değer metin, sayı, doğru/yanlış ya da boş olabilir.
• has_more doğru olduğu sürece ?cursor=<next_cursor> ile yeniden isteyin. Yanıttaki rel="next" içeren Link başlığı da aynı adresi taşır; onu olduğu gibi izleyebilirsiniz.
• Bir sayfada kaç satır olacağına raporlama karar verir. Akış limit, $top ya da $select kabul etmez.
• Veri kümesinin yalnızca bir kısmını okumak için $filter ekleyin (aşağıda). Her sayfada aynı $filter'ı gönderin; Link başlığındaki adres onu zaten taşır.
• Bir imleç tek bir veri kümesine, tek bir sürüme, tek bir $filter'a ve onu alan anahtara aittir. Siz sayfaları okurken veri kümesinin sürümü değişirse ya da imleci başka bir anahtarla gönderirseniz (örneğin anahtarı yeniledikten sonra) sonraki çağrı 400 CURSOR_INVALID döner; ilk sayfadan yeniden başlayın.

$filter ile süzmeBaşlık bağlantısını kopyala

$filter, raporlamanın anahtara zaten açtığı satırları daraltır; hiçbir zaman genişletmez. and ile bağlanmış karşılaştırmalardan oluşur:

<sütun> <işleç> <değer> and <sütun> <işleç> <değer> …

• Sütunlar veri kümesinin kendi sütun adlarıdır (satırlarda göründüğü gibi, küçük harfle).
• İşleçler: eq (eşit), ne (eşit değil), gt, ge, lt, le (büyük, büyük ya da eşit, küçük, küçük ya da eşit). Yalnızca küçük harf.
• Değerler: tek tırnak içinde metin (metnin içindeki tırnağı iki tırnak olarak yazın: 'O''Brien'), tam sayılar (600, -15), true, false, null (yalnızca eq ya da ne ile) ve tırnaksız YYYY-AA-GG biçiminde tarihler.
• En çok 8 karşılaştırma ve 1 024 karakter. or, not, parantez ve işlevler desteklenmez.

Örnekler (adresi oluştururken değeri URL kodlamasıyla yazın):

$filter=local_date ge 2026-09-01 and local_date lt 2026-10-01
$filter=team_id eq '018f0000-0000-7000-8000-000000000001'
$filter=local_date ge 2026-09-01 and employee_count gt 5

Veri kümesinde olmayan bir sütunu adlandıran ya da bir sütunu yanlış türde bir değerle karşılaştıran süzgeç 400 VALIDATION_FAILED döner.

Bir çağrı reddedildiğindeBaşlık bağlantısını kopyala

Power BI DesktopBaşlık bağlantısını kopyala

Veri al → Boş sorgu'yu seçin, Gelişmiş Düzenleyici'yi açın ve aşağıdaki sorguyu yapıştırın. Adresi, veri kümesi anahtarını ve API anahtarını yerine yazın. Power BI hizmetinde zamanlanmış yenileme için adresi aşağıdaki gibi Web.Contents'in ilk bağımsız değişkeninde, yolu da RelativePath'te tutun ve veri kaynağının kimlik bilgisini Anonim yapın; anahtar zaten başlıkta gidiyor.

let
    Host = "https://<akollo-adresi>",
    Dataset = "hours.daily",
    ApiKey = "<api anahtarı>",
    GetPage = (cursor as nullable text) =>
        Json.Document(
            Web.Contents(
                Host,
                [
                    RelativePath = "api/public/v1/datasets/" & Dataset & "/rows",
                    Query = if cursor = null then [] else [cursor = cursor],
                    Headers = [Authorization = "Bearer " & ApiKey, #"Akollo-Version" = "2026-09-24"]
                ]
            )
        ),
    Pages = List.Generate(
        () => GetPage(null),
        each _ <> null,
        each if _[has_more] then GetPage(_[next_cursor]) else null
    ),
    Rows = List.Combine(List.Transform(Pages, each _[data])),
    Result = Table.FromRecords(Rows, null, MissingField.UseNull)
in
    Result

Rapor dosyası başkalarıyla paylaşılacaksa anahtarı sorgu metnine yazmak yerine bir Power BI parametresinde saklayın.

TableauBaşlık bağlantısını kopyala

Tableau akışı iki yoldan biriyle okuyabilir.

• Web Data Connector. Küçük bir bağlayıcı sayfası aynı iki adresi çağırır: tablo seçicisi için veri kümelerini listeler, satırları da next_cursor'ı izleyerek sayfa sayfa okur. Anahtar sayfanın içine değil, bağlayıcının kimlik doğrulama adımına girilir.
• Zamanlanmış özet (extract). Bir betik tüm sayfaları bir CSV dosyasına (ya da Tableau'nun Hyper API'siyle bir Hyper dosyasına) yazar; Tableau Server ya da Tableau Cloud özeti bu dosyadan belirli aralıklarla yeniler. Örneğin:

import csv, os, requests

host = "https://<akollo-adresi>"
headers = {"Authorization": f"Bearer {os.environ['AKOLLO_API_KEY']}", "Akollo-Version": "2026-09-24"}
url = f"{host}/api/public/v1/datasets/hours.daily/rows"
rows, cursor = [], None

while True:
    page = requests.get(url, headers=headers, params={"cursor": cursor} if cursor else None, timeout=60)
    page.raise_for_status()
    body = page.json()
    rows.extend(body["data"])
    if not body["has_more"]:
        break
    cursor = body["next_cursor"]

with open("hours_daily.csv", "w", newline="", encoding="utf-8") as file:
    columns = sorted({name for row in rows for name in row})
    writer = csv.DictWriter(file, fieldnames=columns)
    writer.writeheader()
    writer.writerows(rows)

Anahtarı betik dosyasında değil, ortam değişkeninde ya da bir sır kasasında tutun.

Looker StudioBaşlık bağlantısını kopyala

Looker Studio akışı iki yoldan biriyle okuyabilir.

• Topluluk bağlayıcısı. Bir Apps Script bağlayıcısı aynı adresleri çağırır, kimlik doğrulama adımında anahtarı ister (anahtar türü) ve satırları next_cursor'ı izleyerek sayfa sayfa okur.
• Zamanlanmış Google E-Tablolar. Bir e-tablodaki Apps Script, zamana bağlı bir tetikleyiciyle satırları okuyup bir sekmeye yazar; Looker Studio da kaynak olarak bu e-tabloyu kullanır. Örneğin:

function pullAkollo() {
  const key = PropertiesService.getScriptProperties().getProperty('AKOLLO_API_KEY');
  const base = 'https://<akollo-adresi>/api/public/v1/datasets/hours.daily/rows';
  const headers = { Authorization: 'Bearer ' + key, 'Akollo-Version': '2026-09-24' };
  let rows = [];
  let cursor = null;

  do {
    const url = cursor ? base + '?cursor=' + encodeURIComponent(cursor) : base;
    const body = JSON.parse(UrlFetchApp.fetch(url, { headers: headers }).getContentText());
    rows = rows.concat(body.data);
    cursor = body.has_more ? body.next_cursor : null;
  } while (cursor);

  const columns = [...new Set(rows.flatMap((row) => Object.keys(row)))];
  const sheet = SpreadsheetApp.getActive().getSheetByName('hours.daily');
  sheet.clearContents();
  sheet.getRange(1, 1, 1, columns.length).setValues([columns]);
  if (rows.length > 0) {
    sheet
      .getRange(2, 1, rows.length, columns.length)
      .setValues(rows.map((row) => columns.map((name) => row[name] ?? '')));
  }
}

Anahtarı betik özelliklerinde saklayın; e-tabloyu yalnızca bu rakamları görebilecek kişilerle paylaşın.

Verileri dışarı aktarmanın diğer yollarıBaşlık bağlantısını kopyala

Veri kümesi akışının yanı sıra Entegrasyonlar → Veri aktarımı sayfası dışa aktarma hedeflerini listeler: Azure Blob, Power BI ve Analitik SQL. Azure Blob dışa aktarımı açıkken Akollo her dosyayı seçilen kapsayıcıya bir kez yazar ve sonradan değiştirmez; mevcut dosyaları silmez, değiştirmez ve okumaz. Veri kümelerini doğrudan veritabanından okumak için BI aracını SQL ile bağlama sayfasına bakın.

İyi uygulamalarBaşlık bağlantısını kopyala

• Her araç ve her çalışma alanı için ayrı bir anahtar kullanın; böylece birini değiştirirken diğerleri durmaz.
• Rakamlar ne sıklıkla değişiyorsa o sıklıkta yenileyin, birkaç dakikada bir değil. Her çağrı anahtarın dakikalık sınırından düşer ve API kullanımı olarak kaydedilir.
• Anahtarın süresi dolmadan onu yenileyin: Entegrasyonlar → API anahtarları → Döndür, siz aracı güncellerken önceki anahtarı kısa bir bekleme süresi boyunca çalışır durumda tutar.

Sık sorulan sorularBaşlık bağlantısını kopyala

İlgili sayfalarBaşlık bağlantısını kopyala

• BI aracını SQL ile bağlama
• API ve anahtarlar
• Raporlar