Datu-formatua
JSON fitxategiak erakundeak duen guztia dauka. ZIP artxiboak eduki bera dauka kalkulu-orrien fitxategitan banatuta, eta bazkideen logotipoak irudi-fitxategi gisa.
Entitate bakoitzaren eremuak, formularioek erabiltzen dituzten izenekin, Osagaiak ataleko bere orriko «Zer daukan…» atalean zerrendatzen dira: Erakundeak, Unitate organikoak, Tratamendu-jarduerak, Bazkideak, Kontaktuak, Kontratuak.
JSON fitxategi-formatua
Fitxategi egituratu bakarra, honekin:
| Erakundea | Izenak, helbidea, kontaktuak, kolorea, logotipoa, oharrak |
| Hizkuntzak | Konfiguratutako hizkuntzak eta zein den lehenetsia |
| Bazkideak | Bazkide guztiak, beren kontaktuekin |
| Kontratuak | Kontratu guztiak, lotzen dituzten bazkide eta jarduerekin |
| Unitateak eta jarduerak | Unitate organiko bakoitzaren izena eta tratamendu-jarduera guztiak, behin hizkuntza bakoitzeko, beren eremu guztiekin eta egoera aktibo/inaktiboarekin |
| Unitateen koloreak eta kontaktuak | Unitate organiko bakoitzaren kolorea eta kontaktuak, behin bakarrik, hizkuntza guztietan berdinak baitira |
| Txantiloiak | Zure txantiloi pertsonalizatuak |
Kideak eta haien rolak ez dira horren parte: zure kontuarenak dira, ez erregistroarenak. Oro har, fitxategiak honela ematen du:
{
"exportVersion": 1,
"exportedAt": "2026-05-18T00:00:00.000Z",
"organization": {
"licenseStart": 0,
"licenseEnd": 0,
"licenseCost": 0,
"shortName": "demo",
"isBlocked": false,
"isPublic": true,
"isDemo": true,
"highestOuId": 4,
"highestActivityId": 7,
"highestPartnerId": 7,
"highestContractId": 11,
"schemaVersion": 15,
"defaultActivityAttributes": {
"activityId": 0,
"activityName": "",
"role": "Controller",
"purposeShort": "",
"purposeLong": "",
"legalbasis": ["Consent"],
"legalbasisLong": "",
"legalbasisSpecial": ["ExplicitConsent"],
"dataCategories": ["Characteristics", "Identification"],
"datasubjectCategories": "",
"activityCategories": ["DataCollection", "DataStorage"],
"dataOrigin": "",
"timeLimit": "",
"profiling": false,
"communications": "",
"communicationsLong": "",
"controllers": [0],
"processors": [],
"transfers": false,
"transfersLong": "",
"securityLevel": "low",
"securityMeasuresLong": "",
"active": false,
"createdAt": 0,
"updatedAt": 0
},
"partners": [
{
"organizationId": 0,
"organizationName": "TEST",
"organizationNameLong": "Demo Organization",
"organizationColor": "#2563EB",
"organizationWebsite": "",
"organizationPostalAddress": {
"addressLine1": "Test Avenue",
"addressLine2": "Test Org Main Office",
"city": "Testville",
"stateProvince": "",
"postalCode": "00000",
"country": "LX"
},
"organizationLogo": null,
"organizationLogoVersion": null,
"organizationVatNumber": "",
"organizationNotes": "Self organization. This is the organization owning this ROPA.",
"organizationContacts": [
{
"contactId": 1,
"contactFirstname": "John",
"contactLastname": "Smith",
"contactRole": "DPO",
"contactEmails": [
{
"email": "dpo@test-organization.com",
"description": "DPO Office",
"isPrimary": true
}
],
"contactPhoneNumbers": [
{
"countryCode": "+1",
"phoneNumber": "5551234567",
"description": "Office",
"isPrimary": true
}
],
"contactNotes": "Data Protection Officer. Primary contact for GDPR compliance matters.",
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
}
],
"contractOrder": [],
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
},
{
"organizationId": 1,
"organizationName": "CloudStore",
"organizationNameLong": "CloudStore Solutions Inc.",
"organizationColor": "#0891B2",
"organizationWebsite": "https://www.cloudstore-demo.com",
"organizationPostalAddress": {
"addressLine1": "123 Tech Boulevard",
"addressLine2": "Suite 400",
"city": "San Francisco",
"stateProvince": "California",
"postalCode": "94105",
"country": "US"
},
"organizationLogo": null,
"organizationLogoVersion": null,
"organizationVatNumber": "",
"organizationNotes": "Cloud storage provider for document archiving and backup services. Primary data processor for file storage.",
"organizationContacts": [
{
"contactId": 1,
"contactFirstname": "Sarah",
"contactLastname": "Mitchell",
"contactRole": "DPO",
"contactEmails": [
{
"email": "sarah.mitchell@cloudstore-demo.com",
"description": "Work",
"isPrimary": true
},
{
"email": "dpo@cloudstore-demo.com",
"description": "DPO Office",
"isPrimary": false
}
],
"contactPhoneNumbers": [
{
"countryCode": "+1",
"phoneNumber": "4155551234",
"description": "Office",
"isPrimary": true
},
{
"countryCode": "+1",
"phoneNumber": "4155559876",
"description": "Mobile",
"isPrimary": false
}
],
"contactNotes": "Available Mon-Fri 9am-5pm PST. Preferred contact for data protection matters.",
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
},
{
"contactId": 2,
"contactFirstname": "James",
"contactLastname": "Rodriguez",
"contactRole": "Technical",
"contactEmails": [
{
"email": "james.rodriguez@cloudstore-demo.com",
"description": "Work",
"isPrimary": true
}
],
"contactPhoneNumbers": [
{
"countryCode": "+1",
"phoneNumber": "4155552345",
"description": "Office",
"isPrimary": true
}
],
"contactNotes": "Technical lead for API integration and data migration projects.",
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
},
{
"contactId": 3,
"contactFirstname": "Emily",
"contactLastname": "Chen",
"contactRole": "Support",
"contactEmails": [
{
"email": "emily.chen@cloudstore-demo.com",
"description": "Work",
"isPrimary": true
},
{
"email": "support@cloudstore-demo.com",
"description": "Support Team",
"isPrimary": false
}
],
"contactPhoneNumbers": [
{
"countryCode": "+1",
"phoneNumber": "4155553456",
"description": "Support Line",
"isPrimary": true
}
],
"contactNotes": "Customer support manager. Contact for service issues and incidents.",
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
}
],
"contractOrder": [1, 9],
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
}
],
"ropas": [
{
"locale": "en",
"isDefault": true
},
{
"locale": "de",
"isDefault": false
}
],
"contracts": [
{
"contractId": 1,
"contractName": "HR-SYS-2024",
"contractUrl": "https://example.com/contracts/hr-sys-2024",
"contractExpirationDate": "2025-12-31",
"contractDescription": "HR management system service agreement including payroll processing and training management",
"activityIds": [1],
"partnerIds": [1],
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
},
{
"contractId": 2,
"contractName": "DPA-BENEFITS-2024",
"contractUrl": "https://example.com/contracts/dpa-benefits",
"contractExpirationDate": "2026-06-30",
"contractDescription": "Data processing agreement for employee benefits administration and healthcare coordination",
"activityIds": [1],
"partnerIds": [5],
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
},
{
"contractId": 3,
"contractName": "OSH-2024",
"contractUrl": "https://example.com/contracts/osh-2024",
"contractExpirationDate": "2025-08-31",
"contractDescription": "Occupational safety and health surveillance service agreement with medical assessment provider",
"activityIds": [3],
"partnerIds": [2],
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
}
],
"ous": [
{
"ouId": 1,
"ouColor": "#C084FC",
"ouContacts": [
{
"contactId": 1,
"contactFirstname": "Laura",
"contactLastname": "Novak",
"contactRole": "HR Manager",
"contactEmails": [
{
"email": "hr@test-organization.com",
"description": "HR Office",
"isPrimary": true
}
],
"contactPhoneNumbers": [
{
"countryCode": "+1",
"phoneNumber": "5551230001",
"description": "Office",
"isPrimary": true
}
],
"contactNotes": "Owns the staff records and answers employees' data access requests.",
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
},
{
"contactId": 2,
"contactFirstname": "Peter",
"contactLastname": "Hall",
"contactRole": "Payroll Lead",
"contactEmails": [
{
"email": "payroll@test-organization.com",
"description": "Work",
"isPrimary": true
}
],
"contactPhoneNumbers": [],
"contactNotes": "",
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
}
]
},
{
"ouId": 2,
"ouColor": "#1c7958",
"ouContacts": []
}
],
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
},
"ropas": [
{
"orgId": "",
"orgShortName": "demo",
"locale": "en",
"ous": [
{
"ouName": "Human Resources",
"ouId": 1,
"activities": [
{
"activityId": 1,
"activityName": "Staff Management",
"purposeShort": "Staff management",
"purposeLong": "Management of training, payroll, promotion, and other aspects related to work life",
"legalbasis": ["Contract", "LegalObligation"],
"legalbasisLong": "",
"legalbasisSpecial": ["Employment", "Healthcare"],
"dataCategories": ["Identification"],
"datasubjectCategories": "Students; Other individuals related to the University; Former students",
"activityCategories": [
"DataCollection",
"DataGeneration",
"DataAccess"
],
"dataOrigin": "From the data subject or their legal representative; Reuse of data already held by the controller in other processing operations",
"timeLimit": "As long as necessary to fulfill the purpose for which they were collected and to determine possible responsibilities arising from the processing. Until consent is revoked.",
"profiling": false,
"communications": "-",
"communicationsLong": "-",
"controllers": [0],
"processors": [1, 5],
"transfers": true,
"transfersLong": "International transfers (outside the EEA) of personal data may be made to companies providing information society services, subject to the signing of contracts, and to other institutions with which data transfer agreements have been signed, in both cases respecting legality",
"securityLevel": "low",
"securityMeasuresLong": "Not required.",
"activityExpirationDate": "2099-12-31",
"forcedInactive": false,
"active": false,
"createdAt": 0,
"updatedAt": 0
}
]
},
{
"ouName": "Sales",
"ouId": 2,
"activities": [
{
"activityId": 4,
"activityName": "Customer Management",
"purposeShort": "Customer management",
"purposeLong": "Order management, logistics, billing, and collections management",
"legalbasis": ["Contract"],
"legalbasisLong": "",
"legalbasisSpecial": [],
"dataCategories": ["Identification"],
"datasubjectCategories": "Customers",
"activityCategories": [
"DataCollection",
"DataGeneration",
"DataAccess"
],
"dataOrigin": "From other public administrations or private entities; From the data subject or their legal representative",
"timeLimit": "As long as necessary to fulfill the purpose for which they were collected and to determine possible responsibilities arising from the processing.",
"profiling": true,
"communications": "",
"communicationsLong": "",
"controllers": [0],
"processors": [4],
"transfers": false,
"transfersLong": "Not made",
"securityLevel": "medium",
"securityMeasuresLong": "Not required.",
"activityExpirationDate": "2099-12-31",
"forcedInactive": false,
"active": true,
"createdAt": 0,
"updatedAt": 0
}
]
}
],
"createdAt": "2026-05-18T00:00:00.000Z",
"updatedAt": "2026-05-18T00:00:00.000Z"
}
],
"templates": []
}
ZIP datu-fitxategiaren formatua
Eduki bera, CSV fitxategitan banatuta: bat erregistro-mota bakoitzeko —erakundea, bere hizkuntzak, bazkideak, kontaktuak, kontratuak eta unitate organikoak— eta bat hizkuntza bakoitzeko jardueretarako. Erregistro bakoitza fitxategi bateko errenkada bat da, eta bazkideen logotipoak logos karpetako irudi-fitxategiak dira. Kalkulu-orri batean ireki eta editatzeko pentsatua, ez script batek edo AA laguntzaile batek irakurtzeko.
demo izen laburra duen erakunde baterako, artxiboak hau du:
| Fitxategia | Edukia |
|---|---|
demo-organization.csv | Erakundea bera: errenkada bakarra |
demo-locales.csv | Errenkada bat konfiguratutako hizkuntza bakoitzeko |
demo-partners.csv | Errenkada bat bazkide bakoitzeko |
demo-contacts.csv | Errenkada bat kontaktu bakoitzeko, bazkide batena zein unitate organiko batena izan |
demo-contracts.csv | Errenkada bat kontratu bakoitzeko |
demo-ous.csv | Errenkada bat unitate organiko bakoitzeko, jarduerak izan ala ez: bere kolorea eta bere izena hizkuntza bakoitzean |
demo-ropa-en.csv, demo-ropa-de.csv, … | Errenkada bat tratamendu-jarduera bakoitzeko, fitxategi bat hizkuntza bakoitzeko |
logos/partner-0.png, … | Bazkide bakoitzaren logotipoa, irudi-fitxategi gisa; logotipoa duten bazkideentzat bakarrik |
demo-templates.json | Zure txantiloi pertsonalizatuak; baduzu bakarrik agertzen da |
Adibide bat deskargatu: demo-export.zip, demo erakundearen esportazio osoa.
Fitxategi guztiek konbentzio berberak jarraitzen dituzte:
- UTF-8, komaz bereizita, zutabe-izenak lehen errenkadan. Koma, komatxo edo lerro-jauzi bat duen gelaxka komatxo bikoitzen artean jartzen da, eta barruko komatxoak bikoiztu egiten dira; kalkulu-orriek zuregatik egiten dute.
- Bai/ez eremuek
trueedofalsedute. - Balio anitzeko eremuek balioak
|bidez bereizita dituzte, adib.Contract|LegalObligation. - Gelaxka bakoitzak balio bakarra du. Kontaktu baten helbide elektronikoek eta telefono-zenbakiek zenbakidun zutabeak hartzen dituzte —
email1…email5,phoneNumber1…phoneNumber5—, kontaktu batek bakoitzetik gehienez bost baititu; erabiltzen ez direnak hutsik geratzen dira. Salbuespen bakarra erakundearen atributu lehenetsiak dira (defaultActivityAttributes), JSON testu gisa gordetzen baitira gelaxka bakar batean. - Fitxategiek zenbakiz egiten diote erreferentzia elkarri:
controllers,processorsetapartnerIdseremuek bazkideenorganizationIddute,activityIdseremuakactivityId,ouIderemuak jarduera bat bere unitate organikoarekin lotzen du, etaparentTypeetaparentIderemuek kontaktu bat bere bazkidearekin (partner,organizationIdbat) edo unitatearekin (ou,ouIdbat) lotzen dute. formatVersioneremuak, erakundearen fitxategiko lehen zutabeak, artxiboak zer egitura duen adierazten du. Egitura hau sortu aurretik esportatutako artxiboak inporta daitezke oraindik.
demo-organization.csv
Erakundearen beraren ezarpenak: artxiboaren formatVersion, izen laburra, unitate, jarduera, bazkide eta kontratu berriak zenbakitzeko kontagailuak, eta jarduera berri baten balio lehenetsiak (defaultActivityAttributes, JSON formatuan). Gutxitan editatu beharko duzu fitxategi hau.
formatVersion,shortName,licenseStart,licenseEnd,licenseCost,isBlocked,isPublic,isDemo,highestOuId,highestActivityId,highestPartnerId,highestContractId,schemaVersion,defaultActivityAttributes
2,demo,0,0,0,false,true,true,4,7,7,11,15,"{""activityId"":0,""activityName"":"""",""role"":""Controller"",""purposeShort"":"""",""purposeLong"":"""",""legalbasis"":[""Consent""],""legalbasisLong"":"""",""legalbasisSpecial"":[""ExplicitConsent""],""dataCategories"":[""Characteristics"",""Identification""],""datasubjectCategories"":"""",""activityCategories"":[""DataCollection"",""DataStorage""],""dataOrigin"":"""",""timeLimit"":"""",""profiling"":false,""communications"":"""",""communicationsLong"":"""",""controllers"":[0],""processors"":[],""transfers"":false,""transfersLong"":"""",""securityLevel"":""low"",""securityMeasuresLong"":"""",""active"":false,""createdAt"":0,""updatedAt"":0}"
demo-locales.csv
Konfiguratutako hizkuntzak eta zein den lehenetsia. Hemen zerrendatutako hizkuntza bakoitzak bere demo-ropa-<locale>.csv du.
locale,isDefault
en,true
de,false
demo-partners.csv
Errenkada bat bazkide bakoitzeko; erakundea bera 0 bazkidea da. Posta-helbidea bere zutabeetan banatuta dago, organizationLogo eremuak bazkidearen logotipo-fitxategia adierazten du logos karpetan, eta contractOrder bazkidearen kontratuak erakusteko ordena da. Kontaktuak demo-contacts.csv fitxategian daude.
organizationId,organizationName,organizationNameLong,organizationColor,organizationWebsite,organizationVatNumber,addressLine1,addressLine2,city,stateProvince,postalCode,country,organizationLogo,organizationNotes,contractOrder
0,TEST,Demo Organization,#2563EB,,,Test Avenue,Test Org Main Office,Testville,,00000,LX,,Self organization. This is the organization owning this ROPA.,
1,CloudStore,CloudStore Solutions Inc.,#0891B2,https://www.cloudstore-demo.com,,123 Tech Boulevard,Suite 400,San Francisco,California,94105,US,,Cloud storage provider for document archiving and backup services. Primary data processor for file storage.,1|9
demo-contacts.csv
Errenkada bat kontaktu bakoitzeko. parentType eta parentId eremuek zein den kontaktuaren jabea adierazten dute —partner eta organizationId bat, edo ou eta ouId bat—, eta errenkadek zerrenda bakoitzaren ordena gordetzen dute, beraz bazkide edo unitate baten lehen kontaktua lehenengo dator. Helbide elektroniko batek hiru zutabe hartzen ditu (email, emailDescription, emailIsPrimary) eta telefono batek lau (countryCode, phoneNumber, phoneDescription, phoneIsPrimary), bakoitza 1etik 5era zenbakituta.
parentType,parentId,contactId,contactFirstname,contactLastname,contactRole,contactNotes,email1,emailDescription1,emailIsPrimary1,email2,emailDescription2,emailIsPrimary2,email3,emailDescription3,emailIsPrimary3,email4,emailDescription4,emailIsPrimary4,email5,emailDescription5,emailIsPrimary5,countryCode1,phoneNumber1,phoneDescription1,phoneIsPrimary1,countryCode2,phoneNumber2,phoneDescription2,phoneIsPrimary2,countryCode3,phoneNumber3,phoneDescription3,phoneIsPrimary3,countryCode4,phoneNumber4,phoneDescription4,phoneIsPrimary4,countryCode5,phoneNumber5,phoneDescription5,phoneIsPrimary5
partner,0,1,John,Smith,DPO,Data Protection Officer. Primary contact for GDPR compliance matters.,dpo@test-organization.com,DPO Office,true,,,,,,,,,,,,,+1,5551234567,Office,true,,,,,,,,,,,,,,,,
partner,1,1,Sarah,Mitchell,DPO,Available Mon-Fri 9am-5pm PST. Preferred contact for data protection matters.,sarah.mitchell@cloudstore-demo.com,Work,true,dpo@cloudstore-demo.com,DPO Office,false,,,,,,,,,,+1,4155551234,Office,true,+1,4155559876,Mobile,false,,,,,,,,,,,,
partner,1,2,James,Rodriguez,Technical,Technical lead for API integration and data migration projects.,james.rodriguez@cloudstore-demo.com,Work,true,,,,,,,,,,,,,+1,4155552345,Office,true,,,,,,,,,,,,,,,,
partner,1,3,Emily,Chen,Support,Customer support manager. Contact for service issues and incidents.,emily.chen@cloudstore-demo.com,Work,true,support@cloudstore-demo.com,Support Team,false,,,,,,,,,,+1,4155553456,Support Line,true,,,,,,,,,,,,,,,,
ou,1,1,Laura,Novak,HR Manager,Owns the staff records and answers employees' data access requests.,hr@test-organization.com,HR Office,true,,,,,,,,,,,,,+1,5551230001,Office,true,,,,,,,,,,,,,,,,
ou,1,2,Peter,Hall,Payroll Lead,,payroll@test-organization.com,Work,true,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
demo-contracts.csv
Errenkada bat kontratu bakoitzeko, jarduerak eta bazkideak beren identifikatzaileen bidez lotzen dituena.
contractId,contractName,contractUrl,contractExpirationDate,contractDescription,activityIds,partnerIds
1,HR-SYS-2024,https://example.com/contracts/hr-sys-2024,2025-12-31,HR management system service agreement including payroll processing and training management,1,1
2,DPA-BENEFITS-2024,https://example.com/contracts/dpa-benefits,2026-06-30,Data processing agreement for employee benefits administration and healthcare coordination,1,5
3,OSH-2024,https://example.com/contracts/osh-2024,2025-08-31,Occupational safety and health surveillance service agreement with medical assessment provider,3,2
demo-ous.csv
Errenkada bat unitate organiko bakoitzeko, oraindik jarduerarik ez dutenak barne: ouId, unitatearen kolorea eta name_<locale> zutabe bat hizkuntza bakoitzeko, elkarren ondoan. Unitate baten izena duen fitxategi bakarra da; bere kontaktuak demo-contacts.csv fitxategian daude.
ouId,ouColor,name_en,name_de
1,#C084FC,Human Resources,Personalwesen
2,#1c7958,Sales,Vertrieb
demo-ropa-en.csv
Errenkada bat jarduera bakoitzeko. Lehen bi zutabeak hizkuntza eta ouId dira, jardueraren unitate organikoaren zenbakia (bere izena demo-ous.csv fitxategian dago); gainerakoak jardueraren eremuak dira, formularioan agertzen diren bezala. Balio anitzekoak legalbasis, legalbasisSpecial, dataCategories, activityCategories, controllers eta processors dira.
locale,ouId,activityId,activityName,purposeShort,purposeLong,legalbasis,legalbasisLong,legalbasisSpecial,dataCategories,datasubjectCategories,activityCategories,dataOrigin,timeLimit,profiling,communications,communicationsLong,controllers,processors,transfers,transfersLong,securityLevel,securityMeasuresLong,active,activityExpirationDate,forcedInactive,createdAt,updatedAt
en,1,1,Staff Management,Staff management,"Management of training, payroll, promotion, and other aspects related to work life",Contract|LegalObligation,,Employment|Healthcare,Identification,Students; Other individuals related to the University; Former students,DataCollection|DataGeneration|DataAccess,From the data subject or their legal representative; Reuse of data already held by the controller in other processing operations,As long as necessary to fulfill the purpose for which they were collected and to determine possible responsibilities arising from the processing. Until consent is revoked.,false,-,-,0,1|5,true,"International transfers (outside the EEA) of personal data may be made to companies providing information society services, subject to the signing of contracts, and to other institutions with which data transfer agreements have been signed, in both cases respecting legality",low,Not required.,false,2099-12-31,false,0,0
en,2,4,Customer Management,Customer management,"Order management, logistics, billing, and collections management",Contract,,,Identification,Customers,DataCollection|DataGeneration|DataAccess,From other public administrations or private entities; From the data subject or their legal representative,As long as necessary to fulfill the purpose for which they were collected and to determine possible responsibilities arising from the processing.,true,,,0,4,false,Not made,medium,Not required.,true,2099-12-31,false,0,0
Adibideak demo erakundetik datoz, bi bazkide, hiru kontratu, bi hizkuntza eta bi jardueratara murriztuta.