Tech Articles


Quick start for contributing to Open Source PFC


Given that not everyone is fluent in using Git and or Github (where the Open Source PFC is hosted now), I put together a quick introduction in how to get started.  The video below walks through the steps, which in summary are:

  • Create a GitHub account if you don't already have one.  https://github.com/join
  • Navigate to the Open Source PFC and "Fork" a copy of the code into your account.  The 2019 version of the PFC can be found at: https://github.com/OpenSourcePFCLibraries/2019
  • Chose Code -> Clone and copy the HTTPS URL for your fork.
  • Open the PowerBuilder 2019 IDE and with no workspace open select File -> Connect to Workspace.
    • Source Control System:  Choose Git
    • Repository URL: Paste in the URL you copied above
    • Workspace File: Give it any name you choose
    • User ID:  Your Github user id (normally your email address)
    • Password:  Your Github password
    • Checkout Directory:  Select or create a new empty subdirectory on your local machine for the code to be copied to
  • Wait until the source code is downloaded and refreshed (12 to 15 minutes)

Now you're ready to start making changes.  The process for doing that is:

  • Make the change in your workspace
  • Commit it to your local repository (using the PowerBuilder IDE)
  • Push it to your fork in Github (using the PowerBuilder IDE)
  • Create a Pull Request in your fork of the code in Github

The Pull Request sends the suggested change back to the main Open Source PFC project.  It is then reviewed and if approved is then is merged into the main project.

 

 

 

Comments (5)
Wednesday, Jan 27 2021

Great stuff Bruce!
(just in case anyone gets into the same trouble as I did)
I'm an absolute noob on GitHub and forgot to first do the "Fork", I stupidly enough tried to connect in the new powerbuilder workspace to your repo.
After that, I also realized I cannot connect in powerbuilder using my password and created a token in my own github account, which I then used as the "password" in the powerbuilder workspace when connecting to git.
Thank you!
MiguelL

0

Thursday, Oct 07 2021

Hello Bruce!

I done everything as you did in video, but I have problem with connection to workspace from PB (PB 2019 R2 2328).
I always get notice (Cannot connect to the repository. Please make sure you have specified the correct repository URL, user ID and password)
For sure I use correct credentials.
What could be the problem?
Tomaz

0
Thursday, Oct 07 2021

Since I wrote that article Github has moved to the user of personal access tokens rather than using the password for the Github account.

https://github.blog/2020-07-30-token-authentication-requirements-for-api-and-git-operations/

Just generate a personal access token for your repository and use that instead of the password.

0

Thursday, Sep 07 2023

Hi,

Recently we migrated our application into Powerserver 2021 version. While migrating we faced some below Unsupported Powerserver features in PFC libraries

sqlreturndata
previewinsert
previewdelete
previewupdate
when i searched help docs

https://docs.appeon.com/ps2021/bk06ch02s01s05.html

https://docs.appeon.com/ps2021/bk06ch02s01s06.html

not able to find the workaround for the above PFC feature



Kindly help me to identify the workaround for the above features.



Thanks

Vignesh

0
Thursday, Sep 07 2023

I just turned on discussions in the PFC project in Github. That would be the more appropriate location to discuss this.

https://github.com/orgs/OpenSourcePFCLibraries/discussions

0

Find Articles by Tag

Application SnapObjects PBDOM Migration SqlExecutor Error GhostScript Windows OS JSON C# Trial Jenkins Messagging ODBC .NET DataStore Transaction Azure Database Table Data Bug Variable JSONGenerator SnapDevelop XML Class Open Source Configuration Outlook Deployment RichTextEdit Control PBNI Resize UI Modernization Windows 10 Icons TreeView .NET Std Framework PowerServer Web SQL RibbonBar Builder Data Encoding Expression PowerBuilder Database Database Painter Validation 32-bit PDF Menu Database Table Debugging Automated Testing PostgreSQL DataWindow JSON Event Handler Oracle NativePDF BLOB Performance Export 64-bit .NET Assembly Testing JSONParser SOAP Sort Window Database Connection MessageBox SqlModelMapper Event Handling Web Service Proxy CI/CD OAuth Debug Debugger OAuth 2.0 Service Visual Studio OLE WebBrowser UI Themes iOS TLS/SSL SQL Server File Authentication Stored Procedure PowerBuilder (Appeon) Text Script Model SVN OrcaScript Charts Web API Git Repository Database Object PowerServer Mobile TortoiseGit Icon Database Profile External Functions Import PDFlib PowerBuilder Compiler Import JSON Filter Interface API WinAPI Platform REST CoderObject PostgreSQL ODBC driver DataType DragDrop DevOps Graph License Android SDK Mobile CrypterObject Excel Syntax Database Table Schema Installation IDE PBVM Authorization InfoMaker Event RibbonBar COM TFS Source Control Encryption HTTPClient DLL PFC ActiveX UI DataWindow Source Code Design Array Branch & Merge Linux OS Elevate Conference PowerScript (PS) Export JSON RESTClient