Delen via

AIF-code bijwerken

  • Artikel

Geldt voor: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

AIF (Application Integration Framework) wordt gebruikt om gegevens uit te wisselen tussen Microsoft Dynamics AX en externe systemen. Tijdens het upgradeproces bevat de Controlelijst voor bijwerken van gegevens een stap voor de upgrade van AIF-code. Dit onderwerp beschrijft deze stap van de Controlelijst voor bijwerken van gegevens.

Klik op Systeembeheer > Instellen > Controlelijsten > Controlelijst voor bijwerken van gegevens. Klik vervolgens in het controlelijstdeelvenster op Upgrade voltooien. Klik op AIF-code bijwerken. Deze stap kan even duren. Wanneer de stap is voltooid, controleert u het infologboek om te controleren of er geen fouten zijn opgetreden. Deze stap bevat de volgende twee processen:

  • Code upgrade - dit proces maakt nieuwe serviceklassen, gegevensklassen en serviceknooppunten in de Application Object Tree (AOT).

  • Data-upgrade - dit proces werkt alle AIF-gerelateerde registratie in de database bij.

    Belangrijk

    De upgrade van de AIF-code en gegevens is een proces met twee stappen. U moet de AIF-code bijwerken voordat u de AIF-gegevens kunt bijwerken. Zie Upgrade additional features voor meer informatie.

Voordat u begint

Voordat u begint, moet u vertrouwd zijn met services en AIF. Zie Services and Application Integration Framework (AIF) voor meer informatie.

Controleer de volgende onderdelen voordat u het upgradeproces start.

Gg731887.collapse_all(nl-nl,AX.60).gifBerichten op het bronsysteem verwerken

Voordat u het upgradeproces uitvoert, zorgt u ervoor dat alle AIF-berichten zijn verwerkt op het systeem dat wordt bijgewerkt. Controleer de volgende locaties om te controleren of alle berichten zijn verwerkt:

  • All inbound message locations deze locaties omvatten bestandssysteemmappen, Message Queuing-wachtrijen en alle locaties waar inkomende berichten worden ontvangen door AIF.

  • The queue manager - alle berichten in Queue Manager worden niet verwerkt en moeten worden verwijderd. Klik op Systeembeheer > Periodiek > Services en Application Integration Framework > Wachtrijbeheerder.

Gg731887.collapse_all(nl-nl,AX.60).gifOverwegingen bij upgrades

De verbeteringen in services en AIF in Microsoft Dynamics AX 2012 veroorzaken aanzienlijke wijzigingen in functionaliteit, configuratie, database, schema´s en documentschema´s of .xsd-bestanden. Wanneer u een upgrade van een eerdere versie van Microsoft Dynamics AX plant, moet u rekening houden met de volgende richtlijnen:

  • U moet alle interfaces opnieuw compileren en alle interfaces testen die de vroegere versie van Microsoft Dynamics AX gebruikten om te zorgen dat de interfaces werken met services in Microsoft Dynamics AX 2012.

  • In Microsoft Dynamics AX 2012 worden MSMQ- en BizTalk-adapters vervangen door equivalente functionaliteit die wordt geleverd door Windows Communication Foundation (WCF). U moet alle automatische integratieprocessen opnieuw compileren die deze adapters hebben gebruikt, zoals Microsoft BizTalk Server-integratie.

  • Het upgraderaamwerk verandert AIF-eindpunten en gerelateerde configuraties in integratiepoorten in Microsoft Dynamics AX 2012. Wanneer het upgradeproces is voltooid, moet u deze integratiepoorten configureren voordat u Microsoft Dynamics AX 2012 services en AIF-functionaliteit kunt gebruiken.

AIF-code upgraden

Dit onderdeel beschrijft het proces dat Microsoft Dynamics AX 2012 gebruikt om AIF-code te upgraden.

Gg731887.collapse_all(nl-nl,AX.60).gifUpgradecode

De stap voor de upgrade van AIF-code upgradet bestaande Axd <Document> klassen en methoden. Tijdens de upgrade van de code, worden de volgende klassen bijgewerkt:

  • De Axd <Document>-klassen die zijn opgenomen met Microsoft Dynamics AX

  • Aangepaste Axd <Document>-klassen

  • Aangepaste klassen die de interface AifServicable implementeren

Gg731887.collapse_all(nl-nl,AX.60).gifGegevens-upgrade

Tijdens de gegevensupgrade worden AIF-gegevens in de Microsoft Dynamics AX-database bijgewerkt. Configuratie-instellingen voor AIF-eindpunten worden gekopieerd naar configuratie-instellingen voor integratiepoorten.

Gg731887.collapse_all(nl-nl,AX.60).gifAls u klaar bent

De volgende tabel beschrijft hoe belangrijke concepten en configuratie-instellingen wijzigen wanneer u een upgrade uitvoert van Microsoft Dynamics AX 2009 naar Microsoft Dynamics AX 2012.

Microsoft Dynamics AX 2009-functie

