BeyondERP.Newsletter
Menu

Page · Service management

Active service agreements

A list page that shows only the active service agreements.

Used by
Service dispatcher, Service delivery manager, Sales manager and 1 more role
Business process
Receive service requests
Menu item
SMAAgreementTableListPage_Active
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 that shows only the active service agreements.
What you do hereUse this page to work with the agreements that are currently in force, for example to open one and generate its planned service orders, without seeing suspended or expired agreements.
Active 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 › Active service agreements
Set up firstService agreements Microsoft Learn
Used next byCreate service orders Microsoft Learn
Related pagesService templates 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.

How to use it

  1. Go to Service management > Service agreements > Active service agreements.
  2. Use the Filter box to find an agreement.
  3. Review the Service agreement, Project ID, Description, Service agreement group, Start date, End date, Suspended and Service level agreement columns; the list is filtered on Suspended.
  4. Select New to create an agreement, or select an agreement and choose Edit or Delete.
  5. Use Service agreement and Deliver on the Action Pane to work with the selected agreement.

Source: Checked in Dynamics 365

Fields on the page

FieldWhat it meansTable column
SuspendedWhen selected, no service orders can be created from the agreement.Microsoft Learn Suspended
Start dateThe start of the agreement; no service orders can be created before this date.Microsoft Learn StartDate
End dateThe optional end date of the agreement.Microsoft Learn EndDate
Service agreement groupThe group used to sort and filter agreements.Microsoft Learn AgreementGroupId

Test checklist

  1. Open an agreement from this list and run Deliver > Planned service orders for a short period; check service orders are created.
  2. Suspend the same agreement on Service agreements and try to create a service order from it; check it is blocked.
  3. Clear Suspended and check service orders can be created again.

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 undoneReversible: This is a view over the same service agreement records. What keeps an agreement usable is its own settings: while Suspended is set you can't create service orders from it, and clearing Suspended restores that. Microsoft Learn
If you change it laterSuspending an agreement removes the ability to create service orders from it, so the agreement no longer behaves as an active one. Microsoft Learn
Technical architect

6Technical

Menu itemSMAAgreementTableListPage_Active 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 itPrivilegesMaintain service agreement details SMAAgreementDetailsMaintainView service agreement details SMAAgreementDetailsViewDutiesInquire 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 agreement: New, Show, Copy, Cost prices, Sales prices, RelationsDeliver: Create, Service ordersChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SMAAgreementTableListPage_Active
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