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

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