Microsoft Dynamics AX 2012-functie

Omschrijving

AIF-eindpunten

Integratiepoorten

Het concept van integratiepoorten vervangt het concept van AIF-eindpunten. Het formulier Binnenkomende poorten en het formulier Uitgaande poorten vervangen de AIF-configuratieformulieren. Eindpunten die de Microsoft Dynamics AX-functionaliteit beschikbaar maakten, worden naar binnenkomende integratiepoorten geconverteerd. Eindpunten die berichten hebben ingediend, worden naar uitgaande integratiepoorten geconverteerd.

AIF-eindpunten worden integratiepoorten met een soortgelijke naam. Het upgraderaamwerk combineert de naam van het eindpunt en de bedrijfsnaam om de naam van de integratiepoort te maken. Een eindpunt in BedrijfB dat EindpuntA heeft, wordt bijvoorbeeld een integratiepoort die EindpuntABedrijfB heet.

Eindpuntbeperkingen

Deze functie wordt niet geconverteerd.

Informatie over eindpuntbeperkingen wordt niet naar Microsoft Dynamics AX 2012 gekopieerd. U moet het wettelijke waarderaamwerk en de formulieren voor binnenkomende en uitgaande integratiepoorten gebruiken om beperkingen configureren. Configureer elke integratiepoort om service- en parameterbeperkingen toe te passen.

Eindpuntactiegegevens- en actiebeleid

Het schema en bewerkingsbeperkingen worden op de integratiepoorten toegepast.

Informatie over het gegevens- en actiebeleid wordt niet gekopieerd. In Microsoft Dynamics AX 2009 zijn gegevens- en actiebeleid op het actieniveau toegepast. In Microsoft Dynamics AX 2012 wordt het gegevens- en actiebeleid toegepast op het niveau van de integratiepoort. Daarom moet u de formulieren gebruiken voor binnenkomende en uitgaande integratiepoorten om uw gegevens- en actiebeleid te definiëren na de upgrade.

Notitie

In eerdere versies van Microsoft Dynamics AX, moest u een gegevensbeleid toewijzen aan elk eindpuntactiebeleid. In Microsoft Dynamics AX 2012, is de configuratie van een gegevensbeleid optioneel.

AIF-adapters

Integratiepoorten

Informatie over AIF-adapters wordt niet gekopieerd. Gebruik de formulieren voor integratiepoorten om adapters aan integratiepoorten te koppelen.

AIF-kanalen

Adres van integratiepoorten

Informatie over AIF-kanalen wordt niet gekopieerd. Gebruik de formulieren voor binnenkomende en uitgaande integratiepoorten om het adres en antwoordadres te configureren voor elke integratiepoort.

In eerdere versies van Microsoft Dynamics AX kunt u een eindpunt koppelen aan meerdere kanalen of adressen. In Microsoft Dynamics AX 2012 heeft elke integratiepoort één adres voor binnenkomende berichten en één adres voor antwoorden.

AIF-pijplijnen

Integratiepoortpijplijnen

AIF-pijplijnen worden automatisch bijgewerkt naar integratiepoortpijplijnen.

Servicecodekenmerken

Microsoft Dynamics AX 2012-seviceraamwerk

Tijdens het upgradeproces wordt de servicecode gemarkeerd met de correcte kenmerken, zoals maken, lezen of vinden. Deze stap schakelt de automatische inferentiefunctie in Microsoft Dynamics AX 2012 in om met de bijgewerkte code te werken.

Belangrijk

U moet elke bijgewerkte service configureren om de juiste kenmerken toe te wijzen. Zie de volgende rij voor meer informatie.

De configuratie is altijd specifiek voor het bedrijf.

De configuratie is standaard niet specifiek voor het bedrijf.

In eerdere versies van Microsoft Dynamics AX was elk AIF-eindpunt gekoppeld aan een specifiek bedrijf. In Microsoft Dynamics AX 2012 moeten integratiepoorten niet aan een specifiek bedrijf worden gekoppeld. U kunt de formulieren voor binnenkomende en uitgaande integratiepoorten gebruiken om serviceoproepen te beperken tot een specifiek bedrijf. Voor een binnenkomend bericht haalt het serviceraamwerk de bedrijfs-ID uit de berichtkop op. Als de berichtkop geen bedrijfs-ID bevat, gebruikt het serviceraamwerk de standaardbedrijfs-ID dat aan de gebruiker is gekoppeld die het bericht heeft ingediend.

Serviceverwijzing

Microsoft Visual Studio project

In Microsoft Dynamics AX 2012 worden verwijzingen naar externe webservices niet meer direct aan de AOT toegevoegd. In plaats daarvan, kunnen deze verwijzingen moeten worden gemaakt in een Visual Studio project dat aan de AOT kan worden toegevoegd.

