diff --git a/markdownpages/profit/en/app-connector-auditor-developer.md b/markdownpages/profit/en/app-connector-auditor-developer.md index 88db2ec..9ff3019 100644 --- a/markdownpages/profit/en/app-connector-auditor-developer.md +++ b/markdownpages/profit/en/app-connector-auditor-developer.md @@ -1,6 +1,6 @@ --- author: Eric Zwaal -date: 2026-02-04 +date: 2026-02-24 index: true tags: AppConnector, Auditor, Developer, GetConnector, API, Integration title: AppConnector Auditor - Developer Report @@ -52,7 +52,7 @@ The levels are: ### Data model -#### `Employment number` and `Employment sequence number` are both used. +#### DATA-20: `Employment number` and `Sequence number of employment` are both used. **Level:** ❌ Error @@ -75,7 +75,7 @@ A small number of tables use `Employment sequence number` in the primary key. In ### Datamodel -#### This GetConnector retrieves fields from `Current data per employment relationship`, but the integration uses data per employment. +#### DATA-21: This GetConnector retrieves fields from `Current data per employment relationship`, but the integration uses data per employment. **Level:** ❌ Error @@ -90,7 +90,7 @@ Use `Current data per employment` or avoid current tables entirely. Consult with --- -#### This GetConnector has unknown fields. +#### DATA-23: This GetConnector has unknown fields. **Level:** ❌ Error @@ -105,7 +105,7 @@ Remove the unknown fields, or link them to a field in the database. If they are --- -#### This GetConnector has custom fields. +#### DATA-24: This GetConnector has free fields. **Niveau:** ℹ️ Informatief @@ -121,7 +121,7 @@ If you want to use this GetConnector in another environment, these custom fields --- -#### This GetConnector uses compression. +#### DATA-25: This GetConnector uses aggregation. **Level:** ℹ️ Informational @@ -136,7 +136,7 @@ Use compression only consciously. If in doubt: consult with AFAS. --- -#### This GetConnector has fields with a special format. +#### DATA-26: This GetConnector has fields with a special format. **Level:** ⚠️ Warning @@ -154,7 +154,7 @@ Use these fields only for presentation and never filter/sort on these fields. ### Performance -#### This GetConnector lacks fields that are needed to optimally use the indexes for sorting. +#### PERF-45: This GetConnector is missing fields needed to optimally use the indexes for sorting. **Level:** ⚠️ Warning @@ -169,7 +169,7 @@ Make index fields visible and use them in sorting and filtering. --- -#### Unique indexes on the main table of this GetConnector. +#### PERF-46: Unique indexes on the main table of this GetConnector. **Level:** ℹ️ Informational @@ -181,7 +181,7 @@ Use these indexes for optimal performance. The fields in these indexes identify --- -#### This GetConnector retrieves data from tables more than 5 levels deep. +#### PERF-52: This GetConnector retrieves data from tables more than 5 levels deep. **Level:** ⚠️ Warning @@ -201,7 +201,7 @@ Check if you can simplify the GetConnector by using less deeply nested tables. ### Selection & filtering -#### The filter uses 'contains (not)', 'starts (not) with' or 'ends (not) with'. +#### FILT-47: The filter uses 'contains (not)', 'starts (not) with' or 'ends (not) with'. **Level:** ❌ Error @@ -217,7 +217,7 @@ Use equality filters (`=`, `>`, `<` etc.) on index fields. --- -#### This GetConnector retrieves data from more than 5 different tables. +#### PERF-34: This GetConnector retrieves data from more than 5 different tables. **Level:** ⚠️ Warning @@ -233,7 +233,7 @@ Only action needed if performance issues occur. In that case, create multiple Ge --- -#### This GetConnector retrieves data from a very large table. +#### PERF-35: This GetConnector retrieves data from a very large table. **Level:** ⚠️ Warning @@ -250,7 +250,7 @@ Ensure that your filters and sorting make optimal use of indexes. Use as few joi ## Authorization & Privacy -#### This GetConnector is authorized. +#### AUT-16: This GetConnector is authorized. **Level:** ⚠️ Warning @@ -265,7 +265,7 @@ Be sure the connector user received the correct access rights. --- -#### This GetConnector has fields that are marked as privacy-sensitive. +#### AUT-19: This GetConnector has fields marked as privacy-sensitive. **Level:** ⚠️ Warning @@ -279,11 +279,23 @@ Possible GDPR risk. Only retrieve strictly necessary data +--- + +## System Integrator support + +Need help as a developer? You can use support from AFAS System Integrators. + +⚠️ **Important:** Support for developers is paid. + +Submit a System Integrator Request via [https://klant.afas.nl/systemintegrators](https://klant.afas.nl/systemintegrators). + +System Integrators have strong knowledge of AFAS Profit and can therefore assess your GetConnectors quickly and effectively. They can also help add the correct fields when those are not directly available in your current setup. + --- ## Conclusion -This help is intended as a **reference work and technical specification**, not as a replacement for personal consultation. +This help is intended as a **reference work and technical specification**, not as a replacement for [System Integrator support](#system-integrator-support). This document is never finished. Do you see something that is incorrect, or do you have suggestions for improvement? Make a pull request on the [GitHub page of the documentation](https://github.com/AFASSoftware/OASContent/blob/main/markdownpages/profit/en/app-connector-auditor-developer.md). diff --git a/markdownpages/profit/en/app-connector-auditor-partner.md b/markdownpages/profit/en/app-connector-auditor-partner.md index 5ce757d..793e26c 100644 --- a/markdownpages/profit/en/app-connector-auditor-partner.md +++ b/markdownpages/profit/en/app-connector-auditor-partner.md @@ -1,6 +1,6 @@ --- author: Eric Zwaal -date: 2026-02-04 +date: 2026-02-24 index: true tags: AppConnector, Auditor, Partner, Certification, GetConnector, pentest title: AppConnector Auditor - Partner Report @@ -25,7 +25,7 @@ This report is specifically designed for **AFAS Partners** and contains the stri * **Certification impact:** Every message affects your partner status * **Deadlines:** Hard deadlines apply for some messages -> During the certification process, there is intensive contact with AFAS System Integrators. If you have doubts about a message or cannot resolve it independently, always contact us. +> During the certification process, there is intensive contact with AFAS System Integrators. If you have doubts about a message or cannot resolve it independently, always [contact us](#lets-talk). --- @@ -97,7 +97,7 @@ This section contains partner-specific messages about the AppConnector itself (n ### Authorization & Privacy -#### Filter authorization is applied. +#### AUT-17: Filter authorization is applied. **Level:** ⚠️ Warning **Certification impact:** Must be resolved or documented @@ -120,7 +120,7 @@ If authorizations are not properly configured, the integration gets too much or ### Data model -#### `Employment number` and `Employment sequence number` are both used. +#### DATA-20: `Employment number` and `Sequence number of employment` are both used. **Level:** ❌ Error **Certification impact:** **Blocks certification** @@ -141,7 +141,7 @@ A small number of tables use `Employment sequence number` in the primary key. In ### Performance & scalability -#### Financial transactions are retrieved, but `Changed booking days` is not used. +#### PERF-30: Financial mutations are being retrieved, but `Changed booking days` is not used. **Level:** ❌ Error **Certification impact:** **Blocks certification** @@ -157,7 +157,7 @@ Use an additional GetConnector based on the data collection `Changed booking day --- -#### Post-calculation is retrieved, but `Changed booking days post-calculation` is not used. +#### PERF-31: Post-calculation is being retrieved, but `Changed booking days post-calculation` is not used. **Level:** ❌ Error @@ -178,7 +178,7 @@ Use an additional GetConnector based on the data collection `Changed booking day ### Connector structure -#### This is a supplied Profit GetConnector. +#### STRUCT-27: This is an included Profit GetConnector. **Level:** ❌ Error **Certification impact:** **Blocks certification** @@ -202,7 +202,7 @@ Never use `Profit` or `AFAS` in the name; that is clear to the customer anyway. --- -#### This GetConnector has a name that starts with `Profit_`. +#### STRUCT-28: TThis GetConnector has a name that starts with `Profit_`. **Level:** ❌ Error **Certification impact:** **Blocks certification** @@ -224,7 +224,7 @@ Never use `Profit` or `AFAS` in the name. --- -#### This GetConnector has fields with a period in the name. +#### STRUCT-29: This GetConnector has fields with a dot in the name. **Level:** ❌ Error **Certification impact:** **Blocks certification** @@ -242,7 +242,7 @@ Adjust the relevant field names and remove the period. ### Data model -#### This GetConnector retrieves fields from `Current data per employment relationship`, but the integration uses data per employment. +#### DATA-21: This GetConnector retrieves fields from `Current data per employment relationship`, but the integration uses data per employment. @@ -256,11 +256,11 @@ This GetConnector retrieves fields from `Current data per employment relationshi With multiple simultaneous employments, incorrect or incomplete data is retrieved. These errors are very difficult to trace. **Solution** -Use `Current data per employment` or avoid current tables entirely. Consult with System Integrators if in doubt. +Use `Current data per employment` or avoid current tables entirely. Consult with System Integrators via [let's talk](#lets-talk) if in doubt. --- -#### This GetConnector has unknown fields. +#### DATA-23: This GetConnector has unknown fields. **Level:** ❌ Error **Certification impact:** **Blocks certification** @@ -276,7 +276,7 @@ Remove the unknown fields, or link them to a field in the database. If they are --- -#### This GetConnector has custom fields. +#### DATA-24: This GetConnector has free fields. @@ -296,7 +296,7 @@ Custom fields do not exist by default in every customer environment. --- -#### This GetConnector uses compression. +#### DATA-25: This GetConnector uses aggregation. @@ -314,7 +314,7 @@ Use compression only consciously. If in doubt: consult with AFAS. --- -#### This GetConnector has fields with a special format. +#### DATA-26: This GetConnector has fields with a special format. **Level:** ⚠️ Warning **Certification impact:** Must be resolved or justified @@ -332,7 +332,7 @@ Use these fields only for presentation and never filter/sort on these fields. ### Performance -#### This GetConnector has (possibly) a cyclic reference. +#### PERF-32: This GetConnector (possibly) has a cyclic reference. **Level:** ⚠️ Warning @@ -350,7 +350,7 @@ If not: simplify the GetConnector. --- -#### This GetConnector possibly uses a subselect. +#### PERF-33: This GetConnector may use a subselect. **Level:** ⚠️ Warning @@ -363,12 +363,12 @@ If not: simplify the GetConnector. Subselects can be executed per row and can negatively affect performance. **Solution** -Only action needed if performance issues occur. Get advice from System Integrators. +Only action needed if performance issues occur. Get advice from System Integrators via [let's talk](#lets-talk). --- -#### This GetConnector retrieves data from more than 5 different tables. +#### PERF-34: This GetConnector retrieves data from more than 5 different tables. **Level:** ⚠️ Warning @@ -382,13 +382,13 @@ Using many joins can cause performance problems, especially with large tables. **Solution** -Only action needed if performance issues occur. In that case, create multiple GetConnectors that each use fewer tables. Get advice from System Integrators. +Only action needed if performance issues occur. In that case, create multiple GetConnectors that each use fewer tables. Get advice from System Integrators via [let's talk](#lets-talk). --- -#### This GetConnector retrieves data from a very large table. +#### PERF-35: This GetConnector retrieves data from a very large table. **Level:** ⚠️ Warning @@ -406,7 +406,7 @@ Ensure that your filters and sorting make optimal use of indexes. Use as few joi --- -#### This GetConnector retrieves fields from a table that is also available as an alias. +#### PERF-36: This GetConnector retrieves fields from a table that is also available as an alias. @@ -424,7 +424,7 @@ Check if you can use the alias table instead of the longer path. This gives bett --- -#### This GetConnector also retrieves fields from another alias. +#### PERF-37: This GetConnector also retrieves fields from another alias. **Level:** ⚠️ Warning @@ -443,7 +443,7 @@ Test yourself, or consult with AFAS, whether the indexes are unique. If not: exp --- -#### This GetConnector lacks fields that are needed to optimally use the indexes for sorting. +#### PERF-45: This GetConnector is missing fields needed to optimally use the indexes for sorting. **Level:** ⚠️ Warning **Certification impact:** Must be resolved @@ -459,7 +459,7 @@ Make index fields visible and use them in sorting and filtering. --- -#### Unique indexes on the main table of this GetConnector. +#### PERF-46: Unique indexes on the main table of this GetConnector. **Level:** ℹ️ Informational **Certification impact:** Best practice @@ -472,7 +472,7 @@ Use these indexes for optimal performance. The fields in these indexes identify --- -#### This GetConnector retrieves data from tables more than 5 levels deep. +#### PERF-52: This GetConnector retrieves data from tables more than 5 levels deep. **Level:** ⚠️ Warning **Certification impact:** Resolve or justify @@ -493,7 +493,7 @@ Check if you can simplify the GetConnector by using less deeply nested tables. ### Selection & filtering -#### The filter uses 'contains (not)', 'starts (not) with' or 'ends (not) with'. +#### FILT-47: The filter uses 'contains (not)', 'starts (not) with' or 'ends (not) with'. **Level:** ❌ Error @@ -510,7 +510,7 @@ Use equality filters (`=`, `>`, `<` etc.) on index fields. --- -#### This GetConnector has a user filter. +#### FILT-48: This GetConnector has a user filter. **Level:** ⚠️ Warning **Certification impact:** Must be resolved or documented @@ -530,7 +530,7 @@ Make filters dynamic via URL parameters or document limitations. ## Authorization & Privacy -#### This GetConnector is authorized. +#### AUT-16: This GetConnector is authorized. **Level:** ⚠️ Warning @@ -547,7 +547,7 @@ State in your implementation document which authorization filters apply --- -#### This GetConnector has fields that are marked as privacy-sensitive. +#### AUT-19: This GetConnector has fields marked as privacy-sensitive. **Level:** ⚠️ Warning @@ -566,12 +566,24 @@ Possible GDPR risk. --- +## Let's talk + +Do you have questions, remarks, bug reports, improvement suggestions, or complaints? Get in touch with us. The auditor is intended as a practical tool for you as a partner, for AFAS, and ultimately for the customer. + +Go to your own partner page at [https://partner.afas.nl/product-partner-portal](https://partner.afas.nl/product-partner-portal), sign in via the link at the top right, and choose the **Ask a question** tile. + +### No login yet? + +One or more of your colleagues are administrators on the customer portal and can add you as a contact person, so you can sign in yourself. + +--- + ## Conclusion This help is intended as a **reference work and technical specification**, not as a replacement for personal consultation. > Do you encounter a message that is not feasible for you, or do you have a well-justified reason to deviate from it? -> Contact the System Integrators – deviations can be assessed and recorded together. +> [Contact](#lets-talk) the System Integrators – deviations can be assessed and recorded together. This document is never finished. Do you see something that is incorrect, or do you have suggestions for improvement? Make a pull request on the [GitHub page of the documentation](https://github.com/AFASSoftware/OASContent/blob/main/markdownpages/profit/en/app-connector-auditor-partner.md). diff --git a/markdownpages/profit/nl/app-connector-auditor-developer.md b/markdownpages/profit/nl/app-connector-auditor-developer.md index 4f82375..708c08c 100644 --- a/markdownpages/profit/nl/app-connector-auditor-developer.md +++ b/markdownpages/profit/nl/app-connector-auditor-developer.md @@ -1,6 +1,6 @@ --- author: Eric Zwaal -date: 2026-02-04 +date: 2026-02-24 index: true tags: AppConnector, Auditor, Developer, GetConnector, API, Integration title: AppConnector Auditor - Ontwikkelaarsrapport @@ -52,7 +52,7 @@ De niveaus zijn: ### Datamodel -#### `Dienstverbandnummer` en `Volgnummer dienstverband` worden beide gebruikt. +#### DATA-20: `Dienstverbandnummer` en `Volgnummer dienstverband` worden beide gebruikt. **Niveau:** ❌ Fout @@ -75,7 +75,7 @@ Een klein aantal tabellen gebruikt `Volgnummer dienstverband` in de primaire sle ### Datamodel -#### Deze GetConnector haalt velden uit `Actuele gegevens per arbeidsverhouding`, maar de integratie gebruikt gegevens per dienstverband. +#### DATA-21: Deze GetConnector haalt velden uit `Actuele gegevens per arbeidsverhouding`, maar de integratie gebruikt gegevens per dienstverband. **Niveau:** ❌ Fout @@ -90,7 +90,7 @@ Gebruik `Actuele gegevens per dienstverband` of vermijd actuele tabellen volledi --- -#### Deze GetConnector heeft onbekende velden. +#### DATA-23: Deze GetConnector heeft onbekende velden. **Niveau:** ❌ Fout @@ -105,7 +105,7 @@ Verwijder de onbekende velden, of koppel ze aan een veld in de database. Mogelij --- -#### Deze GetConnector heeft vrije velden. +#### DATA-24: Deze GetConnector heeft vrije velden. **Niveau:** ℹ️ Informatief @@ -121,7 +121,7 @@ Als je deze GetConnector ook in een andere omgeving wilt gebruiken, moet je deze --- -#### Deze GetConnector gebruikt verdichting. +#### DATA-25: Deze GetConnector gebruikt verdichting. **Niveau:** ℹ️ Informatief @@ -137,7 +137,7 @@ Gebruik verdichting alleen bewust. Bij twijfel: overleg met AFAS. --- -#### Deze GetConnector heeft velden met een speciaal formaat. +#### DATA-26: Deze GetConnector heeft velden met een speciaal formaat. **Niveau:** ⚠️ Waarschuwing @@ -155,7 +155,7 @@ Gebruik deze velden alleen voor presentatie en filter/sorteer nooit op deze veld ### Performance -#### Deze GetConnector mist velden die nodig zijn om de indexen optimaal te gebruiken voor sortering. +#### PERF-45: Deze GetConnector mist velden die nodig zijn om de indexen optimaal te gebruiken voor sortering. **Niveau:** ⚠️ Waarschuwing @@ -170,7 +170,7 @@ Maak indexvelden zichtbaar en gebruik deze in sortering en filtering. --- -#### Unieke indexen op de hoofdtabel van deze GetConnector. +#### PERF-46: Unieke indexen op de hoofdtabel van deze GetConnector. **Niveau:** ℹ️ Informatief @@ -182,7 +182,7 @@ Gebruik deze indexen voor optimale performance. De velden in deze indexen identi --- -#### Deze GetConnector haalt gegevens op uit tabellen van meer dan 5 niveaus diep. +#### PERF-52: Deze GetConnector haalt gegevens op uit tabellen van meer dan 5 niveaus diep. **Niveau:** ⚠️ Waarschuwing @@ -202,7 +202,7 @@ Controleer of je de GetConnector kunt vereenvoudigen door minder diepe tabellen ### Selectie & filtering -#### Het filter maakt gebruik van 'bevat (niet)', 'begint (niet) met' of 'eindigt (niet) op'. +#### FILT-47: Het filter maakt gebruik van 'bevat (niet)', 'begint (niet) met' of 'eindigt (niet) op'. **Niveau:** ❌ Fout @@ -218,7 +218,7 @@ Gebruik gelijkheidsfilters (`=`, `>`, `<` etc.) op indexvelden. --- -#### Deze GetConnector haalt gegevens op uit meer dan 5 verschillende tabellen. +#### PERF-34: Deze GetConnector haalt gegevens op uit meer dan 5 verschillende tabellen. **Niveau:** ⚠️ Waarschuwing @@ -234,7 +234,7 @@ Alleen actie nodig bij performanceproblemen. Maak in dat geval meerdere GetConne --- -#### Deze GetConnector haalt gegevens op uit een zeer grote tabel. +#### PERF-35: Deze GetConnector haalt gegevens op uit een zeer grote tabel. **Niveau:** ⚠️ Waarschuwing @@ -251,7 +251,7 @@ Zorg ervoor dat je filters en sortering optimaal gebruikmaken van indexen. Gebru ## Autorisatie & Privacy -#### Deze GetConnector is geautoriseerd. +#### AUT-16: Deze GetConnector is geautoriseerd. **Niveau:** ⚠️ Waarschuwing @@ -266,7 +266,7 @@ Zorg ervoor dat de connectorgebruiker de juiste autorisaties heeft. --- -#### Deze GetConnector heeft velden die zijn gemarkeerd als privacygevoelig. +#### AUT-19: Deze GetConnector heeft velden die zijn gemarkeerd als privacygevoelig. **Niveau:** ⚠️ Waarschuwing @@ -280,11 +280,23 @@ Mogelijk AVG-risico. Haal alleen strikt noodzakelijke gegevens op +--- + +## Ondersteuning door Systemintegrators + +Hulp nodig als developer? Dan kun je ondersteuning inzetten van AFAS Systemintegrators. + +⚠️ **Belangrijk:** Deze ondersteuning is betaald. + +Dien een Aanvraag Systemintegrator in via [https://klant.afas.nl/systemintegrators](https://klant.afas.nl/systemintegrators). + +Systemintegrators hebben veel kennis van AFAS Profit en kunnen daardoor je GetConnectoren snel en effectief beoordelen. Ook kunnen ze helpen met het toevoegen van de juiste velden als die in jouw huidige inrichting niet direct beschikbaar zijn. + --- ## Tot slot -Deze help is bedoeld als **naslagwerk en technische specificatie**, niet als vervanging van persoonlijk overleg. +Deze help is bedoeld als **naslagwerk en technische specificatie**, niet als vervanging van [ondersteuning door Systemintegrators](#ondersteuning-door-systemintegrators). Dit document is nooit af. Zie je iets dat niet klopt, of heb je suggesties voor verbetering? Maak een pull request aan op de [GitHub-pagina van de documentatie](https://github.com/AFASSoftware/OASContent/blob/main/markdownpages/profit/nl/app-connector-auditor-developer.md). diff --git a/markdownpages/profit/nl/app-connector-auditor-partner.md b/markdownpages/profit/nl/app-connector-auditor-partner.md index 7053039..4375f05 100644 --- a/markdownpages/profit/nl/app-connector-auditor-partner.md +++ b/markdownpages/profit/nl/app-connector-auditor-partner.md @@ -1,6 +1,6 @@ --- author: Eric Zwaal -date: 2026-02-04 +date: 2026-02-24 index: true tags: AppConnector, Auditor, Partner, Certificering, GetConnector, pentest title: AppConnector Auditor - Partnerrapport @@ -22,25 +22,17 @@ Dit rapport is specifiek bedoeld voor **AFAS Partners** en bevat de strengste co * **Fouten zijn blokkerend:** Rode meldingen ❌ blokkeren je certificering * **Strengere eisen:** Meer controles en hogere kwaliteitsnormen -* **Certificerings-impact:** Elke melding heeft invloed op je partnerstatus +* **Certificeringsimpact:** Elke melding heeft invloed op je partnerstatus * **Deadlines:** Voor sommige meldingen gelden harde deadlines -> Tijdens het certificeringstraject is er intensief contact met AFAS Systemintegrators. Twijfel je over een melding of kun je deze niet zelfstandig oplossen, neem dan altijd contact met ons op. +> Tijdens het certificeringstraject is er intensief contact met AFAS Systemintegrators. Twijfel je over een melding of kun je deze niet zelfstandig oplossen, neem dan altijd [contact](#kom-in-gesprek) met ons op. --- -## Partnergegevens en administratie +## Partnergegevens Voor uitleg over de secties **Partnergegevens** en **Jouw koppelingen** die bovenaan het rapport worden getoond, zie [Partnergegevens en koppelingen](./app-connector-auditor-partnerinfo). -Deze sectie bevat kritieke informatie over: -* Je partnerstatus en certificering -* pentest-geldigheid en verloopdata -* Contactpersonen en projectleiders -* Openstaande projecttaken en deadlines - -⚠️ **Let op:** Verlopen pentests of overschreden deadlines hebben direct gevolgen voor de certificering van je koppeling. - --- ## Partner-specifieke vereisten @@ -93,11 +85,11 @@ Deze sectie bevat partner-specifieke meldingen over de AppConnector zelf (niet d --- -## GetConnectoren – Overkoepelend +## GetConnectoren: overkoepelend ### Autorisatie & Privacy -#### Er wordt filterautorisatie toegepast. +#### AUT-17: Er wordt filterautorisatie toegepast. **Niveau:** ⚠️ Waarschuwing @@ -120,7 +112,7 @@ Als autorisaties niet goed zijn ingericht, krijgt de integratie te veel of te we ### Datamodel -#### `Dienstverbandnummer` en `Volgnummer dienstverband` worden beide gebruikt. +#### DATA-20: `Dienstverbandnummer` en `Volgnummer dienstverband` worden beide gebruikt. **Niveau:** ❌ Fout **Certificerings-impact:** **Blokkeert certificering** @@ -141,7 +133,7 @@ Een klein aantal tabellen gebruikt `Volgnummer dienstverband` in de primaire sle ### Performance & schaalbaarheid -#### Er worden Financiële mutaties opgehaald, maar `Gewijzigde boekingsdagen` wordt niet gebruikt. +#### PERF-30: Er worden Financiële mutaties opgehaald, maar `Gewijzigde boekingsdagen` wordt niet gebruikt. **Niveau:** ❌ Fout **Certificerings-impact:** **Blokkeert certificering** @@ -157,7 +149,7 @@ Maak gebruik van een extra GetConnector, gebaseerd op de gegevensverzameling `Ge --- -#### Er wordt Nacalculatie opgehaald, maar `Gewijzigde boekingsdagen nacalculatie` wordt niet gebruikt. +#### PERF-31: Er wordt Nacalculatie opgehaald, maar `Gewijzigde boekingsdagen nacalculatie` wordt niet gebruikt. **Niveau:** ❌ Fout @@ -174,11 +166,11 @@ Maak gebruik van een extra GetConnector, gebaseerd op de gegevensverzameling `Ge --- -## GetConnector – Individueel +## GetConnector: individueel ### Connectorstructuur -#### Dit is een meegeleverde Profit GetConnector. +#### STRUCT-27: Dit is een meegeleverde Profit GetConnector. **Niveau:** ❌ Fout **Certificerings-impact:** **Blokkeert certificering** @@ -202,7 +194,7 @@ Gebruik nooit `Profit` of `AFAS` in de naam; dat is voor de klant wel duidelijk. --- -#### Deze GetConnector heeft een naam die begint met `Profit_`. +#### STRUCT-28: Deze GetConnector heeft een naam die begint met `Profit_`. **Niveau:** ❌ Fout **Certificerings-impact:** **Blokkeert certificering** @@ -224,7 +216,7 @@ Gebruik nooit `Profit` of `AFAS` in de naam. --- -#### Deze GetConnector heeft velden met een punt in de naam. +#### STRUCT-29: Deze GetConnector heeft velden met een punt in de naam. **Niveau:** ❌ Fout **Certificerings-impact:** **Blokkeert certificering** @@ -242,7 +234,7 @@ Pas de betreffende veldnamen aan en verwijder de punt. ### Datamodel -#### Deze GetConnector haalt velden uit `Actuele gegevens per arbeidsverhouding`, maar de integratie gebruikt gegevens per dienstverband. +#### DATA-21: Deze GetConnector haalt velden uit `Actuele gegevens per arbeidsverhouding`, maar de integratie gebruikt gegevens per dienstverband. @@ -256,11 +248,11 @@ Deze GetConnector haalt velden uit `Actuele gegevens per arbeidsverhouding`, maa Bij meerdere gelijktijdige dienstverbanden worden onjuiste of onvolledige gegevens opgehaald. **Oplossing** -Gebruik `Actuele gegevens per dienstverband` of vermijd actuele tabellen volledig. Overleg bij twijfel met de Systemintegrators. +Gebruik `Actuele gegevens per dienstverband` of vermijd actuele tabellen volledig. Overleg bij twijfel met de Systemintegrators via [kom in gesprek](#kom-in-gesprek). --- -#### Deze GetConnector heeft onbekende velden. +#### DATA-23: Deze GetConnector heeft onbekende velden. **Niveau:** ❌ Fout **Certificerings-impact:** **Blokkeert certificering** @@ -276,7 +268,7 @@ Verwijder de onbekende velden, of koppel ze aan een veld in de database. Als het --- -#### Deze GetConnector heeft vrije velden. +#### DATA-24: Deze GetConnector heeft vrije velden. @@ -296,7 +288,7 @@ Vrije velden bestaan niet standaard in elke klantomgeving. --- -#### Deze GetConnector gebruikt verdichting. +#### DATA-25: Deze GetConnector gebruikt verdichting. @@ -314,7 +306,7 @@ Gebruik verdichting alleen bewust. Bij twijfel: overleg met AFAS. --- -#### Deze GetConnector heeft velden met een speciaal formaat. +#### DATA-26: Deze GetConnector heeft velden met een speciaal formaat. **Niveau:** ⚠️ Waarschuwing **Certificerings-impact:** Moet opgelost of onderbouwd worden @@ -332,7 +324,7 @@ Gebruik deze velden alleen voor presentatie en filter/sorteer nooit op deze veld ### Performance -#### Deze GetConnector heeft (mogelijk) een cyclische verwijzing. +#### PERF-32: Deze GetConnector heeft (mogelijk) een cyclische verwijzing. **Niveau:** ⚠️ Waarschuwing @@ -350,7 +342,7 @@ Zo niet: vereenvoudig de GetConnector. --- -#### Deze GetConnector gebruikt mogelijk een subselect. +#### PERF-33: Deze GetConnector gebruikt mogelijk een subselect. **Niveau:** ⚠️ Waarschuwing @@ -363,12 +355,12 @@ In de SQL-definitie komt meerdere keren `SELECT` voor. Subselects kunnen per rij worden uitgevoerd en kunnen de performance negatief beïnvloeden. **Oplossing** -Alleen actie nodig bij performanceproblemen. Laat je adviseren door Systemintegrators. +Alleen actie nodig bij performanceproblemen. Laat je adviseren door Systemintegrators via [kom in gesprek](#kom-in-gesprek). --- -#### Deze GetConnector haalt gegevens op uit meer dan 5 verschillende tabellen. +#### PERF-34: Deze GetConnector haalt gegevens op uit meer dan 5 verschillende tabellen. **Niveau:** ⚠️ Waarschuwing @@ -382,13 +374,13 @@ Het gebruik van veel joins kan performanceproblemen veroorzaken, met name bij gr **Oplossing** -Alleen actie nodig bij performanceproblemen. Maak in dat geval meerdere GetConnectoren aan die elk minder tabellen gebruiken. Laat je adviseren door Systemintegrators. +Alleen actie nodig bij performanceproblemen. Maak in dat geval meerdere GetConnectoren aan die elk minder tabellen gebruiken. Laat je adviseren door Systemintegrators via [kom in gesprek](#kom-in-gesprek). --- -#### Deze GetConnector haalt gegevens op uit een zeer grote tabel. +#### PERF-35: Deze GetConnector haalt gegevens op uit een zeer grote tabel. **Niveau:** ⚠️ Waarschuwing @@ -406,7 +398,7 @@ Zorg ervoor dat je filters en sortering optimaal gebruikmaken van indexen. Gebru --- -#### Deze GetConnector haalt velden uit een tabel die ook als alias beschikbaar is. +#### PERF-36: Deze GetConnector haalt velden uit een tabel die ook als alias beschikbaar is. @@ -424,7 +416,7 @@ Controleer of je de alias-tabel kunt gebruiken in plaats van het langere pad. Di --- -#### Deze GetConnector haalt ook velden op vanuit een andere alias. +#### PERF-37: Deze GetConnector haalt ook velden op vanuit een andere alias. **Niveau:** ⚠️ Waarschuwing @@ -443,7 +435,7 @@ Test zelf, of overleg met AFAS, of de indexen uniek zijn. Zo niet: breid de sort --- -#### Deze GetConnector mist velden die nodig zijn om de indexen optimaal te gebruiken voor sortering. +#### PERF-45: Deze GetConnector mist velden die nodig zijn om de indexen optimaal te gebruiken voor sortering. **Niveau:** ⚠️ Waarschuwing **Certificerings-impact:** Moet opgelost worden @@ -459,7 +451,7 @@ Maak indexvelden zichtbaar en gebruik deze in sortering en filtering. --- -#### Unieke indexen op de hoofdtabel van deze GetConnector. +#### PERF-46: Unieke indexen op de hoofdtabel van deze GetConnector. **Niveau:** ℹ️ Informatief **Certificerings-impact:** Best practice @@ -472,7 +464,7 @@ Gebruik deze indexen voor optimale performance. De velden in deze indexen identi --- -#### Deze GetConnector haalt gegevens op uit tabellen van meer dan 5 niveaus diep. +#### PERF-52: Deze GetConnector haalt gegevens op uit tabellen van meer dan 5 niveaus diep. **Niveau:** ⚠️ Waarschuwing **Certificerings-impact:** Oplossen of onderbouwen @@ -493,7 +485,7 @@ Controleer of je de GetConnector kunt vereenvoudigen door minder diepe tabellen ### Selectie & filtering -#### filter maakt gebruik van 'bevat (niet)', 'begint (niet) met' of 'eindigt (niet) op'. +#### FILT-47: Het filter maakt gebruik van 'bevat (niet)', 'begint (niet) met' of 'eindigt (niet) op'. **Niveau:** ❌ Fout @@ -510,7 +502,7 @@ Gebruik gelijkheidsfilters (`=`, `>`, `<` etc.) op indexvelden. --- -#### Deze GetConnector heeft een gebruikersfilter. +#### FILT-48: Deze GetConnector heeft een gebruikersfilter. **Niveau:** ⚠️ Waarschuwing **Certificerings-impact:** Moet opgelost of gedocumenteerd worden @@ -528,9 +520,9 @@ Maak filters dynamisch via URL-parameters of documenteer beperkingen. --- -## Autorisatie & Privacy +### Autorisatie & Privacy -#### Deze GetConnector is geautoriseerd. +#### AUT-16: Deze GetConnector is geautoriseerd. **Niveau:** ⚠️ Waarschuwing @@ -547,7 +539,7 @@ Documenteer gebruikte autorisaties in het implementatiedocument. --- -#### Deze GetConnector heeft velden die zijn gemarkeerd als privacygevoelig. +#### AUT-19: Deze GetConnector heeft velden die zijn gemarkeerd als privacygevoelig. **Niveau:** ⚠️ Waarschuwing @@ -566,12 +558,24 @@ Mogelijk AVG-risico. --- +## Kom in gesprek + +Heb je vragen, opmerkingen, bugreports, verbetersuggesties of klachten? Kom bij ons in de lucht. De auditor is bedoeld als hulpmiddel voor jou als partner, voor AFAS en uiteindelijk voor de klant. + +Ga naar jouw eigen partnerpagina op [https://partner.afas.nl/product-partner-portal](https://partner.afas.nl/product-partner-portal), log in via de link rechtsboven en kies de tegel **Stel een vraag**. + +### Heb je geen inlog? + +Een of meer van je collega's zijn beheerder op de klantportal en kunnen je toevoegen als contactpersoon, zodat je zelf kunt inloggen. + +--- + ## Afronding Deze help is bedoeld als **naslagwerk en technische specificatie**, niet als vervanging van persoonlijk overleg. > Kom je een melding tegen die voor jou niet haalbaar is, of heb je een goed onderbouwde reden om hiervan af te wijken? -> Neem contact op met de Systemintegrators – afwijkingen kunnen samen worden beoordeeld en vastgelegd. +> Neem [contact](#kom-in-gesprek) op met de Systemintegrators – afwijkingen kunnen samen worden beoordeeld en vastgelegd. Dit document is nooit af. Zie je iets dat niet klopt, of heb je suggesties voor verbetering? Maak een pull request aan op de [GitHub-pagina van de documentatie](https://github.com/AFASSoftware/OASContent/blob/main/markdownpages/profit/nl/app-connector-auditor-partner.md).