Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Added Styrelsen for Arbejdsmarked og Rekruttering
STARs Udstillings Platform (SUP)










Dokumentation:
Leverancebeskrivelse Dataområde "02 Aktiviteter"










Ansvarlig: Peter Tilsted
Version: 1.1
Status: Under udvikling


DOKUMENT HISTORIK

Dato

Version

Kommentarer og evt. årsag til ændring

Initialer

13-12-2016

0.1

Første version

PTI

07-02-2017

0.5

0.5 Review

JF

06-07-2018

1.1

1.1 release 2018-3 information

PTI

01-11-2019

1.2

1.2 release 2019-4 information

PTI

31-01-2020

1.3

1.3 release 2020-1 information

PTI




INDHOLDSFORTEGNELSE

Anchor
_Toc110311971
_Toc110311971
Anchor
_Toc110311972
_Toc110311972
Anchor
_Toc110312572
_Toc110312572
1 Indledning
1.1 Dokumentets formål
2 Forretningsmæssig beskrivelse
3 Filbeskrivelse
3.1 Noter til leverancen
3.1.1 Tabeller
3.1.2 Delta Leverance
3.1.2.1 Til- og fraflyttede borgere
3.1.3 Fuld Leverance
3.1.4 Sensitiv tekst
4 Tabelrelationer
5 Særlig bemærkninger
5.1 Datamængder pr 01/01/2017:
5.2 Ændringer i kommende releases
5.2.1 Datamodel
5.2.2 DataAnvendelse
6 Fillokation

Anchor
_Toc72503462
_Toc72503462
Indledning

Anchor
_Toc313025728
_Toc313025728
Anchor
_Toc72503463
_Toc72503463
Dokumentets formål

Dette dokument har til formål at vejlede aftagere af dataområde "02 Aktiviteter" på STARs udstillingsplat-form (SUP), i brugen af de aftagne data.
Herunder beskrivelse af filstrukturer, filrelationer, kolonnebeskrivelser, særlig bemærkninger for denne dataområde m.m.

Anchor
_Toc72503464
_Toc72503464
Forretningsmæssig beskrivelse


Dataområde "02 Aktiviteter" indeholder aktiviteter til en borgers plan.
Aktiviteterne vil blive tilknyttet en planversion og det vil sikres, at aktiviteterne overlever evt. plantypeskift, f.eks. fra uddannelsesplan til jobplan.
En aktivitet vil altid være en del af en plan og samme aktivitet vil kunne findes på flere planversioner.
Data opstår ved anvendelse af DFDG Servicen 'ActivityService', der opretter og vedligeholder aktiviteter til en borgers plan. Se beskrivelsen på starwiki her:
https://starwiki.atlassian.net/wiki/display/FYS/ActivityService

Anchor
_Toc72503465
_Toc72503465
Filbeskrivelse

Leverancen består af 16 tabeller:

  1. ActivityCompanyItem
  2. ActivityCompanyItemHistory
  3. ActivityCoreItem
  4. ActivityCoreItemHistory
  5. ActivityCourseItem
  6. ActivityCourseItemHistory
  7. ActivityHelpingDeviceItem
  8. ActivityHelpingDeviceItemHistory
  9. ActivityPersonalAssistanceItem
  10. ActivityPersonalAssistanceItemHistory
  11. ActivityMyPlanVersionLink
  12. ActivityUpdatedByRevision
  13. MyPlanVersion
  14. MyPlanVersionHistory
  15. HealthActivity
  16. HealthActivityHistory
  17. MentorActivity
  18. MentorActivityHistory
  19. SocialActivity
  20. SocialActivityHistory

6 nederste er nye med 2020-1
En fuldstændig beskrivelse af de enkelte tabeller i leverancen, kan ses i Excel dokumentet: "SUP 02-Aktiviteter DBDokumentation"

Anchor
_Toc473800888
_Toc473800888
Anchor
_Toc72503466
_Toc72503466
Noter til leverancen

Anchor
_Toc473800889
_Toc473800889
Anchor
_Toc72503467
_Toc72503467
Tabeller

Tabellen ActivityUpdatedByRevision har ingen forretningsmæssig betydning, men fortæller hvilke ExternalActivityIdentifier der er foretaget datagenopretning på, og hvornår.
Kan benyttes til at forklare ændringer i rækker i ActivityCoreItem

Anchor
_Toc473800890
_Toc473800890
Anchor
_Toc72503468
_Toc72503468
Delta Leverance

Der leveres ugentlige deltaleverancer indeholdende ændringerne siden forrige kørsel.
Bemærk at deltaleverancen indeholder 2 ekstra kolonner i hver tabel, placeret som de to første kolonner:

header__change_oper

Operation der har udløst deltarækken. I = Insert, U=Update, D=Delete

header__timestamp

Tidspunkt for operationen


Disse er nærmere beskrevet i Excel dokumentet "SUP 02-Aktiviteter DBDokumentation":

Anchor
_Toc72503469
_Toc72503469
Til- og fraflyttede borgere

Som beskrevet i dokumentet SUP dokumentation - Historik i leverancer vil der både ved Full- og Deltaleverancer, blive leveret én fil med fraflyttede borgere og en fil pr tabel med alle data for den tilflyttede borger
Filen med fraflyttede borgere er navngivet således:
02_FRAFLYTTET_ÅÅÅÅ_MM_DD.zip
Mens fil for tilflyttede borgere er navngivet således:
02_TabelNavn_TILFLYTNING_ÅÅÅÅ_MM_DD.zip

Anchor
_GoBack
_GoBack

Anchor
_Toc473800891
_Toc473800891
Anchor
_Toc72503470
_Toc72503470
Fuld Leverance

Der vil ved hvert månedsskift blive dannet en ny fuld leverance
Der vil maksimalt ligge 3 fulde leverancer på FTP Serveren

Anchor
_Toc473800892
_Toc473800892
Anchor
_Toc72503471
_Toc72503471
Sensitiv tekst

Det tilstræbes at undgå udstilling af sensitive data på STAR's udstillingsplatform.
Derfor kan alle kolonner der vurderes at indeholde sensitive data, undlades i udstillingen til aftagerne.
Hvilke kolonner det drejer om, vil løbende kunne rettes til ved aftale mellem aftagerne og STAR.
I den fuldstændig beskrivelse af de enkelte tabeller i leverancen, der kan ses i Excel dokumentet "SUP 02-Aktiviteter DBDokumentation",findes to kolonner der beskriver om den angivne kolonne i leverancen, er udvalgt som en kandidat til at indeholde sensitive data, og om den faktisk betragtes som indeholdende sensitive data.
Eksempel:
Image Added

Anchor
_Toc72503472
_Toc72503472
Tabelrelationer

Tabeller i leverancen er relaterede til hinanden på denne vis.
(for de fleste af leverancens tabeller findes en 'history' tabel der indeholder tidligere versioner af rækkerne, disse tabeller vises ikke i diagrammet)
Image Added
Et detaljeret relationsdiagram, udført med Visio v.10, kan ses i dokumentet "SUP 02-Aktiviteter Relationer"
Aktiviteter og Planer hænger naturligt sammen, så hvis begge datapakker er hentet, ses her deres relationer i en Visual Studio datamodel: PlanTotalModel

Anchor
_Toc72503473
_Toc72503473
Særlig bemærkninger


Anchor
_Toc473800895
_Toc473800895
Anchor
_Toc72503474
_Toc72503474
Datamængder pr 01/01/2017:

Full Load Rækker MB

    • ActivityCompanyItem 2.186.019 540
    • ActivityCompanyItemHistory 1.379.080 202
    • ActivityCoreItem 7.012.3839206
    • ActivityCoreItemHistory 9.068.8596755
    • ActivityCourseItem 4.791.6802740
    • ActivityCourseItemHistory 2.917.6791425
    • ActivityHelpingDeviceItem 17.1022
    • ActivityHelpingDeviceItemHistory 17.1162
    • ActivityPersonalAssistanceItem 17.5822
    • ActivityPersonalAssistanceItemHistory17.5932
    • ActivityMyPlanVersionLink 22.646.5943524
    • ActivityUpdatedByRevision 1.274.865114
    • MyPlanVersion 14.704.3718791
    • MyPlanVersionHistory 16.170.1522895

Anchor
_Toc473800896
_Toc473800896
Anchor
_Toc72503475
_Toc72503475
Ændringer i kommende releases

Dette afsnit vil løbende blive opdateret i forbindelse med de kvartalsvise STAR Release

Anchor
_Toc473800897
_Toc473800897
Anchor
_Toc72503476
_Toc72503476
Datamodel

2021-2 Nye kolonner i 2 tabeller:
Plan    ActivityCompanyItem     EmploymentGoalAliasIdentifier          uniqueidentifierPlan    ActivityCompanyItem     EmploymentGoalConceptUriDa         nvarchar 512Plan    ActivityCompanyItemHistory EmploymentGoalAliasIdentifier     uniqueidentifierPlan    ActivityCompanyItemHistory EmploymentGoalConceptUriDa    nvarchar 512

Anchor
_Toc473800898
_Toc473800898
Anchor
_Toc72503477
_Toc72503477
DataAnvendelse



Anchor
_Toc72503478
_Toc72503478
Fillokation

Filerne kan afhentes på SUP Platformens FTP Server.
Anvendelsen af denne er beskrevet i dokumentet "SUP dokumentation - FTP Anvendelse"
Navngivningen af filerne er beskrevet i dokumentet "SUP dokumentation FilBeskrivelse Generelt"
Filerne vil på FTP Serveren, kunne findes i denne folder hvis det er kommunekode 101 (københavn der vil afhente dataområdet '02-Aktiviteter':
\101\02\Full\02_ActivityCompanyItem_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityCompanyItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityCoreItem_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityCoreItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityCourseItem_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityCourseItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityHelpingDeviceItem_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityHelpingDeviceItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityPersonalAssistanceItem_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityPersonalAssistanceItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityPlanVersionLink_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_ActivityUpdatedByRevision_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_PlanVersion_ÅÅÅÅ_MM_DD.zip
\101\02\Full\02_PlanVersionHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCompanyItem_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCompanyItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCoreItem_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCoreItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCourseItem_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCourseItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityHelpingDeviceItem_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityHelpingDeviceItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityPersonalAssistanceItem_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityPersonalAssistanceItemHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityPlanVersionLink_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityUpdatedByRevision_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_PlanVersion_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_PlanVersionHistory_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCompanyItem_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCompanyItemHistory_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCoreItem_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCoreItemHistory_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCourseItem_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityCourseItemHistory_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityHelpingDeviceItem_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityHelpingDeviceItemHistory_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityPersonalAssistanceItem_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityPersonalAssistanceItemHistory_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityPlanVersionLink_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_ActivityUpdatedByRevision_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_PlanVersion_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_PlanVersionHistory_TILFLYTNING_ÅÅÅÅ_MM_DD.zip
\101\02\Delta\02_FRAFLYTTET_ÅÅÅÅ_MM_DD.zip