Renaming App Placements

[eric_allison]

We have an app added in an account as a URL.  We want to rename the placement but can't figure out how to do that.  We can see the placements in the app settings but can't edit them there.  Is there a way to update placement titles in a URL app after they exist?

[awilliams]

Hey  @eric_allison ‌,

I'm not 100% sure what you mean when you say "rename the placement" but I do know that normally I customize the placement choices of an LTI when I install it. Those options aren't all always present. I believe it depends on the configuration of the LTI. This is a rather technical question though, so I'm also going to share it with the https://community.canvaslms.com/groups/canvas-developers?sr=search&searchId=3c4c05b7-8418-4aad-a4e8-...‌ group.

[James]

 @eric_allison ,

Like awilliams, I'm not sure exactly what you mean by placement, either -- does that mean location in the list, the name it uses, or whether it's on the navigation bar or Rich Content Editor or somewhere else?

You should be able to change the name (and a bunch of other stuff) using the edit an external tool API endpoint.

If you're wanting to change something from navigation menu to RCE, I'm not sure if it is as simple as just changing a location. It might be easier to delete it and re-add it where you want it.

[kmeeusen]

Hi  @eric_allison 

I know what you mean by "Placement", and we ran into this early in our Canvas journey, and as  @James  suggested the best method is to uninstall and reinstall the app.

For our more complex integrations I always keep a cheat-sheet that includes the XML config code and any settings (shared secret, key etc.) so that I can easily reinstall and specify the new placement. In a couple examples, we have been able to install again with a different location to display it in two places - we did this with Starfish.

You can also modify the XML code if daring.  In the partial example below you will note "course navigation" in the second line from the bottom. That is the placement for this specific integration example.

<cartridge_basiclti_link xsi:schemaLocation="http://www.imsglobal.org/xsd/imslticc_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticc_v1p0.xsd http://www.imsglobal.org/xsd/imsbasiclti_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imsbasiclti_v1p0.xsd http://www.imsglobal.org/xsd/imslticm_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticm_v1p0.xsd http://www.imsglobal.org/xsd/imslticp_v1p0 http://www.imsglobal.org/xsd/lti/ltiv1p0/imslticp_v1p0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:lticp="http://www.imsglobal.org/xsd/imslticp_v1p0" xmlns:lticm="http://www.imsglobal.org/xsd/imslticm_v1p0" xmlns:blti="http://www.imsglobal.org/xsd/imsbasiclti_v1p0" xmlns="http://www.imsglobal.org/xsd/imslticc_v1p0"><blti:launch_url>https://cptc.classclimatesurveys.com/classclimate/customer/lti/ltiClassClimateTool.php</blti:launch_url><blti:title>Class Climate Survey Evaluation</blti:title><blti:description>Allowing access to your courses evaluations</blti:description><blti:extensions platform="canvas.instructure.com"><lticm:property name="privacy_level">public</lticm:property><lticm:options name="course_navigation"><lticm:property name="enabled">true</lticm:property></lticm:options></blti:extensions></cartridge_basiclti_link>

I hope this helps,

KLM

[codom]

Hi  @eric_allison , I've also used the following API endpoints from the External Tools API to change the app placements of an already installed tool:  (External Tools - Canvas LMS REST API Documentation)

PUT /api/v1/courses/:course_id/external_tools/:external_tool_id

PUT /api/v1/accounts/:account_id/external_tools/:external_tool_id

Sometimes, for me; its been easier to load it then edit it (especially if I'm in .test), than using the XML. 

Hope this is helpful.

[Robbie_Grant]

 @eric_allison ,

We are giving the Canvas Admins area a little bit of love (especially questions that are really, really old) and just want to check in with you.  This will also bring this question new attention. 

Were you able to find an answer to your question? I am going to go ahead and mark this question as answered because there hasn't been any more activity in a while so I assume that you have the information that you need. If you still have a question about this or if you have information that you would like to share with the community, by all means, please do come back and leave a comment.  Also, if this question has been answered by one of the previous replies, please feel free to mark that answer as correct.

Robbie