Skip to content

Commit 6682ac9

Browse files
Merge branch 'main' into feature/sis-hash-documentation
2 parents e952036 + 886624e commit 6682ac9

129 files changed

Lines changed: 16021 additions & 19029 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/deploy.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ jobs:
1515
- uses: actions/checkout@v3
1616
- uses: actions/setup-node@v3
1717
with:
18-
node-version: 18
18+
node-version: 20.x
1919
cache: npm
2020

2121
- name: Install dependencies
22-
run: npm install
22+
run: npm install
2323
- name: Build website
2424
run: npm run build
2525

.github/workflows/test-deploy.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ jobs:
1515
- uses: actions/checkout@v3
1616
- uses: actions/setup-node@v3
1717
with:
18-
node-version: 18
18+
node-version: 20.x
1919
cache: npm
2020

2121
- name: Install dependencies
Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,52 @@
11
---
22
slug: email-support-best-practices
33
title: Best Practices - Requesting Support via email
4-
published: "2024-03-15"
5-
edited: "2024-03-15"
4+
published: '2024-03-15'
5+
edited: '2024-03-15'
66
author: Vikas Gupta
77
tags: ['bestpractices', 'Integrations', 'Partners', 'Developers', 'Community']
88
hide_table_of_contents: false
99
---
10-
<VersioningTracker frontMatter={frontMatter}/>
1110

1211
Ensuring prompt email support is crucial for achieving a seamless integration. We prioritize addressing inquiries from developers and the community promptly. However, given the volume of emails we receive daily, ranging from straightforward queries to those requiring in-depth research for the best solution or alternative, our response times may vary. Our approach to supporting email inquiries involves several phases:
1312

1413
Upon receipt, emails undergo the following process:
1514

16-
* The developer support team identifies the relevant domain associated with the request, such as Learn, Student, Reach, Finance, etc.
17-
* The support request is then assigned to the most suitable resource available.
18-
* Extensive research is conducted on the issue outlined in the email.
19-
* A comprehensive response is crafted and sent out to address the email.
15+
- The developer support team identifies the relevant domain associated with the request, such as Learn, Student, Reach, Finance, etc.
16+
- The support request is then assigned to the most suitable resource available.
17+
- Extensive research is conducted on the issue outlined in the email.
18+
- A comprehensive response is crafted and sent out to address the email.
2019

2120
Below are the recommended best practices to ensure you receive the quickest, most accurate, and highest quality response:
2221

23-
* Ensure a Clear Subject Line:
22+
- Ensure a Clear Subject Line:
2423

25-
* Opt for a descriptive subject line summarizing the issue concisely. We recommend using the following format:
26-
* {Your Company Name}-{Domain Name}: {Brief Issue Description}
27-
* Example: YourCompanyName-AnthologyLearn: Issue with Launching Textbook Tool
24+
- Opt for a descriptive subject line summarizing the issue concisely. We recommend using the following format:
25+
- [Your Company Name] - [Domain Name]: [Brief Issue Description]
26+
- Example: YourCompanyName-AnthologyLearn: Issue with Launching Textbook Tool
2827

29-
* Provide Relevant Information:
28+
- Provide Relevant Information:
3029

31-
* Include all necessary details such as issue specifics, steps to replicate, and relevant test data.
32-
* Be Concise Yet Specific:
30+
- Include all necessary details such as issue specifics, steps to replicate, and relevant test data.
3331

34-
* Offer sufficient information to clarify the problem while avoiding unnecessary details that could potentially confuse the support team.
35-
* One Issue per Email:
32+
- Be Concise Yet Specific:
3633

37-
* Focus on one problem per email to streamline communication and ensure adequate attention is given to each issue.
38-
* Maintain a Polite and Professional Tone:
34+
- Offer sufficient information to clarify the problem while avoiding unnecessary details that could potentially confuse the support team.
3935

40-
* Uphold a respectful demeanor in your communication, regardless of any frustrations. Remember, support agents are here to assist you, and a courteous approach can enhance the interaction.
41-
* Follow Up Appropriately:
36+
- One Issue per Email:
4237

43-
* Should you not receive a response within a reasonable timeframe, consider a polite follow-up. However, refrain from overwhelming the support team with numerous emails in quick succession.
38+
- Focus on one problem per email to streamline communication and ensure adequate attention is given to each issue.
4439

40+
- Maintain a Polite and Professional Tone:
4541

42+
- Uphold a respectful demeanor in your communication, regardless of any frustrations. Remember, support agents are here to assist you, and a courteous approach can enhance the interaction.
43+
44+
- Follow Up Appropriately:
45+
46+
- Should you not receive a response within a reasonable timeframe, consider a polite follow-up. However, refrain from overwhelming the support team with numerous emails in quick succession.
4647

