web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

No record found.

News and Announcements icon
Community site session details

Community site session details

Session Id :
Supply chain | Supply Chain Management, Commerce
Answered

Learning Services in D365FO

(0) ShareShare
ReportReport
Posted on by

Hello all,

I'm just starting to learn about Services in D365 F&O. I want to ask whether this link in Microsoft Docs still valid? Walkthrough: Exposing an X Class as a Data Contract | Microsoft Docs

Cause it is said the content is archived, and I also try to look in other resources and books, there is some basic differences for example in that link with the sample of create Data Contract Class : 

[DataContractAttribute]
 public class EmployeeTest
 {
     str employeeName;
     int employeeAge;
     utcdatetime employeeBirthDate;

 }

The 1st tag [DataContractAttributes, I cannot type it with Intellisense, it only shows me the possibilities without word "..Attributes"

pastedimage1662714864228v1.png

Same goes when I type for [DataMemberAttribute which in that document given as an example, also in this case in some other resources/books, now when I type it only give me "DataMember". Has the development already been changed?

Please help to guide me whether there is a good reference with a good explanation how to learn this, with of course the latest version.

Thanks,

I have the same question (0)
  • Verified answer
    Martin Dráb Profile Picture
    239,040 Most Valuable Professional on at

    It's DataContractAttribute, not DataContractAttributes.

    You don't have to include the Attribute suffix when using an attribute: these two declarations are equivalent:

    [DataContractAttribute]
    [DataContract]

  • VoltesDev Profile Picture
    on at

    Hi Martin,

    "I don't have to" because it is equivalent OR it is just changed so now there is no need to use that word ?

    I'm sorry I have to ask also when you are saying "You don't have to include the Attribute suffix when using an attribute" does it mean there will be in other places that I "have to" declare it with full suffix?

    Last, which means the documents still valid?

    Sorry I have to know this and have a clear understanding about this, since there are so many blogs out there with many versions which makes me lost. For example: For DataMemberAttribute, there are bunch of resources telling of using [DataMemberAttribute] with addition of declaring AifCollectionTypeAttribute. Now in the document it only put the [DataMember] then continue with the void header like "public list ....."

    Thanks,

  • Suggested answer
    Martin Dráb Profile Picture
    239,040 Most Valuable Professional on at

    Both statements in your first sentence are true. There is no need to use the suffix because the declarations are equivalent. You can use either [DataContractAttribute] or [DataContract], whichever you like more. They mean exactly the same thing.

    You should use the suffix in the class name if you ever happen to create a new attribute class.

    AifCollectionTypeAttribute is used when the service operation accepts or return a List. You'll use this attribute to desribe what kind of data will be in the list (e.g. a collection of strings or a collection of MyContract classes).

    The article is for AX 2012, not D365FO, therefore there are some differences. You don't need SysEntryPointAttribute anymore, you don't need to deploy service groups and you can use the JSON-based endpoint in addition to SOAP.

  • VoltesDev Profile Picture
    on at

    Thank you for this explanation.

    Before I close this topic to resolve, may I ask a favor where can I get the right resource to learning Services for D365 FO?

    Since the link that I'm asking is also from D365FO Docs -> docs.microsoft.com/.../custom-services. There is a link inside that brought me to the page that was meant only for AX2012.

    I have this issue ((+) Add service reference failed - Dynamics 365 Supply Chain Management Forum Community Forum) that related to this Services, but since I have experiences develop this, I don't have any clue what's wrong.

    Anyway, Thank you again for your help.

  • Martin Dráb Profile Picture
    239,040 Most Valuable Professional on at

    I'm afraid that there is no good documentation.

  • VoltesDev Profile Picture
    on at

    I see. Well, thanks again Martin.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Introducing the 2026 Season 1 community Super Users

Congratulations to our 2026 Super Stars!

Meet the Microsoft Dynamics 365 Contact Center Champions

We are thrilled to have these Champions in our Community!

Congratulations to the March Top 10 Community Leaders

These are the community rock stars!

Leaderboard > Supply chain | Supply Chain Management, Commerce

#1
Mallesh Deshapaga Profile Picture

Mallesh Deshapaga 296

#2
Laurens vd Tang Profile Picture

Laurens vd Tang 234 Super User 2026 Season 1

#3
Syed Haris Shah Profile Picture

Syed Haris Shah 139 Super User 2026 Season 1

Last 30 days Overall leaderboard

Product updates

Dynamics 365 release plans