Senda leyfisbeiðni í verkflæði

Grein
04/29/2024

Á við um þessi Dynamics 365-forrit:
Human Resources

Í Microsoft Dynamics 365 Human Resources, þú getur notað MyLeaveRequests senda () forritunarviðmót forritsins (API) til að leggja fram leyfisbeiðni til verkflæðis. Þetta API birtist sem aðgerð á MyLeaveRequests OData einingunni.

Forkröfur

Leyfisbeiðnin verður að vera vistuð í gagnagrunninum og verður að endurheimta í gegnum MyLeaveRequests eininguna.

Aðgangsheimildir

Ein af eftirfarandi heimildum er nauðsynleg til að kalla þetta API. Fyrir frekari upplýsingar um heimildir og hvernig á að velja þær, sjá Auðkenning.

Gerð heimildar	Heimildir (frá minnst forréttinda til allra forréttinda)
Úthlutað (vinnu- eða skólareikningur)	user_impersonation

HTTPS beiðni

POST https://{cluster}.hr.talent.dynamics.com/namespaces/{namespace_guid}/data/MyLeaveRequests(RequestId='{requestId}', LeaveType='{leaveType}', LeaveDate={leaveDate}, dataAreaId={dataArea})/Microsoft.Dynamics.DataEntities.submit?cross-company=true

Beiðnin er í samræmi við OData staðla. Færibreyturnar {requestId}, {leaveType}, {leaveDate} og {dataArea} vísa til reitanna sem samanstanda af samsettum náttúrulykli fyrir MyLeaveRequests eininguna.

Nóta

Þó að reitirnir fyrir MyLeaveRequests einingina vísa til einstakrar línu í leyfisbeiðninni, mun hringja í senda API senda alla leyfisbeiðnina (allar línur) til verkflæðis.

Haus beiðni

Haus	Value
Heimildir	Handhafi {token} (krafist)
Efnistegund	application/json

Meginmál beiðni

Ekki leggja fram beiðni aðila um þessa aðferð.

Svar

Árangursríkt svar er alltaf 204 Ekkert efni svar.

Óviðkomandi hringir munu fá 401 óviðkomandi eða 403 bannað svar.

Ef innsending mistekst (td vegna staðfestingar) verður svarið 500 Server Error og svarhlutinn mun innihalda JSON hlut með frekari upplýsingum.

Dæmi

POST https://aos-rts-sf-550e5c091f6-prod-westus2.hr.talent.dynamics.com/namespaces/b2eb8003-334f-4a84-ab63-edbe23569090/data/MyLeaveRequests(RequestId='USMF-000065', LeaveType='Vacation', LeaveDate=2019-10-04T12:00:00Z, dataAreaId='USMF')/Microsoft.Dynamics.DataEntities.submit

{
  "error": {
    "code": "",
    "message": "An error has occurred.",
    "innererror": {
      "message": "Exception occurred while executing action submit on Entity MyLeaveRequest: The request would put the 'Vacation' balance below the allowed minimum balance on 9/10/2019.",
      "type": "System.InvalidOperationException",
      "stacktrace": "   at Microsoft.Dynamics.Platform.Integration.Services.OData.Action.ActionInvokable.Invoke()   at Microsoft.Dynamics.Platform.Integration.Services.OData.Update.UpdateProcessor.ActionInvocation(ChangeOperationContext context, ActionInvokable action)   at Microsoft.Dynamics.Platform.Integration.Services.OData.Update.UpdateManager.<>c__DisplayClass13_0.<ScheduleInvokable>b__0(ChangeOperationContext context)   at Microsoft.Dynamics.Platform.Integration.Services.OData.Update.ChangeInfo.ExecuteActionsInCompanyContext(IEnumerable`1 actionList, ChangeOperationContext operationContext)\r\n   at Microsoft.Dynamics.Platform.Integration.Services.OData.Update.ChangeInfo.ExecuteActions(ChangeOperationContext context)   at Microsoft.Dynamics.Platform.Integration.Services.OData.Update.UpdateManager.SaveChanges()   at Microsoft.Dynamics.Platform.Integration.Services.OData.AxODataDelegatingHandler.<SaveChangesAsync>d__3.MoveNext()"
    }
  }
}

Staðfesting og villuboð

Sem hluti af símtalinu til að senda inn API, framkvæmir Human Resources löggildingu viðskiptatækni áður en hún er lögð fram, sem tryggir að leyfisbeiðnin sé í réttri stöðu til að skila. Hugsanleg villuboð sem þú gætir fengið í svari ef staðfestingar mistakast eru:

Beiðnin myndi setja stöðuna „{LeaveTypeId}“ undir leyfða lágmarksstöðu á {date}.
Ekki er hægt að leggja fram beiðni um frí í fullgerðu ástandi.
Ekki er hægt að senda eða vista beiðni þar sem engar breytingar hafa verið gerðar. Bættu við eða uppfærðu upphæðina eða leyfisgerðina og reyndu aftur.
Tímalengd beiðni sem er slegin inn inniheldur einn eða fleiri daga með sama dagsetningu og leyfi gerð sem fyrirliggjandi biðbeiðni. Mundu að fyrirliggjandi beiðni um að gera breytingar.
Ástæðukóði „{ReasonCodeId}“ á ekki við um leyfisgerðirnar í beiðninni.
Skildu eftir tegund „{LeaveTypeId}” krefst ástæðukóða. Veldu viðeigandi gerð og ástæðukóða.
Ekki tókst að senda frí. Fríið hefur verið vistað sem drög að beiðni.

Deila með