force 0.4.0

Production-ready Salesforce Platform API client with REST and Bulk API 2.0 support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! Miscellaneous utility calls for the SOAP Partner API: `getUserInfo` and
//! `getServerTimestamp`.

use super::{SoapHandler, UserInfo, parse};
use crate::error::{ForceError, Result};
use chrono::{DateTime, Utc};

impl<A: crate::auth::Authenticator> SoapHandler<A> {
    /// Returns information about the current user and org.
    ///
    /// # Errors
    ///
    /// Returns [`ForceError`] on a transport failure,
    /// a SOAP fault, or an XML parse error.
    pub async fn get_user_info(&self) -> Result<UserInfo> {
        let xml = self.send("<urn:getUserInfo/>").await?;
        parse::parse_user_info(&xml)
    }

    /// Returns the current server time as a UTC timestamp.
    ///
    /// # Errors
    ///
    /// Returns [`ForceError`] on a transport failure,
    /// a SOAP fault, an XML parse error, or if the returned timestamp cannot be
    /// parsed as an RFC 3339 datetime.
    pub async fn get_server_timestamp(&self) -> Result<DateTime<Utc>> {
        let xml = self.send("<urn:getServerTimestamp/>").await?;
        let timestamp = parse::parse_server_timestamp(&xml)?;
        DateTime::parse_from_rfc3339(&timestamp)
            .map(|dt| dt.with_timezone(&Utc))
            .map_err(|err| {
                ForceError::InvalidInput(format!("invalid server timestamp '{timestamp}': {err}"))
            })
    }
}