Difference between revisions of "ACP Style Library"

Line 10: Line 10:
 
===To use the ACP Style library===
 
===To use the ACP Style library===
 
The recommended way to use the ACP Style library is to add it from the Options menu in the ACP GUI.  
 
The recommended way to use the ACP Style library is to add it from the Options menu in the ACP GUI.  
*Prepare your model in Desktop Analytica,  adding any Frame nodes or Tall nodes you want [[Embed_table_or_graph_with_ACP|embedded]]  on your diagrams. Once you have uploaded your model to ACP, launch the model by clicking on it's link in the model listing.
+
*Prepare your model in Desktop Analytica,  adding any Frame nodes or Tall nodes you want [[Embed_table_or_graph_with_ACP|embedded]]  on your diagrams.
 +
 
 +
=== Upload your model into ACP ===
 +
If you have an ACP account, you can upload your model into ACP from inside Analytica on the desktop:
 +
* From the '''File''' menu, select '''[[Publish_To_Cloud_dialog|Publish to cloud..]]'''.
 +
 
 +
Otherwise, you can upload your model from inside ACP"
 +
# Start up ACP from [https://acp.analytica.com/ https://acp.analytica.com/].
 +
# Sign in (or [sign up if you don't yet have an ACP account). [[Analytica_Cloud_Platform#How_to_use_ACP|more..]].
 +
# When you see the '''Models''' tab, click the '''Upload''' button.
 +
# Follow the file browser prompts to upload your model into ACP
 +
# Click the name of your uploaded model to start it up in ACP.Once you have uploaded your model to ACP, launch the model by clicking on it's link in the model listing.
 
*You can add the Acp Style library by clicking on the Options menu on the top teal bar (3 horizontal lines) and selecting Acp Style library.  
 
*You can add the Acp Style library by clicking on the Options menu on the top teal bar (3 horizontal lines) and selecting Acp Style library.  
 
[[File:ACP Styles hamburger01.png]]
 
[[File:ACP Styles hamburger01.png]]
  
=== How to install the ACP Style library ===
+
===What the ACP Style library does on model load===
 +
''In ACP3, the styles library has had some major changes. This explains one of the new features.''
 +
 
 +
*The Acp Style library will set some Acp Styles automatically in your model (after prompting you to accept or decline) . This is to simplify the task of preparing the model.
 +
