Skip to main content

PersonsServiceRequestsResource

Struct PersonsServiceRequestsResource 

Source
pub struct PersonsServiceRequestsResource<'a> { /* private fields */ }
Expand description

client.persons().service_requests()

Implementations§

Source§

impl<'a> PersonsServiceRequestsResource<'a>

Source

pub fn delete( &self, person_id: impl Display, request_id: impl Display, ) -> Result<ServiceRequest>

Decline a service request for a person

DELETE /persons/{personId}/servicerequests/{requestId}

Declines the current assignment and returns HTTP 200 with a new unassigned record: person and name are null, isValid=true and isAccepted=false. The original requestId becomes invalid. Related exchange requests are deleted and the workflow sends notifications. Requires permission to decline; assigned persons additionally need allowDecline on the service unless another permission grants access. Invalid records return 404 and unassigned slots return 422.

Use Self::delete_with to pass query parameters.

§Example
let service_request = client.persons().service_requests().delete(42, 42)?;
println!("{:?}", service_request.name);
Source

pub fn delete_with( &self, person_id: impl Display, request_id: impl Display, query: &DeletePersonsIdServicerequestsIdQuery, ) -> Result<ServiceRequest>

Decline a service request for a person

Like Self::delete, with query parameters.

DELETE /persons/{personId}/servicerequests/{requestId}

Declines the current assignment and returns HTTP 200 with a new unassigned record: person and name are null, isValid=true and isAccepted=false. The original requestId becomes invalid. Related exchange requests are deleted and the workflow sends notifications. Requires permission to decline; assigned persons additionally need allowDecline on the service unless another permission grants access. Invalid records return 404 and unassigned slots return 422.

Source

pub fn get( &self, person_id: impl Display, request_id: impl Display, ) -> Result<ServiceRequest>

Get a specific service request for a person

GET /persons/{personId}/servicerequests/{requestId}

Returns the assignment identified by requestId and personId when the viewer has access. Unlike the list endpoint, this lookup can return invalid historical records. Comments are null if the viewer cannot see the reason.

§Example
let service_request = client.persons().service_requests().get(42, 42)?;
println!("{:?}", service_request.name);
Source

pub fn list(&self, person_id: impl Display) -> Result<Vec<ServiceRequest>>

Get all service requests for a person

GET /persons/{personId}/servicerequests

Returns an unpaginated list of visible, valid assignments for this person, including both outstanding and confirmed requests. Declined and superseded records are excluded. Sorted by event start ascending. only_future=true starts at midnight today, so events earlier today are included. meta.count is the number returned after permission filtering.

Use Self::list_with to pass query parameters.

§Example
for service_request in client.persons().service_requests().list(42)? {
    println!("{:?}", service_request.name);
}
Source

pub fn list_with( &self, person_id: impl Display, query: &GetPersonsIdServicerequestsQuery, ) -> Result<Vec<ServiceRequest>>

Get all service requests for a person

Like Self::list, with query parameters.

GET /persons/{personId}/servicerequests

Returns an unpaginated list of visible, valid assignments for this person, including both outstanding and confirmed requests. Declined and superseded records are excluded. Sorted by event start ascending. only_future=true starts at midnight today, so events earlier today are included. meta.count is the number returned after permission filtering.

Source

pub fn undo( &self, person_id: impl Display, request_id: impl Display, ) -> Result<ServiceRequestUndoResult>

Undo last service request action

POST /persons/{personId}/servicerequests/{requestId}/undo

Reverts the last acceptance or decline to an outstanding request. Only the assigned person may do this. The legacy history must identify this as the last action and its timestamp must be within the 10-minute undo window; otherwise 400 is returned. For a decline, use the original declined request ID, not the new unassigned record returned by the decline operation. The automatically created empty record is removed when undoing a decline. Returns the legacy response shape ServiceRequestUndoResult.

§Example
let service_request = client.persons().service_requests().undo(42, 42)?;
println!("{:?}", service_request.name);
Source

pub fn update( &self, person_id: impl Display, request_id: impl Display, body: &PersonServiceRequestUpdate, ) -> Result<ServiceRequest>

Update a service assignment

PUT /persons/{personId}/servicerequests/{requestId}

Creates a replacement assignment and invalidates the previous active record for the same event, service and slot index. Always use the returned ID for subsequent actions. isAccepted=true confirms it; false leaves it awaiting confirmation and does not decline it. Notifications follow the assignment workflow. Updating an occupied slot requires permission to update that assignment; free slots use the self-assignment policy, and target-person restrictions apply. The legacy agreed input is accepted as an alias for isAccepted.

§Example
let body = models::PersonServiceRequestUpdate {
    comment: Some(Some("Hallo zusammen".into())),
    ..Default::default()
};
let result = client.persons().service_requests().update(42, 42, &body)?;
println!("{:?}", result.name);

Trait Implementations§

Source§

impl<'a> Clone for PersonsServiceRequestsResource<'a>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl<'a> Copy for PersonsServiceRequestsResource<'a>

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more