Skip to content

Commit 32b6e93

Browse files
lisa-d-rewstgitbook-bot
authored andcommitted
DocsUpdate-1389: lisa.dellaporta's Mar 24 changes - Document User Details Crate
1 parent aaa60c5 commit 32b6e93

7 files changed

+79
-4
lines changed
Loading
Loading

.gitbook/assets/image (41).png

11.8 KB
Loading

.gitbook/assets/image (42).png

81.6 KB
Loading

SUMMARY.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -484,9 +484,10 @@
484484
* [Document M365 shared mailboxes setup](prebuilt-automations/existing-crate-documentation/document-m365-shared-mailboxes-setup.md)
485485
* [Document M365 users setup](prebuilt-automations/existing-crate-documentation/document-m365-users-setup.md)
486486
* [Document Rewst Form URLs (IT Glue/Hudu) Crate](prebuilt-automations/existing-crate-documentation/document-rewst-form-urls-it-glue-hudu-crate.md)
487-
* [Manage Duo Phones Crate](prebuilt-automations/existing-crate-documentation/manage-duo-phones-crate.md)
487+
* [Document User Details V2 Crate](prebuilt-automations/existing-crate-documentation/document-user-details-v2-crate.md)
488488
* [Export Intune Policies and Configurations Crate](prebuilt-automations/existing-crate-documentation/export-intune-policies-and-configurations-crate.md)
489489
* [Just in Time Admin Access Crate](prebuilt-automations/existing-crate-documentation/just-in-time-admin-access-crate.md)
490+
* [Manage Duo Phones Crate](prebuilt-automations/existing-crate-documentation/manage-duo-phones-crate.md)
490491
* [Microsoft: User Onboarding Crate](prebuilt-automations/existing-crate-documentation/microsoft-user-onboarding-crate-v2/README.md)
491492
* [Onboarding Crate process overview](prebuilt-automations/existing-crate-documentation/microsoft-user-onboarding-crate-v2/onboarding-crate-process-overview.md)
492493
* [Onboarding Identity provider configuration and setup](prebuilt-automations/existing-crate-documentation/microsoft-user-onboarding-crate-v2/onboarding-identity-provider-configuration-and-setup.md)

prebuilt-automations/crates/migrating-between-crate-versions.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# Migrating between Crate versions
22

3-
## Considerations When Migrating
3+
## Considerations when migrating
44

55
When officially migrating to a newer version of a Crate, various items should be taken into consideration as part of this process. Below is a common list of actionable items to consider when migrating.
66

77
* Disabling workflow triggers
88
* Updating any workflow wrappers or completion handlers to utilize the new version of the Crate
9-
* Update references to the form. 
9+
* Updating references to the form.
1010
* For example, this may include any workflows that add form links to tickets
11-
* Update any custom forms that currently utilize the current version to be compatible with and utilize the new version
11+
* Updating any custom forms that currently utilize the current version to be compatible with and utilize the new version
1212

1313
## Crate migration steps
1414

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Document User Details V2 Crate
2+
3+
{% hint style="info" %}
4+
If you’re new to Crates, read through our introductory Crate documentation [here](https://app.rewst.io/marketplace/crates/ad23cb3a-d4fb-4066-91d1-719ea95a6355).
5+
{% endhint %}
6+
7+
## What does the Document User Details V2 Crate do?
8+
9+
Our Document User Details V2 Crate streamlines the documentation of user information in Microsoft 365. This crate automatically records critical user details such as licenses, aliases, and permission levels into your documentation tool.
10+
11+
## Why use the Document User Details V2 Crate?
12+
13+
* Keep up-to-date records of a clients users base in their M365 environment.
14+
* Provide ad-hoc and QBR reporting to your clients.
15+
16+
## Crate prerequisites
17+
18+
IT Glue or Hudu must be integrated with Rewst prior to unpacking this Crate.
19+
20+
The Microsoft Cloud Bundle must be unpacked, and configured, with GDAP Relationships established for your customers.
21+
22+
## Unpack the Document User Details V2 Crate
23+
24+
1. Navigate to **Crates** > **Crate Marketplace** in the Rewst platform.
25+
2. Search for the Document User Details V2 Crate.\
26+
\
27+
![](<../../.gitbook/assets/Screenshot 2025-03-24 at 2.53.14 PM.png>)
28+
3. Click on the Crate tile to begin unpacking.
29+
4. Click **Unpack Crate**.
30+
5. Click **Continue**.
31+
6. Change the **Workflow name**, if desired.\
32+
\
33+
34+
35+
<figure><img src="../../.gitbook/assets/Screenshot 2025-03-24 at 2.54.27 PM.png" alt=""><figcaption></figcaption></figure>
36+
7. Click **Unpack**.
37+
8. Navigate to **Automation > Workflows**.
38+
9. Search for `[Rewst Master v3] ITG: Document Users - [Part 1]`.
39+
10. Click into the workflow.
40+
11. Select the Gear icon to view trigger details.\
41+
\
42+
![](<../../.gitbook/assets/image (41).png>)
43+
12. Set the trigger to **Enabled**.
44+
13. Set the **Cron Schedule** as desired.\
45+
\
46+
47+
48+
<figure><img src="../../.gitbook/assets/image (42).png" alt=""><figcaption></figcaption></figure>
49+
14. Click **Submit**.
50+
51+
{% hint style="info" %}
52+
The workflow is designed to run at the MSP level organization. The workflow will automatically iterate through your Rewst child organizations and populate their specific form URLs in the documentation platform.
53+
{% endhint %}
54+
55+
## Test the Crate
56+
57+
1. Click **test** in the top right corner of the page.
58+
2. Select your MSP organization and click **Test**.
59+
3. Navigate to **Automation > Results** to view the workflow execution. Failed tasks in the record would indicate that the Crate is not working.
60+
61+
## Troubleshoot the Document User Details V2 Crate
62+
63+
### Forbidden error on Microsoft Graph actions
64+
65+
Check your Microsoft Cloud Bundle to make sure the client is configured correctly. Click the green shield icon next to your client to reconsent to delegate admin permission. If errors continue, check GDAP permissions.
66+
67+
### Forbidden error on IT Glue actions
68+
69+
Enable [password access to the API user in IT Glue](https://support.itglue.com/hc/en-us/articles/360017660198-Password-Access-Workflow-in-IT-Glue).
70+
71+
{% hint style="info" %}
72+
Got an idea for a new Crate? Rewst is constantly adding new Crates to our Crate Marketplace. Submit your idea or upvote existing ideas here in our [Canny feedback collector](https://rewst.canny.io/crates).
73+
{% endhint %}
74+

0 commit comments

Comments
 (0)