*If you add the ACP Style library to a model which has no [[AcpStyles#Model_level_styles|model level AcpStyle]] attribute flags set, you will be asked to choose [[AcpStyles#Navigation_style|default settings]] (outline style) or [[AcpStyles#Tabbed_Module_Navigation|Recommended settings]] (Top tabs). The library will apply the styles to the model to display using the settings you accept.<br />
 +
[[File:ACP Style library question01.png]]
 +
*In contrast, when adding the ACP Style library to a model which already contains one or more [[AcpStyles#Model_level_styles|model level AcpStyles]], you will be prompted to either change to the recommended defaults, or to keep the AcpStyles already present in the model.
 +
[[File:ACP Style library question02.png]]
 +
**If you choose to keep the AcpStyles already present in the model, you will be asked to confirm...<br />
 +
[[File:ACP Style library question03.png]]<br />
 +
then the Acp style library will change to reflect these styles - eg if your model contains the AcpStyle <code>show_description:10</code>, the relevant choice menu in the Acp style library would be set to reflect this.
 +
 
  
The ACP Style library is included as a standard Analytica library, but we recommend using '''the most recent ACP Style library version which you can download here: [[Media:ACP_style_library.ana|ACP style library.ana]],''' since there have been major enhancements recently.'''
+
=== How to install the ACP Style library in Desktop Analytica ===
 +
If you prefer you can add the Acp style library to Desktop Analytica before uploading to ACP. The ACP Style library is included as a standard Analytica library, but we recommend using '''the most recent ACP Style library version which you can download here: [[Media:ACP_style_library.ana|ACP style library.ana]],''' since there have been major enhancements recently.'''
  
 
<!--The simplest way to add the ACP Style library is to load it from the standard Analytica libraries:
 
<!--The simplest way to add the ACP Style library is to load it from the standard Analytica libraries:
Line 32: Line 55:
 
{{Release|6.0||:[[File:Reading ACP Style library into a model in desktop Analytica.png]]
 
{{Release|6.0||:[[File:Reading ACP Style library into a model in desktop Analytica.png]]
  
===What the ACP Style library does on model load===
 
''In ACP3, the styles library has had some major changes. This explains one of the new features.''
 
 
*As distributed, the ACP style library has been [[ACP_Style_Library#Make_the_Acp_Style_library_ready_for_Import_into_another_model|made ready for import]] - it will set some Acp Styles automatically in your model (after prompting you to accept or decline) . This is to simplify the task of preparing the model.
 
*Once the style library is imported into a model, it is no longer "''ready for import''" , and it will not automatically apply Acp styles (unless you [[ACP_Style_Library#Make_the_Acp_Style_library_ready_for_Import_into_another_model|make it ready]] and save it, or use a fresh copy).
 
 
*If you add the ACP Style library to a model which has no [[AcpStyles#Model_level_styles|model level AcpStyle]] attribute flags set, you will be asked to choose [[AcpStyles#Navigation_style|default settings]] (outline style) or [[AcpStyles#Tabbed_Module_Navigation|Recommended settings]] (Top tabs). The library will apply the styles to the model to display using the settings you accept.<br />
 
[[File:ACP Style library question01.png]]
 
*In contrast, when adding the ACP Style library to a model which already contains one or more [[AcpStyles#Model_level_styles|model level AcpStyles]], you will be prompted to either change to the recommended defaults, or to keep the AcpStyles already present in the model.
 
[[File:ACP Style library question02.png]]
 
**If you choose to keep the AcpStyles already present in the model, you will be asked to confirm...<br />
 
[[File:ACP Style library question03.png]]<br />
 
then the Acp style library will change to reflect these styles - eg if your model contains the AcpStyle <code>show_description:10</code>, the relevant choice menu in the Acp style library would be set to reflect this.
 
 
}}
 
  
 +
Once you've imported the ACP Styles library into your model, you can use it to set ACP styles in desktop Analytica.
 +
But, it's better to do in in ACP so you can immediately see the effects of each setting.
  
 
{{Release|6.0||
 
{{Release|6.0||
 
=== Upload your model into ACP ===
 
=== Upload your model into ACP ===
 
+
If you have imported the ACP Styles library into your model in Desktop Analytica, you can use it to set ACP styles in desktop Analytica.
Once you've imported the ACP Styles library into your model, you can use it to set ACP styles in desktop Analytica.
 
 
But, it's better to do in in ACP so you can immediately see the effects of each setting.
 
But, it's better to do in in ACP so you can immediately see the effects of each setting.
  
Line 77: Line 86:
 
More details coming soon....
 
More details coming soon....
 
}}
 
}}
 +
<!--As distributed, the ACP style library has been [[ACP_Style_Library#Make_the_Acp_Style_library_ready_for_Import_into_another_model|made ready for import]] - it will set some Acp Styles automatically in your model (after prompting you to accept or decline) . This is to simplify the task of preparing the model.
 +
*Once the style library is imported into a model, it is no longer "''ready for import''" , and it will not automatically apply Acp styles (unless you [[ACP_Style_Library#Make_the_Acp_Style_library_ready_for_Import_into_another_model|make it ready]] and save it, or use a fresh copy).-->
  
 
{{Release||5.4|  
 
{{Release||5.4|  

Revision as of 13:33, 15 April 2022



Release:

4.6  •  5.0  •  5.1  •  5.2  •  5.3  •  5.4  •  6.0  •  6.1  •  6.2  •  6.3  •  6.4  •  6.5


The Analytica Cloud Platform (ACP) offers a variety of user-interface styles and features useful for web applications, and not available in desktop Analytica. These include navigation styles with tabs across the top or down the left side, node styles, and Frame nodes to show tables and graphs embedded in a Diagram. Using the ACP Style Library makes it much easier to select these styles than setting special flags and codes in the AcpStyles attributes of the model.


To use the ACP Style library

The recommended way to use the ACP Style library is to add it from the Options menu in the ACP GUI.

  • Prepare your model in Desktop Analytica, adding any Frame nodes or Tall nodes you want embedded on your diagrams.

Upload your model into ACP

If you have an ACP account, you can upload your model into ACP from inside Analytica on the desktop:

Otherwise, you can upload your model from inside ACP"

  1. Start up ACP from https://acp.analytica.com/.
  2. Sign in (or [sign up if you don't yet have an ACP account). more...
  3. When you see the Models tab, click the Upload button.
  4. Follow the file browser prompts to upload your model into ACP
  5. Click the name of your uploaded model to start it up in ACP.Once you have uploaded your model to ACP, launch the model by clicking on it's link in the model listing.
  • You can add the Acp Style library by clicking on the Options menu on the top teal bar (3 horizontal lines) and selecting Acp Style library.

ACP Styles hamburger01.png

What the ACP Style library does on model load

In ACP3, the styles library has had some major changes. This explains one of the new features.

  • The Acp Style library will set some Acp Styles automatically in your model (after prompting you to accept or decline) . This is to simplify the task of preparing the model.
  • If you add the ACP Style library to a model which has no model level AcpStyle attribute flags set, you will be asked to choose default settings (outline style) or Recommended settings (Top tabs). The library will apply the styles to the model to display using the settings you accept.

ACP Style library question01.png

  • In contrast, when adding the ACP Style library to a model which already contains one or more model level AcpStyles, you will be prompted to either change to the recommended defaults, or to keep the AcpStyles already present in the model.

ACP Style library question02.png

    • If you choose to keep the AcpStyles already present in the model, you will be asked to confirm...

ACP Style library question03.png
then the Acp style library will change to reflect these styles - eg if your model contains the AcpStyle show_description:10, the relevant choice menu in the Acp style library would be set to reflect this.


How to install the ACP Style library in Desktop Analytica

If you prefer you can add the Acp style library to Desktop Analytica before uploading to ACP. The ACP Style library is included as a standard Analytica library, but we recommend using the most recent ACP Style library version which you can download here: ACP style library.ana, since there have been major enhancements recently.


After downloading the library into a folder, you can read it into your model:

  1. Make sure you are in edit mode.
  2. Click File menu > Add Library...
  3. Select ACP Styles.ana' from the folder into which you saved the file and click Open

The 'ACP Styles library' will appear in the diagram:


{{Release|6.0||:Reading ACP Style library into a model in desktop Analytica.png


Once you've imported the ACP Styles library into your model, you can use it to set ACP styles in desktop Analytica. But, it's better to do in in ACP so you can immediately see the effects of each setting.

Upload your model into ACP

If you have imported the ACP Styles library into your model in Desktop Analytica, you can use it to set ACP styles in desktop Analytica. But, it's better to do in in ACP so you can immediately see the effects of each setting.

If you have an ACP account, you can upload your model into ACP from inside Analytica on the desktop:

Otherwise, you can upload your model from inside ACP"

  1. Start up ACP from https://acp.analytica.com/.
  2. Sign in (or [sign up if you don't yet have an ACP account). more...
  3. When you see the Models tab, click the Upload button.
  4. Follow the file browser prompts to upload your model into ACP
  5. Click the name of your uploaded model to start it up in ACP.

How to set ACP styles

The easiest way to see what each option does is just to select from the menu or (uncheck) the checkbox. ACP will immediately show the effect of the changed style. The Default styles for tables and graphs show in the "Preview result" just to the right. A few, like the "Fly-in" option for Index menus show the Pivot icon only when you move your cursor over the "Preview result".

ACP Style library w Preview result styles.png

You can also move your cursor over each control to see its description in a balloon, in the usual way.

Make the Acp Style library ready for Import into another model

More details coming soon....


See Also

Comments


You are not allowed to post comments.