4748
![Email Support Process](/assets/img/emailsupportprocess.png?raw=true)
4849

4950
We eagerly anticipate receiving full support and collaborating with your teams to ensure a successful integration.
5051

51-
52-
Cheers!
52+
Cheers!

blog/2024/2024-04-18-public-rest-api-and-roadmap.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,6 @@ tags: ["bestpractices", "Integrations", "Partners", "Developers", "Community"]
88
hide_table_of_contents: true
99
---
1010

11-
<VersioningTracker frontMatter={frontMatter}/>
12-
1311
Owr very own Camilo Dominguez presented us on our bbtechies session on Wednesday April 17th 2024 the Public REST API roadmap and a bit of the Developer Portal Roadmap.
1412

1513
<iframe width="100%" height="600" src="https://www.youtube.com/embed/xXb89AsDb10?si=myr1kSJg0dBNPZnv" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,21 @@
11
---
22
slug: changes-to-assignments-blackboard-3900.98
33
title: Changes to Assignments With Blackboard 3900.98
4-
published: "2024-11-01"
5-
edited: "2024-11-01"
4+
published: '2024-11-01'
5+
edited: '2024-11-01'
66
author: Mark Kauffman
7-
tags: ['Assignments', 'Tests', 'Integrations', 'Partners', 'Developers', 'Community']
7+
tags:
8+
[
9+
'Assignments',
10+
'Tests',
11+
'Integrations',
12+
'Partners',
13+
'Developers',
14+
'Community',
15+
]
816
hide_table_of_contents: false
917
---
10-
<VersioningTracker frontMatter={frontMatter}/>
1118

12-
We are writing this blog post to document a change to how REST APIs work with Ultra Assignments and Tests. Previously, before Blackboard version 3900.98, you could use the createAssignment REST API and treat the resulting object like a Test. You could add more than one question of differing types, using the user interface. You could use the REST API and add more than one presentation-type question type using POST request to /learn/api/public/v1/courses/{courseId}/assessments/{assessmentId}/questions/{questionId}.
19+
We are writing this blog post to document a change to how REST APIs work with Ultra Assignments and Tests. Previously, before Blackboard version 3900.98, you could use the createAssignment REST API and treat the resulting object like a Test. You could add more than one question of differing types, using the user interface. You could use the REST API and add more than one presentation-type question type using POST request to /learn/api/public/v1/courses/[courseId]/assessments/[assessmentId]/questions/[questionId].
1320

