BeyondERP.Newsletter
Menu

Page · Service management

Service agreements

A list page where you create and maintain service agreements, which define the resources used in a typical service visit and how those resources are invoiced to the customer, with header settings and agreement lines.

Used by
Service dispatcher, Service delivery manager, Sales manager and 1 more role
Business process
Receive service requests
Menu item
SMAAgreementTableListPage
Main table
SMAAgreementTable
Data entity
SMAServiceAgreementHeaderEntity
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA list page where you create and maintain service agreements, which define the resources used in a typical service visit and how those resources are invoiced to the customer, with header settings and agreement lines.
What you do hereUse this page to set up each agreement with its project, agreement ID and group, create or copy its lines, attach service objects and tasks, suspend it when needed, and generate the planned service orders for a period.
ExampleFor example, you can suspend a service agreement, after which no service orders can be created from it, or stop a single line so that no service orders are created for that line only.
Service agreements page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processManage service work › Receive service requests
Menu pathService management › Service agreements › Service agreements
Set up firstAll projects Microsoft Learn Service agreement groups Microsoft Learn Service management parameters Microsoft Learn
Used next byCreate service orders Microsoft Learn Service orders Microsoft Learn
Related pagesService templates Microsoft Learn Combine service orders Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Steps from Microsoft

  1. Go to Service management > Service agreements > Service agreements.
  2. Select New, enter a description and select the project in the Project ID field.
  3. Fill in the rest of the header fields, such as the service agreement group, and select Save.
  4. On the Relations tab, select Service objects or Service tasks to create the relations that can be used on the lines.
  5. In the lower half of the page, add service agreement lines manually or copy them from a service template or another agreement.
  6. Select Save to save the lines and close the page.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Project IDThe project the agreement is attached to; transactions are posted and invoiced through it.Microsoft Learn ProjId
Service agreement groupThe group used to sort and filter agreements; the default from Service management parameters is suggested.Microsoft Learn AgreementGroupId
SuspendedStops all service order creation from this agreement and stops all attached lines.Microsoft Learn Suspended
Combine service ordersHow automatically created service order lines are grouped into service orders (by agreement, task, employee or object).Microsoft Learn GroupBy
Service template groupEntering a template group makes the agreement a template whose lines can be copied elsewhere.Microsoft Learn TemplateGroupId
Service level agreementAssigns time limits for completing manually created service orders under this agreement.Microsoft Learn ServiceLevelAgreementId
Service interval (line)The frequency at which service order lines are created from the agreement line.Microsoft Learn
Stopped (line)Stops service order creation for that single agreement line.Microsoft Learn

Test checklist

  1. Create a service agreement with a Project ID, Service agreement group and Start date; add one Hour line with a Service interval.
  2. On the Relations tab add a service object and a service task, then select them on the line.
  3. Select Deliver > Planned service orders for a one-month period and check service orders are created.
  4. Set Suspended to Yes and run Planned service orders again: check no new service orders are created.
  5. Set Stopped on one line and try to copy that line into another agreement: check it can't be copied.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Number sequences

ReferenceShared or per companyNote
Service agreementPer companyNew records on this page take their Service agreement from the SMAAgreementId reference; BEAT uses number sequence Serv_3. Checked in Dynamics 365
Solution architect

5Design impact

Can it be undoneHard to reverse: Suspended (header) and Stopped (line) can be switched back. But a suspended agreement stops every line and blocks automatic and manual service order creation while it is set, and an agreement that already has service orders can no longer be made a template. All service order transactions post through the attached project, so plan the project before the first order. Microsoft Learn
If you change it laterSuspending an agreement blocks automatic and manual creation of service orders from it and stops every attached line; stopping a line also prevents that line from being copied into another agreement or order. Microsoft Learn
Technical architect

6Technical

Menu itemSMAAgreementTableListPage Checked in Dynamics 365
FormSMAAgreementTable Checked in Dynamics 365
TableSMAAgreementTableShown as “SERVICE AGREEMENTS” in Record infoKey field: AgreementIdChecked in Dynamics 365
Data entitiesSMAServiceAgreementHeaderEntityService agreement headers Microsoft data model
Who can open itPrivilegesView list of service agreements (Customer self-service) EPServiceCSSAgreementListViewMaintain service agreement details SMAAgreementDetailsMaintainView service agreement details SMAAgreementDetailsViewDutiesMaintain customer service (Enterprise Portal) SMAEPCustServiceMaintainInquire into service agreement master SMAServiceAgreementMasterInquireMaintain service agreement master SMAServiceAgreementMasterMaintain
4 security rolesService dispatcher SMADispatcherService delivery manager SMAServiceDeliveryManagerSales manager TradeSalesManagerSales representative TradeSalesRepresentative
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itService delivery manager SMAServiceDeliveryManagerTo use itService dispatcher SMADispatcherSales manager TradeSalesManagerSales representative TradeSalesRepresentativeGive people one of these roles. On this system, 4 roles can open this page.Checked in Dynamics 365
Actions on the pageService agreementDeliver: Create, Service ordersChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SMAAgreementTableListPage
Integrate withSMAServiceAgreementHeaderEntity data entity Microsoft data model
Data migrationSMAServiceAgreementHeaderEntity (Service agreement headers): loaded for each company.Microsoft Learn
Table definitionSMAAgreementTable columns and relations Microsoft data model
Everyone

8Sources