Answered

SUGGESTION BOX: Show "Instructions" after importing Component

(1) Share

Report

Posted on by Community Power Pla... Microsoft Employee

Hello, just a cool suggestion here (not going to post in Ideas).
From my experience, Components need to be "configured" after they are imported into a new app. It would be AWESOME if the Component maker could pass some simple "Instructions" along with the component. These instructions could include the configuration code.

Example:

Responsive Screen Component: "cmpComponent"

- Custom Input Properties:

- cmpHeader

- cmpPrimaryColor

- Bar (Icon control) across component:

- Text: cmpComponent.cmpHeader

- Fill: cmpComponent.cmpPrimaryColor

- Instructions popup would read:

Steps to incorporate this Component.

1. Copy the following code to your apps OnStart or your screen's OnVisible property:
Set(varHeader, <enter your app name>);
Set(varPrimaryColor, <enter hex value>)

2. Select the Component in the Tree View

3. Set its properties accordingly:
- cmpHeader: varHeader
- cmpPrimaryColor: varPrimaryColor

Categories:

Building Power Apps

I have the same question (0)

All responses (3)

Answers (1)

Sort by

Verified answer

RezaDorrani 12,145 on at

Like
a
(1)

Report
Copy link

Link copied!

Hi @ericonline

great suggestion

Alternatively, component can also include a label - which contains all the instructions which then can be deleted or hidden by the person importing it
I have been doing that for most of the components I build

Regards,
Reza Dorrani

If this post helps, then please consider Accept it as the solution to help the other members find it more quickly

Was this reply helpful? Yes No
Community Power Pla... Microsoft Employee on at

Like
a
(1)

Report
Copy link

Link copied!

Great suggestion @RezaDorrani ! I usually put that type of thing into a code comment, but components don't have a "top level" property (like OnStart or OnVisible) to put such a comment.

I love this idea and call this a definite Solution!

Was this reply helpful? Yes No
Community Power Pla... Microsoft Employee on at

Like
a
(1)

Report
Copy link

Link copied!
For the benefit of others, here are the instructions I created for a reusable screen component. These are placed inside an HTML Text control. Hope this helps!

" This component has 8 Custom Properties that must be instantiated after the component is imported. Copy the following code into the OnStart or OnVisible property of your app: NOTE: Everything shown between '- -' below must be customized by you, the app maker. <ol> <li> <code> Concurrent( ClearCollect(colMenuItems, {screen: -screenName as string-, icon: Icon.-whichever icon you want-}, -repeat for each screen in the menu- ), Set(varLogo, -URL of your logo-); Set(varHeader, -name of app as string-), Set(varVersion, -version of app as string-); Set(varPrimaryColor, -hex value of color as #XXXXXX-), Set(varSecondaryColor, -hex value of color as #XXXXXX-), Set(varVersion, -version of your app as string-) ); Set(varTimerStart,true); Set(varTimerStart,false); Set(varTimerStart,true); </code> </li> <li> After this code is instantiated, set the cmpRespScreen custom properties as such: <ul> <li> <code> cmpMenuItems = colMenuItems cmpLogo = varLogo cmpHeader = varHeader cmpVersion = varVersion cmpPrimaryColor = varPrimaryColor cmpSecondaryColor = varSecondaryColor cmpTimerStart = varTimerStart cmpVersion = varVersion </code> </li> </ul> </li> <li> Finally, execute the OnStart or OnVisible code to see your component come alive! </li> </ol> For support, contact me@mycompany.com. "

Was this reply helpful? Yes No