Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Load Settings from json #37

Closed
martincaddick opened this issue Nov 18, 2021 · 10 comments
Closed

Load Settings from json #37

martincaddick opened this issue Nov 18, 2021 · 10 comments

Comments

@martincaddick
Copy link

Looking further at documentation. On the jumpbox (without word) I can export the configuration to all the json files and then copy to a workstation (that does have word installed). If it were possible to 'Load' the configuration (without importing) and then document from the loaded configuration, that would be awesome.

Cheers

@Micke-K
Copy link
Owner

Micke-K commented Nov 18, 2021

Hello!

This should be possible. I kind of do this already in the Compare feature when using the documentation provider. I'll look into this.

Cheers

@Micke-K
Copy link
Owner

Micke-K commented Mar 3, 2022

The lates upload has support for documentation based on exported files.

Try it out when you have time.

Please note that some properties will not be documented if it can't connect to the tenant. These are referenced values like root certificate on SCEP profiles and certificate on VPN profiles.

Cheers!

@martincaddick
Copy link
Author

Noticed the new version yesterday and have already been testing. Jumpbox doesn't have word and does export correctly. Copied source to workstation that has Word installed and started documenting. Only issue I can see (specific to the environment) is that I am unable to use the proxy via PowerShell (constrained language mode) and therefore fails when using graph to enumerate groups / membership so I end up with a lot of guids in the doc rather than names.
Different tenant worked fine. CPU stayed at about 20-40% while generating the doc which took about 15 minutes and produced 280 pages. Let's call it a win. Nice job!

@Micke-K
Copy link
Owner

Micke-K commented Mar 3, 2022

Did you copy the migration table? The group name should be translated correctly if the MigratioTable.json is there. I documented an environment from export while logged into another and I got the group names.

Cheers!

@martincaddick
Copy link
Author

martincaddick commented Mar 3, 2022

I've been running cmtrace with the log file in debug and I can see it trying to connect to graph.microsoft.com for things like servicePrincipals, directoryObjects, namedLocations and directoryRoleTemplates.
Can you confirm when completely isolated from the internet that it will get everything from the MigrationTable.json file?

This change has already made a huge difference. If they're easy to implement a couple of extras would be:
selectable style for table captions and table text
selectable for table caption above or below the table

@Micke-K
Copy link
Owner

Micke-K commented Mar 17, 2022

I'm so sorry looks like I completely missed to reply to this.

I realised that there are quite a lot of dependencies that it tries to load even during offline documentation. I am looking into this right now. I've fixed a few of them.

Not sure about completely offline documentation. Then I need to add a lot of things into the MigTable. When I do offline documentation, I'm logged in to another tenant so I can still get some info from Graph. Can you do that or do you need absolutely no Internet access for the documentation?

I'll have a look at the additional settings. Should be possible.

Cheers!

@martincaddick
Copy link
Author

np. I managed to email the config out to then run the doco on another tenant (when I excluded the scripts that were blocked)

@Micke-K
Copy link
Owner

Micke-K commented Apr 26, 2022

Additional offline documentation support added in 3.5.0

Please report any issues to this thread

@Micke-K
Copy link
Owner

Micke-K commented Apr 26, 2022

This change has already made a huge difference. If they're easy to implement a couple of extras would be:
selectable style for table captions and table text
selectable for table caption above or below the table

This is included in 3.5.0. Let me know if you think it is ok

@Micke-K
Copy link
Owner

Micke-K commented Sep 10, 2022

Closing this. It's been implemented since 3.5.

Please open a new Issue if you have any problems.

Cheers!

@Micke-K Micke-K closed this as completed Sep 10, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants