documentation

ID	Name	Type	Description
1. External Data Mapping
1.0.1	ID	Drop-down	A unique identifier from the external datasource (e.g. 'Periodic Table' element atomic number)
1.0.2	Name	Drop-down	A meaningful name from the external datasource (e.g. 'Periodic Table' element name)
1.0.3	Description	Drop-down	A description from the external datasource (e.g. 'Periodic Table' description)
1.0.4	Link URL	Drop-down	A URL from the external datasource (e.g. 'Periodic Table' link to Wikipedia article)
1.0.5	Use External Data	Checkbox	Does the model map external data to the shapes in the drawing
1.0.6	External Data Source	Button	Lauch the External Data configuration dialog (see below)
1.1 External Data Dialog : Data Source
1.1.1	Data Source Name	Text	The name of the external data source
1.1.2	Data Source URL	Text	The URL for the RESTful API
1.1.3	API Query	Text	An optional API query string to filter the RESTful API results
1.1.4	Authentication	Listbox ('None', 'Username & Password', 'API Key', 'Login with Microsoft')	The API authentication scheme
1.1.5	Username (for 'Username & Password')	Text	The user principal
1.1.6	Password (for 'Username & Password')	Text	The user password
1.1.7	Key Name (for 'API Key')	Text	The HTTP header name
1.1.8	Key Value (for 'Username & Password')	Text	The HTTP header value
1.1.9	User Principal (for 'Login with Microsoft')	Text (optional)	A user principal hint
1.1.10	Azure App ID (for 'Login with Microsoft')	Text (optional)	The MG4V application UUID
1.1.11	Encode API Query	Checkbox	Optionally URL encode the API query (default is false)
1.1.12	Test API	Button	Test the API configuration and load the response in the "MG4V External Data JSON Viewer" dialog
1.2 External Data Dialog : Map Fields
1.2.1	Base Configuration : Root	Text	The jq path for the root of the repeating result set (where applicable)
1.2.2	Base Configuration : Multiple Children	Checkbox	Whether the API result set is exepected to return an array of repeating values
1.2.3	Field Configuration : Name	Text	The name of a column / field in the resultset
1.2.4	Field Configuration : Type	Select ('Boolean', 'Float', 'Int', 'String', 'Date', 'Date Time')	The type of a column / field in the resultset
1.2.5	Field Configuration : Path	Text	The jq path for the field in the resultset
1.2.6	Field Configuration : Show Field Detail	Checkbox	Whether to show the field configuration detail in the data grid resultset
1.2.7	Add Field	Button	Add a new field to the resultset field configuration
1.2.8	Delete Field	Button	Delete the selected field from the resultset field configuration
1.2.9	Clear All	Button	Reset the field resultset configuration
1.3 External Data Dialog : External Data Load
1.3.1	Delete Row	Button	Delete the selected row from the resulset
1.4 External Data Dialog : Button Bar
1.4.1	Save to File	Button	Export the external data configuration to a file
1.4.2	Load from File	Button	Import an existing external data configuration from a file
1.4.3	Reset	Button	Reset the external data configuration dialog
1.4.4	Load Data	Button	Execute the configured API query and load the retured data into the 'External Data Load' tab
1.4.5	Import and Close	Button	Import the resultset from the 'External Data Load' tab as an new named External Data source in the Visio model and close the dialog
1.4.6	Close	Button	Close the External Data dialog
2. Published Model Behaviour
2.1	Initial	Dropdown (%)	The initial size of the published model
2.2	Min	Dropdown (%)	The minimum size for zoom out (≤ Max)
2.3	Max	Dropdown (%)	The maximum size for zoom in (≥ Min)
2.4	Zoom Step	Dropdown ('Very Small', 'Small', 'Medium', 'Large', 'Very Large')	The zoom increment step size
2.5	Pan Step	Dropdown ('Very Small', 'Small', 'Medium', 'Large', 'Very Large')	Enable pan increment step size
2.6	Animation	Dropdown ('Off', 'Very Slow', 'Slow', 'Medium', 'Fast', 'Very Fast')	Pan and zoom response time / delay (no delay when 'Off')
2.7	Mouse Wheel	Checkbox	If enabled the mouse wheel will zoom in / zoom out, if disabled the mouse wheel will page scroll
2.8	Export Layers	Checkbox	Whether to export dynamic layer controls
3. Published Model Appearance
3.1	Fill	Color Picker Dialog	The highlight fill when the mouse pointer hovers over a model element
3.2	Line	Color Picker Dialog	The line color when the mouse pointer hovers over a model element
3.3	Font	Color Picker Dialog	The font color when the mouse pointer hovers over a model element
3.4	Line Width (pt)	Dropdown	The line width when the mouse pointer hovers over a model element
3.5	Popup Size	Drop-down ('Large', 'Medium', 'Small')	The popup dialog size
3.6	Modal Popup	Checkox	Whether the popup should be modal
4. Published Model Search
4.1	Seach On	Checkbox	Whether to display search field for interative indexed search
4.2	Search Field	Drop-down	The external data field used for indexed searches
4.3	Match Fill	Color Picker Dialog	The fill color for matched searches
4.4	Match Line	Color Picker Dialog	The line color for matched searches
4.5	Match Font	Color Picker Dialog	The font color for matched searches
4.6	No Match Fill	Color Picker Dialog	The fill color for non-matched searches
4.7	No Match Line	Color Picker Dialog	The line color for non-matched searches
4.8	No Match Font	Color Picker Dialog	The font color for non-matched searches
4.9	Shape Opacity	Dropdown (%)	The shape fill opacity non-matched searches
4.10	Text Opacity	Dropdown (%)	The text fill opacity non-matched searches
5. Output File Properties
5.1	Page Name	Text	The generated HTML page (overrides default Visio Page name)
5.2	Slim HTML	Checkbox	Additional processing to reduce the size of the generated HTML (may result in reduced quality image)
5.3	Browser Launch	Checkbox	Whether to launch the generated HTML page in a browser
5.4	User Settings	Button	Launch User Settings dialog (see below)
5.5	Publish	Button	Publishes the model based upon user configuration settings
5.6	Profile	Button	The active user settings profile
5.7	Name	Text	The active user settings profile name
6. User Settings
6.1 Active Profile Selector & Configuration Security
6.1.1	Active Profile	Pick List	The active user settings profile
6.1.2	Profile Name	Text	A user friendly name to identify the active user setting profile
6.1.3	Security Password	Text, must be 8 characters	The encryption/decryption password for user registry saved, and exported user settings
6.1.4	Password Visible	Checkbox	Unmasks encryption/decryption password when checked
6.1.3	Save To Directory	Folder Chooser	The folder where generated HTML gets written
6.2 AWS S3
6.2.1	Access Key	Text	AWS access key for S3 bucket
6.2.2	Secret Key	Text	AWS secret key for S3 bucket
6.2.3	AWS Region	ListBox	AWS S3 bucket region
6.2.4	Bucket Name	Text	S3 bucket name
6.2.5	Test	Button	Tests AWS S3 configuration
6.3 Confluence
6.3.1	Site URL	Text	Confluence cloud URL (e.g. https://<domain>.atlassian.net) or Confluence Server URL
6.3.2	User ID (email)	Text	Confluence Cloud user email address, or Confluence Server user name
6.3.3	API Token	Text	API token for Confluence Cloud API requests (see https://id.atlassian.com/manage-profile/security/api-tokens). Alternatively the Confluence Server user password
6.3.4	Space Key	Text	Target Confluence Space
6.3.5	Parent Page ID	Number	ID of parent page to publish ModelGen for Visio content
6.3.7	Hosting	ListBox ("Cloud", "Server")	The Confluence host environment
6.3.8	Test	Button	Tests confluence configuration
6.3.9	Frame Border	ListBox ("show" or "hide")	Whether to surround generated model with a border
6.3.10	Scrolling	ListBox ("yes", "no" or "auto")	Scrolling behaviour for generated model
6.3.11	Width	Percentage	Generated model width percentage
6.3.12	Height	Number	Generated model height in pixels
6.3.13	Alignment	ListBox ("left", "right", "top", "middle", "bottom")	The position of the generated model within the page
6.3.14	Page Source	ListBox ("VP4C", "AWS S3", "Azure Blob")	The source of the model, one of: 1. VP4C : Visio Publisher for Confluence dynamic macro (installed from Atlassian marketplace - see below); or 2. AWS S3 : Confluence IFrame macro with page src URL set to AWS S3 bucket; or 3. Azure Blob : Confluence IFrame macro with page src URL set to Azure Blob container
6.4 SharePoint
6.4.1	SharePoint Site	Text	SharePoint Online publish site (e.g. https://<domain>.sharepoint.com/sites/<Site Name>)
6.4.2	Login using Microsoft	Checkbox	Whether to prompt the user to pick an existing Azure AD account (including current logged in user). When checked the User and Password fields are disabled, however a populated User name will be used as a hint.
6.4.3	User	Text	Azure AD User (only used where 6.4.2 "Login using Microsoft" is unchecked)
6.4.4	Password	Text	Azure AD Password (only used where 6.4.2 "Login using Microsoft" is unchecked)
6.4.5	VP4S Document	Text	A relative path under the SharePoint Shared Documents where MG4V will publish the generated HTML model. Only used where 6.4.12 "Page Source" is set to "VP4S"
6.4.6	Test	Button	Tests SharePoint Online, including SharePoint site access, and existence of "VPS Document" path when using VP4S
6.4.7	Frame Border	ListBox ("show" or "hide")	Whether to surround generated model with a border
6.4.8	Scrolling	ListBox ("yes", "no" or "auto")	Scrolling behaviour for generated model
6.4.9	Width	Percentage	Generated model width percentage
6.4.10	Height	Number	Generated model height in pixels
6.4.11	Alignment	ListBox ("left", "right", "top", "middle", "bottom")	The position of the generated model within the page
6.4.12	Page Source	ListBox ("VP4S", "Azure Blob", "AWS S3")	The source of the model, one of : 1. Visio Publisher for SharePoint (VP4S) instlled from Microsoft SharePoint store, 2. Azure Blob : Embed WebPart with page src URL set to Azure Blob container, 3. AWS S3 : Embed WebPart with page src URL set to AWS S3 bucket
6.5 Azure Blob
6.5.1	Connection String	Text	Azure Blob Connection String
6.5.2	Container Name	Text	Azure Blob Container String
6.5.3	Test	Button	Tests connectivity to the Azure Blob Container, using the Connection String. If the named container doesn't exist, then it will be created
6.6 Advanced
6.6.1	Azure App ID	Text	Unique Azure AD Application ID (assigned by SharePoint Azure AD admin). Defaults to CPAS registered MG4V application where "Azure multitenant" is checked.
6.6.2	Azure Tenant ID	Text	Azure AD Tenant ID for user authentication. Defaults to "common" where "Azure multitenant" is checked.
6.6.3	Azure multitenant	Checkbox	Whether MG4V should be treated as a mutitenant application. When unchecked the "Azure App ID" and "Azure Tenant ID" fields are editable
6.7 Configuration Action
6.7.1	Save All	Button	Saves user configuration to user registry (requires a valid Security Password)
6.7.2	Close	Button	Closes user configuration window. If there are unsaved user configuration changes these will be saved
6.7.3	Export	Button	Exports encrypted user configuration to file "ModelGenVisioConfiguration.mg4v" in nominated directory
6.7.4	Import	Button	Imports encrypted user configuration from file "ModelGenVisioConfiguration.mg4v" in nominated directory
6.7.5	Load	Button	Loads user configuration from registry (requires a valid Security Password)

Description	Visio Drawing	Visio 2003 - 2010 Drawing
An interactive periodic table demonstrating all MG4V features	Periodic-Table.vsdx	Periodic-Table.vsd
A sample entity relationship diagram with dynamic entities and relationships	General Ledger ERD.vsdx	General Ledger ERD.vsd
A sample business process flow model	Match Invoice Proocess Flow Chart.vsdx	Match Invoice Proocess Flow Chart.vsd

End-User License Agreement ("Agreement")

Last updated: September 20, 2020

Please read this End-User License Agreement carefully before clicking the "I Agree" button, downloading or using ModelGen for Visio (MG4V) and/or Visio Pubisher for Confluence (VP4C) .

Interpretation and Definitions

Interpretation

The words of which the initial letter is capitalized have meanings defined under the following conditions. The following definitions shall have the same meaning regardless of whether they appear in singular or in plural.

Definitions

For the purposes of this End-User License Agreement:

Agreement means this End-User License Agreement that forms the entire agreement between You and the Company regarding the use of the Application.
Application means the software program provided by the Company downloaded by You to a Device, named ModelGen for Visio
Company (referred to as either "the Company", "We", "Us" or "Our" in this Agreement) refers to Crecy Poitiers Agincourt Solutions, Suite 1016 Level 10 155 King St Sydney NSW 2048 Australia.
Content refers to content such as text, images, or other information that can be posted, uploaded, linked to or otherwise made available by You, regardless of the form of that content.
Country refers to: New South Wales, Australia
Device means any device that can access the Application such as a computer, a cellphone or a digital tablet.
Third-Party Services means any services or content (including data, information, applications and other products services) provided by a third-party that may be displayed, included or made available by the Application.
You means the individual accessing or using the Application or the company, or other legal entity on behalf of which such individual is accessing or using the Application, as applicable.

Acknowledgment

By clicking the "I Agree" button, downloading or using the Application, You are agreeing to be bound by the terms and conditions of this Agreement. If You do not agree to the terms of this Agreement, do not click on the "I Agree" button, do not download or do not use the Application.

This Agreement is a legal document between You and the Company and it governs your use of the Application made available to You by the Company.

The Application is licensed, not sold, to You by the Company for use strictly in accordance with the terms of this Agreement.

License

Scope of License

The Company grants You a revocable, non-exclusive, non-transferable, limited license to download, install and use the Application strictly in accordance with the terms of this Agreement.

The license that is granted to You by the Company is solely for your personal, non-commercial purposes strictly in accordance with the terms of this Agreement.

License Restrictions

You agree not to, and You will not permit others to:

License, sell, rent, lease, assign, distribute, transmit, host, outsource, disclose or otherwise commercially exploit the Application or make the Application available to any third party.
Modify, make derivative works of, disassemble, decrypt, reverse compile or reverse engineer any part of the Application.
Remove, alter or obscure any proprietary notice (including any notice of copyright or trademark) of the Company or its affiliates, partners, suppliers or the licensors of the Application.

Content

Content Restrictions

The Company is not responsible for the entries, information or content of the Application's users. You expressly understand and agree that You are solely responsible for the Content and for all activity that occurs under your account, whether done so by You or any third person using your account.

You may not transmit any Content that is unlawful, offensive, upsetting, intended to disgust, threatening, libelous, defamatory, obscene or otherwise objectionable. Examples of such objectionable Content include, but are not limited to, the following:

Unlawful or promoting unlawful activity.
Defamatory, discriminatory, or mean-spirited content, including references or commentary about religion, race, sexual orientation, gender, national/ethnic origin, or other targeted groups.
Spam, machine – or - or randomly - – generated, constituting unauthorized or unsolicited advertising, chain letters, any other form of unauthorized solicitation, or any form of lottery or gambling.
Containing or installing any viruses, worms, malware, trojan horses, or other content that is designed or intended to disrupt, damage, or limit the functioning of any software, hardware or telecommunications equipment or to damage or obtain unauthorized access to any data or other information of a third person.
Infringing on any proprietary rights of any party, including patent, trademark, trade secret, copyright, right of publicity or other rights.
Impersonating any person or entity including the Company and its employees or representatives.
Violating the privacy of any third person.
False information and features.

The Company reserves the right, but not the obligation, to, in its sole discretion, determine whether or not any Content is appropriate and complies with this Agreement, refuse or remove any Content. The Company further reserves the right to make formatting and edits and change the manner any Content. The Company can also limit or revoke the use of the Application if You post such objectionable Content.

As the Company cannot control all content posted by users and/or third parties on the Application, you agree to use the Application at your own risk. You understand that by using the Application You may be exposed to content that You may find offensive, indecent, incorrect or objectionable, and You agree that under no circumstances will the Company be liable in any way for any content, including any errors or omissions in any content, or any loss or damage of any kind incurred as a result of your use of any content.

Intellectual Property

The Application, including without limitation all copyrights, patents, trademarks, trade secrets and other intellectual property rights are, and shall remain, the sole and exclusive property of the Company.

The Company shall not be obligated to indemnify or defend You with respect to any third party claim arising out of or relating to the Application. To the extend the Company is required to provide indemnification by applicable law, the Company shall be solely responsible for the investigation, defense, settlement and discharge of any claim that the Application or your use of it infringes any third party intellectual property rights.

Your Suggestions

Any feedback, comments, ideas, improvements or suggestions provided by You to the Company with respect to the Application shall remain the sole and exclusive property of the Company.

The Company shall be free to use, copy, modify, publish, or redistribute the Suggestions for any purpose and in any way without any credit or any compensation to You.

Modifications to the Application

The Company reserves the right to modify, suspend or discontinue, temporarily or permanently, the Application or any service to which it connects, with or without notice and without liability to You.

Updates to the Application

The Company may from time to time provide enhancements or improvements to the features/functionality of the Application, which may include patches, bug fixes, updates, upgrades and other modifications.

Updates may modify or delete certain features and/or functionalities of the Application. You agree that the Company has no obligation to (i) provide any Updates, or (ii) continue to provide or enable any particular features and/or functionalities of the Application to You.

You further agree that all updates or any other modifications will be (i) deemed to constitute an integral part of the Application, and (ii) subject to the terms and conditions of this Agreement.

Maintenance and Support

The Company does not provide any maintenance or support for the download and use of the Application. To the extent that any maintenance or support is required by applicable law, the Company shall be obligated to furnish any such maintenance or support.

Third-Party Services

The Application may display, include or make available third-party content (including data, information, applications and other products services) or provide links to third-party websites or services.

You acknowledge and agree that the Company shall not be responsible for any Third-party Services, including their accuracy, completeness, timeliness, validity, copyright compliance, legality, decency, quality or any other aspect thereof. The Company does not assume and shall not have any liability or responsibility to You or any other person or entity for any Third-party Services.

You must comply with applicable Third parties' Terms of agreement when using the Application. Third-party Services and links thereto are provided solely as a convenience to You and You access and use them entirely at your own risk and subject to such third parties' Terms and conditions.

Term and Termination

This Agreement shall remain in effect until terminated by You or the Company. The Company may, in its sole discretion, at any time and for any or no reason, suspend or terminate this Agreement with or without prior notice.

This Agreement will terminate immediately, without prior notice from the Company, in the event that you fail to comply with any provision of this Agreement. You may also terminate this Agreement by deleting the Application and all copies thereof from your Device or from your computer.

Upon termination of this Agreement, You shall cease all use of the Application and delete all copies of the Application from your Device.

Termination of this Agreement will not limit any of the Company's rights or remedies at law or in equity in case of breach by You (during the term of this Agreement) of any of your obligations under the present Agreement.

Indemnification

You agree to indemnify and hold the Company and its parents, subsidiaries, affiliates, officers, employees, agents, partners and licensors (if any) harmless from any claim or demand, including reasonable attorneys' fees, due to or arising out of your: (a) use of the Application; (b) violation of this Agreement or any law or regulation; or (c) violation of any right of a third party.

No Warranties

The Application is provided to You "AS IS" and "AS AVAILABLE" and with all faults and defects without warranty of any kind. To the maximum extent permitted under applicable law, the Company, on its own behalf and on behalf of its affiliates and its and their respective licensors and service providers, expressly disclaims all warranties, whether express, implied, statutory or otherwise, with respect to the Application, including all implied warranties of merchantability, fitness for a particular purpose, title and non-infringement, and warranties that may arise out of course of dealing, course of performance, usage or trade practice. Without limitation to the foregoing, the Company provides no warranty or undertaking, and makes no representation of any kind that the Application will meet your requirements, achieve any intended results, be compatible or work with any other software, applications, systems or services, operate without interruption, meet any performance or reliability standards or be error free or that any errors or defects can or will be corrected.

Without limiting the foregoing, neither the Company nor any of the company's provider makes any representation or warranty of any kind, express or implied: (i) as to the operation or availability of the Application, or the information, content, and materials or products included thereon; (ii) that the Application will be uninterrupted or error-free; (iii) as to the accuracy, reliability, or currency of any information or content provided through the Application; or (iv) that the Application, its servers, the content, or e-mails sent from or on behalf of the Company are free of viruses, scripts, trojan horses, worms, malware, timebombs or other harmful components.

Some jurisdictions do not allow the exclusion of certain types of warranties or limitations on applicable statutory rights of a consumer, so some or all of the above exclusions and limitations may not apply to You. But in such a case the exclusions and limitations set forth in this section 11 shall be applied to the greatest extent enforceable under applicable law. To the extent any warranty exists under law that cannot be disclaimed, the Company shall be solely responsible for such warranty.

Limitation of Liability

Notwithstanding any damages that You might incur, the entire liability of the Company and any of its suppliers under any provision of this Agreement and your exclusive remedy for all of the foregoing shall be limited to the amount actually paid by You for the Application or through the Application.

To the maximum extent permitted by applicable law, in no event shall the Company or its suppliers be liable for any special, incidental, indirect, or consequential damages whatsoever (including, but not limited to, damages for loss of profits, loss of data or other information, for business interruption, for personal injury, loss of privacy arising out of or in any way related to the use of or inability to use the Application, third-party software and/or third-party hardware used with the Application, or otherwise in connection with any provision of this Agreement), even if the Company or any supplier has been advised of the possibility of such damages and even if the remedy fails of its essential purpose.

Some states/jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to You.

Severability and Waiver

Severability

If any provision of this Agreement is held to be unenforceable or invalid, such provision will be changed and interpreted to accomplish the objectives of such provision to the greatest extent possible under applicable law and the remaining provisions will continue in full force and effect.

Waiver

Except as provided herein, the failure to exercise a right or to require performance of an obligation under this Agreement shall not effect a party's ability to exercise such right or require such performance at any time thereafter nor shall be the waiver of a breach constitute a waiver of any subsequent breach.

Product Claims

The Company does not make any warranties concerning the Application.

United States Legal Compliance

You represent and warrant that (i) You are not located in a country that is subject to the United States government embargo, or that has been designated by the United States government as a "terrorist supporting" country, and (ii) You are not listed on any United States government list of prohibited or restricted parties.

Changes to this Agreement

The Company reserves the right, at its sole discretion, to modify or replace this Agreement at any time. If a revision is material we will provide at least 30 days' notice prior to any new terms taking effect. What constitutes a material change will be determined at the sole discretion of the Company.

By continuing to access or use the Application after any revisions become effective, You agree to be bound by the revised terms. If You do not agree to the new terms, You are no longer authorized to use the Application.

Governing Law

The laws of the Country, excluding its conflicts of law rules, shall govern this Agreement and your use of the Application. Your use of the Application may also be subject to other local, state, national, or international laws.

Entire Agreement

The Agreement constitutes the entire agreement between You and the Company regarding your use of the Application and supersedes all prior and contemporaneous written or oral agreements between You and the Company.

You may be subject to additional terms and conditions that apply when You use or purchase other Company's services, which the Company will provide to You at the time of such use or purchase.

Contact Us

If you have any questions about this Agreement, You can contact Us:

By email: info@crecy.com.au
By visiting this page on our website: https://crecy.com.au/model-gen
By phone number: +61 2 9079 1802

about

installation

documentation

1. External Data Mapping

1.1 External Data Dialog : Data Source

1.2 External Data Dialog : Map Fields

1.3 External Data Dialog : External Data Load

1.4 External Data Dialog : Button Bar

2. Published Model Behaviour

3. Published Model Appearance

4. Published Model Search

5. Output File Properties

6. User Settings

6.1 Active Profile Selector & Configuration Security

6.2 AWS S3

6.3 Confluence

6.4 SharePoint

6.5 Azure Blob

6.6 Advanced

6.7 Configuration Action

Examples

Example Models

Entra ID

Microsoft Entra ID Gallery - MG4V

VP4C

Visio Publisher for Confluence - VP4C

VP4S

Visio Publisher for SharePoint - VP4S

support