Opgrader AIF-kode

Anvendes på: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Application Integration Framework (AIF) bruges til udveksling af data mellem Microsoft Dynamics AX og eksterne systemer. Under opgraderingsprocessen medtager Kontrollisten til dataopgradering et trin til opgradering af AIF-kode. Dette emne indeholder en beskrivelse af dette trin i Kontrollisten til dataopgradering.

Klik på Systemadministration > Opsætning > Kontrollister > Kontrollisten til dataopgradering. Klik derefter på Fuldfør opgradering i kontrollisteruden. Klik på Opgrader AIF-kode. Det kan tage et stykke tid at udføre dette trin. Når trinnet er udført, skal du se infologgen for at kontrollere, at der ikke opstod fejl. Dette trin omfatter følgende to processer:

• Kodeopgradering – Denne proces opretter nye tjenesteklasser, dataklasser og tjenestenoder i applikationsobjekttræet (AOT).

• Dataopgradering – Denne proces opgraderer alle AIF-relaterede poster i databasen.

  Vigtigt

  Opgraderingen af AIF-kode og -data er en totrinsproces. Du skal opgradere AIF-koden, før du kan opgradere AIF-dataene. Du kan finde flere oplysninger i Upgrade additional features.

Før du opgraderer

Før du opgraderer, skal du sætte dig ind i tjenesterne og AIF. Yderligere oplysninger finder du i Services and Application Integration Framework (AIF).

Gennemgå følgende afsnit, før du starter opgraderingsprocessen.

Behandlingsmeddelelser på kildesystemet

Før du kører opgraderingsprocessen, skal du kontrollere, at alle AIF-meddelelser er blevet behandlet på det systemet, der opgraderes. Kontrollér følgende placeringer for at kontrollere, at alle meddelelser er blevet behandlet:

• Placeringer af alle indgående meddelelser – Omfatter filsystemmapper, MSMQ-køer eller andre placeringer, hvor AIF modtager indgående meddelelser.

• Køstyring – Alle meddelelser i Køstyring er ubehandlede og skal slettes. Klik på Systemadministration > Periodisk > Tjenester og Application Integration Framework > Køstyring.

Overvejelser omkring opgradering

De forbedringer, der er udført i tjenester og i AIF i Microsoft Dynamics AX 2012 giver betydelige ændringer i funktionalitet, konfiguration, databaseskemaer og dokumentskemaer eller xsd-filer. Når du planlægger en opgradering fra en tidligere version af Microsoft Dynamics AX, skal du overveje følgende:

• Du kan rekompilere og teste alle grænseflader, der brugte den tidligere version af Microsoft Dynamics AX for at sikre, at grænsefladerne fungerer i tjenesterne i Microsoft Dynamics AX 2012.

• I Microsoft Dynamics AX 2012 er MSMQ- og BizTalk-adaptere blevet erstattet med lignende funktionalitet fra Windows Communication Foundation (WCF). Du skal rekompilere alle automatiske integrationsprocesser, der benyttede disse adaptorer, f.eks. Microsoft BizTalk Server-orkestrering.

• Opgraderingsstrukturen ændrer AIF-slutpunkter og relaterede konfigurationer til integrationsporte i Microsoft Dynamics AX 2012. Når opgraderingsprocessen er fuldført, skal du konfigurere integrationsportene, før du kan bruge Microsoft Dynamics AX 2012-tjenester og AIF-funktionalitet.

Opgradere AIF-kode

I dette afsnit beskrives den proces, som Microsoft Dynamics AX 2012 bruger til at opgradere AIF-kode.

Kodeopgradering

Trinnet for opgradering af AIF-kode opgraderes eksisterende Axd <dokument>-klasser og -metoder. Under kodeopgraderingen opgraderes følgende klasser:

• Axd <dokument>-klasser, der er omfattet af Microsoft Dynamics AX

• Tilpassede Axd <dokument>-klasser

• Tilpassede klasser, der implementerer AifServicable-grænsefladen

Dataopgradering

Under dataopgraderingen opgraderes AIF-dataene i Microsoft Dynamics AX-databasen. Konfigurationsindstillinger for AIF-slutpunkter kopieres til konfigurationsindstillinger for integrationsporte.

Efter opgraderingen

Følgende tabel viser, hvordan nøglebegreber og konfigurationsindstillinger ændres, når du opgraderer fra Microsoft Dynamics AX 2009 til Microsoft Dynamics AX 2012.