14-
[Blackboard introduced a new Assignment tool with version 3900.98.](https://help.blackboard.com/Learn/Administrator/SaaS/Release_Notes/Archived_Release_Notes#3900.98.0-6) It is no longer the same as a Test. With the new Assignment tool, when you use createAssignment the assignment body is still created, but you only see the instructions, with no option to add questions, and you cannot add questions using the assessments endpoint. To create a Test you must now use the createContent endpoint. You can find more information here: [Creating and Updating Content with REST APIs](/docs/blackboard/rest-apis/hands-on/creating-content-with-rest-apis).
21+
[Blackboard introduced a new Assignment tool with version 3900.98.](https://help.blackboard.com/Learn/Administrator/SaaS/Release_Notes/Archived_Release_Notes#3900.98.0-6) It is no longer the same as a Test. With the new Assignment tool, when you use createAssignment the assignment body is still created, but you only see the instructions, with no option to add questions, and you cannot add questions using the assessments endpoint. To create a Test you must now use the createContent endpoint. You can find more information here: [Creating and Updating Content with REST APIs](/docs/blackboard/rest-apis/hands-on/creating-content-with-rest-apis).

docs/archive/b2/getting-started/faq.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: post
3-
title: "B2-FAQs"
3+
title: 'B2-FAQs'
44
categories: Learn b2
55
id: archive-b2-gs-faqs
66
author: Scott Hurrey
@@ -45,7 +45,7 @@ and contribute to the content on the wiki and forum areas of this site as well
4545
as access certain developer content that requires a login to access.
4646

4747
Commercial entities are invited to join the program and purchase developer
48-
licenses at [this link](https://www.blackboard.com/Platforms/learn/Extensions/Partnerships-Program.aspx){: target='\_blank'}. If you have lost your license file or require a change in
48+
licenses at [this link](https://www.blackboard.com/Platforms/learn/Extensions/Partnerships-Program.aspx)[: target='\_blank']. If you have lost your license file or require a change in
4949
your license, please contact your sales representative or the partnership
5050
program.
5151

@@ -58,15 +58,15 @@ with the installation of the Learning System product. For assistance, please
5858
call our Client Support Team at (888) 788-5264. Have your six-digit company ID
5959
ready when you call.
6060

61-
All others should read up on the available [DVBA](#)or request help on the [Developer forums](https://community.blackboard.com/developers){: target='\_blank'}
61+
All others should read up on the available [DVBA](#) or request help on the <a href="https://community.blackboard.com/developers" target="_blank">Developer forums</a>
6262

6363
## API/known issues
6464

6565
If you believe you've found an issue with our APIs, please follow this process
6666
to receive support:
6767

68-
1. Post your issue to our discussion forums on the [community site](https://community.blackboard.com/developers){: target='\_blank'}
69-
2. Search the [Blackboard Techies Slack Space](https://blackboardtechies.s;ack.com){: target='\_blank'} archives and optionally e-mail the listserv regarding your issue.
68+
1. Post your issue to our discussion forums on the <a href="https://community.blackboard.com/developers" target="_blank">community site</a>
69+
2. Search the <a href="https://blackboardtechies.slack.com" target="_blank">Blackboard Techies Slack Space</a> archives and optionally e-mail the listserv regarding your issue.
7070
3. Open a new case to Behind the Blackboard (or have your Blackboard administrator do this on your behalf)
7171

7272
## Product improvements/recommendations

docs/archive/b2/getting-started/rosetta-stone.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: post
3-
title: "Rosetta Stone"
3+
title: 'Rosetta Stone'
44
categories: Learn
55
id: archive-b2-gs-rosetta_stone
66
authors: Mark Kauffman
@@ -22,9 +22,9 @@ You want to know this because this page is infrequently updated. Just log in to
2222

2323
### Rosetta Stone & Secret Decoder Ring
2424

25-
- Blackboard Learn 9.1 Q4 2019 **<< EOL December 2021 >>**
25+
- Blackboard Learn 9.1 Q4 2019 ** EOL December 2021 **
2626
- [9.1 Q4 2019 Cumulative Update 1](https://blackboard.secure.force.com/btbb_articleview?id=kA01O000000xVuX) (Build:3800.0.1-rel.42+75c791f)
27-
- Blackboard Learn 9.1 Q2 2019 **<< EOL June 2021 >>**
27+
- Blackboard Learn 9.1 Q2 2019 ** EOL June 2021 **
2828
- [9.1 Q2 2019 Cumulative Update 7](https://blackboard.secure.force.com/btbb_articleview?id=kA01O000000xVte) (Build: 3700.0.7-rel.21+54e64bd)
2929
- [9.1 Q2 2019 Cumulative Update 6](https://blackboard.secure.force.com/btbb_articleview?id=kA01O000000xVRG) (Build: 3700.0.6-rel.16+b131895)
3030
- [9.1 Q2 2019 Cumulative Update 5](https://blackboard.secure.force.com/btbb_articleview?id=kA01O000000xVJb) (Build: 3700.0.5-rel.21+dfdd268)
@@ -33,7 +33,7 @@ You want to know this because this page is infrequently updated. Just log in to
3333
- [9.1 Q2 2019 Cumulative Update 2](https://blackboard.secure.force.com/btbb_articleview?id=kA01O000000xUMU) (Build: 3700.0.2-rel.36+fbf2221)
3434
- [9.1 Q2 2019 Cumulative Update 1](https://blackboard.secure.force.com/btbb_articleview?id=kA01O000000Pf2S) (Build:3700.0.1-rel.29+a963bd8)
3535
- [9.1 Q2 2019](https://blackboard.secure.force.com/btbb_articleview?id=kA41O000000Cgap) (Build:3700.0.0) LTI 1.3/Advantage Release to Self/Managed-Hosted (Was first availalbe in SaaS 3500.11)
36-
- Blackboard Learn 9.1 Q4 2018 **<< EOL December 2020 >>**
36+
- Blackboard Learn 9.1 Q4 2018 ** EOL December 2020 **
3737
- [9.1 Q4 2018 Cumulative Update 10](https://blackboard.secure.force.com/btbb_articleview?id=kA01O000000xVtZ) (Build: 3500.0.10-rel.27+b7718ce)
3838
- [9.1 Q4 2018 Cumulative Update 9](http://blackboard.secure.force.com/btbb_articleview?id=kA01O000000xVJg) (Build:3500.0.9-rel.12+78adef1)
3939
- [9.1 Q4 2018 Cumulative Update 8](https://blackboard.secure.force.com/publickbarticleview?id=kA01O000000xV4CSAU) (Build: 3500.0.8-rel.13+ba67594)
@@ -44,30 +44,30 @@ You want to know this because this page is infrequently updated. Just log in to
4444
- [9.1 Q4 2018 Cumulative Update 3](https://blackboard.secure.force.com/apex/btbb_articleview?id=kA039000000PvnE) (Build:3500.0.3-rel.26+06aa766)
4545
- [9.1 Q4 2018 Cumulative Update 2](https://blackboard.secure.force.com/btbb_articleview?id=kA039000000Tm09) (Build:3500.0.2-rel.32+19c67cc)
4646
- [9.1 Q4 2018 Cumulative Update 1](https://blackboard.secure.force.com/btbb_articleview?id=kA039000000Tlvx)(Build:3500.0.1-rel.59+219b76) : Admin->LTI, Content Type \[\]Deep Linking
47-
- Blackboard Learn 9.1 Q2 2018 **<< EOL June 2020 >>**
47+
- Blackboard Learn 9.1 Q2 2018 ** EOL June 2020 **
4848
- [9.1 Q2 2018 (Build:3400.0.0-rel.44+9fb1e0e)](https://blackboard.secure.force.com/btbb_articleview?id=kA4390000008SoQ)
4949
- [9.1, Q2 2018 Release (Build: 3400.0.1-rel.90+b74efee)](https://blackboard.secure.force.com/btbb_articleview?id=kA0390000005EnP) : B2s->LTI, CIM, No Content Type Dropdown
50-
- Blackboard Learn 9.1 Q4 2017 << EOL Dec 2019 >> FIRST AVAILABILITY OF LTI CIM/Deep-linking 1.0
50+
- Blackboard Learn 9.1 Q4 2017 EOL Dec 2019 FIRST AVAILABILITY OF LTI CIM/Deep-linking 1.0
5151
- 9.1 Q4 2017 CU2 (Build: 3300.0.2-rel.137+ba130da)
5252
- [9.1 Q4 2017 Cumulative Update 1](https://blackboard.secure.force.com/btbb_articleview?id=kA039000000H1tF) (Build: 3300.0.1-rel.60+a05276c) : B2s->LTI, +CIM, Content Type Dropdown
53-
- Blackboard Learn 9.1 Q2 2017 << EOL June 2019 >>
53+
- Blackboard Learn 9.1 Q2 2017 EOL June 2019
5454
- [9.1 Q2 2017 Cumulative Update 2](https://blackboard.secure.force.com/btbb_articleview?id=kA039000000H2K8) (Build: 3200.0.2-rel.37+f07d42b)
5555
- 9.1 Q2 2017 Cumulative Update 2 (Build: 3200.0.2-rel.34+a87152a)
5656
- [9.1 Q2 2017 Cumulative Update 1](http://blackboard.secure.force.com/btbb_articleview?id=kA039000000H1tF) (Build: 3200.0.1-rel.56+af64d14)
5757
- [9.1 Q2 2017](https://blackboard.secure.force.com/btbb_articleview?id=kA439000000Cidz) (Build: 3200.0.0-rel.52+647f084) : LTI still under B2s, No Deep Linking
58-
- Blackboard Learn 9.1 Q4 2016 **<< EOL Dec 2018 >>**
58+
- Blackboard Learn 9.1 Q4 2016 ** EOL Dec 2018 **
5959
- [9.1 Q4 2016 Cumlative Update 3](https://blackboard.secure.force.com/btbb_articleview?id=kA03900000093Cw) (Build: 3100.0.3-rel.51+917ccd3)
6060
- Build: 3100.0.2 released to SaaS FDO only - Article # [43586](https://blackboard.secure.force.com/btbb_articleview?id=kAA390000004CeL)
6161
- [9.1 Q4 2016 Cumulative Update 1](https://blackboard.secure.force.com/btbb_articleview?id=kA03900000092tp) (Build: 3100.0.1-rel.117+6ef1843)
6262
- [9.1 Q4 2016](https://blackboard.secure.force.com/btbb_articleview?id=kA439000000CgaJ) (Build: 3100.0.0-rel.107+401e) FIRST USE OF Tomcat 8
63-
- Blackboard Learn 9.1 Q2 2016 **<< No longer supported >>**
63+
- Blackboard Learn 9.1 Q2 2016 ** No longer supported **
6464
- [9.1 Q2 2016 Cumulative Update 5](https://blackboard.secure.force.com/btbb_articleview?id=kA03900000093F2) (Build: 3000.1.5-rel.106+a770c2a)
6565
- [9.1 Q2 2016 Cumulative Update 4](https://blackboard.secure.force.com/btbb_articleview?id=kA03900000092kJ) (Build: 3000.1.4-rel.183+298455c)
6666
- [9.1 Q2 2016 Cumulative Update 3](https://blackboard.secure.force.com/btbb_articleview?id=kA039000000LKE3) (Build: 3000.1.3-rel.70+214db31)
6767
- [9.1 Q2 2016 Cumulative Update 2](https://blackboard.secure.force.com/btbb_articleview?id=kA039000000LK5f) (Build: 3000.1.2-rel.52+af05c84)
6868
- [9.1 Q2 2016 Cumulative Update 1](https://blackboard.secure.force.com/btbb_articleview?id=kA0390000004fiv) (Build: 3000.1.1-rel.20+6fbf7f6 )
6969
- [9.1 Q2 2016](https://blackboard.secure.force.com/btbb_articleview?id=kA439000000039Z) (Build: 3000.1.0-rel.52+991d) FIRST USE OF Java 8
70-
- Blackboard Learn 9.1 Q4 2015 **<< No longer supported >>**
70+
- Blackboard Learn 9.1 Q4 2015 ** No longer supported **
7171
- [9.1 Q4 2015 Cumulative Update 3](https://blackboard.secure.force.com/btbb_articleview?id=kA03900000092fJ) (Build: 9.1.201510.1176878)
7272
- [9.1 Q4 2015 Cumulative Update 2](https://blackboard.secure.force.com/btbb_articleview?id=kA0390000004fs7) (Build: 9.1.201510.1175205)
7373
- [9.1 Q4 2015 Cumulative Update 1](https://blackboard.secure.force.com/btbb_articleview?id=kA0390000000Djn) (LRNSI-21344)

docs/archive/b2/resources/first-project-using-gradle-and-git.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: post
3-
title: "First Project: Gradle, Git and b2-starter-template"
3+
title: 'First Project: Gradle, Git and b2-starter-template'
44
categories: Learn b2
55
id: archive-b2-resources-first_project_gradle
66
author: Scott Hurrey
@@ -144,11 +144,11 @@ Set this section to reflect your remote development settings:
144144
   }
145145
```
146146

147-
| Term | Definition |
148-
| -------------- | ----------------------------------------------------------------------------------------------------- |
149-
| learnVersion | used in pulling the appropriate library jars for target version |
150-
| deployServer | the IP or server name for the target development server (add ":<port&rt;" if not served from port 80) |
151-
| deployInstance | the DB instance for the target development server |
147+
| Term | Definition |
148+
| -------------- | ---------------------------------------------------------------------------------------------------- |
149+
| learnVersion | used in pulling the appropriate library jars for target version |
150+
| deployServer | the IP or server name for the target development server (add `":<port>"` if not served from port 80) |
151+
| deployInstance | the DB instance for the target development server |
152152

153153
#### Repository
154154

docs/archive/b2/resources/useful-links.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: post
3-
title: "Useful Links"
3+
title: 'Useful Links'
44
categories: Learn b2
55
id: archive-b2-resources-useful_links
66
author: Scott Hurrey
@@ -17,9 +17,9 @@ Building Blocks framework.
1717

1818
## Building Block Developer Tools
1919

20-
- [Blackboard Maven Repository](https://maven.blackboard.com/content/repositories/releases/){: target='\_blank'}
21-
- [schema.xml validator](https://maven.blackboard.com/content/repositories/releases/blackboard/platform/bb-schema-xsd/){: target='\_blank'}
22-
- [bb-manifest.xml validator](https://maven.blackboard.com/content/repositories/releases/blackboard/platform/bb-manifest-plugin/){: target='\_blank'}
23-
- [Blackboard Github Repository](https://github.com/blackboard){: target='\_blank'}
20+
- <a href="https://maven.blackboard.com/content/repositories/releases/" target="_blank">Blackboard Maven Repository</a>
21+
- <a href="https://maven.blackboard.com/content/repositories/releases/blackboard/platform/bb-schema-xsd/" target="_blank">schema.xml validator</a>
22+
- <a href="https://maven.blackboard.com/content/repositories/releases/blackboard/platform/bb-manifest-plugin/" target="_blank">bb-manifest.xml validator</a>
23+
- <a href="https://github.com/blackboard" target="_blank">Blackboard Github Repository</a>
2424
- [Java 11](./prepare-for-java11.md)
2525
- [Java 11 FAQs](./java11-faq.md)

0 commit comments

Comments
 (0)