Het is mogelijk om serviceverwijzingen in Microsoft Dynamics AX 2012 Microsoft Dynamics AX 2009 te importeren. Als u kiest om dit te doen, kunt u de volgende fouten tijdens het importeren proces bekijken. U kunt deze fouten gewoon negeren en de serviceverwijzing gebruiken:

  • Opgegeven webverwijzingen hoofdmap bestaan niet.

  • De .NET-assembly is vergrendeld door de AOS. Start de AOS opnieuw om de nieuwe, gegenereerde assembly te laden.

Als u klaar bent

Nadat u begint, moet u het kenmerk SysEntryPointAttribute configureren en de migratie van AIF-eindpunten valideren.

Gg731887.collapse_all(nl-nl,AX.60).gifSysEntryPointAttribute configureren

Microsoft Dynamics AX 2012 wijst het automatisch niet SysEntryPointAttribute het kenmerk aan serviceklassen toe die worden bijgewerkt. Volg deze stappen voor elke service die u bijwerkt.

  1. Vouw in de AOT het knooppunt Services uit en zoek de services die wordt bijgewerkt. Open het deelvenster Eigenschappen, zoek de bijbehorende klassenaam voor de service en maak een notitie van de klassenaam.

  2. Vouw in de AOT het knooppunt Klassen uit en zoek de vermelding voor de klasse die u in de vorige stap hebt gevonden.

  3. Voor elke servicebewerking in de klasse, een SysEntryPointAttribute kenmerk toe dat een waarde van true of er false gebruikt. Wij raden aan om de waarde naar true in te stellen, zodat de servicebewerking de machtigingen accepteert die eraan zijn toegewezen door het rolgebaseerde beveiligingsraamwerk in Microsoft Dynamics AX.

    De volgende voorbeeldcode geeft aan hoe u het kenmerk toevoegt aan de bewerking create van de klasse SalesSalesOrderService.

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

Gg731887.collapse_all(nl-nl,AX.60).gifDe migratie van AIF-eindpunten valideren

Gebruik de formulieren Microsoft Dynamics AX 2012 voor binnenkomende en uitgaande integratiepoorten om de AIF-eindpunten die u hebt gemigreerd te valideren en te configureren.

  1. Open de Microsoft Dynamics AX-client.

  2. Initialiseer AIF om adapters en services te registreren:

    1. Klik op Systeembeheer > Instellen > Controlelijsten > Controlelijst voor initialisatie.

    2. Vouw het knooppunt Systeem initialiseren uit.

    3. Klik op Application Integration Framework instellen.

  3. Open elk formulier voor de configuratie van integratiepoorten:

    1. Klik op Systeembeheer > Instellen > Services en Application Integration Framework > Binnenkomende poorten.

    2. Klik op Systeembeheer > Instellen > Services en Application Integration Framework > Uitgaande poorten.

  4. Controleer de lijst met integratiepoorten om ervoor te zorgen dat de AIF-eindpunten als integratiepoorten zijn gemigreerd.

  5. Valideer voor elke integratiepoort de gemigreerde instellingen en geef alle instellingen op die niet zijn gemigreerd:

    1. Selecteer in de groep Adres een geschikte adapter in het veld Adapter.

    2. Klik op Configureren om de adapter te configureren die u hebt geselecteerd.

    3. Selecteer in het veld URI een geschikte waarde voor de URI.

    4. De servicebewerkingen beschikbaar maken. Selecteer Servicebewerkingen weergeven en klik vervolgens op Servicebewerkingen.

    5. Gegevensbeleid en wettelijke waarden handmatig configureren. Selecteer Documenten aanpassen en klik vervolgens op Gegevensbeleid.

    6. Gebruik het sneltabblad Verwerkingsopties om verwerkingsinstellingen te configureren. Verwerkingsinstellingen zijn onder andere instellingen die het gedrag controleren wanneer fouten in een batch optreden. Deze instellingen regelen ook de voorverwerking van aanvragen en naverwerking van antwoorden.

    7. Gebruik het sneltabblad Problemen oplossen om instellingen voor het oplossen van problemen te configureren. Instellingen voor het oplossen van problemen zijn onder andere instellingen die de logboekmodus en de propagatie van fouten controleren.

    8. Gebruik het sneltabblad Beveiliging om beveiligingsinstellingen te configureren. Beveiligingsinstellingen zijn onder andere instellingen die beperkingen regelen op geautoriseerde gebruikers en vertrouwde intermediairen. Deze instellingen regelen ook of de integratiepoort tot een specifiek bedrijf is beperkt.

    9. Open in een browser de Microsoft Dynamics AX-webservice en bevestig dat de webserver de WSDL-pagina retourneert. Gebruik de volgende URL om de webservice te openen:

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

      Notitie

      Microsoft Dynamics AX gebruikt standaard poort 8081.

Gg731887.collapse_all(nl-nl,AX.60).gifMeer informatie

Voor details over het configureren van integratiepoorten in services en AIF, raadpleegt u de documentatie op de TechNet Web site.

Aankondigingen: Om bekende problemen en recente fixes te zien, gebruikt u Probleem zoeken in Microsoft Dynamics Lifecycle Services (LCS).