Microsoft Dynamics AX 2009-funktion	Microsoft Dynamics AX 2012-funktion	Beskrivelse
AIF-slutpunkter	Integrationsporte	Begrebet integrationsporte erstatter begrebet AIF-slutpunkter. Formen Indgående porte og formen Udgående porte erstatter formsene til AIF-konfiguration. Slutpunkter med Microsoft Dynamics AX-funktionalitet konverteres til indgående integrationsporte. Slutpunkter, der sendte meddelelser, konverteres til udgående integrationsporte. AIF-slutpunkter bliver til integrationsporte med et lignende navn. I opgraderingsstrukturen kombineres navnet på slutpunktet og firmanavnet for at oprette navnet på integrationsporten. Et slutpunkt i FirmaB med navnet SlutpunktA bliver f.eks. til en integrationsport med navnet SlutpunktAFirmaB.
Slutpunktbegrænsninger	Denne funktion konverteres ikke.	Oplysninger om slutpunktbegrænsninger kopieres ikke til Microsoft Dynamics AX 2012. Du skal bruge strukturen for gyldige værdier og formsene til indgående og udgående integrationsporte til at konfigurere begrænsninger. Konfigurer alle integrationsporte, så de overholder tjeneste- og parameterbegrænsninger.
Slutpunktdata og handlingspolitikker	Skemaet og handlingsbegrænsninger anvendes på integrationsporte.	Oplysninger om data- og handlingspolitikker kopieres ikke. I Microsoft Dynamics AX 2009 blev data og handlingspolitikker anvendt på handlingsniveau. I Microsoft Dynamics AX 2012 anvendes data og handlingspolitikker på integrationsportniveau. Derfor skal du bruge formsene til indgående og udgående integrationsporte til at definere dine data- og handlingspolitikker efter opgraderingen. Bemærk I tidligere versioner af Microsoft Dynamics AX skulle man tildele datapolitikker til alle slutpunktshandlingspolitikker. I Microsoft Dynamics AX 2012 er det valgfrit, om man vil konfigurere datapolitikker.
AIF-adaptere	Integrationsporte	Oplysninger om AIF-adaptere kopieres ikke. Brug formsene til integrationsporte til at knytte adaptere til integrationsporte.
AIF-kanaler	Integrationsportadresse	Oplysninger om AIF-kanaler kopieres ikke. Brug formsene til indgående og udgående integrationsporte til at konfigurere adressen og svaradressen for hver integrationsport. I tidligere versioner af Microsoft Dynamics AX kunne man knytte et slutpunkt til flere kanaler eller adresser. I Microsoft Dynamics AX 2012 har hver integrationsport én adresse til indgående meddelelser og én adresse til svar.
AIF-pipelines	Integrationsportpipelines	AIF-pipelines opgraderes automatisk til integrationsportpipelines.
Tjenestekodeattributter	Microsoft Dynamics AX 2012-tjenestestruktur	Under opgraderingen markeres tjenestekoden med de relevante attributter, f.eks. opret, læs eller søg. Dette trin aktiverer funktionen for automatisk inferens i Microsoft Dynamics AX 2012, så den fungerer med opgraderingskoden. Forsigtigt Du skal konfigurere alle opgraderede tjenester for at tildele de relevante attributter. Der er flere oplysninger i næste række.
Konfigurationen er altid firmaspecifik.	Konfigurationen er som standard ikke firmaspecifik.	I tidligere versioner af Microsoft Dynamics AX var hvert enkelt AIF-slutpunkt tilknyttet et bestemt firma. I Microsoft Dynamics AX 2012 behøver man ikke knytte integrationsporte til bestemte firmaer. Du kan dog bruge formsene til indgående og udgående integrationsporte til at begrænse tjenestekald til et bestemt firma. I forbindelse med en indgående meddelelse henter tjenestestrukturen firma-id'et fra meddelelseshovedet. Hvis meddelelseshovedet ikke indeholder et firma-id, bruger tjenestestrukturen det standard firma-id, der er knyttet til den bruger, der sendte meddelelsen.
Ydelsesreference	Microsoft Visual Studio-projekt	I Microsoft Dynamics AX 2012 føjes henvisninger til eksterne webtjenester ikke længere direkte til AOT-træet. I stedet skal disse referencer oprettes i et Visual Studio-projekt, som derefter kan føjes til AOT-træet. Det er muligt at importere tjenestereferencer til Microsoft Dynamics AX 2012 fra Microsoft Dynamics AX 2009. Hvis du vælger at gøre dette, vil du evt. se følgende fejl under importprocessen. Du kan roligt ignorere disse fejl og bruge tjenestereferencen: Rodmappen for den angivne webreference findes ikke. .NET-assembly er låst af AOS. Genstart AOS for at indlæse den nye assembly.

