> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kişi bazında uyumluluk

> Önceki bir sağlayıcının kişi bazındaki eğitim uyumluluğu dışa aktarımını /v1 atamaları, kayıtları ve kurslarından yeniden oluşturun.

Bu rapor, önceki bir sağlayıcının kişi bazındaki uyumluluk dışa aktarımının Eğitim kısmını oluşturur: dizin kimliği ve her kişi için her Eğitim kaydına ait bir satır (modül durumu ve tarihleri).

Veri ayrıntı düzeyi uzun biçimlidir (kişi × atama), çünkü `GET /v1/assignments/{id}/enrollments` zaten bu biçimde veri döndürmektedir. Sorgu, modülleri sütunlara dönüştürmez.

<Note>
  Politika onayları bu raporun kapsamında değildir. Living Security'nin politika kabulü API'si bulunmadığından, eski dışa aktarımdaki bu sütunlar bekleyen bir eşleme değil, kapsam dışıdır. Bkz. [Eski dışa aktarımdan farklılıklar](#eski-d%C4%B1%C5%9Fa-aktar%C4%B1mdan-farkl%C4%B1l%C4%B1klar).
</Note>

Kurulum, kimlik bilgileri, sayfalama ve hız sınırı sonrası yeniden deneme işlemleri [Power BI / Excel bağlantı kılavuzu](/tr/developers/v1/powerbi) ile aynıdır. Önce paylaşılan `Fn_FetchAll` sorgusunu ekleyin; bu rapor onu adıyla çağırır.

## Gerekli anahtar kapsamları

| Kapsam | Kullanım amacı |
| - | - |
| `training:read` | `GET /v1/assignments` ve `GET /v1/assignments/{id}/enrollments` |
| `course:read` | `GET /v1/courses` (katalog başlıkları) |

## Kaynak uç noktalar

| Uç nokta | Rol |
| - | - |
| `GET /v1/assignments` | Atama listesi: `assignment_id`, başlık, `course_id`, yaşam döngüsü durumu, `created_at`. Sorgu duruma göre filtreleme yapmaz; dolayısıyla etkin, duraklatılmış ve tamamlanmış atamaların tümü görünür (geçmiş uyumluluk). |
| `GET /v1/assignments/{id}/enrollments` | Öğrenen bazında ilerleme. Her atama için sayfalı bir tarama yapılır. Bu, olgu ayrıntı düzeyidir ve bu raporda e-postayı raporlama birleştirme anahtarı olarak taşıyan tek `/v1` kaynağıdır. |
| `GET /v1/courses` | `course_id` değerini kurs başlığına (Eğitim modülünün adı) çözümler. `Assignment.title` bir kampanya etiketidir, modül adı değildir. |

Bu sorgu `GET /v1/entities` uç noktasını **çağırmaz**. Kayıt satırı zaten `email` ve `display_name` bilgilerini taşır; varlık listesinde ise departman veya iş unvanı bulunmaz. Bu nedenle listeyi taramak, kayıt satırında bulunmayan dizin sütunlarını doldurmaz.

### Ayrıntı düzeyi

Her kayıt için bir satır (kişi × atama). Aynı kursa iki farklı atama üzerinden atanan bir kişi için iki satır oluşur. Hiç kaydı olmayan bir kişi görünmez; çünkü `/v1` e-posta olmadan kullanılabilir bir dizin satırı üretemez ve yalnızca kişiye ait satırlar oluşturmak farklı ayrıntı düzeylerini karıştırırdı.

İstek bütçesi: her atama için sırayla, paylaşılan anahtar başına hız sınırı altında bir sayfalı tarama. Her zaman `limit = "500"` ayarını yapın.

## Sütun eşleme

Eski sütun adları, önceki sağlayıcınızın dışa aktarımından alınmıştır. `/v1` alanları genel API adlarıdır; sorgu bunların bir kısmına rapor için takma ad verir.

| Eski sütun | `/v1` alanı veya türetme | Rapor sütunu |
| - | - | - |
| E-posta | `Enrollment.email` | `email` |
| Ad soyad | `Enrollment.display_name` | `full_name` |
| Departman | `/v1` üzerinde yok | Atlanır, boş bırakılmaz |
| Diğer dizin bilgileri (unvan, yönetici, konum, …) | `/v1` üzerinde yok; varlıklar yalnızca e-posta ve görünen ad taşır. | Atlanır |
| Eğitim modülü / kurs adı | `Course.title`, bulunamazsa `Assignment.title` | `course_name` |
| Atama / modül durumu | `Enrollment.status` — `not_started` \| `in_progress` \| `completed` \| `overdue` \| `withdrawn` | `enrollment_status` |
| Atanma tarihi | `Enrollment.assigned_at` | `assigned_at` |
| Tamamlanma tarihi | `Enrollment.completed_at` | `completed_at` |
| Son tarih | `Enrollment.due_at` (eski dışa aktarımda bulunmayabilir; API sunduğu için dahil edilmiştir) | `due_at` |
| Politika kabulü / onayı | Politika alanı yok | Atlanır |
| Politika adı, kabul tarihi | Politika alanı yok | Atlanır |

Yıldız şema modeli için korunan birleştirme anahtarları: `entity_id`, `assignment_id`, `course_id`, `user_assignment_id`.

Sorgu ayrıca `course_slug`, `assignment_title`, `passed`, `attempts`, `assignment_lifecycle_status` ve `assignment_created_at` alanlarını da korur. `enrollment_status`, atamanın yaşam döngüsünü değil, Öğrenen'in ilerlemesini gösterir (`active` / `paused` / `completed`).

## Eski dışa aktarımdan farklılıklar

* **Politika kabulleri mevcut değildir.** Bu platformda politika alanı yoktur; `/policies`, `/policy_acceptances` veya eşdeğer bir `/v1` kaynağı bulunmaz. Bu sütunları bekleyen bir eşleme olarak değerlendirmeyin. Bunlar kapsam dışıdır.
* **Dizin ek bilgileri atlanır, boş bırakılmaz.** Departman, iş unvanı, yönetici ve konum `/v1` üzerinde yer almaz. Sorgu bunlar için boş sütunlar oluşturmaz.
* **Son tarih dahil edilir;** eski dışa aktarımda bulunmasa bile, çünkü `Enrollment.due_at` API'de mevcuttur.
* **Kurs adında katalog başlığı tercih edilir.** `Course.title` modül adıdır. `Assignment.title` yalnızca katalog satırı eksik olduğunda (silinmiş veya yayından kaldırılmış) kullanılır.
* **Uzun biçimli, dönüştürülmemiş.** Her kayıt için bir satır vardır; her kişi için modül başına sütun içeren tek bir satır yoktur.

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Power BI ve Excel kurulumu" href="/tr/developers/v1/powerbi">
    Kimlik bilgileri, sayfalama ve bu sorguları Power BI veya Excel'e yükleme.
  </Card>

  <Card title="E-posta kimlik avı günlüğü" href="/tr/developers/v1/reports/email-phishing-log">
    Son 12 aya ait olay düzeyinde kimlik avı etkileşimleri.
  </Card>

  <Card title="En savunmasız kullanıcılar" href="/tr/developers/v1/reports/most-susceptible-users">
    Kişi bazında 12 aylık tıklama, kimlik bilgisi ve bildirim özeti.
  </Card>

  <Card title="API anahtarları" href="/tr/developers/developer-hub/api-keys">
    Bu raporu yenileyen anahtara `training:read` ve `course:read` izinlerini verin.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.