Efter opgraderingen

Når du opgraderer, skal du konfigurere attributten SysEntryPointAttribute og validere overførslen af AIF-slutpunkter.

Konfiguration af SysEntryPointAttribute

Microsoft Dynamics AX 2012 tildeler ikke automatisk SysEntryPointAttribute-attributten til tjenesteklasser, der opgraderes. Følg disse trin for hver tjeneste, du er ved at opgradere.

1. Udvid noden Tjenester i AOT, og find den tjeneste, du er ved at opgradere. Åbn ruden Egenskaber, find det tilsvarende klasenavn for tjenesten, og notér klassenavnet.

2. Udvid noden Klasser i AOT, og find den post for klassen, som du fandt i det forrige trin.

3. For hver tjenestehandling i klassen skal du tilføje en SysEntryPointAttribute -attribut, der bruger en værdi for true eller false. Vi anbefaler, at du indstiller værdien til true, så tjenestehandlingen accepterer de tilladelser, den tildeles af den rollebaserede sikkerhedsstruktur i Microsoft Dynamics AX.

   I følgende eksempelkode kan du se, hvordan du kan føje attributten til create-handlingen i klassen SalesSalesOrderService.

    [AifDocumentCreateAttribute, SysEntryPointAttribute(true)] 
   public AifEntityKeyList create(SalesSalesOrder _salesSalesOrder) 
   { return this.createList(_salesSalesOrder); }
   

Validere overflytningen af AIF-slutpunkter

Brug Microsoft Dynamics AX 2012-formsene til indgående og udgående integrationsporte til at validere og konfigurere de AIF-slutpunkter, du har overflyttet.

1. Åbn Microsoft Dynamics AX-klienten.

2. Initialiser AIF for at registrere adaptere og tjenester:

   1. Klik på Systemadministration > Opsætning > Kontrollister > Initialiseringskontrolliste.

   2. Udvid noden Initialiser system.

   3. Klik på Konfigurer Application Integration Framework.

3. Åbn hver enkelt form for konfiguration af integrationsporte:

   1. Klik på Systemadministration > Opsætning > Tjenester og Application Integration Framework > Indgående porte.

   2. Klik på Systemadministration > Opsætning > Tjenester og Application Integration Framework > Udgående porte.

4. Gennemse listen over integrationsporte for at kontrollere, at AIF-slutpunkterne er blevet overflyttet som integrationsporte.

5. I forbindelse med hver enkelt integrationsport skal du validere de overflyttede indstillinger, og angive eventuelle indstillinger, der ikke er blevet overflyttet:

   1. Vælg den relevante adapter i gruppen Adresse i feltet Kort.

   2. Klik på Konfigurer for at konfigurere den valgte adapter.

   3. Vælg en relevant værdi for URI'en i feltet URI.

   4. Vis servicehandlingerne. Vælg Fremvis servicehandlinger, og klik derefter på Servicehandlinger.

   5. Konfigurer datapolitikker og gyldige værdier manuelt. Vælg Tilpas dokumenter, og klik derefter på Datapolitikker.

   6. Brug oversigtspanelet Indstillinger for behandling til at konfigurere behandlingsindstillinger. Behandlingsindstillinger omfatter indstillinger, der styrer, hvad der sker, hvis der opstår fejl i et batch. Indstillingerne styrer også forbehandling af anmodninger og efterbehandling af svar.

   7. Brug oversigtspanelet Fejlfinding til at konfigurere fejlfindingsindstillinger. Fejlfindingsindstillinger omfatter indstillinger, der styrer logføringstilstand og udbredelse af fejl.

   8. Brug oversigtspanelet Sikkerhed til at konfigurere sikkerhedsindstillinger. Sikkerhedsindstillinger omfatter indstillinger, der styrer begrænsninger på autoriserede brugere og pålidelige mellemled. Indstillingerne styrer også, om integrationsporten er begrænset til et bestemt firma.

   9. Åbn webtjenesten Microsoft Dynamics AX i en browser, og bekræft, at webserveren returnerer WSDL-siden. Brug følgende URL-adresse til at åbne webtjenesten:

      net.tcp:// AOS_SERVICE_HOST/DynamicsAx/Services/ServiceName?wsdl
      

      Bemærk

      Microsoft Dynamics AX bruger som standard port 8081.

Yderligere oplysninger

Du kan få flere oplysninger om konfiguration af integrationsporte i tjenester og AIF i dokumentationen på TechNet-webstedet.

Meddelelser: Hvis du vil se kendte problemer og de seneste rettelser, skal du bruge Problemsøgning i Microsoft Dynamics Lifecycle Services (LCS).